Date: Wed, 05 Feb 2003 21:14:27 -0700 (MST) From: Kazuo Horikawa <horikawa@jp.FreeBSD.org> To: swear@attbi.com Cc: freebsd-doc@FreeBSD.ORG, ru@FreeBSD.ORG Subject: Re: manpage section ordering and mdoc(7) manpage Message-ID: <20030205.211427.59464356.horikawa@attbi.com> In-Reply-To: <6qel6qif5w.l6q@localhost.localdomain> References: <6qel6qif5w.l6q@localhost.localdomain>
next in thread | previous in thread | raw e-mail | index | archive | help
(Cc'ing mdoc(7) authority as he looks missing freebsd-doc mails.) swear@attbi.com (Gary W. Swearingen) wrote: > The mdoc(7) manpage seems to claim to be the FreeBSD standard for > manpages (or at least part of the standard). Is it? Should it be? > > Specifically, is the order of sections specified by the manpage the > FreeBSD standard, which, if violated, calls for a doc PR? > > For instance, should the mdoc(7) manpage have its own "FILES" and > "DIAGNOSTICS" sections re-ordered to match it's own rules? Or should > the manpage be modified to sound less like a standard? Ruslan, what do you think about section ordering Gary mentioned? I only sweeped section 8, but I found ac.8, getty.8, init.8, mount.8, nslookup.8 nsupdate.8, pppd.8, pw.8, restore.8, rlogind.8, rshd.8, rtadvd.8, rtsold.8 and sa.8 do not follow "this order." (FILES vs DIAGNOSTICS) > If it IS the standard, should it be modified to no longer require the > "IMPLEMENTATION NOTES" and "RETURN VALUES" sections, a "standard" which > is seldom followed as reflected in the manpage's own example template? Gary, I understand that IMPLEMENTATION NOTES and RETURN VALUES are optional sections, as they are listed under the explanation "The following commands should be uncommented and used where appropriate." as follow: .\" The following commands should be uncommented and .\" used where appropriate. .\" .Sh IMPLEMENTATION NOTES .\" This next command is for sections 2, 3 and 9 function .\" return values only. .\" .Sh RETURN VALUES [snip] -- Kazuo Horikawa To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030205.211427.59464356.horikawa>