Date: Mon, 13 Dec 1999 01:50:02 -0800 (PST) From: "Ronald F. Guilmette" <rfg@monkeys.com> To: freebsd-doc@freebsd.org Subject: Re: docs/14563: Wrong manpage produced by `man 4 fd' Message-ID: <199912130950.BAA02782@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/14563; it has been noted by GNATS. From: "Ronald F. Guilmette" <rfg@monkeys.com> To: Nik Clayton <nik@freebsd.org> Cc: FreeBSD-gnats-submit@freebsd.org Subject: Re: docs/14563: Wrong manpage produced by `man 4 fd' Date: Mon, 13 Dec 1999 01:48:04 -0800 In message <19991212104642.B82758@catkin.nothing-going-on.org>, you wrote: >On Wed, Oct 27, 1999 at 05:06:22PM -0700, Ronald F. Guilmette wrote: >> >Synopsis: Wrong manpage produced by `man 4 fd' >> >> >Description: >> >> Typing "man 4 fd" produces a man page talking generally about UNIX >> file descriptors. >> >> This is in conflict with the established convention that `man 4 foo' >> produces documentation for the `foo' device type (and its driver). >> >> `man 4 fd' should produce documentation relating to the `fd' (floppy >> disk) device type. (See `man 4 fdc') >> >> >How-To-Repeat: >> >> man 4 fd >> >> >Fix: >> >> Use `man 4 fdc' instead. > >Sorry, I don't understand. The situation is as you say it is. Are you >documenting the fact, or do you want it fixed? I'd like to see it fixed. >If you want it fixed, did you have anything in mind? I thought that the solution I was proposing was abundantly clear in what I wrote: >> `man 4 fd' should produce documentation relating to the `fd' (floppy >> disk) device type. >As things >stand, section 4 of the manuals seems to be the right place to put both >the fd and fdc manual pages. I agree completely, but `man 4 fd' *should* yield a man page that talks about floppy disk device files... *not* one that talks about UNIX file descriptors. (You can just trash the one that talks about file descrip- tors as far as I'm concerned. If people want to know about those, they should go buy a general book about UNIX/C programming.) 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?199912130950.BAA02782>