Skip site navigation (1)Skip section navigation (2)
Date:      02 Feb 2003 12:46:51 -0800
From:      swear@attbi.com (Gary W. Swearingen)
To:        freebsd-doc@freebsd.org
Subject:   manpage section ordering and mdoc(7) manpage
Message-ID:  <6qel6qif5w.l6q@localhost.localdomain>

next in thread | raw e-mail | index | archive | help
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?

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?

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?6qel6qif5w.l6q>