From owner-freebsd-current Mon Mar 24 9:12:22 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 AC2F037B401 for ; Mon, 24 Mar 2003 09:12:19 -0800 (PST) Received: from postal3.es.net (postal3.es.net [198.128.3.207]) by mx1.FreeBSD.org (Postfix) with ESMTP id EEFBE43F75 for ; Mon, 24 Mar 2003 09:12:18 -0800 (PST) (envelope-from oberman@es.net) Received: from ptavv.es.net ([198.128.4.29]) by postal3.es.net (Postal Node 3) with ESMTP id MUA74016; Mon, 24 Mar 2003 09:12:17 -0800 Received: from ptavv (localhost [127.0.0.1]) by ptavv.es.net (Tachyon Server) with ESMTP id 7DBD85D07; Mon, 24 Mar 2003 09:12:15 -0800 (PST) To: Christian Brueffer Cc: Jarkko Santala , Poul-Henning Kamp , current@FreeBSD.ORG Subject: Re: MAKEDEV(8) manpage In-reply-to: Your message of "Mon, 24 Mar 2003 14:34:57 +0100." <20030324133457.GR36490@unixpages.org> Date: Mon, 24 Mar 2003 09:12:15 -0800 From: "Kevin Oberman" Message-Id: <20030324171215.7DBD85D07@ptavv.es.net> X-Spam-Status: No, hits=-6.5 required=5.0 tests=IN_REP_TO,QUOTED_EMAIL_TEXT 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 > Date: Mon, 24 Mar 2003 14:34:57 +0100 > From: Christian Brueffer > Sender: owner-freebsd-current@FreeBSD.ORG > > 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 Brueffer w= > rites: > > > >now that MAKEDEV has been gone for a while, the manpages (alpha and i3= > 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 confused. > > > > -jake > > > > 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. > > I think we can't really help people that don't read the recommended > documentation. 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. 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. 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. 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 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-current" in the body of the message