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

[Yuri Pankov]

On Thu, Jul 14, 2011 at 10:34:05AM -0400, Gordon Ross wrote:
> 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.

Thanks, this looks definitely better than other options (Rich suggested
7fs as well), webrev updated.


Yuri