Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 16 May 2003 10:53:20 -0700
From:      "Bruce A. Mah" <bmah@freebsd.org>
To:        Tom Rhodes <trhodes@freebsd.org>, hmp@freebsd.org
Cc:        freebsd-doc@freebsd.org
Subject:   Re: docs/39214: No my(4) man page
Message-ID:  <20030516175320.GA91137@intruder.bmah.org>
In-Reply-To: <20030516114541.26131d4f.trhodes@FreeBSD.org>
References:  <200305161127.h4GBR0QJ013946@freefall.freebsd.org> <20030516114541.26131d4f.trhodes@FreeBSD.org>

next in thread | previous in thread | raw e-mail | index | archive | help

--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 <hmp@freebsd.org> 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--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030516175320.GA91137>