From owner-freebsd-current Mon Mar 24 10:14:58 2003 Delivered-To: freebsd-current@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E87BC37B405 for ; Mon, 24 Mar 2003 10:14:53 -0800 (PST) Received: from haakonia.hitnet.rwth-aachen.de (haakonia.hitnet.RWTH-Aachen.DE [137.226.181.92]) by mx1.FreeBSD.org (Postfix) with ESMTP id BBC4343FAF for ; Mon, 24 Mar 2003 10:14:52 -0800 (PST) (envelope-from chris@unixpages.org) Received: from gondor.middleearth (gondor.middleearth [192.168.1.42]) by haakonia.hitnet.rwth-aachen.de (Postfix) with ESMTP id 058D8C1DC; Mon, 24 Mar 2003 19:14:52 +0100 (CET) Received: by gondor.middleearth (Postfix, from userid 1001) id 15087466F; Mon, 24 Mar 2003 19:14:50 +0100 (CET) Date: Mon, 24 Mar 2003 19:14:50 +0100 From: Christian Brueffer To: Kevin Oberman Cc: Jarkko Santala , Poul-Henning Kamp , current@FreeBSD.ORG Subject: Re: MAKEDEV(8) manpage Message-ID: <20030324181450.GU36490@unixpages.org> References: <20030324133457.GR36490@unixpages.org> <20030324171215.7DBD85D07@ptavv.es.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="IfZ+tgy+ooJOsAAy" Content-Disposition: inline In-Reply-To: <20030324171215.7DBD85D07@ptavv.es.net> User-Agent: Mutt/1.4.1i X-Operating-System: FreeBSD 5.0-CURRENT X-PGP-Key: http://people.freebsd.org/~brueffer/brueffer.key.asc X-PGP-Fingerprint: A5C8 2099 19FF AACA F41B B29B 6C76 178C A0ED 982D X-Spam-Status: No, hits=-38.8 required=5.0 tests=EMAIL_ATTRIBUTION,IN_REP_TO,PGP_SIGNATURE_2, QUOTED_EMAIL_TEXT,REFERENCES,REPLY_WITH_QUOTES, USER_AGENT_MUTT autolearn=ham version=2.50 X-Spam-Level: X-Spam-Checker-Version: SpamAssassin 2.50 (1.173-2003-02-20-exp) Sender: owner-freebsd-current@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG --IfZ+tgy+ooJOsAAy Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, Mar 24, 2003 at 09:12:15AM -0800, Kevin Oberman wrote: > > Date: Mon, 24 Mar 2003 14:34:57 +0100 > > From: Christian Brueffer > > Sender: owner-freebsd-current@FreeBSD.ORG > >=20 > > On Mon, Mar 24, 2003 at 09:40:32AM +0200, Jarkko Santala wrote: > > > On Sun, 23 Mar 2003, Poul-Henning Kamp wrote: > > > > > > > In message <20030323143507.GG36490@unixpages.org>, Christian Brueff= er w=3D > > rites: > > > > >now that MAKEDEV has been gone for a while, the manpages (alpha an= d i3=3D > > 86) > > > > >can be nuked as well, right? > > > > > > > > Right. > > > > > > Although it might be considered dragging old baggage around, would it > > > make sense to instead of zapping the man page completely write a new = one > > > that would at least give a clue on how things are done these days? > > > > > > Otherwise unclued people might just think there's something wrong with > > > their system because the man page is missing and get even more confus= ed. > > > > > > -jake > > > > >=20 > > Well, people are supposed to read UPDATING before updating the system. > > UPDATING already has an entry about this, so has the handbook, the > > release notes etc. > >=20 > > I think we can't really help people that don't read the recommended > > documentation. >=20 > I think POLA should apply to things like this (even across major > releases). MAKEDEV has been around for a long time and most folks are > used to it being there. It's simply something that most people assume > will be there on a Unix-like system. >=20 > Yes, people should read UPDATING and, better still, the release > notes. But taking the added step of having a simple man page with a > pointer to the devfs paper and saying that MAKEDEV is no more there will > avoid a lot of confusion.=20 >=20 > The goal of documentation should not be to make it possible for > sophisticated users to use the system. It should make it as > easy as possible for all levels of users, including those new to Unix > and BSD to use the system. >=20 > R. Kevin Oberman, Network Engineer > Energy Sciences Network (ESnet) > Ernest O. Lawrence Berkeley National Laboratory (Berkeley Lab) > E-mail: oberman@es.net Phone: +1 510 486-8634 >=20 > To Unsubscribe: send mail to majordomo@FreeBSD.org > with "unsubscribe freebsd-current" in the body of the message >=20 >=20 I'll write a small manpage this evening which says that MAKEDEV is gone now with a short summary of what devfs does. Does that resolve your worries? - Christian --=20 Christian Brueffer chris@unixpages.org brueffer@FreeBSD.org GPG Key: http://people.freebsd.org/~brueffer/brueffer.key.asc GPG Fingerprint: A5C8 2099 19FF AACA F41B B29B 6C76 178C A0ED 982D --IfZ+tgy+ooJOsAAy Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+f0sZbHYXjKDtmC0RArhdAJ9s5arshO90ucl2cdn4HMk6K+WkCACg9/CP Xugh3BEKYLshCQEYtcEh4Ms= =GnuT -----END PGP SIGNATURE----- --IfZ+tgy+ooJOsAAy-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-current" in the body of the message