* Mike Pritchard (m...@mpp.pro-ns.net) [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 majord...@freebsd.org with "unsubscribe freebsd-hackers" in the body of the message