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

[Albert Lee]

On Thu, Jul 14, 2011 at 10:59 AM, Yuri Pankov <yuri.pankov at gmail.com> wrote:
> 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
>

LGTM.

-Albert