Re: [PATCH] termios.3: Use bold style for Bnn and EXTn macro constants

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Thursday 29 July 2021 13:21:40 Alejandro Colomar (man-pages) wrote:
> Hi Pali,
> 
> On 7/26/21 12:54 AM, Pali Rohár wrote:
> > Signed-off-by: Pali Rohár <pali@xxxxxxxxxx>
> > ---
> >   man3/termios.3 | 5 +++--
> >   1 file changed, 3 insertions(+), 2 deletions(-)
> > 
> > diff --git a/man3/termios.3 b/man3/termios.3
> > index 01c20994424d..e603879e18d4 100644
> > --- a/man3/termios.3
> > +++ b/man3/termios.3
> > @@ -1068,8 +1068,9 @@ and
> >   are nonstandard, but available on the BSDs.
> >   .SH NOTES
> >   UNIX\ V7 and several later systems have a list of baud rates
> > -where after the fourteen values B0, ..., B9600 one finds the
> > -two constants EXTA, EXTB ("External A" and "External B").
> > +where after the fourteen values \fBB0\fP, ..., \fBB9600\fP
> 
> Could you please use .B and/or .BR instead of inline \fB...\fP?

Ok, no problem. I used inline style because few lines below is already
used this \fIduration\fP inline style.

How do you prefer to format this part? \fBB0\fP, ..., \fBB9600\fP

> See this extract from man-pages(7):
> 
>        Any  reference  to  the  subject of the current manual page
>        should be written with the name in bold followed by a  pair
>        of parentheses in Roman (normal) font.  For example, in the
>        fcntl(2) man page, references to the subject  of  the  page
>        would  be  written as: fcntl().  The preferred way to write
>        this in the source file is:
> 
>            .BR fcntl ()
> 
>        (Using this format, rather than the  use  of  "\fB...\fP()"
>        makes  it  easier to write tools that parse man page source
>        files.)
> 
> 
> Thanks,
> 
> Alex
> 
> > +one finds the two constants \fBEXTA\fP, \fBEXTB\fP
> > +("External A" and "External B").
> >   Many systems extend the list with much higher baud rates.
> >   .PP
> >   The effect of a nonzero \fIduration\fP with
> > 
> 
> 
> -- 
> Alejandro Colomar
> Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/
> http://www.alejandro-colomar.es/



[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux