Date: Wed, 27 Sep 2006 16:49:58 +0400 From: Ruslan Ermilov <ru@FreeBSD.org> To: Tom Rhodes <trhodes@FreeBSD.org> Cc: src-committers@FreeBSD.org, cvs-src@FreeBSD.org, cvs-all@FreeBSD.org, danger@FreeBSD.org, brueffer@FreeBSD.org, Ceri Davies <ceri@submonkey.net> Subject: Re: cvs commit: src/share/examples/mdoc example.4 Message-ID: <20060927124958.GD6346@rambler-co.ru> In-Reply-To: <20060927045417.639f3db1.trhodes@FreeBSD.org> References: <200609261959.k8QJxqkh068350@repoman.freebsd.org> <20060926202339.GA2039@haakonia.hitnet.RWTH-Aachen.DE> <20060927034124.2c57b517.trhodes@FreeBSD.org> <20060927075314.GQ54669@submonkey.net> <20060927041526.6b33a348.trhodes@FreeBSD.org> <20060927084514.GR54669@submonkey.net> <20060927045417.639f3db1.trhodes@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
--65ImJOski3p8EhYV Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, Sep 27, 2006 at 04:54:17AM -0400, Tom Rhodes wrote: [...] > > That's wrong. Getting rid of "the" works. >=20 > I like "enable" in the first bit, and I'll agree "the" should > go, even though your argument works in some cases but fails > in others. >=20 I think a common sense should apply here -- i.e., make less work for manpage writers? What most of our section four manpages document? Drivers or subsystems? I think drivers. This is an example manpage, it's not a full skeleton manpage. To be a full skeleton manpage, some other words can be put into comments, like is already done for the .Dd argument. Cheers, --=20 Ruslan Ermilov ru@FreeBSD.org FreeBSD committer --65ImJOski3p8EhYV Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.5 (FreeBSD) iD8DBQFFGnN2qRfpzJluFF4RAmH/AJ4oylF4ivbg1oQ6rKH0CbbtdjyIpACfU76j jfDSEKiW6d1BzeoA1DYPEf8= =nDWF -----END PGP SIGNATURE----- --65ImJOski3p8EhYV--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20060927124958.GD6346>