* .In adds line break while in non-SYNOPSIS section
@ 2010-06-01 12:47 Ulrich Spörlein
2010-06-01 15:13 ` Kristaps Dzonsons
0 siblings, 1 reply; 2+ messages in thread
From: Ulrich Spörlein @ 2010-06-01 12:47 UTC (permalink / raw)
To: tech
Hi again,
another small bug that introduces line breaks, where it shouldn't.
NB that groff explicitly states:
The ‘.In’ macro, while in the SYNOPSIS section, represents the #include
statement, and is the short form of the above example. It specifies the
C header file as being included in a C program. It also causes a line
break.
While not in the SYNOPSIS section, it represents the header file enclosed
in angle brackets.
Note the omission of line break in the second paragraph. mdocml 1.10.0
always adds a line break though, eg.:
This was changed by
.St -p1003.2-92
to decouple
.Fn getopt
from
.In stdio.h .
This was changed by IEEE Std 1003.2-1992 (``POSIX.2'') to decouple
getopt() from <stdio.h>
.
Pretty ugly, huh? :)
Regards,
Uli
--
To unsubscribe send an email to tech+unsubscribe@mdocml.bsd.lv
^ permalink raw reply [flat|nested] 2+ messages in thread
* Re: .In adds line break while in non-SYNOPSIS section
2010-06-01 12:47 .In adds line break while in non-SYNOPSIS section Ulrich Spörlein
@ 2010-06-01 15:13 ` Kristaps Dzonsons
0 siblings, 0 replies; 2+ messages in thread
From: Kristaps Dzonsons @ 2010-06-01 15:13 UTC (permalink / raw)
To: tech
> another small bug that introduces line breaks, where it shouldn't.
> NB that groff explicitly states:
>
> The ‘.In’ macro, while in the SYNOPSIS section, represents the #include
> statement, and is the short form of the above example. It specifies the
> C header file as being included in a C program. It also causes a line
> break.
>
> While not in the SYNOPSIS section, it represents the header file enclosed
> in angle brackets.
>
> Note the omission of line break in the second paragraph. mdocml 1.10.0
> always adds a line break though, eg.:
>
> This was changed by
> .St -p1003.2-92
> to decouple
> .Fn getopt
> from
> .In stdio.h .
>
>
> This was changed by IEEE Std 1003.2-1992 (``POSIX.2'') to decouple
> getopt() from <stdio.h>
>
> .
>
>
> Pretty ugly, huh? :)
Ulrich,
Fixed, thanks!
Kristaps
--
To unsubscribe send an email to tech+unsubscribe@mdocml.bsd.lv
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2010-06-01 15:03 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2010-06-01 12:47 .In adds line break while in non-SYNOPSIS section Ulrich Spörlein
2010-06-01 15:13 ` Kristaps Dzonsons
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).