On Tue, Aug 13, 2013 at 11:59:13PM +0200, Jan Stary wrote:
> The diff below replaces the occurences of "BSD"
> in the manpages with the .Bx macro where appropriate.
> (Some might be overkill though.)
> 
> Specifically, it does not put .Bx inside .%T lines and the like,
> e.g. ".%T Design and Implementation of 4.4 BSD",
> as discussed off-list with jmc@
> 
> The following files
> 
>       /usr/src/lib/libc/sys/sigaction.2
>       /usr/src/share/man/man4/multicast.4
>       /usr/src/usr.bin/cvs/cvsintro.7
> 
> are left untouched because I am not sure
> what would be the best way to markup "BSD-derived"
> and similar.
> 

i used Bx Ns -blah

> 
> It unifies "BSD Authentication" and "BSD authentication" to
> 
>       .Bx
>       Authentication
> 
> - the capitalized form seemed to be in the majority (don't know why).
> 
> 
> crontab(5) says
> 
>       (BSD can't do this)
> 
> which I rewrote as
> 
>       .Po
>       .Bx
>       can't do this
>       .Pc
> 
> but I don't think it's true; surely BSD can mail
> the result of a cronjob to the user. Also, it mentions
> "ATT" which I assumed was meant to be AT&T UNIX
> (and typed it as .At). Should factually .At also be
> the one that "can't do this" above?
> 

not sure. i'll ask.

> 
> /usr/src/share/man/man7/mdoc.7 which describes .Bx and others
> does not itself use .Bx and others - for example, it says
> 
>       .Ss \&Bx
>       Format the BSD version provided as an argument ...
> 
> instead of
> 
>       .Ss \&Bx
>       Format the
>       .Bx
>       version provided as an argument ...
> 
> Is this on purpose?
> 

probably needs changed, but i'll ask.

> 
> This replacement should probably be done for
> other system names as well (occurences of
> "BSD/OS" not done with .Bsx etc). Occasionaly,
> SunOS is mentioned which does not have its own macro.
> Would it make sense to have one?
> Similarly for HP-UX, IRIX ...
> 

well, it'd be non-portable (unless groff already has macros for this
stuff).

anyway, diff committed.

jmc

Reply via email to