From owner-cvs-all@FreeBSD.ORG  Wed Sep 27 12:49:59 2006
Return-Path: <owner-cvs-all@FreeBSD.ORG>
X-Original-To: cvs-all@FreeBSD.org
Delivered-To: cvs-all@FreeBSD.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id B4FC116A584;
	Wed, 27 Sep 2006 12:49:59 +0000 (UTC)
	(envelope-from ru@rambler-co.ru)
Received: from relay0.rambler.ru (relay0.rambler.ru [81.19.66.187])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 1825D43D58;
	Wed, 27 Sep 2006 12:49:58 +0000 (GMT)
	(envelope-from ru@rambler-co.ru)
Received: from relay0.rambler.ru (localhost [127.0.0.1])
	by relay0.rambler.ru (Postfix) with ESMTP id C4AC75CF2;
	Wed, 27 Sep 2006 16:49:56 +0400 (MSD)
Received: from edoofus.park.rambler.ru (unknown [81.19.65.108])
	by relay0.rambler.ru (Postfix) with ESMTP id BBADE5CDD;
	Wed, 27 Sep 2006 16:49:56 +0400 (MSD)
Received: (from ru@localhost)
	by edoofus.park.rambler.ru (8.13.8/8.13.8) id k8RCnwFp025347;
	Wed, 27 Sep 2006 16:49:58 +0400 (MSD) (envelope-from ru)
Date: Wed, 27 Sep 2006 16:49:58 +0400
From: Ruslan Ermilov <ru@FreeBSD.org>
To: Tom Rhodes <trhodes@FreeBSD.org>
Message-ID: <20060927124958.GD6346@rambler-co.ru>
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>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature"; boundary="65ImJOski3p8EhYV"
Content-Disposition: inline
In-Reply-To: <20060927045417.639f3db1.trhodes@FreeBSD.org>
User-Agent: Mutt/1.5.13 (2006-08-11)
X-Virus-Scanned: No virus found
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
X-BeenThere: cvs-all@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: CVS commit messages for the entire tree <cvs-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/cvs-all>
List-Post: <mailto:cvs-all@freebsd.org>
List-Help: <mailto:cvs-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 27 Sep 2006 12:49:59 -0000


--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--