diff options
| author | Alejandro Colomar <alx.manpages@gmail.com> | 2022-07-29 01:15:17 +0200 |
|---|---|---|
| committer | Alejandro Colomar <alx.manpages@gmail.com> | 2022-07-29 12:30:22 +0200 |
| commit | 3113c7f3b8173a725016481f0efaec74417283e6 (patch) | |
| tree | 6a6c037e6f1be6f15ddd363297a55a0d9074577c /man7/standards.7 | |
| parent | cca1bcd67da3d3675345c287529bde96319a9120 (diff) | |
| download | man-pages-3113c7f3b817.tar.gz | |
Many pages: Use STANDARDS instead of CONFORMING TO
STANDARDS seems to be much more extended than CONFORMING TO. For
consistency across the whole manual pages corpus, let's try to
unify, by following the most commonly used section name.
On 7/27/22 12:49, Ingo Schwarze wrote:
> Alejandro Colomar wrote on Tue, Jul 26, 2022 at 02:02:56PM +0200:
> > We use CONFORMING TO in Linux. Don't know why; just history, I guess.
> > See man-pages(7).
>
> Weird.
>
> I failed to find a single instance of "CONFORMING TO" in AT&T UNIX
> (including v6, PWB, v7, 32v, v8, v10, System III, SVR1, SVR2) nor in
> any version of UCB CSRG BSD. So considering that System V and BSD are
> widely considered the two main original branches of the development
> of Unix-like operating systems and Linux is often considered to have
> drawn inspiration from both, the section name "CONFORMING TO" does
> not appear to be a UNIX thing. For example, Aeleen Frisch, "Essential
> System Administration", O'Reilly, Cambridge 1995, considers Linux
> as slightly more influenced by 4.3BSD than by System V Release 3.
>
> STANDARDS, on the other hand, is present since 4.3BSD-Reno (June 1990).
>
> 4.3BSD-Reno predates the first version of the Linux kernel by more than
> a year, and the first Linux manual pages probably for longer than that.
>
> So i have no idea where "CONFORMING TO" may have come from.
Scripted change:
$ find man* -type f | xargs sed -i 's/CONFORMING TO/STANDARDS/'
plus a few manual fixes to the following files:
- man2/getrlimit.2
- man3/syslog.3
- scripts/bash_aliases
Reported-by: Ingo Schwarze <schwarze@openbsd.org>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Diffstat (limited to 'man7/standards.7')
| -rw-r--r-- | man7/standards.7 | 4 |
1 files changed, 2 insertions, 2 deletions
diff --git a/man7/standards.7 b/man7/standards.7 index 9f88d3d909..94a69266f0 100644 --- a/man7/standards.7 +++ b/man7/standards.7 @@ -6,7 +6,7 @@ .SH NAME standards \- C and UNIX Standards .SH DESCRIPTION -The CONFORMING TO section that appears in many manual pages identifies +The STANDARDS section that appears in many manual pages identifies various standards to which the documented interface conforms. The following list briefly describes these standards. .TP @@ -262,7 +262,7 @@ and which mandates an additional set of interfaces beyond those in the base specification. .IP -In general, where the CONFORMING TO section of a manual page +In general, where the STANDARDS section of a manual page lists POSIX.1-2001, it can be assumed that the interface also conforms to POSIX.1-2008, unless otherwise noted. .IP |