Bug #1192
closedfd manpage should be in section 7
100%
Description
fd manpage is describing special files in /dev and should live in section 7. While here, add links for stdin, stdout and stderr to fd.
Updated by Rich Lowe almost 11 years ago
I think the idea is that its describing files and thus in 4. We mostly use 7 itself for non-driver kernel modules it seems. I think that it doesn't really fit that well anywhere, but either 7FS or just leaving it in 4 seems reasonable?
Updated by Yuri Pankov almost 11 years ago
Well, my understanding is that 4 is 'file formats', fd doesn't describe any format, it talks about special files in /dev; if it doesn't fit in any subsection of 7 then let it just be in 7 itself (if we didn't use 7 for this, we can always start doing it if it seems logical).
Updated by Albert Lee almost 11 years ago
I cite zero(7D) and null(7D) as supporting evidence this should be in section 7D.
intro(7) doesn't describe anything other than subsections.
(7D) The system provides drivers for a variety of hardware devices, such as disk, magnetic tapes, serial communication lines, mice, and frame buffers, as well as virtual devices such as pseudo-terminals and windows. This section describes special files that refer to specific hardware peripherals and device drivers. STREAMS device drivers are also described. Characteristics of both the hardware device and the corresponding device driver are discussed where applicable.
Anything in (7) right now appears to either be X server drivers or leftover stuff from the BSD manpage section.
Updated by Yuri Pankov almost 11 years ago
Last attempt at being stubborn :-)
Albert Lee wrote:
I cite zero(7D) and null(7D) as supporting evidence this should be in section 7D.
intro(7) also reads "All device special files are located under the /devices directory.", /dev/zero and /dev/null are indeed links to /devices/, while /dev/fd/ contents aren't.
intro(7) doesn't describe anything other than subsections.
We could fix that :-)
[...]
Anything in (7) right now appears to either be X server drivers or leftover stuff from the BSD manpage section.
It also could be used for special cases like fd.
Updated by Garrett D'Amore almost 11 years ago
- Status changed from New to Resolved
- % Done changed from 0 to 100
Resolved in:
changeset: 13424:f2dd4a8a49cd
tag: tip
user: Yuri Pankov <yuri.pankov@nexenta.com>
date: Wed Aug 10 22:43:54 2011 -0700
description:
635 sed manual page needs significant updates
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
Reviewed by: Albert Lee <trisk@opensolaris.org>
Reviewed by: Gordon Ross <gordon.w.ross@gmail.com>
Approved by: Garrett D'Amore <garrett@nexenta.com>