Date: Tue, 13 Dec 2005 19:12:34 +0100 From: Roland Smith <rsmith@xs4all.nl> To: Kevin Oberman <oberman@es.net> Cc: "\[LoN\]Kamikaze" <LoN_Kamikaze@gmx.de>, freebsd-stable@freebsd.org Subject: Re: devfs doesn't set access rights Message-ID: <20051213181234.GB20852@slackbox.xs4all.nl> In-Reply-To: <20051213173714.C15515D07@ptavv.es.net> References: <20051213164947.GA17705@odin.ac.hmc.edu> <20051213173714.C15515D07@ptavv.es.net>
next in thread | previous in thread | raw e-mail | index | archive | help
--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: <snip>>=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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20051213181234.GB20852>