get_nprocs.3, get_nprocs_conf.3, program_invocation_name.3, sysvipc.7: Match page...

Manually tweak a few pages that weren't covered by the scripts
used in the 2 previous commits.

On 10/30/22 23:00, G. Branden Robinson wrote:
> For those to whom this change is coming as an unpleasant surprise, the
> forthcoming groff 1.23.0 features an option that will reverse this
> change at rendering time.
>
>  From groff_man(7):
>
>     -rCT=1 Capitalize titles, setting the man page title (the first
>            argument to .TH) in full capitals in headers and footers.
>            This transformation is off by default because it discards
>            case distinction information.
>
> This register can also be set in a site-local "man.local" file to force
> it on for all pages.  On Debian-based systems, this file is in
> /etc/groff.  The following line will do the trick.
>
> .nr CT 1
>
> The groff_man_style(7) man page offers further examples of such
> rendering customization.
>
>     /usr/local/share/groff/site-tmac/man.local
>            Put site‐local changes and customizations into this file.
>
>                   .\" Use narrower indentation on terminals and similar.
>                   .if n .nr IN 4n
>                   .\" Put only one space after the end of a sentence.
>                   .ss 12 0 \" See groff(7).
>                   .\" Keep pages narrow even on wide terminals.
>                   .if n .if \n[LL]>78n .nr LL 78n
>                   .\" Ensure hyperlinks are enabled for terminals.
>                   .nr U 1
>
>            On multi‐user systems, it is more considerate to users whose
>            preferences may differ from the administrator’s to be less
>            aggressive with such settings, or to permit their override
>            with a user‐specific man.local file.  This can be achieved by
>            placing one or both of following requests at the end of the
>            site‐local file.
>                   .soquiet \V[XDG_CONFIG_HOME]/man.local
>                   .soquiet \V[HOME]/.man.local
>            However, a security‐sandboxed man(1) program may lack
>            permission to open such files.

Cc: Ingo Schwarze <schwarze@openbsd.org>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

diff --git a/man3/get_nprocs.3 b/man3/get_nprocs.3
index 63c03bac7e32b3fc6a8450f4bfe1c75d5694c60b..98478cb8016c500f2a2fe4127bb093642c8d9635 100644 (file)
--- a/man3/get_nprocs.3
+++ b/man3/get_nprocs.3
@@ -1 +1,95 @@
-.so man3/get_nprocs_conf.3
+.\" Copyright (c) 2012, Petr Benas
+.\" and Copyright (c) 2012, Michael Kerrisk <mtk.man-pages@gmail.com>
+.\"
+.\" SPDX-License-Identifier: Linux-man-pages-copyleft
+.\"
+.TH get_nprocs 3 (date) "Linux man-pages (unreleased)"
+.SH NAME
+get_nprocs, get_nprocs_conf \- get number of processors
+.SH LIBRARY
+Standard C library
+.RI ( libc ", " \-lc )
+.SH SYNOPSIS
+.nf
+.B #include <sys/sysinfo.h>
+.PP
+.B int get_nprocs(void);
+.B int get_nprocs_conf(void);
+.fi
+.SH DESCRIPTION
+The function
+.BR get_nprocs_conf ()
+returns the number of processors configured by the operating system.
+.PP
+The function
+.BR get_nprocs ()
+returns the number of processors currently available in the system.
+This may be less than the number returned by
+.BR get_nprocs_conf ()
+because processors may be offline (e.g., on hotpluggable systems).
+.SH RETURN VALUE
+As given in DESCRIPTION.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.ad l
+.nh
+.TS
+allbox;
+lbx lb lb
+l l l.
+Interface      Attribute       Value
+T{
+.BR get_nprocs (),
+.BR get_nprocs_conf ()
+T}     Thread safety   MT-Safe
+.TE
+.hy
+.ad
+.sp 1
+.SH STANDARDS
+These functions are GNU extensions.
+.SH NOTES
+The current
+.\" glibc 2.15
+implementation of these functions is rather expensive,
+since they open and parse files in the
+.I /sys
+filesystem each time they are called.
+.PP
+The following
+.BR sysconf (3)
+calls make use of the functions documented on this page
+to return the same information.
+.PP
+.in +4n
+.EX
+np = sysconf(_SC_NPROCESSORS_CONF);     /* processors configured */
+np = sysconf(_SC_NPROCESSORS_ONLN);     /* processors available */
+.EE
+.in
+.SH EXAMPLES
+The following example shows how
+.BR get_nprocs ()
+and
+.BR get_nprocs_conf ()
+can be used.
+.PP
+.\" SRC BEGIN (get_nprocs_conf.c)
+.EX
+#include <stdio.h>
+#include <stdlib.h>
+#include <sys/sysinfo.h>
+
+int
+main(void)
+{
+    printf("This system has %d processors configured and "
+            "%d processors available.\en",
+            get_nprocs_conf(), get_nprocs());
+    exit(EXIT_SUCCESS);
+}
+.EE
+.\" SRC END
+.SH SEE ALSO
+.BR nproc (1)

diff --git a/man3/get_nprocs_conf.3 b/man3/get_nprocs_conf.3
index 1cf7f2070a5f4672a50caf51669ad81391afb0e3..7de3e2b314dec96d73624409bfcc569a9c88005e 100644 (file)
--- a/man3/get_nprocs_conf.3
+++ b/man3/get_nprocs_conf.3
@@ -1,95 +1 @@
-.\" Copyright (c) 2012, Petr Benas
-.\" and Copyright (c) 2012, Michael Kerrisk <mtk.man-pages@gmail.com>
-.\"
-.\" SPDX-License-Identifier: Linux-man-pages-copyleft
-.\"
-.TH GET_NPROCS 3 (date) "Linux man-pages (unreleased)"
-.SH NAME
-get_nprocs, get_nprocs_conf \- get number of processors
-.SH LIBRARY
-Standard C library
-.RI ( libc ", " \-lc )
-.SH SYNOPSIS
-.nf
-.B #include <sys/sysinfo.h>
-.PP
-.B int get_nprocs(void);
-.B int get_nprocs_conf(void);
-.fi
-.SH DESCRIPTION
-The function
-.BR get_nprocs_conf ()
-returns the number of processors configured by the operating system.
-.PP
-The function
-.BR get_nprocs ()
-returns the number of processors currently available in the system.
-This may be less than the number returned by
-.BR get_nprocs_conf ()
-because processors may be offline (e.g., on hotpluggable systems).
-.SH RETURN VALUE
-As given in DESCRIPTION.
-.SH ATTRIBUTES
-For an explanation of the terms used in this section, see
-.BR attributes (7).
-.ad l
-.nh
-.TS
-allbox;
-lbx lb lb
-l l l.
-Interface      Attribute       Value
-T{
-.BR get_nprocs (),
-.BR get_nprocs_conf ()
-T}     Thread safety   MT-Safe
-.TE
-.hy
-.ad
-.sp 1
-.SH STANDARDS
-These functions are GNU extensions.
-.SH NOTES
-The current
-.\" glibc 2.15
-implementation of these functions is rather expensive,
-since they open and parse files in the
-.I /sys
-filesystem each time they are called.
-.PP
-The following
-.BR sysconf (3)
-calls make use of the functions documented on this page
-to return the same information.
-.PP
-.in +4n
-.EX
-np = sysconf(_SC_NPROCESSORS_CONF);     /* processors configured */
-np = sysconf(_SC_NPROCESSORS_ONLN);     /* processors available */
-.EE
-.in
-.SH EXAMPLES
-The following example shows how
-.BR get_nprocs ()
-and
-.BR get_nprocs_conf ()
-can be used.
-.PP
-.\" SRC BEGIN (get_nprocs_conf.c)
-.EX
-#include <stdio.h>
-#include <stdlib.h>
-#include <sys/sysinfo.h>
-
-int
-main(void)
-{
-    printf("This system has %d processors configured and "
-            "%d processors available.\en",
-            get_nprocs_conf(), get_nprocs());
-    exit(EXIT_SUCCESS);
-}
-.EE
-.\" SRC END
-.SH SEE ALSO
-.BR nproc (1)
+.so man3/get_nprocs.3

diff --git a/man3/program_invocation_name.3 b/man3/program_invocation_name.3
index 6110d826efd701703f9b2cb7a089985be044699e..97d7874708443484238ac94303694c332bcede2c 100644 (file)
--- a/man3/program_invocation_name.3
+++ b/man3/program_invocation_name.3
@@ -21,7 +21,7 @@
 .\" SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 .\" %%%LICENSE_END
 .\"
-.TH INVOCATION_NAME 3 (date) "Linux man-pages (unreleased)"
+.TH program_invocation_name 3 (date) "Linux man-pages (unreleased)"
 .SH NAME
 program_invocation_name, program_invocation_short_name \- \
 obtain name used to invoke calling program

diff --git a/man7/sysvipc.7 b/man7/sysvipc.7
index e801794b0dbfbd79d45d5701a8a87973d4946026..4b3576157514ca72df644a33548b068032c414a0 100644 (file)
--- a/man7/sysvipc.7
+++ b/man7/sysvipc.7
@@ -2,7 +2,7 @@
 .\"
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
-.TH SVIPC 7 (date) "Linux man-pages (unreleased)"
+.TH sysvipc 7 (date) "Linux man-pages (unreleased)"
 .SH NAME
 sysvipc \- System V interprocess communication mechanisms
 .SH DESCRIPTION