Date: Sat, 28 Aug 1999 02:29:08 -0500 (CDT) From: Mike Pritchard <mpp@mpp.pro-ns.net> To: freebsd-hackers@freebsd.org, freebsd-doc@freebsd.org Cc: phantom@cris.net Subject: Propose mdoc fix regarding ERRORS section Message-ID: <199908280729.CAA93164@mpp.pro-ns.net>
next in thread | raw e-mail | index | archive | help
>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 As things have progressed, sometimes the errno names have become wider than the name specified in the .Bl macro. Man pages can also specify: .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. Suggestions/comments/etc welcome. -Mike -- Mike Pritchard mpp@FreeBSD.org or mpp@mpp.pro-ns.net To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-hackers" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199908280729.CAA93164>