Date: Sat, 28 Apr 2001 05:52:32 -0500 From: Mike Pritchard <mpp@mppsystems.com> To: Ruslan Ermilov <ru@FreeBSD.ORG> Cc: cvs-committers@FreeBSD.ORG, cvs-all@FreeBSD.ORG Subject: Re: cvs commit: src/share/doc/papers/memfs Makefile src/share/misc mdoc.template src/share/man/man7 Makefile man.7 mdoc.7 mdoc.samples.7 src/share/examples/mdoc example.1 example.3 example.4 Message-ID: <20010428055232.A54517@mppsystems.com> In-Reply-To: <200104261713.f3QHDUU90290@freefall.freebsd.org>; from ru@FreeBSD.ORG on Thu, Apr 26, 2001 at 10:13:30AM -0700 References: <200104261713.f3QHDUU90290@freefall.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Thu, Apr 26, 2001 at 10:13:30AM -0700, Ruslan Ermilov wrote: > ru 2001/04/26 10:13:29 PDT > > Modified files: (Branch: RELENG_4) > share/examples/mdoc example.1 example.3 example.4 [...] > Log: > MFC: Upgrade to Groff 1.17. > > Revision Changes Path > 1.12.2.4 +3 -7 src/share/examples/mdoc/example.1 > 1.12.2.5 +4 -8 src/share/examples/mdoc/example.3 > 1.10.2.3 +3 -7 src/share/examples/mdoc/example.4 I missed this on the first go round, but in the example man pages, they had comments that read like so: .\" Note: Only specify the operating system when the command .\" is FreeBSD specific, otherwise use the .Os macro with no .\" arguments. These were removed by this MFC, and presumabliy by the original commit. I think the comments are still valid, although with how we are doing man pages these days, I might re-word it so it might be better: Note: Only specify the operating system and version when the command is FreeBSD specific, or when it is documenting a deprecated interface. And maybe for those few man pages that are actually documenting obsoleted interfaces, they should have an "OBSOLETE" header right at the start of the man page. -Mike -- Mike Pritchard mpp@FreeBSD.org or mpp@mppsystems.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010428055232.A54517>