From owner-freebsd-stable@FreeBSD.ORG Tue Dec 13 18:13:02 2005 Return-Path: X-Original-To: freebsd-stable@freebsd.org Delivered-To: freebsd-stable@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C6C6E16A426 for ; Tue, 13 Dec 2005 18:13:02 +0000 (GMT) (envelope-from rsmith@xs4all.nl) Received: from smtp-vbr9.xs4all.nl (smtp-vbr9.xs4all.nl [194.109.24.29]) by mx1.FreeBSD.org (Postfix) with ESMTP id CB9B543D5D for ; Tue, 13 Dec 2005 18:12:54 +0000 (GMT) (envelope-from rsmith@xs4all.nl) Received: from slackbox.xs4all.nl (slackbox.xs4all.nl [213.84.242.160]) by smtp-vbr9.xs4all.nl (8.13.3/8.13.3) with ESMTP id jBDICYnw051200; Tue, 13 Dec 2005 19:12:35 +0100 (CET) (envelope-from rsmith@xs4all.nl) Received: by slackbox.xs4all.nl (Postfix, from userid 1001) id 7573FB827; Tue, 13 Dec 2005 19:12:34 +0100 (CET) Date: Tue, 13 Dec 2005 19:12:34 +0100 From: Roland Smith To: Kevin Oberman Message-ID: <20051213181234.GB20852@slackbox.xs4all.nl> Mail-Followup-To: Kevin Oberman , Brooks Davis , "[LoN]Kamikaze" , freebsd-stable@freebsd.org References: <20051213164947.GA17705@odin.ac.hmc.edu> <20051213173714.C15515D07@ptavv.es.net> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="TRYliJ5NKNqkz5bu" Content-Disposition: inline In-Reply-To: <20051213173714.C15515D07@ptavv.es.net> User-Agent: Mutt/1.4.2.1i X-GPG-Fingerprint: 1A2B 477F 9970 BA3C 2914 B7CE 1277 EFB0 C321 A725 X-GPG-Key: http://www.xs4all.nl/~rsmith/pubkey.txt X-GPG-Notice: If this message is not signed, don't assume I sent it! X-Virus-Scanned: by XS4ALL Virus Scanner Cc: "\[LoN\]Kamikaze" , freebsd-stable@freebsd.org Subject: Re: devfs doesn't set access rights X-BeenThere: freebsd-stable@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Production branch of FreeBSD source code List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 13 Dec 2005 18:13:03 -0000 --TRYliJ5NKNqkz5bu Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, Dec 13, 2005 at 09:37:13AM -0800, Kevin Oberman wrote: >=20 > You are being entirely too kind. The documentation for the practical use > of devfs at all sucks! Nothing I could find in the handbook, > either. It's a classic case of documentation written by programmers in > that the author can't look at his software from the standpoint of > someone who does not know anything about it. Good documentation really > needs to be written by someone sitting "on the outside" of the > development process. But this is a huge problem for commercial > applications where they actually hire writers, let alone for a volunteer > project.=20 The manual pages for devfs.conf and devfs.rules were definitely written "on= the outside". :-) > I thought that the devfs.rules page was pretty helpful, but neither the > devfs(8) nor the devfs(5) man pages mention either devfs.conf or > devfs.rules in "SEE ALSO" (although devfs.rules is mentioned in > "FILES"). No indication of how to use it or that there is actually a man > page for it. No mention of devfs.conf at all. devfs(5) provides no clue > at all that devfs does this sort of thing, either. Listing devfs.(conf|rules) in the SEE ALSO sections of devfs(5|8) sounds like a good idea. > Guess I'll try putting something together. Other than putting it in a > PR, should I do anything else with it? Putting in a PR, preferredly with a patch for the relevant manual pages, would be fine, I think. Roland --=20 R.F.Smith (http://www.xs4all.nl/~rsmith/) Please send e-mail as plain text. public key: http://www.xs4all.nl/~rsmith/pubkey.txt --TRYliJ5NKNqkz5bu Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.2 (FreeBSD) iD8DBQFDnw8SEnfvsMMhpyURAp3DAJ4l6WnndhFKuPOwXorMlMO7eVZ2bwCfVCoS TCZFdiyihcQsiweLHT7VxNo= =hgV9 -----END PGP SIGNATURE----- --TRYliJ5NKNqkz5bu--