Subject: Re: Style of "man" pages for NetBSD
To: Charles M. Hannum <abuse@spamalicious.com>
From: Steven M. Bellovin <smb@cs.columbia.edu>
List: netbsd-users
Date: 01/25/2005 13:06:31
In message <200501251738.28390.abuse@spamalicious.com>, "Charles M. Hannum" wri
tes:
>On Saturday 22 January 2005 15:24, Florian Stoehr wrote:
>> Hi,
>>
>> I see most man pages for NetBSD are in .Dd-Style. I like the other .TH
>> style with the "justified" text more.
>>
>> Is it OK to use the TH (e.g. ipf(4))-Style within pages designed for
>> NetBSD only?
>
>AFAICT, you're referring to the different between "mdoc" and "man" style 
>pages.  We do not write documentation in "man" style any more.  "mdoc" is 
>intentionally not justified when rendered in text form, because people 
>generally find it harder to read that way.
>

Yes, though it's not hard to turn on justification if running troff as 
opposed to nroff.


		--Prof. Steven M. Bellovin, http://www.cs.columbia.edu/~smb