From owner-freebsd-doc@FreeBSD.ORG Fri May 16 10:53:24 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0B88337B401; Fri, 16 May 2003 10:53:24 -0700 (PDT) Received: from rwcrmhc51.attbi.com (rwcrmhc51.attbi.com [204.127.198.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id 37C0F43FAF; Fri, 16 May 2003 10:53:23 -0700 (PDT) (envelope-from bmah@employees.org) Received: from bmah.dyndns.org (12-240-204-110.client.attbi.com[12.240.204.110]) by attbi.com (rwcrmhc51) with ESMTP id <2003051617532005100bv6gte>; Fri, 16 May 2003 17:53:20 +0000 Received: from intruder.bmah.org (localhost [127.0.0.1]) by bmah.dyndns.org (8.12.9/8.12.9) with ESMTP id h4GHrKrh091267; Fri, 16 May 2003 10:53:20 -0700 (PDT) (envelope-from bmah@intruder.bmah.org) Received: (from bmah@localhost) by intruder.bmah.org (8.12.9/8.12.9/Submit) id h4GHrKMG091266; Fri, 16 May 2003 10:53:20 -0700 (PDT) (envelope-from bmah) Date: Fri, 16 May 2003 10:53:20 -0700 From: "Bruce A. Mah" To: Tom Rhodes , hmp@freebsd.org Message-ID: <20030516175320.GA91137@intruder.bmah.org> References: <200305161127.h4GBR0QJ013946@freefall.freebsd.org> <20030516114541.26131d4f.trhodes@FreeBSD.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="jRHKVT23PllUwdXP" Content-Disposition: inline In-Reply-To: <20030516114541.26131d4f.trhodes@FreeBSD.org> User-Agent: Mutt/1.4.1i X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif X-url: http://www.employees.org/~bmah/ cc: freebsd-doc@freebsd.org Subject: Re: docs/39214: No my(4) man page X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 16 May 2003 17:53:24 -0000 --jRHKVT23PllUwdXP Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable If memory serves me right, Tom Rhodes wrote: > On Fri, 16 May 2003 04:27:00 -0700 (PDT) > Hiten Pandya wrote: >=20 > > Synopsis: No my(4) man page > >=20 > > Responsible-Changed-From-To: freebsd-doc->hmp > > Responsible-Changed-By: hmp > > Responsible-Changed-When: Fri May 16 04:24:42 PDT 2003 > > Responsible-Changed-Why:=20 > > I have this man page in the works. It is simple, and not trendy > > like other NIC man pages, but it fills the gap: > >=20 > > http://people.FreeBSD.ORG/~hmp/my.4.txt > >=20 >=20 > Need more review? Note, mii(4) does not exist, its miibus(4), which > I wrote and added to the tree a couple of months ago. I'll jump in with a few nitpicks. :-p The correspondence between "DEC Tulip NIC chipset" and the dc(4) driver in the cross-references is not clear. The supported models are not sentences, and therefore should not end with full-stops. In the HISTORY section, you should say that the my driver *first* appeared in FreeBSD 4.6. The AUTHORS section could probably be better worded as "The my driver was written by Myson Technologies." If you (hmp) want to give yourself credit for the manpage, that's acceptable here. I'd also try to turn the BUGS section into a complete sentence. Bruce. PS. Yes, I always sign my name in email as though it were a sentence. So sue me. :-) --jRHKVT23PllUwdXP Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE+xSWP2MoxcVugUsMRAjecAKCerrajDi+mPVXQSl51aQQdmkDopQCg9cOX XWNPuOvx6aDCiKDPuNjBfpg= =PZI3 -----END PGP SIGNATURE----- --jRHKVT23PllUwdXP--