aboutsummaryrefslogtreecommitdiffstats
path: root/man7
diff options
context:
space:
mode:
authorAlejandro Colomar <alx.manpages@gmail.com>2022-07-29 01:15:17 +0200
committerAlejandro Colomar <alx.manpages@gmail.com>2022-07-29 12:30:22 +0200
commit3113c7f3b8173a725016481f0efaec74417283e6 (patch)
tree6a6c037e6f1be6f15ddd363297a55a0d9074577c /man7
parentcca1bcd67da3d3675345c287529bde96319a9120 (diff)
downloadman-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')
-rw-r--r--man7/aio.72
-rw-r--r--man7/capabilities.72
-rw-r--r--man7/cgroup_namespaces.72
-rw-r--r--man7/credentials.72
-rw-r--r--man7/epoll.72
-rw-r--r--man7/fanotify.72
-rw-r--r--man7/feature_test_macros.72
-rw-r--r--man7/hier.72
-rw-r--r--man7/inode.72
-rw-r--r--man7/inotify.72
-rw-r--r--man7/locale.72
-rw-r--r--man7/man-pages.74
-rw-r--r--man7/mount_namespaces.72
-rw-r--r--man7/nptl.72
-rw-r--r--man7/numa.72
-rw-r--r--man7/pid_namespaces.72
-rw-r--r--man7/queue.72
-rw-r--r--man7/rtld-audit.72
-rw-r--r--man7/signal.72
-rw-r--r--man7/sock_diag.72
-rw-r--r--man7/standards.74
-rw-r--r--man7/suffixes.72
-rw-r--r--man7/uri.72
-rw-r--r--man7/user_namespaces.72
-rw-r--r--man7/xattr.72
25 files changed, 27 insertions, 27 deletions
diff --git a/man7/aio.7 b/man7/aio.7
index e9dfdae580..132e81cff8 100644
--- a/man7/aio.7
+++ b/man7/aio.7
@@ -141,7 +141,7 @@ or was greater than the limit returned by the call
.IR sysconf(_SC_AIO_PRIO_DELTA_MAX) .
.SH VERSIONS
The POSIX AIO interfaces are provided by glibc since version 2.1.
-.SH CONFORMING TO
+.SH STANDARDS
POSIX.1-2001, POSIX.1-2008.
.SH NOTES
It is a good idea to zero out the control block buffer before use (see
diff --git a/man7/capabilities.7 b/man7/capabilities.7
index c97409e599..c92623cdd8 100644
--- a/man7/capabilities.7
+++ b/man7/capabilities.7
@@ -1753,7 +1753,7 @@ or when executed by a process that resides in a descendant of such a namespace.
For further information on the interaction of
capabilities and user namespaces, see
.BR user_namespaces (7).
-.SH CONFORMING TO
+.SH STANDARDS
No standards govern capabilities, but the Linux capability implementation
is based on the withdrawn POSIX.1e draft standard; see
.UR https://archive.org\:/details\:/posix_1003.1e-990310
diff --git a/man7/cgroup_namespaces.7 b/man7/cgroup_namespaces.7
index 9782eedaf8..94360e052b 100644
--- a/man7/cgroup_namespaces.7
+++ b/man7/cgroup_namespaces.7
@@ -160,7 +160,7 @@ sh2# \fBcat /proc/self/mountinfo | grep freezer\fP
.EE
.in
.\"
-.SH CONFORMING TO
+.SH STANDARDS
Namespaces are a Linux-specific feature.
.SH NOTES
Use of cgroup namespaces requires a kernel that is configured with the
diff --git a/man7/credentials.7 b/man7/credentials.7
index 41de356cd8..af152acf40 100644
--- a/man7/credentials.7
+++ b/man7/credentials.7
@@ -297,7 +297,7 @@ process "dumpable" attribute, as described in
Changes to process user and group IDs can affect the capabilities
of the process, as described in
.BR capabilities (7).
-.SH CONFORMING TO
+.SH STANDARDS
Process IDs, parent process IDs, process group IDs, and session IDs
are specified in POSIX.1.
The real, effective, and saved set user and groups IDs,
diff --git a/man7/epoll.7 b/man7/epoll.7
index af77425a0b..865142a3f1 100644
--- a/man7/epoll.7
+++ b/man7/epoll.7
@@ -579,7 +579,7 @@ The
API was introduced in Linux kernel 2.5.44.
.\" Its interface should be finalized in Linux kernel 2.5.66.
Support was added to glibc in version 2.3.2.
-.SH CONFORMING TO
+.SH STANDARDS
The
.B epoll
API is Linux-specific.
diff --git a/man7/fanotify.7 b/man7/fanotify.7
index 396b23f8a6..a27c4de547 100644
--- a/man7/fanotify.7
+++ b/man7/fanotify.7
@@ -910,7 +910,7 @@ written.
The fanotify API was introduced in version 2.6.36 of the Linux kernel and
enabled in version 2.6.37.
Fdinfo support was added in version 3.8.
-.SH CONFORMING TO
+.SH STANDARDS
The fanotify API is Linux-specific.
.SH NOTES
The fanotify API is available only if the kernel was built with the
diff --git a/man7/feature_test_macros.7 b/man7/feature_test_macros.7
index ceee31538d..051a7165e3 100644
--- a/man7/feature_test_macros.7
+++ b/man7/feature_test_macros.7
@@ -731,7 +731,7 @@ depends on the glibc version:
.RE
.PP
Multiple macros can be defined; the results are additive.
-.SH CONFORMING TO
+.SH STANDARDS
POSIX.1 specifies
.BR _POSIX_C_SOURCE ,
.BR _POSIX_SOURCE ,
diff --git a/man7/hier.7 b/man7/hier.7
index dbe68a6d4f..0a74c36e44 100644
--- a/man7/hier.7
+++ b/man7/hier.7
@@ -636,7 +636,7 @@ this directory holds temporary files stored for an unspecified duration.
.I /var/yp
Database files for NIS,
formerly known as the Sun Yellow Pages (YP).
-.SH CONFORMING TO
+.SH STANDARDS
The Filesystem Hierarchy Standard (FHS), Version 3.0, published March 19, 2015
.UR https://refspecs.linuxfoundation.org/fhs.shtml
.UE .
diff --git a/man7/inode.7 b/man7/inode.7
index 33c38313a3..3cf75879eb 100644
--- a/man7/inode.7
+++ b/man7/inode.7
@@ -424,7 +424,7 @@ on a directory means that a file
in that directory can be renamed or deleted only by the owner
of the file, by the owner of the directory, and by a privileged
process.
-.SH CONFORMING TO
+.SH STANDARDS
If you need to obtain the definition of the
.I blkcnt_t
or
diff --git a/man7/inotify.7 b/man7/inotify.7
index 05cdbe3245..8fb9b8211f 100644
--- a/man7/inotify.7
+++ b/man7/inotify.7
@@ -583,7 +583,7 @@ The required library interfaces were added to glibc in version 2.4.
and
.B IN_ONLYDIR
were added in glibc version 2.5.)
-.SH CONFORMING TO
+.SH STANDARDS
The inotify API is Linux-specific.
.SH NOTES
Inotify file descriptors can be monitored using
diff --git a/man7/locale.7 b/man7/locale.7
index 5e8d5959ca..3970077eaa 100644
--- a/man7/locale.7
+++ b/man7/locale.7
@@ -350,7 +350,7 @@ Usual default locale archive location.
.TP
.I /usr/lib/locale
Usual default path for compiled individual locale files.
-.SH CONFORMING TO
+.SH STANDARDS
POSIX.1-2001.
.\"
.\" The GNU gettext functions are specified in LI18NUX2000.
diff --git a/man7/man-pages.7 b/man7/man-pages.7
index e88b98ddb9..f1c381525e 100644
--- a/man7/man-pages.7
+++ b/man7/man-pages.7
@@ -172,7 +172,7 @@ ENVIRONMENT
FILES
VERSIONS [Normally only in Sections 2, 3]
ATTRIBUTES [Normally only in Sections 2, 3]
-CONFORMING TO
+STANDARDS
NOTES
CAVEATS
BUGS
@@ -385,7 +385,7 @@ The
manual page also provides information about kernel versions
in which various system calls first appeared.
.TP
-.B CONFORMING TO
+.B STANDARDS
A description of any standards or conventions that relate to the function
or command described by the manual page.
.IP
diff --git a/man7/mount_namespaces.7 b/man7/mount_namespaces.7
index c402eb8c19..f6325a7b8d 100644
--- a/man7/mount_namespaces.7
+++ b/man7/mount_namespaces.7
@@ -941,7 +941,7 @@ was performed.
.\"
.SH VERSIONS
Mount namespaces first appeared in Linux 2.4.19.
-.SH CONFORMING TO
+.SH STANDARDS
Namespaces are a Linux-specific feature.
.\"
.SH NOTES
diff --git a/man7/nptl.7 b/man7/nptl.7
index 4ca39495c5..8350b38e56 100644
--- a/man7/nptl.7
+++ b/man7/nptl.7
@@ -91,7 +91,7 @@ and
.\" FIXME .
.\" Maybe say something about vfork() not being serialized wrt set*id() APIs?
.\" https://sourceware.org/bugzilla/show_bug.cgi?id=14749
-.SH CONFORMING TO
+.SH STANDARDS
For details of the conformance of NPTL to the POSIX standard, see
.BR pthreads (7).
.SH NOTES
diff --git a/man7/numa.7 b/man7/numa.7
index 2cb6c8b8ee..4298c8302a 100644
--- a/man7/numa.7
+++ b/man7/numa.7
@@ -125,7 +125,7 @@ removed from memory by the swapper soon.
.TP
.I writeback=<pages>
Number of pages that are currently being written out to disk.
-.SH CONFORMING TO
+.SH STANDARDS
No standards govern NUMA interfaces.
.SH NOTES
The Linux NUMA system calls and
diff --git a/man7/pid_namespaces.7 b/man7/pid_namespaces.7
index 79518d4d66..f1a537dd20 100644
--- a/man7/pid_namespaces.7
+++ b/man7/pid_namespaces.7
@@ -369,7 +369,7 @@ in
.BR unix (7)),
it is translated into the corresponding PID value in
the receiving process's PID namespace.
-.SH CONFORMING TO
+.SH STANDARDS
Namespaces are a Linux-specific feature.
.SH EXAMPLES
See
diff --git a/man7/queue.7 b/man7/queue.7
index f9d223284d..085e8810c1 100644
--- a/man7/queue.7
+++ b/man7/queue.7
@@ -109,7 +109,7 @@ The first and last entries are connected.
However:
.IP * 3
The termination condition for traversal is more complex.
-.SH CONFORMING TO
+.SH STANDARDS
Not in POSIX.1, POSIX.1-2001, or POSIX.1-2008.
Present on the BSDs.
.I <sys/queue.h>
diff --git a/man7/rtld-audit.7 b/man7/rtld-audit.7
index 69c891e71e..8da1d99615 100644
--- a/man7/rtld-audit.7
+++ b/man7/rtld-audit.7
@@ -455,7 +455,7 @@ is ignored.
.\" symbol binding should return the value of the 'retval' argument
.\" (not provided by GNU, but equivalent to returning outregs->lrv_eax
.\" on (say) x86-32).
-.SH CONFORMING TO
+.SH STANDARDS
This API is nonstandard, but very similar to the Solaris API,
described in the Solaris
.IR "Linker and Libraries Guide" ,
diff --git a/man7/signal.7 b/man7/signal.7
index 43ef50eaba..1e609a1886 100644
--- a/man7/signal.7
+++ b/man7/signal.7
@@ -914,7 +914,7 @@ Linux 2.6.8 and earlier:
.IP *
Linux 2.4 and earlier:
.BR nanosleep (2).
-.SH CONFORMING TO
+.SH STANDARDS
POSIX.1, except as noted.
.SH NOTES
For a discussion of async-signal-safe functions, see
diff --git a/man7/sock_diag.7 b/man7/sock_diag.7
index 89b8378918..4e15101539 100644
--- a/man7/sock_diag.7
+++ b/man7/sock_diag.7
@@ -616,7 +616,7 @@ sockets.
and
.B INET_DIAG_SKMEMINFO
were introduced in Linux 3.6.
-.SH CONFORMING TO
+.SH STANDARDS
The NETLINK_SOCK_DIAG API is Linux-specific.
.SH EXAMPLES
The following example program prints inode number, peer's inode number,
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
diff --git a/man7/suffixes.7 b/man7/suffixes.7
index 378f79d908..4f12e30cbd 100644
--- a/man7/suffixes.7
+++ b/man7/suffixes.7
@@ -253,7 +253,7 @@ Suffix File type
\(ti Emacs or \fBpatch\fP(1) backup file
rc startup (`run control') file, e.g., \fI.newsrc\fP
.TE
-.SH CONFORMING TO
+.SH STANDARDS
General UNIX conventions.
.SH BUGS
This list is not exhaustive.
diff --git a/man7/uri.7 b/man7/uri.7
index 9ef20f8d43..ca28d7c081 100644
--- a/man7/uri.7
+++ b/man7/uri.7
@@ -563,7 +563,7 @@ permitted, and can be used only when there is no defined base
(such as in dialog boxes).
Don't use abbreviated URIs as hypertext links inside a document;
use the standard format as described here.
-.SH CONFORMING TO
+.SH STANDARDS
.UR http://www.ietf.org\:/rfc\:/rfc2396.txt
(IETF RFC\ 2396)
.UE ,
diff --git a/man7/user_namespaces.7 b/man7/user_namespaces.7
index 00c09377b3..1504b6f5b7 100644
--- a/man7/user_namespaces.7
+++ b/man7/user_namespaces.7
@@ -1012,7 +1012,7 @@ in
they are translated into the corresponding values as per the
receiving process's user and group ID mappings.
.\"
-.SH CONFORMING TO
+.SH STANDARDS
Namespaces are a Linux-specific feature.
.\"
.SH NOTES
diff --git a/man7/xattr.7 b/man7/xattr.7
index cf1789470e..4a69e2eb53 100644
--- a/man7/xattr.7
+++ b/man7/xattr.7
@@ -150,7 +150,7 @@ the total bytes used for the name, value, and implementation overhead bytes
is limited to the filesystem
.I nodesize
value (16\ kB by default).
-.SH CONFORMING TO
+.SH STANDARDS
Extended attributes are not specified in POSIX.1, but some other systems
(e.g., the BSDs and Solaris) provide a similar feature.
.SH NOTES
generated by cgit 1.2.3-korg (git 2.43.0) at 2025-12-01 18:46:34 +0000