Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 10 Mar 2003 21:35:03 +0100
From:      Stijn Hoop <stijn@win.tue.nl>
To:        David Schultz <das@freebsd.org>
Cc:        Sean Chittenden <sean@chittenden.org>, "M. Warner Losh" <imp@bsdimp.com>, doc@freebsd.org, trhodes@freebsd.org, dwmalone@freebsd.org
Subject:   Re: your mail
Message-ID:  <20030310203503.GA34500@pcwin002.win.tue.nl>
In-Reply-To: <20030310195323.GA2812@HAL9000.homeunix.com>
References:  <20030310195323.GA2812@HAL9000.homeunix.com>

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

--n8g4imXOkfNTN/H1
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Mon, Mar 10, 2003 at 11:53:23AM -0800, David Schultz wrote:
> Bcc: src-committers@FreeBSD.org, cvs-src@FreeBSD.org, cvs-all@FreeBSD.org=
=20
> Subject: Re: cvs commit: src/sys/dev/kbd kbd.c
> Reply-To:=20
> In-Reply-To: <20030310110025.GS79234@perrin.int.nxad.com>
>=20
> [moving to doc@; please CC me]
>=20
> Thus spake Sean Chittenden <sean@chittenden.org>:
> > It's just a skeleton at this point with only a few MIBs filled in, but
> > unless there's a strong objection, it'd be great to get this flushed
> > out over time.  The man pages that the various MIBs reference should
> > contain the appropriate information about what these MIB values mean
> > and how to adjust them, and what levels are appropriate.
> >=20
> > http://people.freebsd.org/~seanc/patches/#sysctl_5_start
> >=20
> > It isn't automatically generated, but it's a start and given that
> > there are only a handful of MIBs that come into existence every month
> > or so, I think it's reasonable to have this file maintained by hand.
>=20
> Very cool.  I think it might be a better idea to move the
> centralized list to the handbook, since hypertext is a better
> medium for a list that will potentially be very long and contain
> many cross-references.  Short descriptions next to MIBs would be
> nice.  Also, sorting first by category and then by alphabetical
> order might be more helpful.

I vote for a manpage first. Although I agree with the fact that hyperlinks
are better for information linking than SEE ALSO sections in a manpage,
I think this sort of reference clearly belongs in the *man*ual. I look
to the handbook when I have a specific task I want to do, not for
reference.

Now, the XML manpage stuff, that would really rock. But I'm not skilled
enough at that to do anything about it, unfortunately.

--Stijn

--=20
"What kind of a two-bit operation are they running out of this treehouse,
 Cooper? I have seen some slipshod backwater burgs, but this place takes the
 cake."
		-- Special Agent Albert Rosenfield, "Twin Peaks"

--n8g4imXOkfNTN/H1
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.1 (FreeBSD)

iD8DBQE+bPb3Y3r/tLQmfWcRAn+gAJ0ZOBT0/jJ8bzYJDKJe2VDTyoaB4ACfYant
3XKthTEbnSTWz7wjmvAnQ/w=
=ABcX
-----END PGP SIGNATURE-----

--n8g4imXOkfNTN/H1--

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




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