[PATCH v2 2/2] Various pages: Normalize NOTES about nonexistent glibc wrappers

[Alejandro Colomar <alx.manpages@gmail.com>]

From: Ganimedes Colomar <gacoan.linux@gmail.com>

See previous commit.

This commit normalizes texts under sections other than SYNOPSIS
(most of them in NOTES).

Signed-off-by: Ganimedes Colomar <gacoan.linux@gmail.com>
Cowritten-by: Alejandro Colomar <alx.manpages@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
---
 man2/add_key.2              | 2 +-
 man2/arch_prctl.2           | 6 ++----
 man2/getdents.2             | 8 ++++----
 man2/io_cancel.2            | 2 +-
 man2/io_destroy.2           | 2 +-
 man2/io_getevents.2         | 2 +-
 man2/io_setup.2             | 2 +-
 man2/io_submit.2            | 2 +-
 man2/kexec_load.2           | 3 +--
 man2/keyctl.2               | 2 +-
 man2/pidfd_getfd.2          | 2 +-
 man2/pidfd_open.2           | 2 +-
 man2/pidfd_send_signal.2    | 2 +-
 man2/request_key.2          | 2 +-
 man2/s390_guarded_storage.2 | 3 +--
 man2/s390_pci_mmio_write.2  | 3 +--
 man2/s390_runtime_instr.2   | 3 +--
 man2/s390_sthyi.2           | 3 +--
 man2/seccomp.2              | 3 +++
 man2/sysctl.2               | 3 +--
 20 files changed, 26 insertions(+), 31 deletions(-)

diff --git a/man2/add_key.2 b/man2/add_key.2
index 7c20de777..0d136e4aa 100644
--- a/man2/add_key.2
+++ b/man2/add_key.2
@@ -216,7 +216,7 @@ This system call first appeared in Linux 2.6.10.
 .SH CONFORMING TO
 This system call is a nonstandard Linux extension.
 .SH NOTES
-No wrapper for this system call is provided in glibc.
+Glibc does not provide a wrapper for this system call.
 A wrapper is provided in the
 .IR libkeyutils
 package.
diff --git a/man2/arch_prctl.2 b/man2/arch_prctl.2
index e8a6da391..f9a9dc39d 100644
--- a/man2/arch_prctl.2
+++ b/man2/arch_prctl.2
@@ -177,10 +177,8 @@ and
 in the same thread is dangerous, as they may overwrite each other's
 TLS entries.
 .PP
-As of version 2.7, glibc provides no prototype for
-.BR arch_prctl ().
-You have to declare it yourself for now.
-This may be fixed in future glibc versions.
+Glibc does not provide a wrapper for this system call; call it using
+.BR syscall (2).
 .PP
 .I FS
 may be already used by the threading library.
diff --git a/man2/getdents.2 b/man2/getdents.2
index 8fe6f90fc..2a0576ffd 100644
--- a/man2/getdents.2
+++ b/man2/getdents.2
@@ -211,13 +211,13 @@ SVr4.
 Library support for
 .BR getdents64 ()
 was added in glibc 2.30;
-there is no glibc wrapper for
-.BR getdents ().
-Calling
+Glibc does not provide a wrapper for
+.BR getdents ();
+call
 .BR getdents ()
 (or
 .BR getdents64 ()
-on earlier glibc versions) requires the use of
+on earlier glibc versions) using
 .BR syscall (2).
 In that case you will need to define the
 .I linux_dirent
diff --git a/man2/io_cancel.2 b/man2/io_cancel.2
index 1bea257ec..8bcd9c195 100644
--- a/man2/io_cancel.2
+++ b/man2/io_cancel.2
@@ -68,7 +68,7 @@ The asynchronous I/O system calls first appeared in Linux 2.5.
 is Linux-specific and should not be used
 in programs that are intended to be portable.
 .SH NOTES
-Glibc does not provide a wrapper function for this system call.
+Glibc does not provide a wrapper for this system call.
 You could invoke it using
 .BR syscall (2).
 But instead, you probably want to use the
diff --git a/man2/io_destroy.2 b/man2/io_destroy.2
index dc9633f5a..89defd867 100644
--- a/man2/io_destroy.2
+++ b/man2/io_destroy.2
@@ -57,7 +57,7 @@ The asynchronous I/O system calls first appeared in Linux 2.5.
 is Linux-specific and should not be used in programs
 that are intended to be portable.
 .SH NOTES
-Glibc does not provide a wrapper function for this system call.
+Glibc does not provide a wrapper for this system call.
 You could invoke it using
 .BR syscall (2).
 But instead, you probably want to use the
diff --git a/man2/io_getevents.2 b/man2/io_getevents.2
index c9a608e06..0f7c17dbf 100644
--- a/man2/io_getevents.2
+++ b/man2/io_getevents.2
@@ -94,7 +94,7 @@ The asynchronous I/O system calls first appeared in Linux 2.5.
 is Linux-specific and should not be used in
 programs that are intended to be portable.
 .SH NOTES
-Glibc does not provide a wrapper function for this system call.
+Glibc does not provide a wrapper for this system call.
 You could invoke it using
 .BR syscall (2).
 But instead, you probably want to use the
diff --git a/man2/io_setup.2 b/man2/io_setup.2
index 5168ee445..e08d19bb8 100644
--- a/man2/io_setup.2
+++ b/man2/io_setup.2
@@ -72,7 +72,7 @@ The asynchronous I/O system calls first appeared in Linux 2.5.
 is Linux-specific and should not be used in programs
 that are intended to be portable.
 .SH NOTES
-Glibc does not provide a wrapper function for this system call.
+Glibc does not provide a wrapper for this system call.
 You could invoke it using
 .BR syscall (2).
 But instead, you probably want to use the
diff --git a/man2/io_submit.2 b/man2/io_submit.2
index bcbcf43b9..6cdd018a5 100644
--- a/man2/io_submit.2
+++ b/man2/io_submit.2
@@ -247,7 +247,7 @@ The asynchronous I/O system calls first appeared in Linux 2.5.
 is Linux-specific and should not be used in
 programs that are intended to be portable.
 .SH NOTES
-Glibc does not provide a wrapper function for this system call.
+Glibc does not provide a wrapper for this system call.
 You could invoke it using
 .BR syscall (2).
 But instead, you probably want to use the
diff --git a/man2/kexec_load.2 b/man2/kexec_load.2
index a7114545a..4951eb5c3 100644
--- a/man2/kexec_load.2
+++ b/man2/kexec_load.2
@@ -335,8 +335,7 @@ system call first appeared in Linux 3.17.
 .SH CONFORMING TO
 These system calls are Linux-specific.
 .SH NOTES
-Currently, there is no glibc support for these system calls.
-Call them using
+Glibc does not provide a wrapper for this system call; call it using
 .BR syscall (2).
 .SH SEE ALSO
 .BR reboot (2),
diff --git a/man2/keyctl.2 b/man2/keyctl.2
index f37cae8df..9311100cf 100644
--- a/man2/keyctl.2
+++ b/man2/keyctl.2
@@ -1953,7 +1953,7 @@ This system call first appeared in Linux 2.6.10.
 .SH CONFORMING TO
 This system call is a nonstandard Linux extension.
 .SH NOTES
-No wrapper for this system call is provided in glibc.
+Glibc does not provide a wrapper for this system call.
 A wrapper is provided in the
 .IR libkeyutils
 library.
diff --git a/man2/pidfd_getfd.2 b/man2/pidfd_getfd.2
index 9312b6f92..1a1319aae 100644
--- a/man2/pidfd_getfd.2
+++ b/man2/pidfd_getfd.2
@@ -121,7 +121,7 @@ first appeared in Linux 5.6.
 .BR pidfd_getfd ()
 is Linux specific.
 .SH NOTES
-Currently, there is no glibc wrapper for this system call; call it using
+Glibc does not provide a wrapper for this system call; call it using
 .BR syscall (2).
 .PP
 For a description of PID file descriptors, see
diff --git a/man2/pidfd_open.2 b/man2/pidfd_open.2
index 1b0c5e0d4..b6a321562 100644
--- a/man2/pidfd_open.2
+++ b/man2/pidfd_open.2
@@ -91,7 +91,7 @@ first appeared in Linux 5.3.
 .BR pidfd_open ()
 is Linux specific.
 .SH NOTES
-Currently, there is no glibc wrapper for this system call; call it using
+Glibc does not provide a wrapper for this system call; call it using
 .BR syscall (2).
 .PP
 The following code sequence can be used to obtain a file descriptor
diff --git a/man2/pidfd_send_signal.2 b/man2/pidfd_send_signal.2
index ffbfd1796..7b1dc782d 100644
--- a/man2/pidfd_send_signal.2
+++ b/man2/pidfd_send_signal.2
@@ -135,7 +135,7 @@ first appeared in Linux 5.1.
 .BR pidfd_send_signal ()
 is Linux specific.
 .SH NOTES
-Currently, there is no glibc wrapper for this system call; call it using
+Glibc does not provide a wrapper for this system call; call it using
 .BR syscall (2).
 .\"
 .SS PID file descriptors
diff --git a/man2/request_key.2 b/man2/request_key.2
index 6b041d0c4..997c221b7 100644
--- a/man2/request_key.2
+++ b/man2/request_key.2
@@ -439,7 +439,7 @@ in Linux 2.6.13.
 .SH CONFORMING TO
 This system call is a nonstandard Linux extension.
 .SH NOTES
-No wrapper for this system call is provided in glibc.
+Glibc does not provide a wrapper for this system call.
 A wrapper is provided in the
 .IR libkeyutils
 package.
diff --git a/man2/s390_guarded_storage.2 b/man2/s390_guarded_storage.2
index c3ab3bc85..c20230786 100644
--- a/man2/s390_guarded_storage.2
+++ b/man2/s390_guarded_storage.2
@@ -144,9 +144,8 @@ This Linux-specific system call is available only on the s390 architecture.
 .PP
 The guarded storage facility is available beginning with System z14.
 .SH NOTES
-Glibc does not provide a wrapper for this system call, use
+Glibc does not provide a wrapper for this system call; call it using
 .BR syscall (2)
-to call it.
 .PP
 The description of the guarded storage facility along with related
 instructions and Guarded Storage Control Block and
diff --git a/man2/s390_pci_mmio_write.2 b/man2/s390_pci_mmio_write.2
index 2ccd630ab..5897c967e 100644
--- a/man2/s390_pci_mmio_write.2
+++ b/man2/s390_pci_mmio_write.2
@@ -103,8 +103,7 @@ These system calls are available since Linux 3.19.
 This Linux-specific system call is available only on the s390 architecture.
 The required PCI support is available beginning with System z EC12.
 .SH NOTES
-Glibc does not provide a wrapper for this system call, use
+Glibc does not provide wrappers for these system calls; call them using
 .BR syscall (2)
-to call it.
 .SH SEE ALSO
 .BR syscall (2)
diff --git a/man2/s390_runtime_instr.2 b/man2/s390_runtime_instr.2
index 0f4a704de..71e391fe9 100644
--- a/man2/s390_runtime_instr.2
+++ b/man2/s390_runtime_instr.2
@@ -97,9 +97,8 @@ This Linux-specific system call is available only on the s390 architecture.
 The run-time instrumentation facility is available
 beginning with System z EC12.
 .SH NOTES
-Glibc does not provide a wrapper for this system call, use
+Glibc does not provide a wrapper for this system call; call it using
 .BR syscall (2)
-to call it.
 .PP
 The
 .I asm/runtime_instr.h
diff --git a/man2/s390_sthyi.2 b/man2/s390_sthyi.2
index 70871286b..91fc622bc 100644
--- a/man2/s390_sthyi.2
+++ b/man2/s390_sthyi.2
@@ -126,9 +126,8 @@ This system call is available since Linux 4.15.
 .SH CONFORMING TO
 This Linux-specific system call is available only on the s390 architecture.
 .SH NOTES
-Glibc does not provide a wrapper for this system call, use
+Glibc does not provide a wrapper for this system call; call it using
 .BR syscall (2)
-to call it.
 .PP
 For details of the STHYI instruction, see
 .UR https://www.ibm.com\:/support\:/knowledgecenter\:/SSB27U_6.3.0\:/com.ibm.zvm.v630.hcpb4\:/hcpb4sth.htm
diff --git a/man2/seccomp.2 b/man2/seccomp.2
index 4600c51d6..181e89bfc 100644
--- a/man2/seccomp.2
+++ b/man2/seccomp.2
@@ -858,6 +858,9 @@ Tile (since Linux 4.3)
 PA-RISC (since Linux 4.6)
 .\" User mode Linux since Linux 4.6
 .PD
+.PP
+Glibc does not provide a wrapper for this system call; call it using
+.BR syscall (2).
 .\"
 .SS Caveats
 There are various subtleties to consider when applying seccomp filters
diff --git a/man2/sysctl.2 b/man2/sysctl.2
index 72f0af6f3..0ed68df00 100644
--- a/man2/sysctl.2
+++ b/man2/sysctl.2
@@ -120,8 +120,7 @@ Note that on older kernels where this system call still exists,
 it is available only if the kernel was configured with the
 .B CONFIG_SYSCTL_SYSCALL
 option.
-Furthermore,
-glibc does not provide a wrapper for this system call,
+Furthermore, glibc does not provide a wrapper for this system call,
 necessitating the use of
 .BR syscall (2).
 .SH BUGS
-- 
2.29.2