* Mike Pritchard ([EMAIL PROTECTED]) [990828 11:44]:
>>Category: docs
>>Synopsis: src/lib/libc/sys/*.2 misc patch pack
>- first column in most ERROR lists is too narrow. Normalize their width.
>
>Right now we have a problem with our on-line man pages. Most were
>written when the length of errno's were only 6 - 8 characters long.
>Now we have errno's that can be up to 15 characters long. Many
>of our man pages have the following mdoc instruction (or something
>similar) to ensure that the field width for the errno is appropriate:
>
>.Bl -tag -width EBADFXXX
Most lists do actually. But you already know =)
>.Bl -tag -width Er
>
>Which will reserve enough space for the errno name based on what
>width the Er macro specifies. Right now it doesn't allocate enough
>width to contain our largest errno's.
>
>I propose that we fix mdoc to allocate enough width when the second
>form is specified, and then change all of the man pages to use that
>format in the ERRORS section.
I think using -width Er and setting the Er constant to a higher value
might be the best thing. Offcourse we need to check all of the manpages
in order whether they use -width EBLAHBLAH or -width Er.
If you need help, please yell.
--
Jeroen Ruigrok van der Werven asmodai(at)wxs.nl
The BSD Programmer's Documentation Project <http://home.wxs.nl/~asmodai>
Network/Security Specialist BSD: Technical excellence at its best
Fame is the perfume of heroic deeds.
To Unsubscribe: send mail to [EMAIL PROTECTED]
with "unsubscribe freebsd-hackers" in the body of the message
