[illumos-Developer] webrev for 635, 1181, 1188-1192

[Gordon Ross]

On Wed, Jul 13, 2011 at 10:53 PM, Yuri Pankov <yuri.pankov at gmail.com> wrote:
> On Wed, Jul 13, 2011 at 08:12:29PM -0400, Albert Lee wrote:
>> On Wed, Jul 13, 2011 at 4:42 PM, Yuri Pankov <yuri.pankov at gmail.com> wrote:
>> > On Wed, Jul 13, 2011 at 04:19:06PM -0400, Gordon Ross wrote:
>> >> On Wed, Jul 13, 2011 at 3:31 PM, Yuri Pankov <yuri.pankov at gmail.com> wrote:
>> >> > Hi,
>> >> >
>> >> > https://www.xvoid.org/illumos/webrev/manfixes/
>> >> >
>> >> > 635 sed manual page needs significant updates
>> >> > 1181 Remove plot(1B), plot(4B), tplot(1)
>> >> > 1188 Move pppdump and tcpd manpages to usr/src/man
>> >> > 1189 add stdin/stdout/stderr(3C) manpage symlinks
>> >> > 1190 Remove source-security-tcp-wrapper and SUNWtcpdS packages
>> >> > 1191 Remove source-network-pppdump and SUNWpppgS packages
>> >> > 1192 fd manpage should be in section 7
>>
>> Thanks, this looks excellent.
>>
>> Does our pppdump license really have the heinous advertising clause?
>> :( We should probably file a bug about that.
>>
>> Section 7 (with no subsection) is not actually documented, so my
>> feeling is that the fd manpage should probably actually be in
>> subsection 7D along with null(7D) and zero(7D). (I commented on the
>> bug as well). The aforementioned (7D) manpages also have FILES
>> sections with the /dev paths.
>
> The problem is that we already have fd manpage in section 7D (fd, fdc -
> drivers for floppy disks and floppy disk controllers), so the one
> talking about file descriptors really looks homeless. If you strongly
> disagree with using section 7 for such manpages, we probably could make
> the floppy stuff be named fdc only (still looks better than section 4 in
> any case..).

OK, so let me try for a more serious response :)

Another suggestion is to make stdin, stdout, stderr, links to a
(possibly new) "fd(7fs) man page".  I suggest this because
/dev/fd is actually a mount point of the "fd" filesystem, and the
symlinks stdin, stdout, stderr, are just links to 0,1,2 under that
special filesystem.

This is different from /dev/null or /dev/zero which are true devices.

Gordon