Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 13 Dec 1999 16:47:31 -0800
From:      "Ronald F. Guilmette" <rfg@monkeys.com>
To:        Alexey Zelkin <phantom@cris.net>
Cc:        freebsd-doc@freebsd.org
Subject:   Re: docs/14563: Wrong manpage produced by `man 4 fd' 
Message-ID:  <10954.945132451@monkeys.com>
In-Reply-To: Your message of Mon, 13 Dec 1999 22:11:01 %2B0300. <19991213221101.A602@scorpion.crimea.ua> 

next in thread | previous in thread | raw e-mail | index | archive | help

In message <19991213221101.A602@scorpion.crimea.ua>, you wrote:

>hi,
>
>On Mon, Dec 13, 1999 at 01:50:02AM -0800, Ronald F. Guilmette wrote:
>
>>  >> 	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.
>
>What exactly ? Rename fdc(4) -> fd(4) ? Ok. Any suggestions on new name for
>current fd(4) then ?

Just throw that away.  Or else take that material and put it into intro(2),
where it ought to be.

Basic information about data thingies... e.g. unix file descriptors, UIDs,
GIDs, timeval thingies, semaphore identifiers, SysV shared memory identifiers,
and all info about all such basic data thingies should go into intro(2).



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?10954.945132451>