diff --git a/man1/iconv.1 b/man1/iconv.1 index 6156ec752..67cf27299 100644 --- a/man1/iconv.1 +++ b/man1/iconv.1 @@ -178,7 +178,7 @@ Usual system default gconv module configuration file. Usual system gconv module configuration cache. .SH CONFORMING TO POSIX.1-2001. -.SH EXAMPLE +.SH EXAMPLES Convert text from the ISO 8859-15 character encoding to UTF-8: .PP .in +4n diff --git a/man1/locale.1 b/man1/locale.1 index fad256a67..d848f37cb 100644 --- a/man1/locale.1 +++ b/man1/locale.1 @@ -136,7 +136,7 @@ Usual default locale archive location. Usual default path for locale definition files. .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES .EX $ \fBlocale\fP LANG=en_US.UTF\-8 diff --git a/man1/localedef.1 b/man1/localedef.1 index 8d79a2f63..dcd4ff90d 100644 --- a/man1/localedef.1 +++ b/man1/localedef.1 @@ -373,7 +373,7 @@ An output file that contains information about formatting of data and time values. .SH CONFORMING TO POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES Compile the locale files for Finnish in the UTF\-8 character set and add it to the default locale archive with the name .BR fi_FI.UTF\-8 : diff --git a/man1/memusage.1 b/man1/memusage.1 index aa5739eb0..4a37e380c 100644 --- a/man1/memusage.1 +++ b/man1/memusage.1 @@ -201,7 +201,7 @@ Exit status is equal to the exit status of profiled program. To report bugs, see .UR http://www.gnu.org/software/libc/bugs.html .UE -.SH EXAMPLE +.SH EXAMPLES Below is a simple program that reallocates a block of memory in cycles that rise to a peak before then cyclically reallocating the memory in smaller blocks that return to zero. diff --git a/man1/memusagestat.1 b/man1/memusagestat.1 index b010a5ded..3d06cec3d 100644 --- a/man1/memusagestat.1 +++ b/man1/memusagestat.1 @@ -82,7 +82,7 @@ Print version information and exit. To report bugs, see .UR http://www.gnu.org/software/libc/bugs.html .UE -.SH EXAMPLE +.SH EXAMPLES See .BR memusage (1). .SH SEE ALSO diff --git a/man1/pldd.1 b/man1/pldd.1 index 5f6eddcb1..83df9c6d1 100644 --- a/man1/pldd.1 +++ b/man1/pldd.1 @@ -103,7 +103,7 @@ was broken: it just hung when executed. .\" glibc commit 1a4c27355e146b6d8cc6487b998462c7fdd1048f This problem was fixed in glibc 2.30, and the fix has been backported to earlier glibc versions in some distributions. -.SH EXAMPLE +.SH EXAMPLES .EX $ \fBecho $$\fP # Display PID of shell 1143 diff --git a/man1/sprof.1 b/man1/sprof.1 index a5788c247..4c841abc2 100644 --- a/man1/sprof.1 +++ b/man1/sprof.1 @@ -76,7 +76,7 @@ Display the program version and exit. The .B sprof command is a GNU extension, not present in POSIX.1. -.SH EXAMPLE +.SH EXAMPLES The following example demonstrates the use of .BR sprof . The example consists of a main program that calls two functions diff --git a/man2/_syscall.2 b/man2/_syscall.2 index 249763221..a51d5b1a8 100644 --- a/man2/_syscall.2 +++ b/man2/_syscall.2 @@ -139,7 +139,7 @@ passed by-value or by-pointer (for aggregates like structs). .\" header file contains the required SYS_foo definition. .\" Otherwise, the use of a _syscall macro is required. .\" -.SH EXAMPLE +.SH EXAMPLES .EX #include #include diff --git a/man2/accept.2 b/man2/accept.2 index 87fe8127b..f4407d932 100644 --- a/man2/accept.2 +++ b/man2/accept.2 @@ -367,7 +367,7 @@ standard wanted to change it into a \fIsize_t\ *\fPC; .\" SunOS 5 has 'size_t *' later POSIX standards and glibc 2.x have .IR "socklen_t\ * ". -.SH EXAMPLE +.SH EXAMPLES See .BR bind (2). .SH SEE ALSO diff --git a/man2/add_key.2 b/man2/add_key.2 index c7520250d..e0dee15c6 100644 --- a/man2/add_key.2 +++ b/man2/add_key.2 @@ -221,7 +221,7 @@ A wrapper is provided in the package. When employing the wrapper in that library, link with .IR \-lkeyutils . -.SH EXAMPLE +.SH EXAMPLES The program below creates a key with the type, description, and payload specified in its command-line arguments, and links that key into the session keyring. diff --git a/man2/bind.2 b/man2/bind.2 index c118c2161..1ea120a4d 100644 --- a/man2/bind.2 +++ b/man2/bind.2 @@ -256,7 +256,7 @@ type, see .SH BUGS The transparent proxy options are not described. .\" FIXME Document transparent proxy options -.SH EXAMPLE +.SH EXAMPLES An example of the use of .BR bind () with Internet domain sockets can be found in diff --git a/man2/chown.2 b/man2/chown.2 index 332516632..1276c5623 100644 --- a/man2/chown.2 +++ b/man2/chown.2 @@ -446,7 +446,7 @@ as the old has got the same syscall number, and .BR chown () got the newly introduced number. -.SH EXAMPLE +.SH EXAMPLES .PP The following program changes the ownership of the file named in its second command-line argument to the value specified in its diff --git a/man2/clock_getres.2 b/man2/clock_getres.2 index d169d90b4..1cc0d830c 100644 --- a/man2/clock_getres.2 +++ b/man2/clock_getres.2 @@ -437,7 +437,7 @@ and .BR CLOCK_THREAD_CPUTIME_ID , on systems that provide such an implementation (i.e., Linux 2.6.12 and later). -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR clock_gettime () and diff --git a/man2/clone.2 b/man2/clone.2 index 69325ef83..9aa6f3aa6 100644 --- a/man2/clone.2 +++ b/man2/clone.2 @@ -1771,7 +1771,7 @@ mypid = syscall(SYS_getpid); Because of the stale-cache problem, as well as other problems noted in .BR getpid (2), the PID caching feature was removed in glibc 2.25. -.SH EXAMPLE +.SH EXAMPLES The following program demonstrates the use of .BR clone () to create a child process that executes in a separate UTS namespace. diff --git a/man2/connect.2 b/man2/connect.2 index 125ca33ef..41296cf4e 100644 --- a/man2/connect.2 +++ b/man2/connect.2 @@ -286,7 +286,7 @@ If fails, consider the state of the socket as unspecified. Portable applications should close the socket and create a new one for reconnecting. -.SH EXAMPLE +.SH EXAMPLES An example of the use of .BR connect () is shown in diff --git a/man2/copy_file_range.2 b/man2/copy_file_range.2 index c0eb62db7..67442d276 100644 --- a/man2/copy_file_range.2 +++ b/man2/copy_file_range.2 @@ -226,7 +226,7 @@ gives filesystems an opportunity to implement "copy acceleration" techniques, such as the use of reflinks (i.e., two or more inodes that share pointers to the same copy-on-write disk blocks) or server-side-copy (in the case of NFS). -.SH EXAMPLE +.SH EXAMPLES .EX #define _GNU_SOURCE #include diff --git a/man2/eventfd.2 b/man2/eventfd.2 index d48f10b43..7917ec93f 100644 --- a/man2/eventfd.2 +++ b/man2/eventfd.2 @@ -357,7 +357,7 @@ The functions perform the read and write operations on an eventfd file descriptor, returning 0 if the correct number of bytes was transferred, or \-1 otherwise. -.SH EXAMPLE +.SH EXAMPLES .PP The following program creates an eventfd file descriptor and then forks to create a child process. diff --git a/man2/execve.2 b/man2/execve.2 index 109c0d57d..72c3ff69b 100644 --- a/man2/execve.2 +++ b/man2/execve.2 @@ -780,7 +780,7 @@ Since UNIX\ V7, both are NULL. .\" .BR execve () .\" that could be exploited for denial of service by a suitably crafted .\" ELF binary. There are no known problems with 2.0.34 or 2.2.15. -.SH EXAMPLE +.SH EXAMPLES The following program is designed to be execed by the second program below. It just echoes its command-line arguments, one per line. .PP diff --git a/man2/fork.2 b/man2/fork.2 index 235a88e50..05f3d23f2 100644 --- a/man2/fork.2 +++ b/man2/fork.2 @@ -309,7 +309,7 @@ The glibc wrapper invokes any fork handlers that have been established using .BR pthread_atfork (3). .\" and does some magic to ensure that getpid(2) returns the right value. -.SH EXAMPLE +.SH EXAMPLES See .BR pipe (2) and diff --git a/man2/futex.2 b/man2/futex.2 index 141ebaa45..c7e3749a8 100644 --- a/man2/futex.2 +++ b/man2/futex.2 @@ -1711,7 +1711,7 @@ various POSIX threads synchronization mechanisms .\" .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\" -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates use of futexes in a program where a parent process and a child process use a pair of futexes located inside a shared anonymous mapping to synchronize access to a shared resource: diff --git a/man2/getdents.2 b/man2/getdents.2 index a56fe02e5..b48e6073c 100644 --- a/man2/getdents.2 +++ b/man2/getdents.2 @@ -228,7 +228,7 @@ instead of these system calls. .PP These calls supersede .BR readdir (2). -.SH EXAMPLE +.SH EXAMPLES .\" FIXME The example program needs to be revised, since it uses the older .\" getdents() system call and the structure with smaller field widths. The program below demonstrates the use of diff --git a/man2/getrlimit.2 b/man2/getrlimit.2 index 5cf1d3388..b240cac5d 100644 --- a/man2/getrlimit.2 +++ b/man2/getrlimit.2 @@ -776,7 +776,7 @@ and .BR getrlimit () as wrapper functions that call .BR prlimit (). -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR prlimit (). .PP diff --git a/man2/getxattr.2 b/man2/getxattr.2 index d0ed96fb9..65f8e4c72 100644 --- a/man2/getxattr.2 +++ b/man2/getxattr.2 @@ -148,7 +148,7 @@ These system calls are Linux-specific. .\" and the SGI XFS development team, .\" .RI < linux-xfs@oss.sgi.com >. .\" Please send any bug reports or comments to these addresses. -.SH EXAMPLE +.SH EXAMPLES See .BR listxattr (2). .SH SEE ALSO diff --git a/man2/inotify_add_watch.2 b/man2/inotify_add_watch.2 index 78e05e869..dcff071f7 100644 --- a/man2/inotify_add_watch.2 +++ b/man2/inotify_add_watch.2 @@ -140,7 +140,7 @@ is not a directory. Inotify was merged into the 2.6.13 Linux kernel. .SH CONFORMING TO This system call is Linux-specific. -.SH EXAMPLE +.SH EXAMPLES See .BR inotify (7). .SH SEE ALSO diff --git a/man2/ioctl_fat.2 b/man2/ioctl_fat.2 index be86dfd8e..25fa11d95 100644 --- a/man2/ioctl_fat.2 +++ b/man2/ioctl_fat.2 @@ -243,7 +243,7 @@ was introduced in version 3.11 of the Linux kernel. .SH CONFORMING TO This API is Linux-specific. -.SH EXAMPLE +.SH EXAMPLES .SS Toggling the archive flag The following program demonstrates the usage of .BR ioctl (2) diff --git a/man2/ioctl_getfsmap.2 b/man2/ioctl_getfsmap.2 index 6892946c5..96f7bc750 100644 --- a/man2/ioctl_getfsmap.2 +++ b/man2/ioctl_getfsmap.2 @@ -363,7 +363,7 @@ operation first appeared in Linux 4.12. .SH CONFORMING TO This API is Linux-specific. Not all filesystems support it. -.SH EXAMPLE +.SH EXAMPLES See .I io/fsmap.c in the diff --git a/man2/ioctl_ns.2 b/man2/ioctl_ns.2 index 7d2196b49..9e45ff094 100644 --- a/man2/ioctl_ns.2 +++ b/man2/ioctl_ns.2 @@ -186,7 +186,7 @@ does not refer to a file. .SH CONFORMING TO Namespaces and the operations described on this page are a Linux-specific. -.SH EXAMPLE +.SH EXAMPLES The example shown below uses the .BR ioctl (2) operations described above to perform simple diff --git a/man2/ioctl_tty.2 b/man2/ioctl_tty.2 index 63cc14540..d1d314824 100644 --- a/man2/ioctl_tty.2 +++ b/man2/ioctl_tty.2 @@ -549,7 +549,7 @@ Inappropriate .TP .B EPERM Insufficient permission. -.SH EXAMPLE +.SH EXAMPLES Check the condition of DTR on the serial port. .PP .EX diff --git a/man2/ioctl_userfaultfd.2 b/man2/ioctl_userfaultfd.2 index d417e30f3..878fdb6e4 100644 --- a/man2/ioctl_userfaultfd.2 +++ b/man2/ioctl_userfaultfd.2 @@ -679,7 +679,7 @@ operation that queries features availability and reopened before the second .BR UFFDIO_API operation that actually enables the desired features. -.SH EXAMPLE +.SH EXAMPLES See .BR userfaultfd (2). .SH SEE ALSO diff --git a/man2/kcmp.2 b/man2/kcmp.2 index 2fc70c5aa..812c08de2 100644 --- a/man2/kcmp.2 +++ b/man2/kcmp.2 @@ -319,7 +319,7 @@ See .BR clone (2) for some background information on the shared resources referred to on this page. -.SH EXAMPLE +.SH EXAMPLES The program below uses .BR kcmp () to test whether pairs of file descriptors refer to diff --git a/man2/keyctl.2 b/man2/keyctl.2 index 7536d98be..e2968d672 100644 --- a/man2/keyctl.2 +++ b/man2/keyctl.2 @@ -1961,7 +1961,7 @@ When employing the wrapper in that library, link with However, rather than using this system call directly, you probably want to use the various library functions mentioned in the descriptions of individual operations above. -.SH EXAMPLE +.SH EXAMPLES The program below provide subset of the functionality of the .BR request-key (8) program provided by the diff --git a/man2/listen.2 b/man2/listen.2 index 3544d85d5..a71698bf2 100644 --- a/man2/listen.2 +++ b/man2/listen.2 @@ -175,7 +175,7 @@ with the value 128. .\" The following is now rather historic information (MTK, Jun 05) .\" Don't rely on this value in portable applications since BSD .\" (and some BSD-derived systems) limit the backlog to 5. -.SH EXAMPLE +.SH EXAMPLES See .BR bind (2). .SH SEE ALSO diff --git a/man2/listxattr.2 b/man2/listxattr.2 index b10272dbc..98a64a8fe 100644 --- a/man2/listxattr.2 +++ b/man2/listxattr.2 @@ -171,7 +171,7 @@ attribute name list returned by .BR listxattr (7). If the total size of attribute names attached to a file exceeds this limit, it is no longer possible to retrieve the list of attribute names. -.SH EXAMPLE +.SH EXAMPLES The following program demonstrates the usage of .BR listxattr () and diff --git a/man2/membarrier.2 b/man2/membarrier.2 index f67867c65..5d7b1fd6e 100644 --- a/man2/membarrier.2 +++ b/man2/membarrier.2 @@ -270,7 +270,7 @@ Examples where .BR membarrier () can be useful include implementations of Read-Copy-Update libraries and garbage collectors. -.SH EXAMPLE +.SH EXAMPLES Assuming a multithreaded application where "fast_path()" is executed very frequently, and where "slow_path()" is executed infrequently, the following code (x86) can be transformed using diff --git a/man2/memfd_create.2 b/man2/memfd_create.2 index 5a59a2c41..4aa0dbf7f 100644 --- a/man2/memfd_create.2 +++ b/man2/memfd_create.2 @@ -341,7 +341,7 @@ If desired, the second process can apply further seals to impose additional restrictions (so long as the .BR F_SEAL_SEAL seal has not yet been applied). -.SH EXAMPLE +.SH EXAMPLES Below are shown two example programs that demonstrate the use of .BR memfd_create () and the file sealing API. diff --git a/man2/mmap.2 b/man2/mmap.2 index fe99f9f70..09e74d89a 100644 --- a/man2/mmap.2 +++ b/man2/mmap.2 @@ -904,7 +904,7 @@ however, this doesn't work on .BR tmpfs (5) (for example, when using the POSIX shared memory interface documented in .BR shm_overview (7)). -.SH EXAMPLE +.SH EXAMPLES .\" FIXME . Add an example here that uses an anonymous shared region for .\" IPC between parent and child. .PP diff --git a/man2/mprotect.2 b/man2/mprotect.2 index d94b12f3f..3b0931bbc 100644 --- a/man2/mprotect.2 +++ b/man2/mprotect.2 @@ -283,7 +283,7 @@ When called this way, the operation of .BR pkey_mprotect () is equivalent to .BR mprotect (). -.SH EXAMPLE +.SH EXAMPLES .\" sigaction.2 refers to this example .PP The program below demonstrates the use of diff --git a/man2/msgop.2 b/man2/msgop.2 index 88aa9b0af..f992d91a3 100644 --- a/man2/msgop.2 +++ b/man2/msgop.2 @@ -571,7 +571,7 @@ this error was not diagnosed by This bug is fixed .\" commit 4f87dac386cc43d5525da7a939d4b4e7edbea22c in Linux 3.14. -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR msgsnd () and diff --git a/man2/open_by_handle_at.2 b/man2/open_by_handle_at.2 index 27fa71620..78c3220f8 100644 --- a/man2/open_by_handle_at.2 +++ b/man2/open_by_handle_at.2 @@ -467,7 +467,7 @@ in order to produce the .IR mount_fd argument used by .BR open_by_handle_at (). -.SH EXAMPLE +.SH EXAMPLES The two programs below demonstrate the use of .BR name_to_handle_at () and diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2 index 89d267c02..37bb4386f 100644 --- a/man2/perf_event_open.2 +++ b/man2/perf_event_open.2 @@ -3390,7 +3390,7 @@ Various generalized events have had wrong values. For example, retired branches measured the wrong thing on AMD machines until Linux 2.6.35. .\" commit f287d332ce835f77a4f5077d2c0ef1e3f9ea42d2 -.SH EXAMPLE +.SH EXAMPLES The following is a short example that measures the total instruction count of a call to .BR printf (3). diff --git a/man2/pidfd_open.2 b/man2/pidfd_open.2 index f41a58fab..246cabb0e 100644 --- a/man2/pidfd_open.2 +++ b/man2/pidfd_open.2 @@ -193,7 +193,7 @@ furthermore, the file descriptor obtained in this way is .I not pollable and can't be waited on with .BR waitid (2). -.SH EXAMPLE +.SH EXAMPLES The program below opens a PID file descriptor for the process whose PID is specified as its command-line argument. It then uses diff --git a/man2/pidfd_send_signal.2 b/man2/pidfd_send_signal.2 index fbf124412..95e897ff2 100644 --- a/man2/pidfd_send_signal.2 +++ b/man2/pidfd_send_signal.2 @@ -176,7 +176,7 @@ if that process terminates, .BR pidfd_send_signal () fails with the error .BR ESRCH . -.SH EXAMPLE +.SH EXAMPLES .nf #define _GNU_SOURCE #include diff --git a/man2/pipe.2 b/man2/pipe.2 index ca0af8e38..02896171f 100644 --- a/man2/pipe.2 +++ b/man2/pipe.2 @@ -216,7 +216,7 @@ wrapper function transparently deals with this. See .BR syscall (2) for information regarding registers used for storing second file descriptor. -.SH EXAMPLE +.SH EXAMPLES .\" fork.2 refers to this example program. The following program creates a pipe, and then .BR fork (2)s diff --git a/man2/pivot_root.2 b/man2/pivot_root.2 index 199536161..683a17134 100644 --- a/man2/pivot_root.2 +++ b/man2/pivot_root.2 @@ -271,7 +271,7 @@ at that time that the implementation might change before final release. However, the behavior stated in DESCRIPTION has remained consistent since this system call was first implemented and will not change now. -.SH EXAMPLE +.SH EXAMPLES .\" FIXME .\" Would it be better, because simpler, to use unshare(2) .\" rather than clone(2) in the example below? diff --git a/man2/pkey_alloc.2 b/man2/pkey_alloc.2 index 9e0663384..2983cf989 100644 --- a/man2/pkey_alloc.2 +++ b/man2/pkey_alloc.2 @@ -131,7 +131,7 @@ or after it is freed via .BR pkey_free ()), the kernel may make arbitrary changes to the parts of the rights register affecting access to that key. -.SH EXAMPLE +.SH EXAMPLES See .BR pkeys (7). .SH SEE ALSO diff --git a/man2/poll.2 b/man2/poll.2 index 2907eaf15..e2a6c637b 100644 --- a/man2/poll.2 +++ b/man2/poll.2 @@ -477,7 +477,7 @@ notion of the sigset. See the discussion of spurious readiness notifications under the BUGS section of .BR select (2). -.SH EXAMPLE +.SH EXAMPLES The program below opens each of the files named in its command-line arguments and monitors the resulting file descriptors for readiness to read .RB ( POLLIN ). diff --git a/man2/process_vm_readv.2 b/man2/process_vm_readv.2 index 59ad0c178..de78b5843 100644 --- a/man2/process_vm_readv.2 +++ b/man2/process_vm_readv.2 @@ -299,7 +299,7 @@ when using, for example, shared memory or pipes). .\" Original user is MPI, http://www.mcs.anl.gov/research/projects/mpi/ .\" See also some benchmarks at http://lwn.net/Articles/405284/ .\" and http://marc.info/?l=linux-mm&m=130105930902915&w=2 -.SH EXAMPLE +.SH EXAMPLES The following code sample demonstrates the use of .BR process_vm_readv (). It reads 20 bytes at the address 0x10000 from the process with PID 10 diff --git a/man2/readlink.2 b/man2/readlink.2 index b540c2e3c..2a3645a39 100644 --- a/man2/readlink.2 +++ b/man2/readlink.2 @@ -272,7 +272,7 @@ glibc constructs a pathname based on the symbolic link in that corresponds to the .IR dirfd argument. -.SH EXAMPLE +.SH EXAMPLES The following program allocates the buffer needed by .BR readlink () dynamically from the information provided by diff --git a/man2/readv.2 b/man2/readv.2 index af27aa63e..30fc4f31a 100644 --- a/man2/readv.2 +++ b/man2/readv.2 @@ -408,7 +408,7 @@ that the system is running a Linux kernel older than version 2.6.18 And since glibc 2.20 (which requires a minimum Linux kernel version of 2.6.32), the glibc wrapper functions always just directly invoke the system calls. -.SH EXAMPLE +.SH EXAMPLES The following code sample demonstrates the use of .BR writev (): .PP diff --git a/man2/recv.2 b/man2/recv.2 index e90477e1d..6d08e919a 100644 --- a/man2/recv.2 +++ b/man2/recv.2 @@ -545,7 +545,7 @@ See .BR recvmmsg (2) for information about a Linux-specific system call that can be used to receive multiple datagrams in a single call. -.SH EXAMPLE +.SH EXAMPLES An example of the use of .BR recvfrom () is shown in diff --git a/man2/recvmmsg.2 b/man2/recvmmsg.2 index 1be4c5d72..13bf1def0 100644 --- a/man2/recvmmsg.2 +++ b/man2/recvmmsg.2 @@ -189,7 +189,7 @@ The error code is expected to be returned on a subsequent call to In the current implementation, however, the error code can be overwritten in the meantime by an unrelated network event on a socket, for example an incoming ICMP packet. -.SH EXAMPLE +.SH EXAMPLES .PP The following program uses .BR recvmmsg () diff --git a/man2/request_key.2 b/man2/request_key.2 index e895d3a11..e8a8f57e8 100644 --- a/man2/request_key.2 +++ b/man2/request_key.2 @@ -444,7 +444,7 @@ A wrapper is provided in the package. When employing the wrapper in that library, link with .IR \-lkeyutils . -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR request_key (). The diff --git a/man2/sched_setaffinity.2 b/man2/sched_setaffinity.2 index 685515734..1e50f8019 100644 --- a/man2/sched_setaffinity.2 +++ b/man2/sched_setaffinity.2 @@ -303,7 +303,7 @@ counting those which are set, and stop upon reaching the value returned by .BR CPU_COUNT (3) (rather than iterating over the number of bits requested to be allocated). -.SH EXAMPLE +.SH EXAMPLES The program below creates a child process. The parent and child then each assign themselves to a specified CPU and execute identical loops that consume some CPU time. diff --git a/man2/seccomp.2 b/man2/seccomp.2 index 4707f8628..d16efc339 100644 --- a/man2/seccomp.2 +++ b/man2/seccomp.2 @@ -909,7 +909,7 @@ addressing mode modifier yields an immediate mode operand whose value is the size of the .IR seccomp_data buffer. -.SH EXAMPLE +.SH EXAMPLES The program below accepts four or more arguments. The first three arguments are a system call number, a numeric architecture identifier, and an error number. diff --git a/man2/select.2 b/man2/select.2 index deab3b0b2..d56abc34f 100644 --- a/man2/select.2 +++ b/man2/select.2 @@ -710,7 +710,7 @@ system call has the same behavior, but the glibc wrapper hides this behavior by internally copying the .I timeout to a local variable and passing that variable to the system call. -.SH EXAMPLE +.SH EXAMPLES .EX #include #include diff --git a/man2/select_tut.2 b/man2/select_tut.2 index fac9731a5..a41065f09 100644 --- a/man2/select_tut.2 +++ b/man2/select_tut.2 @@ -346,7 +346,7 @@ API provides an interface that is more efficient than and .BR poll (2) when monitoring large numbers of file descriptors. -.SH EXAMPLE +.SH EXAMPLES Here is an example that better demonstrates the true utility of .BR select (). The listing below is a TCP forwarding program that forwards diff --git a/man2/semctl.2 b/man2/semctl.2 index e57519a93..e03e03c6f 100644 --- a/man2/semctl.2 +++ b/man2/semctl.2 @@ -639,7 +639,7 @@ operations. This was rectified .\" commit a5f4db877177d2a3d7ae62a7bac3a5a27e083d7f in Linux 4.6. -.SH EXAMPLE +.SH EXAMPLES See .BR shmop (2). .SH SEE ALSO diff --git a/man2/semget.2 b/man2/semget.2 index 21fda264e..4277abe17 100644 --- a/man2/semget.2 +++ b/man2/semget.2 @@ -313,7 +313,7 @@ The name choice was perhaps unfortunate, .B IPC_NEW would more clearly show its function. -.SH EXAMPLE +.SH EXAMPLES The program shown below uses .BR semget () to create a new semaphore set or retrieve the ID of an existing set. diff --git a/man2/semop.2 b/man2/semop.2 index 6cbb78190..f5529c0da 100644 --- a/man2/semop.2 +++ b/man2/semop.2 @@ -517,7 +517,7 @@ This bug is fixed in kernel 2.6.11. .\" http://marc.theaimsgroup.com/?l=linux-kernel&m=110260821123863&w=2 .\" the fix: .\" http://marc.theaimsgroup.com/?l=linux-kernel&m=110261701025794&w=2 -.SH EXAMPLE +.SH EXAMPLES The following code segment uses .BR semop () to atomically wait for the value of semaphore 0 to become zero, diff --git a/man2/send.2 b/man2/send.2 index 44c9fdb42..a952b9180 100644 --- a/man2/send.2 +++ b/man2/send.2 @@ -458,7 +458,7 @@ Linux may return .B EPIPE instead of .BR ENOTCONN . -.SH EXAMPLE +.SH EXAMPLES An example of the use of .BR sendto () is shown in diff --git a/man2/sendmmsg.2 b/man2/sendmmsg.2 index 88037608c..8a2b0e0a0 100644 --- a/man2/sendmmsg.2 +++ b/man2/sendmmsg.2 @@ -174,7 +174,7 @@ The caller can retry the transmission, starting at the first failed message, but there is no guarantee that, if an error is returned, it will be the same as the one that was lost on the previous call. -.SH EXAMPLE +.SH EXAMPLES The example below uses .BR sendmmsg () to send diff --git a/man2/setns.2 b/man2/setns.2 index d86a6825a..0cfbfb391 100644 --- a/man2/setns.2 +++ b/man2/setns.2 @@ -253,7 +253,7 @@ a new thread is created using .BR clone (2) can be changed using .BR setns (). -.SH EXAMPLE +.SH EXAMPLES The program below takes two or more arguments. The first argument specifies the pathname of a namespace file in an existing .I /proc/[pid]/ns/ diff --git a/man2/shmget.2 b/man2/shmget.2 index ecaf20686..b58dc07fb 100644 --- a/man2/shmget.2 +++ b/man2/shmget.2 @@ -411,7 +411,7 @@ The name choice was perhaps unfortunate, .B IPC_NEW would more clearly show its function. -.SH EXAMPLE +.SH EXAMPLES See .BR shmop (2). .SH SEE ALSO diff --git a/man2/shmop.2 b/man2/shmop.2 index ed30ca911..3495d1a7b 100644 --- a/man2/shmop.2 +++ b/man2/shmop.2 @@ -291,7 +291,7 @@ is the same as the system page size.) The implementation places no intrinsic per-process limit on the number of shared memory segments .RB ( SHMSEG ). -.SH EXAMPLE +.SH EXAMPLES .PP The two programs shown below exchange a string using a shared memory segment. Further details about the programs are given below. diff --git a/man2/sigaction.2 b/man2/sigaction.2 index 744cdfcc4..edae16e0c 100644 --- a/man2/sigaction.2 +++ b/man2/sigaction.2 @@ -1035,7 +1035,7 @@ prevents not only the delivered signal from being masked during execution of the handler, but also the signals specified in .IR sa_mask . This bug was fixed in kernel 2.6.14. -.SH EXAMPLE +.SH EXAMPLES See .BR mprotect (2). .SH SEE ALSO diff --git a/man2/sigaltstack.2 b/man2/sigaltstack.2 index 98d4d9c70..dd2cd84db 100644 --- a/man2/sigaltstack.2 +++ b/man2/sigaltstack.2 @@ -324,7 +324,7 @@ give an error if .B SS_ONSTACK is specified in .IR ss.ss_flags . -.SH EXAMPLE +.SH EXAMPLES The following code segment demonstrates the use of .BR sigaltstack () (and diff --git a/man2/signalfd.2 b/man2/signalfd.2 index 080b8a156..7f82f5d37 100644 --- a/man2/signalfd.2 +++ b/man2/signalfd.2 @@ -444,7 +444,7 @@ and fields are not filled in with the data accompanying a signal sent by .BR sigqueue (3). .\" The fix also was put into 2.6.24.5 -.SH EXAMPLE +.SH EXAMPLES The program below accepts the signals .B SIGINT and diff --git a/man2/socket.2 b/man2/socket.2 index 0b3b90bb8..d75e5b38a 100644 --- a/man2/socket.2 +++ b/man2/socket.2 @@ -485,7 +485,7 @@ families. However, already the BSD man page promises: "The protocol family generally is the same as the address family", and subsequent standards use AF_* everywhere. -.SH EXAMPLE +.SH EXAMPLES An example of the use of .BR socket () is shown in diff --git a/man2/splice.2 b/man2/splice.2 index d1123e310..a401996e4 100644 --- a/man2/splice.2 +++ b/man2/splice.2 @@ -261,7 +261,7 @@ was required to be a pipe. Since Linux 2.6.31, .\" commit 7c77f0b3f9208c339a4b40737bb2cb0f0319bb8d both arguments may refer to pipes. -.SH EXAMPLE +.SH EXAMPLES See .BR tee (2). .SH SEE ALSO diff --git a/man2/spu_create.2 b/man2/spu_create.2 index 875c5dcd3..bacd0c74a 100644 --- a/man2/spu_create.2 +++ b/man2/spu_create.2 @@ -262,7 +262,7 @@ See .UR http://www.bsc.es\:/projects\:/deepcomputing\:/linuxoncell/ .UE for the recommended libraries. -.SH EXAMPLE +.SH EXAMPLES See .BR spu_run (2) for an example of the use of diff --git a/man2/spu_run.2 b/man2/spu_run.2 index 7ab0ad96b..8c5a5bcc2 100644 --- a/man2/spu_run.2 +++ b/man2/spu_run.2 @@ -204,7 +204,7 @@ See .UR http://www.bsc.es\:/projects\:/deepcomputing\:/linuxoncell/ .UE for the recommended libraries. -.SH EXAMPLE +.SH EXAMPLES The following is an example of running a simple, one-instruction SPU program with the .BR spu_run () diff --git a/man2/stat.2 b/man2/stat.2 index 8ef79f8a9..43469d8e5 100644 --- a/man2/stat.2 +++ b/man2/stat.2 @@ -640,7 +640,7 @@ wrapper function is actually called or, on some architectures, .\" strace(1) shows the name "newfstatat" on x86-64 .BR newfstatat (). -.SH EXAMPLE +.SH EXAMPLES The following program calls .BR lstat () and displays selected fields in the returned diff --git a/man2/syscall.2 b/man2/syscall.2 index e3a0ceac1..2fd94db53 100644 --- a/man2/syscall.2 +++ b/man2/syscall.2 @@ -369,7 +369,7 @@ arguments 5 through 8 on the user stack. .PP Note that these tables don't cover the entire calling convention\(emsome architectures may indiscriminately clobber other registers not listed here. -.SH EXAMPLE +.SH EXAMPLES .EX #define _GNU_SOURCE #include diff --git a/man2/sysctl.2 b/man2/sysctl.2 index f7b5318f6..482b5a451 100644 --- a/man2/sysctl.2 +++ b/man2/sysctl.2 @@ -133,7 +133,7 @@ Not all available objects are properly documented. .PP It is not yet possible to change operating system by writing to .IR /proc/sys/kernel/ostype . -.SH EXAMPLE +.SH EXAMPLES .EX #define _GNU_SOURCE #include diff --git a/man2/tee.2 b/man2/tee.2 index 03d043b46..c65cffb9e 100644 --- a/man2/tee.2 +++ b/man2/tee.2 @@ -133,7 +133,7 @@ under the covers, .BR tee () assigns data to the output by merely grabbing a reference to the input. -.SH EXAMPLE +.SH EXAMPLES The example below implements a basic .BR tee (1) program using the diff --git a/man2/timer_create.2 b/man2/timer_create.2 index bab928d1a..9f64843fc 100644 --- a/man2/timer_create.2 +++ b/man2/timer_create.2 @@ -335,7 +335,7 @@ and in glibc versions before 2.17, .\" glibc commit 93a78ac437ba44f493333d7e2a4b0249839ce460 the implementation falls back to this technique on systems running pre-2.6 Linux kernels. -.SH EXAMPLE +.SH EXAMPLES The program below takes two arguments: a sleep period in seconds, and a timer frequency in nanoseconds. The program establishes a handler for the signal it uses for the timer, diff --git a/man2/timer_getoverrun.2 b/man2/timer_getoverrun.2 index 73c3b490f..84242ef46 100644 --- a/man2/timer_getoverrun.2 +++ b/man2/timer_getoverrun.2 @@ -126,7 +126,7 @@ if the timer overrun value exceeds the maximum representable integer, the counter cycles, starting once more from low values. .\" Bug filed: http://bugzilla.kernel.org/show_bug.cgi?id=12665 .\" http://thread.gmane.org/gmane.linux.kernel/113276/ -.SH EXAMPLE +.SH EXAMPLES See .BR timer_create (2). .SH SEE ALSO diff --git a/man2/timer_settime.2 b/man2/timer_settime.2 index e2b5d8c32..9fb8b1acc 100644 --- a/man2/timer_settime.2 +++ b/man2/timer_settime.2 @@ -206,7 +206,7 @@ is negative or greater than 999,999,999. These system calls are available since Linux 2.6. .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES See .BR timer_create (2). .SH SEE ALSO diff --git a/man2/timerfd_create.2 b/man2/timerfd_create.2 index 37a8c73f5..7434c746f 100644 --- a/man2/timerfd_create.2 +++ b/man2/timerfd_create.2 @@ -552,7 +552,7 @@ Currently, .BR timerfd_create () supports fewer types of clock IDs than .BR timer_create (2). -.SH EXAMPLE +.SH EXAMPLES The following program creates a timer and then monitors its progress. The program accepts up to three command-line arguments. The first argument specifies the number of seconds for diff --git a/man2/unshare.2 b/man2/unshare.2 index 7614614e3..d3242be70 100644 --- a/man2/unshare.2 +++ b/man2/unshare.2 @@ -460,7 +460,7 @@ Such functionality may be added in the future, if required. .\"be incrementally added to unshare without affecting legacy .\"applications using unshare. .\" -.SH EXAMPLE +.SH EXAMPLES The program below provides a simple implementation of the .BR unshare (1) command, which unshares one or more namespaces and executes the diff --git a/man2/userfaultfd.2 b/man2/userfaultfd.2 index ba21ae29b..4a9232a55 100644 --- a/man2/userfaultfd.2 +++ b/man2/userfaultfd.2 @@ -483,7 +483,7 @@ might be created. In this case, a spurious .B UFFD_EVENT_FORK will be delivered to the userfaultfd monitor. -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of the userfaultfd mechanism. The program creates two threads, one of which acts as the page-fault handler for the process, for the pages in a demand-page zero diff --git a/man2/wait.2 b/man2/wait.2 index a2327d23d..eda36bb68 100644 --- a/man2/wait.2 +++ b/man2/wait.2 @@ -618,7 +618,7 @@ is NULL, succeeds, and returns the process ID of the waited-for child. Applications should avoid relying on this inconsistent, nonstandard, and unnecessary feature. -.SH EXAMPLE +.SH EXAMPLES .\" fork.2 refers to this example program. The following program demonstrates the use of .BR fork (2) diff --git a/man3/CPU_SET.3 b/man3/CPU_SET.3 index 0a020a82e..db5da81ee 100644 --- a/man3/CPU_SET.3 +++ b/man3/CPU_SET.3 @@ -312,7 +312,7 @@ and less efficient operation of the macros that operate on dynamically allocated CPU sets. These bugs are fixed in glibc 2.9. .\" http://sourceware.org/bugzilla/show_bug.cgi?id=7029 -.SH EXAMPLE +.SH EXAMPLES The following program demonstrates the use of some of the macros used for dynamically allocated CPU sets. .PP diff --git a/man3/__ppc_get_timebase.3 b/man3/__ppc_get_timebase.3 index 6622f3138..ff254f7ef 100644 --- a/man3/__ppc_get_timebase.3 +++ b/man3/__ppc_get_timebase.3 @@ -63,7 +63,7 @@ has been provided since version 2.16 and has been available since version 2.17. .SH CONFORMING TO Both functions are nonstandard GNU extensions. -.SH EXAMPLE +.SH EXAMPLES The following program will calculate the time, in microseconds, spent between two calls to .BR __ppc_get_timebase (). diff --git a/man3/__setfpucw.3 b/man3/__setfpucw.3 index 01b4334eb..dedf17af7 100644 --- a/man3/__setfpucw.3 +++ b/man3/__setfpucw.3 @@ -48,7 +48,7 @@ and macros from .I can be used. -.SH EXAMPLE +.SH EXAMPLES .B __setfpucw(0x1372) .PP Set FPU control word on the i386 architecture to diff --git a/man3/aio_cancel.3 b/man3/aio_cancel.3 index 4897c1a0c..a94e2655a 100644 --- a/man3/aio_cancel.3 +++ b/man3/aio_cancel.3 @@ -125,7 +125,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES See .BR aio (7). .SH SEE ALSO diff --git a/man3/aio_error.3 b/man3/aio_error.3 index 7fccd2dfd..ff264934a 100644 --- a/man3/aio_error.3 +++ b/man3/aio_error.3 @@ -93,7 +93,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES See .BR aio (7). .SH SEE ALSO diff --git a/man3/aio_read.3 b/man3/aio_read.3 index 455a3c5dc..54c3c3097 100644 --- a/man3/aio_read.3 +++ b/man3/aio_read.3 @@ -155,7 +155,7 @@ The memory areas involved must remain valid. Simultaneous I/O operations specifying the same .I aiocb structure produce undefined results. -.SH EXAMPLE +.SH EXAMPLES See .BR aio (7). .SH SEE ALSO diff --git a/man3/aio_return.3 b/man3/aio_return.3 index 237e569e8..baea7cb49 100644 --- a/man3/aio_return.3 +++ b/man3/aio_return.3 @@ -89,7 +89,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES See .BR aio (7). .SH SEE ALSO diff --git a/man3/atexit.3 b/man3/atexit.3 index 139d90f87..e5faa41d4 100644 --- a/man3/atexit.3 +++ b/man3/atexit.3 @@ -143,7 +143,7 @@ Since glibc 2.2.3, .BR on_exit (3)) can be used within a shared library to establish functions that are called when the shared library is unloaded. -.SH EXAMPLE +.SH EXAMPLES .EX #include #include diff --git a/man3/backtrace.3 b/man3/backtrace.3 index 57c8bd7e7..2bfb6ebdb 100644 --- a/man3/backtrace.3 +++ b/man3/backtrace.3 @@ -196,7 +196,7 @@ For systems using the GNU linker, it is necessary to use the linker option. Note that names of "static" functions are not exposed, and won't be available in the backtrace. -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR backtrace () and diff --git a/man3/basename.3 b/man3/basename.3 index e1e1a3128..c880fb3b6 100644 --- a/man3/basename.3 +++ b/man3/basename.3 @@ -178,7 +178,7 @@ Before glibc 2.2.1, the glibc version of .BR dirname () did not correctly handle pathnames with trailing \(aq/\(aq characters, and generated a segfault if given a NULL argument. -.SH EXAMPLE +.SH EXAMPLES The following code snippet demonstrates the use of .BR basename () and diff --git a/man3/bsearch.3 b/man3/bsearch.3 index b10a4dda2..63ca0c899 100644 --- a/man3/bsearch.3 +++ b/man3/bsearch.3 @@ -89,7 +89,7 @@ T} Thread safety MT-Safe .sp 1 .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008, C89, C99, SVr4, 4.3BSD. -.SH EXAMPLE +.SH EXAMPLES The example below first sorts an array of structures using .BR qsort (3), then retrieves desired elements using diff --git a/man3/bswap.3 b/man3/bswap.3 index 0ce7d6997..6975aabfa 100644 --- a/man3/bswap.3 +++ b/man3/bswap.3 @@ -42,7 +42,7 @@ These macros return the value of their argument with the bytes reversed. These macros always succeed. .SH CONFORMING TO These macros are GNU extensions. -.SH EXAMPLE +.SH EXAMPLES The program below swaps the bytes of the 8-byte integer supplied as its command-line argument. The following shell session demonstrates the use of the program: diff --git a/man3/cacos.3 b/man3/cacos.3 index 37f4ca13e..a1ce6fd1b 100644 --- a/man3/cacos.3 +++ b/man3/cacos.3 @@ -49,7 +49,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO C99, POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES .EX /* Link with "\-lm" */ diff --git a/man3/cacosh.3 b/man3/cacosh.3 index 8abc31d21..36841ff80 100644 --- a/man3/cacosh.3 +++ b/man3/cacosh.3 @@ -52,7 +52,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO C99, POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES .EX /* Link with "\-lm" */ diff --git a/man3/catan.3 b/man3/catan.3 index 582d3f94f..81be2ed46 100644 --- a/man3/catan.3 +++ b/man3/catan.3 @@ -47,7 +47,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO C99, POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES .EX /* Link with "\-lm" */ diff --git a/man3/catanh.3 b/man3/catanh.3 index 1ebd2b2b8..1f45b3e95 100644 --- a/man3/catanh.3 +++ b/man3/catanh.3 @@ -49,7 +49,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO C99, POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES .EX /* Link with "\-lm" */ diff --git a/man3/clock_getcpuclockid.3 b/man3/clock_getcpuclockid.3 index 5d96fec45..3db221f24 100644 --- a/man3/clock_getcpuclockid.3 +++ b/man3/clock_getcpuclockid.3 @@ -109,7 +109,7 @@ with a of 0, is the same as using the clock ID .BR CLOCK_PROCESS_CPUTIME_ID . -.SH EXAMPLE +.SH EXAMPLES The example program below obtains the CPU-time clock ID of the process whose ID is given on the command line, and then uses diff --git a/man3/cmsg.3 b/man3/cmsg.3 index d1209d95a..2c6e39fbe 100644 --- a/man3/cmsg.3 +++ b/man3/cmsg.3 @@ -186,7 +186,7 @@ and are constant expressions (assuming their argument is constant), meaning that these values can be used to declare the size of global variables. This may not be portable, however. -.SH EXAMPLE +.SH EXAMPLES This code looks for the .B IP_TTL option in a received ancillary buffer: diff --git a/man3/confstr.3 b/man3/confstr.3 index dcf5426f9..0171349b5 100644 --- a/man3/confstr.3 +++ b/man3/confstr.3 @@ -140,7 +140,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES The following code fragment determines the path where to find the POSIX.2 system utilities: .PP diff --git a/man3/div.3 b/man3/div.3 index c9bc04970..2bf35f958 100644 --- a/man3/div.3 +++ b/man3/div.3 @@ -104,7 +104,7 @@ The functions and .BR imaxdiv () were added in C99. -.SH EXAMPLE +.SH EXAMPLES After .PP .in +4n diff --git a/man3/dl_iterate_phdr.3 b/man3/dl_iterate_phdr.3 index 41605185a..0eb668041 100644 --- a/man3/dl_iterate_phdr.3 +++ b/man3/dl_iterate_phdr.3 @@ -243,7 +243,7 @@ is the main program. For the main program, the .I dlpi_name field will be an empty string. -.SH EXAMPLE +.SH EXAMPLES The following program displays a list of pathnames of the shared objects it has loaded. For each shared object, the program lists some information diff --git a/man3/dlerror.3 b/man3/dlerror.3 index 475f2cd7f..a69f95695 100644 --- a/man3/dlerror.3 +++ b/man3/dlerror.3 @@ -81,7 +81,7 @@ calls. .\" .in .SS History This function is part of the dlopen API, derived from SunOS. -.SH EXAMPLE +.SH EXAMPLES See .BR dlopen (3). .SH SEE ALSO diff --git a/man3/dlinfo.3 b/man3/dlinfo.3 index 2606ec609..6b83cdc75 100644 --- a/man3/dlinfo.3 +++ b/man3/dlinfo.3 @@ -241,7 +241,7 @@ This function derives from the Solaris function of the same name and also appears on some other systems. The sets of requests supported by the various implementations overlaps only partially. -.SH EXAMPLE +.SH EXAMPLES The program below opens a shared objects using .BR dlopen (3) and then uses the diff --git a/man3/dlopen.3 b/man3/dlopen.3 index 3bf225154..a5ee54a18 100644 --- a/man3/dlopen.3 +++ b/man3/dlopen.3 @@ -544,7 +544,7 @@ results in a program crash .\" https://sourceware.org/bugzilla/show_bug.cgi?id=18684 if the call is made from any object loaded in a namespace other than the initial namespace. -.SH EXAMPLE +.SH EXAMPLES The program below loads the (glibc) math library, looks up the address of the .BR cos (3) diff --git a/man3/dlsym.3 b/man3/dlsym.3 index 5ea151209..13a14bc62 100644 --- a/man3/dlsym.3 +++ b/man3/dlsym.3 @@ -166,7 +166,7 @@ The function is part of the dlopen API, derived from SunOS. That system does not have .BR dlvsym (). -.SH EXAMPLE +.SH EXAMPLES See .BR dlopen (3). .SH SEE ALSO diff --git a/man3/duplocale.3 b/man3/duplocale.3 index c675d64a0..0c1f0f31a 100644 --- a/man3/duplocale.3 +++ b/man3/duplocale.3 @@ -115,7 +115,7 @@ Each locale object created by .BR duplocale () should be deallocated using .BR freelocale (3). -.SH EXAMPLE +.SH EXAMPLES The program below uses .BR uselocale (3) and diff --git a/man3/encrypt.3 b/man3/encrypt.3 index fb7f87e2f..adca287a8 100644 --- a/man3/encrypt.3 +++ b/man3/encrypt.3 @@ -163,7 +163,7 @@ See .BR crypt (3). .SS Features in glibc In glibc 2.2, these functions use the DES algorithm. -.SH EXAMPLE +.SH EXAMPLES .EX #define _XOPEN_SOURCE #include diff --git a/man3/end.3 b/man3/end.3 index 185615789..e87ab60ff 100644 --- a/man3/end.3 +++ b/man3/end.3 @@ -73,7 +73,7 @@ or Use .BR sbrk (2) with an argument of zero to find the current value of the program break. -.SH EXAMPLE +.SH EXAMPLES When run, the program below produces output such as the following: .PP .in +4n diff --git a/man3/endian.3 b/man3/endian.3 index 4ff655858..f5a5c471d 100644 --- a/man3/endian.3 +++ b/man3/endian.3 @@ -127,7 +127,7 @@ on all UNIX systems. On the other hand, the fact that they were designed for use in the context of TCP/IP means that they lack the 64-bit and little-endian variants described in this page. -.SH EXAMPLE +.SH EXAMPLES The program below display the results of converting an integer from host byte order to both little-endian and big-endian byte order. Since host byte order is either little-endian or big-endian, diff --git a/man3/envz_add.3 b/man3/envz_add.3 index 94ded8737..7cdf0893d 100644 --- a/man3/envz_add.3 +++ b/man3/envz_add.3 @@ -138,7 +138,7 @@ T} Thread safety MT-Safe .SH CONFORMING TO These functions are a GNU extension. Handle with care. -.SH EXAMPLE +.SH EXAMPLES .EX #include #include diff --git a/man3/err.3 b/man3/err.3 index d163b6492..d009042d6 100644 --- a/man3/err.3 +++ b/man3/err.3 @@ -138,7 +138,7 @@ These functions are nonstandard BSD extensions. .\" .BR warn () .\" functions first appeared in .\" 4.4BSD. -.SH EXAMPLE +.SH EXAMPLES Display the current .I errno information string and exit: diff --git a/man3/fmemopen.3 b/man3/fmemopen.3 index efac77c93..b1fcc9eac 100644 --- a/man3/fmemopen.3 +++ b/man3/fmemopen.3 @@ -278,7 +278,7 @@ silently changed the ABI: previously, .BR fmemopen () ignored \(aqb\(aq in .IR mode . -.SH EXAMPLE +.SH EXAMPLES The program below uses .BR fmemopen () to open an input buffer, and diff --git a/man3/fmtmsg.3 b/man3/fmtmsg.3 index c4b4901e4..4bd04a006 100644 --- a/man3/fmtmsg.3 +++ b/man3/fmtmsg.3 @@ -266,7 +266,7 @@ are described in POSIX.1-2001 and POSIX.1-2008. System V and UnixWare man pages tell us that these functions have been replaced by "pfmt() and addsev()" or by "pfmt(), vpfmt(), lfmt(), and vlfmt()", and will be removed later. -.SH EXAMPLE +.SH EXAMPLES .EX #include #include diff --git a/man3/fopencookie.3 b/man3/fopencookie.3 index 909881c7b..f7803936c 100644 --- a/man3/fopencookie.3 +++ b/man3/fopencookie.3 @@ -256,7 +256,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO This function is a nonstandard GNU extension. -.SH EXAMPLE +.SH EXAMPLES The program below implements a custom stream whose functionality is similar (but not identical) to that available via .BR fmemopen (3). diff --git a/man3/frexp.3 b/man3/frexp.3 index 604d01f0b..97b11ab8e 100644 --- a/man3/frexp.3 +++ b/man3/frexp.3 @@ -118,7 +118,7 @@ The variant returning .I double also conforms to SVr4, 4.3BSD, C89. -.SH EXAMPLE +.SH EXAMPLES The program below produces results such as the following: .PP .in +4n diff --git a/man3/ftok.3 b/man3/ftok.3 index 1b1313a61..8c496591d 100644 --- a/man3/ftok.3 +++ b/man3/ftok.3 @@ -112,7 +112,7 @@ Collisions may easily happen, for example between files on .I /dev/hda1 and files on .IR /dev/sda1 . -.SH EXAMPLE +.SH EXAMPLES See .BR semget (2). .SH SEE ALSO diff --git a/man3/ftw.3 b/man3/ftw.3 index 3821da448..db14de284 100644 --- a/man3/ftw.3 +++ b/man3/ftw.3 @@ -443,7 +443,7 @@ This regression was eventually fixed in glibc 2.30, .\" http://austingroupbugs.net/view.php?id=1121 .\" https://bugzilla.redhat.com/show_bug.cgi?id=1422736 so that the glibc implementation (once more) follows the POSIX specification. -.SH EXAMPLE +.SH EXAMPLES The following program traverses the directory tree under the path named in its first command-line argument, or under the current directory if no argument is supplied. diff --git a/man3/get_nprocs_conf.3 b/man3/get_nprocs_conf.3 index b9740c9df..d6edf4f5c 100644 --- a/man3/get_nprocs_conf.3 +++ b/man3/get_nprocs_conf.3 @@ -81,7 +81,7 @@ np = sysconf(_SC_NPROCESSORS_CONF); /* processors configured */ np = sysconf(_SC_NPROCESSORS_ONLN); /* processors available */ .EE .in -.SH EXAMPLE +.SH EXAMPLES The following example shows how .BR get_nprocs () and diff --git a/man3/get_phys_pages.3 b/man3/get_phys_pages.3 index 3580333da..ddd0eb71a 100644 --- a/man3/get_phys_pages.3 +++ b/man3/get_phys_pages.3 @@ -76,7 +76,7 @@ total_pages = sysconf(_SC_PHYS_PAGES); /* total pages */ avl_pages = sysconf(_SC_AVPHYS_PAGES); /* available pages */ .EE .in -.SH EXAMPLE +.SH EXAMPLES The following example shows how .BR get_phys_pages () and diff --git a/man3/getaddrinfo.3 b/man3/getaddrinfo.3 index 830ef944d..12f77ce94 100644 --- a/man3/getaddrinfo.3 +++ b/man3/getaddrinfo.3 @@ -637,7 +637,7 @@ The GNU C library instead assumes a value of .BR "(AI_V4MAPPED\ |\ AI_ADDRCONFIG)" for this case, since this value is considered an improvement on the specification. -.SH EXAMPLE +.SH EXAMPLES .\" getnameinfo.3 refers to this example .\" socket.2 refers to this example .\" bind.2 refers to this example diff --git a/man3/getaddrinfo_a.3 b/man3/getaddrinfo_a.3 index f84895b75..3a3b77bda 100644 --- a/man3/getaddrinfo_a.3 +++ b/man3/getaddrinfo_a.3 @@ -328,7 +328,7 @@ The interface of was modeled after the .BR lio_listio (3) interface. -.SH EXAMPLE +.SH EXAMPLES Two examples are provided: a simple example that resolves several requests in parallel synchronously, and a complex example showing some of the asynchronous capabilities. diff --git a/man3/getdate.3 b/man3/getdate.3 index 199c6fed4..65d49e25e 100644 --- a/man3/getdate.3 +++ b/man3/getdate.3 @@ -227,7 +227,7 @@ In glibc, is implemented using .BR strptime (3), so that precisely the same conversions are supported by both. -.SH EXAMPLE +.SH EXAMPLES The program below calls .BR getdate () for each of its command-line arguments, diff --git a/man3/getgrent_r.3 b/man3/getgrent_r.3 index 0b0ea62a6..5c89c3415 100644 --- a/man3/getgrent_r.3 +++ b/man3/getgrent_r.3 @@ -169,7 +169,7 @@ The function .BR getgrent_r () is not really reentrant since it shares the reading position in the stream with all other threads. -.SH EXAMPLE +.SH EXAMPLES .EX #define _GNU_SOURCE #include diff --git a/man3/getgrouplist.3 b/man3/getgrouplist.3 index ee98354ab..86cc61961 100644 --- a/man3/getgrouplist.3 +++ b/man3/getgrouplist.3 @@ -121,7 +121,7 @@ in the array .IR groups , even when the number of groups exceeds .IR *ngroups . -.SH EXAMPLE +.SH EXAMPLES .PP The program below displays the group list for the user named in its first command-line argument. diff --git a/man3/getifaddrs.3 b/man3/getifaddrs.3 index 72f873929..ebdf6dc4a 100644 --- a/man3/getifaddrs.3 +++ b/man3/getifaddrs.3 @@ -218,7 +218,7 @@ defined in defined in .IR ), which contains various interface attributes and statistics. -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR getifaddrs (), .BR freeifaddrs (), diff --git a/man3/getline.3 b/man3/getline.3 index 3bc294ce8..d02424f3f 100644 --- a/man3/getline.3 +++ b/man3/getline.3 @@ -158,7 +158,7 @@ and .BR getdelim () were originally GNU extensions. They were standardized in POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES .EX #define _GNU_SOURCE #include diff --git a/man3/getnameinfo.3 b/man3/getnameinfo.3 index 78e2592b7..7ed173417 100644 --- a/man3/getnameinfo.3 +++ b/man3/getnameinfo.3 @@ -258,7 +258,7 @@ and .I servlen arguments were typed as .IR size_t . -.SH EXAMPLE +.SH EXAMPLES The following code tries to get the numeric hostname and service name, for a given socket address. Note that there is no hardcoded reference to diff --git a/man3/getopt.3 b/man3/getopt.3 index 9cedb05d5..dd4c1d3b5 100644 --- a/man3/getopt.3 +++ b/man3/getopt.3 @@ -394,7 +394,7 @@ routine that rechecks .B POSIXLY_CORRECT and checks for GNU extensions in .IR optstring .) -.SH EXAMPLE +.SH EXAMPLES .SS getopt() The following trivial example program uses .BR getopt () diff --git a/man3/getprotoent_r.3 b/man3/getprotoent_r.3 index 57b9c63af..4e85cf7ea 100644 --- a/man3/getprotoent_r.3 +++ b/man3/getprotoent_r.3 @@ -150,7 +150,7 @@ T} Thread safety MT-Safe locale These functions are GNU extensions. Functions with similar names exist on some other systems, though typically with different calling signatures. -.SH EXAMPLE +.SH EXAMPLES The program below uses .BR getprotobyname_r () to retrieve the protocol record for the protocol named diff --git a/man3/getpwent_r.3 b/man3/getpwent_r.3 index 19979da4a..e8c52144d 100644 --- a/man3/getpwent_r.3 +++ b/man3/getpwent_r.3 @@ -174,7 +174,7 @@ The function .BR getpwent_r () is not really reentrant since it shares the reading position in the stream with all other threads. -.SH EXAMPLE +.SH EXAMPLES .EX #define _GNU_SOURCE #include diff --git a/man3/getpwnam.3 b/man3/getpwnam.3 index d8b4f19c8..c71af9e5a 100644 --- a/man3/getpwnam.3 +++ b/man3/getpwnam.3 @@ -275,7 +275,7 @@ To determine the (initial) home directory of another user, it is necessary to use .I getpwnam("username")\->pw_dir or similar. -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR getpwnam_r () to find the full username and user ID for the username diff --git a/man3/getservent_r.3 b/man3/getservent_r.3 index a9add50ac..50b876a39 100644 --- a/man3/getservent_r.3 +++ b/man3/getservent_r.3 @@ -148,7 +148,7 @@ T} Thread safety MT-Safe locale These functions are GNU extensions. Functions with similar names exist on some other systems, though typically with different calling signatures. -.SH EXAMPLE +.SH EXAMPLES The program below uses .BR getservbyport_r () to retrieve the service record for the port and protocol named diff --git a/man3/getsubopt.3 b/man3/getsubopt.3 index 01b483cac..40cd3da02 100644 --- a/man3/getsubopt.3 +++ b/man3/getsubopt.3 @@ -149,7 +149,7 @@ Since overwrites any commas it finds in the string .IR *optionp , that string must be writable; it cannot be a string constant. -.SH EXAMPLE +.SH EXAMPLES The following program expects suboptions following a "\-o" option. .PP .EX diff --git a/man3/getutent.3 b/man3/getutent.3 index e45a7177c..68c762c19 100644 --- a/man3/getutent.3 +++ b/man3/getutent.3 @@ -307,7 +307,7 @@ On success, they return 0, and a pointer to the result is written in On error, these functions return \-1. There are no utmpx equivalents of the above functions. (POSIX.1 does not specify such functions.) -.SH EXAMPLE +.SH EXAMPLES The following example adds and removes a utmp record, assuming it is run from within a pseudo terminal. For usage in a real application, you diff --git a/man3/glob.3 b/man3/glob.3 index cb87b1a40..5e92dfcf4 100644 --- a/man3/glob.3 +++ b/man3/glob.3 @@ -325,7 +325,7 @@ or .BR opendir (3). These will store their error code in .IR errno . -.SH EXAMPLE +.SH EXAMPLES One example of use is the following code, which simulates typing .PP .in +4n diff --git a/man3/gnu_get_libc_version.3 b/man3/gnu_get_libc_version.3 index a1a9e4d7c..d609a3c57 100644 --- a/man3/gnu_get_libc_version.3 +++ b/man3/gnu_get_libc_version.3 @@ -61,7 +61,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO These functions are glibc-specific. -.SH EXAMPLE +.SH EXAMPLES When run, the program below will produce output such as the following: .PP .in +4n diff --git a/man3/hsearch.3 b/man3/hsearch.3 index 9365e9e22..2ff066a3e 100644 --- a/man3/hsearch.3 +++ b/man3/hsearch.3 @@ -297,7 +297,7 @@ implementation violates the specification, updating the \fIdata\fP for the given \fIkey\fP in this case. .PP Individual hash table entries can be added, but not deleted. -.SH EXAMPLE +.SH EXAMPLES .PP The following program inserts 24 items into a hash table, then prints some of them. diff --git a/man3/if_nameindex.3 b/man3/if_nameindex.3 index 8bddc00b6..aba6421b6 100644 --- a/man3/if_nameindex.3 +++ b/man3/if_nameindex.3 @@ -120,7 +120,7 @@ T} Thread safety MT-Safe POSIX.1-2001, POSIX.1-2008, RFC\ 3493. .PP This function first appeared in BSDi. -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of the functions described on this page. An example of the output this program might produce is the following: diff --git a/man3/inet.3 b/man3/inet.3 index fe3281560..e5379de51 100644 --- a/man3/inet.3 +++ b/man3/inet.3 @@ -285,7 +285,7 @@ Classful network addresses are now obsolete, having been superseded by Classless Inter-Domain Routing (CIDR), which divides addresses into network and host components at arbitrary bit (rather than byte) boundaries. -.SH EXAMPLE +.SH EXAMPLES An example of the use of .BR inet_aton () and diff --git a/man3/inet_net_pton.3 b/man3/inet_net_pton.3 index 7de25786e..e191aec00 100644 --- a/man3/inet_net_pton.3 +++ b/man3/inet_net_pton.3 @@ -244,7 +244,7 @@ but the number of octets specified in the network number exceed then .I bits is set to 8 times the number of octets actually specified. -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR inet_net_pton () and diff --git a/man3/inet_ntop.3 b/man3/inet_ntop.3 index 8c0464097..b06e5343a 100644 --- a/man3/inet_ntop.3 +++ b/man3/inet_ntop.3 @@ -125,7 +125,7 @@ but 2.2 and later have .SH BUGS .B AF_INET6 converts IPv4-mapped IPv6 addresses into an IPv6 format. -.SH EXAMPLE +.SH EXAMPLES See .BR inet_pton (3). .SH SEE ALSO diff --git a/man3/inet_pton.3 b/man3/inet_pton.3 index db481273e..81b5ca302 100644 --- a/man3/inet_pton.3 +++ b/man3/inet_pton.3 @@ -167,7 +167,7 @@ does not recognize IPv4 addresses. An explicit IPv4-mapped IPv6 address must be supplied in .I src instead. -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR inet_pton () and diff --git a/man3/insque.3 b/man3/insque.3 index 27922c950..6ff0d9d60 100644 --- a/man3/insque.3 +++ b/man3/insque.3 @@ -148,7 +148,7 @@ as NULL. Consequently, to build a linear list, the caller had to build a list using an initial call that contained the first two elements of the list, with the forward and backward pointers in each element suitably initialized. -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR insque (). Here is an example run of the program: diff --git a/man3/makecontext.3 b/man3/makecontext.3 index 852c48f67..9a04fb2a7 100644 --- a/man3/makecontext.3 +++ b/man3/makecontext.3 @@ -149,7 +149,7 @@ and won't work on architectures where pointers are larger than Nevertheless, starting with version 2.8, glibc makes some changes to .BR makecontext (), to permit this on some 64-bit architectures (e.g., x86-64). -.SH EXAMPLE +.SH EXAMPLES .PP The example program below demonstrates the use of .BR getcontext (3), diff --git a/man3/mallinfo.3 b/man3/mallinfo.3 index 677a9a1cf..738f786fd 100644 --- a/man3/mallinfo.3 +++ b/man3/mallinfo.3 @@ -164,7 +164,7 @@ structure are typed as However, because some internal bookkeeping values may be of type .IR long , the reported values may wrap around zero and thus be inaccurate. -.SH EXAMPLE +.SH EXAMPLES The program below employs .BR mallinfo () to retrieve memory allocation statistics before and after diff --git a/man3/malloc_hook.3 b/man3/malloc_hook.3 index fa8091018..1efb33ef7 100644 --- a/man3/malloc_hook.3 +++ b/man3/malloc_hook.3 @@ -91,7 +91,7 @@ variable has been removed from the API. .\" http://sourceware.org/bugzilla/show_bug.cgi?id=9957 Programmers should instead preempt calls to the relevant functions by defining and exporting functions such as "malloc" and "free". -.SH EXAMPLE +.SH EXAMPLES Here is a short example of how to use these variables. .PP .EX diff --git a/man3/malloc_info.3 b/man3/malloc_info.3 index 7953abd5f..fad4e06ad 100644 --- a/man3/malloc_info.3 +++ b/man3/malloc_info.3 @@ -94,7 +94,7 @@ function is designed to address deficiencies in .BR malloc_stats (3) and .BR mallinfo (3). -.SH EXAMPLE +.SH EXAMPLES The program below takes up to four command-line arguments, of which the first three are mandatory. The first argument specifies the number of threads that diff --git a/man3/mallopt.3 b/man3/mallopt.3 index 4d49365ca..304801388 100644 --- a/man3/mallopt.3 +++ b/man3/mallopt.3 @@ -511,7 +511,7 @@ being freed by the call the block starting at .I p+sizeof(size_t) is initialized. -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR M_CHECK_ACTION . If the program is supplied with an (integer) command-line argument, diff --git a/man3/matherr.3 b/man3/matherr.3 index 8bba0e37c..cceeaedf8 100644 --- a/man3/matherr.3 +++ b/man3/matherr.3 @@ -286,7 +286,7 @@ T{ .BR matherr () T} Thread safety MT-Safe .TE -.SH EXAMPLE +.SH EXAMPLES The example program demonstrates the use of .BR matherr () when calling diff --git a/man3/mbstowcs.3 b/man3/mbstowcs.3 index b4d3c02fb..6aef9c34e 100644 --- a/man3/mbstowcs.3 +++ b/man3/mbstowcs.3 @@ -118,7 +118,7 @@ The function .BR mbsrtowcs (3) provides a better interface to the same functionality. -.SH EXAMPLE +.SH EXAMPLES The program below illustrates the use of .BR mbstowcs (), as well as some of the wide character classification functions. diff --git a/man3/mcheck.3 b/man3/mcheck.3 index 09a8fb16d..4966165c2 100644 --- a/man3/mcheck.3 +++ b/man3/mcheck.3 @@ -177,7 +177,7 @@ But, using .B MALLOC_CHECK_ does not require the application to be relinked. .\" But is MALLOC_CHECK_ slower? -.SH EXAMPLE +.SH EXAMPLES The program below calls .BR mcheck () with a NULL argument and then frees the same block of memory twice. diff --git a/man3/mempcpy.3 b/man3/mempcpy.3 index 590f51670..6bf9c0b82 100644 --- a/man3/mempcpy.3 +++ b/man3/mempcpy.3 @@ -70,7 +70,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO This function is a GNU extension. -.SH EXAMPLE +.SH EXAMPLES .EX void * combine(void *o1, size_t s1, void *o2, size_t s2) diff --git a/man3/mq_getattr.3 b/man3/mq_getattr.3 index 90b2f4869..ca90a55e5 100644 --- a/man3/mq_getattr.3 +++ b/man3/mq_getattr.3 @@ -157,7 +157,7 @@ and are library functions layered on top of the .BR mq_getsetattr (2) system call. -.SH EXAMPLE +.SH EXAMPLES The program below can be used to show the default .I mq_maxmsg and diff --git a/man3/mq_notify.3 b/man3/mq_notify.3 index 290f53cf6..6da3dbd75 100644 --- a/man3/mq_notify.3 +++ b/man3/mq_notify.3 @@ -208,7 +208,7 @@ The implementation involves the use of a raw .BR netlink (7) socket and creates a new thread for each notification that is delivered to the process. -.SH EXAMPLE +.SH EXAMPLES The following program registers a notification request for the message queue named in its command-line argument. Notification is performed by creating a thread. diff --git a/man3/mtrace.3 b/man3/mtrace.3 index ff9f0fc5d..2923c6fb4 100644 --- a/man3/mtrace.3 +++ b/man3/mtrace.3 @@ -127,7 +127,7 @@ The line-number information produced by is not always precise: the line number references may refer to the previous or following (nonblank) line of the source code. -.SH EXAMPLE +.SH EXAMPLES The shell session below demonstrates the use of the .BR mtrace () function and the diff --git a/man3/newlocale.3 b/man3/newlocale.3 index ea9b11d65..ea9805e65 100644 --- a/man3/newlocale.3 +++ b/man3/newlocale.3 @@ -218,7 +218,7 @@ Each locale object created by .BR newlocale () should be deallocated using .BR freelocale (). -.SH EXAMPLE +.SH EXAMPLES The program below takes up to two command-line arguments, which each identify locales. The first argument is required, and is used to set the diff --git a/man3/nl_langinfo.3 b/man3/nl_langinfo.3 index 65cb5a279..fe222f512 100644 --- a/man3/nl_langinfo.3 +++ b/man3/nl_langinfo.3 @@ -318,7 +318,7 @@ is undefined if is the special locale object .BR LC_GLOBAL_LOCALE or is not a valid locale object handle. -.SH EXAMPLE +.SH EXAMPLES The following program sets the character type and the numeric locale according to the environment and queries the terminal character set and the radix character. diff --git a/man3/offsetof.3 b/man3/offsetof.3 index 6f79533a1..a1ff43621 100644 --- a/man3/offsetof.3 +++ b/man3/offsetof.3 @@ -62,7 +62,7 @@ within the given in units of bytes. .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008, C89, C99. -.SH EXAMPLE +.SH EXAMPLES On a Linux/i386 system, when compiled using the default .BR gcc (1) options, the program below produces the following output: diff --git a/man3/open_memstream.3 b/man3/open_memstream.3 index b3cc47b32..1fe3a3b3c 100644 --- a/man3/open_memstream.3 +++ b/man3/open_memstream.3 @@ -136,7 +136,7 @@ does not enlarge the buffer; instead the .BR fseek (3) call fails, returning \-1. .\" http://sourceware.org/bugzilla/show_bug.cgi?id=1996 -.SH EXAMPLE +.SH EXAMPLES See .BR fmemopen (3). .SH SEE ALSO diff --git a/man3/posix_spawn.3 b/man3/posix_spawn.3 index c21c90f50..9bc00fe19 100644 --- a/man3/posix_spawn.3 +++ b/man3/posix_spawn.3 @@ -600,7 +600,7 @@ failed with an error if .BR POSIX_SPAWN_SETSCHEDULER was specified without also specifying .BR POSIX_SPAWN_SETSCHEDPARAM . -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of various functions in the POSIX spawn API. The program accepts command-line attributes that can be used diff --git a/man3/printf.3 b/man3/printf.3 index 827d9cbae..d8b164d14 100644 --- a/man3/printf.3 +++ b/man3/printf.3 @@ -1068,7 +1068,7 @@ call to write to memory and creating a security hole. .\" .PP .\" Some floating-point conversions under early libc4 .\" caused memory leaks. -.SH EXAMPLE +.SH EXAMPLES To print .I Pi to five decimal places: diff --git a/man3/pthread_attr_init.3 b/man3/pthread_attr_init.3 index da478b923..ce99f8faf 100644 --- a/man3/pthread_attr_init.3 +++ b/man3/pthread_attr_init.3 @@ -99,7 +99,7 @@ The type should be treated as opaque: any access to the object other than via pthreads functions is nonportable and produces undefined results. -.SH EXAMPLE +.SH EXAMPLES The program below optionally makes use of .BR pthread_attr_init () and various related functions to initialize a thread attributes diff --git a/man3/pthread_attr_setdetachstate.3 b/man3/pthread_attr_setdetachstate.3 index 76c63fb8f..07ff61e25 100644 --- a/man3/pthread_attr_setdetachstate.3 +++ b/man3/pthread_attr_setdetachstate.3 @@ -118,7 +118,7 @@ in a later call to .BR pthread_detach (3) or .BR pthread_join (3). -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_attr_init (3). .SH SEE ALSO diff --git a/man3/pthread_attr_setguardsize.3 b/man3/pthread_attr_setguardsize.3 index 2f87a8cc0..dee6c8169 100644 --- a/man3/pthread_attr_setguardsize.3 +++ b/man3/pthread_attr_setguardsize.3 @@ -165,7 +165,7 @@ allocating extra space at the end of the stack for the guard area. .\" Reportedly, LinuxThreads did the right thing, allocating .\" extra space at the end of the stack: .\" http://sourceware.org/ml/libc-alpha/2008-05/msg00086.html -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_getattr_np (3). .SH SEE ALSO diff --git a/man3/pthread_attr_setinheritsched.3 b/man3/pthread_attr_setinheritsched.3 index cdbc0db7e..7204ef909 100644 --- a/man3/pthread_attr_setinheritsched.3 +++ b/man3/pthread_attr_setinheritsched.3 @@ -138,7 +138,7 @@ in the thread attributes object before calling .BR pthread_create (3). .\" FIXME . Track status of the following bug: .\" http://sourceware.org/bugzilla/show_bug.cgi?id=7007 -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_setschedparam (3). .SH SEE ALSO diff --git a/man3/pthread_attr_setschedparam.3 b/man3/pthread_attr_setschedparam.3 index 003c88ebb..78ff4b5e5 100644 --- a/man3/pthread_attr_setschedparam.3 +++ b/man3/pthread_attr_setschedparam.3 @@ -123,7 +123,7 @@ POSIX.1-2001, POSIX.1-2008. See .BR pthread_attr_setschedpolicy (3) for a list of the thread scheduling policies supported on Linux. -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_setschedparam (3). .SH SEE ALSO diff --git a/man3/pthread_attr_setschedpolicy.3 b/man3/pthread_attr_setschedpolicy.3 index 9b1dd2588..ccdbad4c2 100644 --- a/man3/pthread_attr_setschedpolicy.3 +++ b/man3/pthread_attr_setschedpolicy.3 @@ -112,7 +112,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_setschedparam (3). .SH SEE ALSO diff --git a/man3/pthread_attr_setstack.3 b/man3/pthread_attr_setstack.3 index 54759838b..76f466c8a 100644 --- a/man3/pthread_attr_setstack.3 +++ b/man3/pthread_attr_setstack.3 @@ -162,7 +162,7 @@ stack address attribute between calls to .BR pthread_create (3); otherwise, the threads will attempt to use the same memory area for their stacks, and chaos will ensue. -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_attr_init (3). .SH SEE ALSO diff --git a/man3/pthread_attr_setstacksize.3 b/man3/pthread_attr_setstacksize.3 index 9f01b4039..93301e800 100644 --- a/man3/pthread_attr_setstacksize.3 +++ b/man3/pthread_attr_setstacksize.3 @@ -118,7 +118,7 @@ in violation of POSIX.1, which says that the allocated stack will be at least .I stacksize bytes. -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_create (3). .SH SEE ALSO diff --git a/man3/pthread_cancel.3 b/man3/pthread_cancel.3 index 03387f2a6..c83ff7730 100644 --- a/man3/pthread_cancel.3 +++ b/man3/pthread_cancel.3 @@ -145,7 +145,7 @@ On LinuxThreads, the second real-time signal is used, if real-time signals are available, otherwise .B SIGUSR2 is used. -.SH EXAMPLE +.SH EXAMPLES The program below creates a thread and then cancels it. The main thread joins with the canceled thread to check that its exit status was diff --git a/man3/pthread_cleanup_push.3 b/man3/pthread_cleanup_push.3 index 6d74f3a93..1efe93c4e 100644 --- a/man3/pthread_cleanup_push.3 +++ b/man3/pthread_cleanup_push.3 @@ -166,7 +166,7 @@ and .BR pthread_cleanup_pop () is undefined. Portable applications should avoid doing this. -.SH EXAMPLE +.SH EXAMPLES The program below provides a simple example of the use of the functions described in this page. The program creates a thread that executes a loop bracketed by diff --git a/man3/pthread_create.3 b/man3/pthread_create.3 index c1d47fb05..281407657 100644 --- a/man3/pthread_create.3 +++ b/man3/pthread_create.3 @@ -236,7 +236,7 @@ each of the threads in a process has a different process ID. This is in violation of the POSIX threads specification, and is the source of many other nonconformances to the standard; see .BR pthreads (7). -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR pthread_create (), as well as a number of other functions in the pthreads API. diff --git a/man3/pthread_detach.3 b/man3/pthread_detach.3 index 84b9757db..310687625 100644 --- a/man3/pthread_detach.3 +++ b/man3/pthread_detach.3 @@ -103,7 +103,7 @@ should be called for each thread that an application creates, so that system resources for the thread can be released. (But note that the resources of any threads for which one of these actions has not been done will be freed when the process terminates.) -.SH EXAMPLE +.SH EXAMPLES The following statement detaches the calling thread: .PP pthread_detach(pthread_self()); diff --git a/man3/pthread_getattr_default_np.3 b/man3/pthread_getattr_default_np.3 index abc7b5ff2..3604fc692 100644 --- a/man3/pthread_getattr_default_np.3 +++ b/man3/pthread_getattr_default_np.3 @@ -96,7 +96,7 @@ T} Thread safety MT-Safe .SH CONFORMING TO These functions are nonstandard GNU extensions; hence the suffix "_np" (nonportable) in their names. -.SH EXAMPLE +.SH EXAMPLES The program below uses .BR pthread_getattr_default_np () to fetch the default thread-creation attributes and then displays diff --git a/man3/pthread_getattr_np.3 b/man3/pthread_getattr_np.3 index 5006dd430..137057f9b 100644 --- a/man3/pthread_getattr_np.3 +++ b/man3/pthread_getattr_np.3 @@ -112,7 +112,7 @@ T} Thread safety MT-Safe .SH CONFORMING TO This function is a nonstandard GNU extension; hence the suffix "_np" (nonportable) in the name. -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR pthread_getattr_np (). The program creates a thread that then uses diff --git a/man3/pthread_getcpuclockid.3 b/man3/pthread_getcpuclockid.3 index f76cbbd4c..f26a7ba46 100644 --- a/man3/pthread_getcpuclockid.3 +++ b/man3/pthread_getcpuclockid.3 @@ -90,7 +90,7 @@ and .BR clock_settime (2) when given the clock ID .BR CLOCK_THREAD_CPUTIME_ID . -.SH EXAMPLE +.SH EXAMPLES The program below creates a thread and then uses .BR clock_gettime (2) to retrieve the total process CPU time, diff --git a/man3/pthread_join.3 b/man3/pthread_join.3 index 2245225de..7fd3c5bd8 100644 --- a/man3/pthread_join.3 +++ b/man3/pthread_join.3 @@ -137,7 +137,7 @@ you probably need to rethink your application design. .PP All of the threads in a process are peers: any thread can join with any other thread in the process. -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_create (3). .SH SEE ALSO diff --git a/man3/pthread_mutex_consistent.3 b/man3/pthread_mutex_consistent.3 index b898a8af1..c39438556 100644 --- a/man3/pthread_mutex_consistent.3 +++ b/man3/pthread_mutex_consistent.3 @@ -93,7 +93,7 @@ was defined: .PP This GNU-specific API, which first appeared in glibc 2.4, is nowadays obsolete and should not be used in new programs. -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_mutexattr_setrobust (3). .SH SEE ALSO diff --git a/man3/pthread_mutexattr_setrobust.3 b/man3/pthread_mutexattr_setrobust.3 index 950388271..3030750bb 100644 --- a/man3/pthread_mutexattr_setrobust.3 +++ b/man3/pthread_mutexattr_setrobust.3 @@ -185,7 +185,7 @@ were also defined. .PP These GNU-specific APIs, which first appeared in glibc 2.4, are nowadays obsolete and should not be used in new programs. -.SH EXAMPLE +.SH EXAMPLES .PP The program below demonstrates the use of the robustness attribute of a mutex attributes object. diff --git a/man3/pthread_setaffinity_np.3 b/man3/pthread_setaffinity_np.3 index ccbf9768b..bb6c5a6dc 100644 --- a/man3/pthread_setaffinity_np.3 +++ b/man3/pthread_setaffinity_np.3 @@ -160,7 +160,7 @@ Instead the CPU set size given to the underlying system calls was always A new thread created by .BR pthread_create (3) inherits a copy of its creator's CPU affinity mask. -.SH EXAMPLE +.SH EXAMPLES In the following program, the main thread uses .BR pthread_setaffinity_np () to set its CPU affinity mask to include CPUs 0 to 7 diff --git a/man3/pthread_setcancelstate.3 b/man3/pthread_setcancelstate.3 index 1ed96bd77..01ff4f128 100644 --- a/man3/pthread_setcancelstate.3 +++ b/man3/pthread_setcancelstate.3 @@ -202,7 +202,7 @@ A precisely analogous set of statements applies for the .I oldtype argument of .BR pthread_setcanceltype (). -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_cancel (3). .SH SEE ALSO diff --git a/man3/pthread_setname_np.3 b/man3/pthread_setname_np.3 index c416653e5..790d040ea 100644 --- a/man3/pthread_setname_np.3 +++ b/man3/pthread_setname_np.3 @@ -126,7 +126,7 @@ filesystem: .IR /proc/self/task/[tid]/comm . .BR pthread_getname_np () retrieves it from the same location. -.SH EXAMPLE +.SH EXAMPLES .PP The program below demonstrates the use of .BR pthread_setname_np () diff --git a/man3/pthread_setschedparam.3 b/man3/pthread_setschedparam.3 index 3c0ae8d17..acfaf81a1 100644 --- a/man3/pthread_setschedparam.3 +++ b/man3/pthread_setschedparam.3 @@ -159,7 +159,7 @@ changing a thread's scheduling policy and priority, and details of the permitted ranges for priorities in each scheduling policy, see .BR sched (7). -.SH EXAMPLE +.SH EXAMPLES The program below demonstrates the use of .BR pthread_setschedparam () and diff --git a/man3/pthread_sigmask.3 b/man3/pthread_sigmask.3 index e6e24b480..f4a49be39 100644 --- a/man3/pthread_sigmask.3 +++ b/man3/pthread_sigmask.3 @@ -90,7 +90,7 @@ are used internally by the NPTL threading implementation. See .BR nptl (7) for details. -.SH EXAMPLE +.SH EXAMPLES The program below blocks some signals in the main thread, and then creates a dedicated thread to fetch those signals via .BR sigwait (3). diff --git a/man3/pthread_testcancel.3 b/man3/pthread_testcancel.3 index 32b48592f..bb8e70199 100644 --- a/man3/pthread_testcancel.3 +++ b/man3/pthread_testcancel.3 @@ -69,7 +69,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_cleanup_push (3). .SH SEE ALSO diff --git a/man3/pthread_tryjoin_np.3 b/man3/pthread_tryjoin_np.3 index bba7b51f1..6cf710985 100644 --- a/man3/pthread_tryjoin_np.3 +++ b/man3/pthread_tryjoin_np.3 @@ -135,7 +135,7 @@ T} Thread safety MT-Safe .SH CONFORMING TO These functions are nonstandard GNU extensions; hence the suffix "_np" (nonportable) in the names. -.SH EXAMPLE +.SH EXAMPLES The following code waits to join for up to 5 seconds: .PP .in +4n diff --git a/man3/qsort.3 b/man3/qsort.3 index 07ff4a13e..1935901d4 100644 --- a/man3/qsort.3 +++ b/man3/qsort.3 @@ -118,7 +118,7 @@ POSIX.1-2001, POSIX.1-2008, C89, C99, SVr4, 4.3BSD. To compare C strings, the comparison function can call .BR strcmp (3), as shown in the example below. -.SH EXAMPLE +.SH EXAMPLES For one example of use, see the example under .BR bsearch (3). .PP diff --git a/man3/rand.3 b/man3/rand.3 index 61d4ae6f4..99bb7ce67 100644 --- a/man3/rand.3 +++ b/man3/rand.3 @@ -177,7 +177,7 @@ when good randomness is needed. (Use .BR random (3) instead.) -.SH EXAMPLE +.SH EXAMPLES POSIX.1-2001 gives the following example of an implementation of .BR rand () and diff --git a/man3/remainder.3 b/man3/remainder.3 index 59b2038e8..fd5c330b0 100644 --- a/man3/remainder.3 +++ b/man3/remainder.3 @@ -234,7 +234,7 @@ for the domain error that occurs when is an infinity and .I y is not a NaN. -.SH EXAMPLE +.SH EXAMPLES The call "remainder(29.0, 3.0)" returns \-1. .SH SEE ALSO .BR div (3), diff --git a/man3/rpmatch.3 b/man3/rpmatch.3 index 1ca665ea7..72f4d42a1 100644 --- a/man3/rpmatch.3 +++ b/man3/rpmatch.3 @@ -132,7 +132,7 @@ expression notation described in .B ^([yY]|yes|YES)$ and .BR ^([nN]|no|NO)$ . -.SH EXAMPLE +.SH EXAMPLES The following program displays the results when .BR rpmatch () is applied to the string given in the program's command-line argument. diff --git a/man3/rtime.3 b/man3/rtime.3 index cacdf41d1..b341de912 100644 --- a/man3/rtime.3 +++ b/man3/rtime.3 @@ -89,7 +89,7 @@ instead of .SH BUGS .BR rtime () in glibc 2.2.5 and earlier does not work properly on 64-bit machines. -.SH EXAMPLE +.SH EXAMPLES This example requires that port 37 is up and open. You may check that the time entry within diff --git a/man3/rtnetlink.3 b/man3/rtnetlink.3 index b738530cf..89f4f59c2 100644 --- a/man3/rtnetlink.3 +++ b/man3/rtnetlink.3 @@ -83,7 +83,7 @@ bytes of data. These macros are nonstandard Linux extensions. .SH BUGS This manual page is incomplete. -.SH EXAMPLE +.SH EXAMPLES .\" FIXME . ? would be better to use libnetlink in the EXAMPLE code here Creating a rtnetlink message to set the MTU of a device: .PP diff --git a/man3/scandir.3 b/man3/scandir.3 index 1545fd3b6..9cfabf758 100644 --- a/man3/scandir.3 +++ b/man3/scandir.3 @@ -287,7 +287,7 @@ and glibc 2.10 changed the definition of (and the nonstandard .BR versionsort ()) to match the standard. -.SH EXAMPLE +.SH EXAMPLES The program below prints a list of the files in the current directory in reverse order. .\" diff --git a/man3/scanf.3 b/man3/scanf.3 index aef6283a9..02f5a74ba 100644 --- a/man3/scanf.3 +++ b/man3/scanf.3 @@ -731,7 +731,7 @@ The usage of is not the same as on 4.4BSD, as it may be used in float conversions equivalently to .BR L . -.SH EXAMPLE +.SH EXAMPLES To use the dynamic allocation conversion specifier, specify .B m as a length modifier (thus diff --git a/man3/sem_init.3 b/man3/sem_init.3 index 693cc58e4..723e572a1 100644 --- a/man3/sem_init.3 +++ b/man3/sem_init.3 @@ -111,7 +111,7 @@ Bizarrely, POSIX.1-2001 does not specify the value that should be returned by a successful call to .BR sem_init (). POSIX.1-2008 rectifies this, specifying the zero return on success. -.SH EXAMPLE +.SH EXAMPLES See .BR shm_open (3) and diff --git a/man3/sem_post.3 b/man3/sem_post.3 index 1ef9371b9..2f1b53320 100644 --- a/man3/sem_post.3 +++ b/man3/sem_post.3 @@ -76,7 +76,7 @@ POSIX.1-2001. .BR sem_post () is async-signal-safe: it may be safely called within a signal handler. -.SH EXAMPLE +.SH EXAMPLES See .BR sem_wait (3) and diff --git a/man3/sem_wait.3 b/man3/sem_wait.3 index 8632c97a1..0014174ba 100644 --- a/man3/sem_wait.3 +++ b/man3/sem_wait.3 @@ -156,7 +156,7 @@ T} Thread safety MT-Safe .TE .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES .PP The (somewhat trivial) program shown below operates on an unnamed semaphore. diff --git a/man3/setaliasent.3 b/man3/setaliasent.3 index bc0a8b636..069deffb5 100644 --- a/man3/setaliasent.3 +++ b/man3/setaliasent.3 @@ -133,7 +133,7 @@ alias_ent *alias_getent(void); alias_ent *alias_getbyname(char *name); .EE .in -.SH EXAMPLE +.SH EXAMPLES The following example compiles with .IR "gcc example.c \-o example" . It will dump all names in the alias database. diff --git a/man3/shm_open.3 b/man3/shm_open.3 index 9c7e5cdfe..bbda0a0c5 100644 --- a/man3/shm_open.3 +++ b/man3/shm_open.3 @@ -285,7 +285,7 @@ of a dedicated .BR tmpfs (5) filesystem that is normally mounted under .IR /dev/shm . -.SH EXAMPLE +.SH EXAMPLES The programs below employ POSIX shared memory and POSIX unnamed semaphores to exchange a piece of data. The "bounce" program (which must be run first) raises the case diff --git a/man3/sigwait.3 b/man3/sigwait.3 index 17a5c57a9..63beb8bb3 100644 --- a/man3/sigwait.3 +++ b/man3/sigwait.3 @@ -109,7 +109,7 @@ are used internally by the NPTL threading implementation. See .BR nptl (7) for details. -.SH EXAMPLE +.SH EXAMPLES See .BR pthread_sigmask (3). .SH SEE ALSO diff --git a/man3/sockatmark.3 b/man3/sockatmark.3 index fc7022216..e882430b0 100644 --- a/man3/sockatmark.3 +++ b/man3/sockatmark.3 @@ -108,7 +108,7 @@ operation. Prior to glibc 2.4, .BR sockatmark () did not work. -.SH EXAMPLE +.SH EXAMPLES The following code can be used after receipt of a .B SIGURG signal to read (and discard) all data up to the mark, diff --git a/man3/stdarg.3 b/man3/stdarg.3 index a21dcaab1..0a1bfb9ef 100644 --- a/man3/stdarg.3 +++ b/man3/stdarg.3 @@ -269,7 +269,7 @@ pass all of their arguments on to a function that takes a .I va_list argument, such as .BR vfprintf (3). -.SH EXAMPLE +.SH EXAMPLES The function .I foo takes a string of format characters and prints out the argument associated diff --git a/man3/stpcpy.3 b/man3/stpcpy.3 index f10d01035..5fda5bab6 100644 --- a/man3/stpcpy.3 +++ b/man3/stpcpy.3 @@ -92,7 +92,7 @@ It is also present on the BSDs. .SH BUGS This function may overrun the buffer .IR dest . -.SH EXAMPLE +.SH EXAMPLES For example, this program uses .BR stpcpy () to concatenate diff --git a/man3/strcat.3 b/man3/strcat.3 index c3b0bd2c8..888ae9d0e 100644 --- a/man3/strcat.3 +++ b/man3/strcat.3 @@ -180,7 +180,7 @@ but is available on Linux via the .IR libbsd library. .\" -.SH EXAMPLE +.SH EXAMPLES Because .BR strcat () and diff --git a/man3/strcmp.3 b/man3/strcmp.3 index f1046f2e3..9305c603f 100644 --- a/man3/strcmp.3 +++ b/man3/strcmp.3 @@ -126,7 +126,7 @@ the last compared byte in from the last compared byte in .IR s1 . (If the two characters are equal, this difference is 0.) -.SH EXAMPLE +.SH EXAMPLES The program below can be used to demonstrate the operation of .BR strcmp () (when given two arguments) and diff --git a/man3/strfmon.3 b/man3/strfmon.3 index a0f475491..1dc1b6446 100644 --- a/man3/strfmon.3 +++ b/man3/strfmon.3 @@ -175,7 +175,7 @@ T} Thread safety MT-Safe .sp 1 .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES The call .PP .in +4n diff --git a/man3/strftime.3 b/man3/strftime.3 index 984165c4e..c236f7df5 100644 --- a/man3/strftime.3 +++ b/man3/strftime.3 @@ -681,7 +681,7 @@ provides the .IR \-Wno\-format\-y2k option to prevent the warning, so that the above workaround is no longer required. -.SH EXAMPLE +.SH EXAMPLES .BR "RFC\ 2822-compliant date format" (with an English locale for %a and %b) .PP diff --git a/man3/strptime.3 b/man3/strptime.3 index 29366339e..01eada762 100644 --- a/man3/strptime.3 +++ b/man3/strptime.3 @@ -411,7 +411,7 @@ Leap seconds are not counted unless leap second support is available. .PP The glibc implementation does not require whitespace between two field descriptors. -.SH EXAMPLE +.SH EXAMPLES The following example demonstrates the use of .BR strptime () and diff --git a/man3/strtod.3 b/man3/strtod.3 index d3b6de005..c54573ca4 100644 --- a/man3/strtod.3 +++ b/man3/strtod.3 @@ -197,7 +197,7 @@ mantissa component of the returned value. .\" something similar. .\" C11 says: "An implementation may use the n-char sequence to determine .\" extra information to be represented in the NaN's significant." -.SH EXAMPLE +.SH EXAMPLES See the example on the .BR strtol (3) manual page; diff --git a/man3/strtok.3 b/man3/strtok.3 index 933a7b96c..3cca201f6 100644 --- a/man3/strtok.3 +++ b/man3/strtok.3 @@ -213,7 +213,7 @@ function uses a static buffer while parsing, so it's not thread safe. Use .BR strtok_r () if this matters to you. -.SH EXAMPLE +.SH EXAMPLES The program below uses nested loops that employ .BR strtok_r () to break a string into a two-level hierarchy of tokens. diff --git a/man3/strtol.3 b/man3/strtol.3 index 02598b983..69a48c938 100644 --- a/man3/strtol.3 +++ b/man3/strtol.3 @@ -213,7 +213,7 @@ may be equivalent to .BR strtoll () or to .BR strtol (). -.SH EXAMPLE +.SH EXAMPLES The program shown below demonstrates the use of .BR strtol (). The first command-line argument specifies a string from which diff --git a/man3/strtoul.3 b/man3/strtoul.3 index 353c7d920..a7089ca0b 100644 --- a/man3/strtoul.3 +++ b/man3/strtoul.3 @@ -217,7 +217,7 @@ Negative values are considered valid input and are silently converted to the equivalent .I "unsigned long int" value. -.SH EXAMPLE +.SH EXAMPLES See the example on the .BR strtol (3) manual page; diff --git a/man3/strverscmp.3 b/man3/strverscmp.3 index bdec23ce1..ac6aaf85e 100644 --- a/man3/strverscmp.3 +++ b/man3/strverscmp.3 @@ -111,7 +111,7 @@ T} Thread safety MT-Safe .\" problem. .SH CONFORMING TO This function is a GNU extension. -.SH EXAMPLE +.SH EXAMPLES The program below can be used to demonstrate the behavior of .BR strverscmp (). It uses diff --git a/man3/tsearch.3 b/man3/tsearch.3 index ae05ee3de..c73e4bb43 100644 --- a/man3/tsearch.3 +++ b/man3/tsearch.3 @@ -263,7 +263,7 @@ further reference to a node after calling the user function with argument "endorder" or "leaf". This works with the GNU library implementation, but is not in the System V documentation. -.SH EXAMPLE +.SH EXAMPLES The following program inserts twelve random numbers into a binary tree, where duplicate numbers are collapsed, then prints the numbers in order. diff --git a/man3/uselocale.3 b/man3/uselocale.3 index f3f14baac..0dd03591c 100644 --- a/man3/uselocale.3 +++ b/man3/uselocale.3 @@ -110,7 +110,7 @@ and .BR newlocale (3) to obtain a locale object equivalent to the current locale and modify the desired categories in that object. -.SH EXAMPLE +.SH EXAMPLES See .BR newlocale (3) and diff --git a/man3/wcstok.3 b/man3/wcstok.3 index 1c8359515..dfaaea5d9 100644 --- a/man3/wcstok.3 +++ b/man3/wcstok.3 @@ -95,7 +95,7 @@ The original .I wcs wide-character string is destructively modified during the operation. -.SH EXAMPLE +.SH EXAMPLES The following code loops over the tokens contained in a wide-character string. .PP .EX diff --git a/man3/wordexp.3 b/man3/wordexp.3 index 60797cf5d..ffca58258 100644 --- a/man3/wordexp.3 +++ b/man3/wordexp.3 @@ -220,7 +220,7 @@ calls those functions, so we use race:utent to remind users. .SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH EXAMPLE +.SH EXAMPLES The output of the following example program is approximately that of "ls [a-c]*.c". .PP diff --git a/man4/loop.4 b/man4/loop.4 index d95c38e77..610383891 100644 --- a/man4/loop.4 +++ b/man4/loop.4 @@ -246,7 +246,7 @@ If the device is in use, the call fails with the error .TP .IR /dev/loop* The loop block special device files. -.SH EXAMPLE +.SH EXAMPLES The program below uses the .I /dev/loop-control device to find a free loop device, opens the loop device, diff --git a/man4/vcs.4 b/man4/vcs.4 index bc481243d..47e07fd01 100644 --- a/man4/vcs.4 +++ b/man4/vcs.4 @@ -100,7 +100,7 @@ requests are supported. .\" Andries Brouwer .SH VERSIONS Introduced with version 1.1.92 of the Linux kernel. -.SH EXAMPLE +.SH EXAMPLES You may do a screendump on vt3 by switching to vt1 and typing .PP .in +4n diff --git a/man5/charmap.5 b/man5/charmap.5 index 3718929f5..676cfef0f 100644 --- a/man5/charmap.5 +++ b/man5/charmap.5 @@ -103,7 +103,7 @@ The width definition section ends with the string Usual default character map path. .SH CONFORMING TO POSIX.2. -.SH EXAMPLE +.SH EXAMPLES The Euro sign is defined as follows in the .I UTF\-8 charmap: diff --git a/man5/core.5 b/man5/core.5 index 22ea85f39..e9b01fd03 100644 --- a/man5/core.5 +++ b/man5/core.5 @@ -591,7 +591,7 @@ where each thread of a process has a different PID.) .\" LinuxThreads continue appending the PID (the kernel has no easy .\" way of telling which threading implementation the user-space .\" application is using). -- mtk, April 2006 -.SH EXAMPLE +.SH EXAMPLES The program below can be used to demonstrate the use of the pipe syntax in the .I /proc/sys/kernel/core_pattern diff --git a/man5/gai.conf.5 b/man5/gai.conf.5 index 296be51cd..ace018707 100644 --- a/man5/gai.conf.5 +++ b/man5/gai.conf.5 @@ -76,7 +76,7 @@ The .I gai.conf .\" Added in 2006 file is supported by glibc since version 2.5. -.SH EXAMPLE +.SH EXAMPLES The default table according to RFC\ 3484 would be specified with the following configuration file: .PP diff --git a/man5/hosts.5 b/man5/hosts.5 index 53c3df8d4..bafeeff70 100644 --- a/man5/hosts.5 +++ b/man5/hosts.5 @@ -104,7 +104,7 @@ though looking around at the time of writing (circa 2000), there are historical hosts.txt files on the WWW. I just found three, from 92, 94, and 95. -.SH EXAMPLE +.SH EXAMPLES .EX # The following lines are desirable for IPv4 capable hosts 127.0.0.1 localhost diff --git a/man5/hosts.equiv.5 b/man5/hosts.equiv.5 index 5356443ae..e432f8ca4 100644 --- a/man5/hosts.equiv.5 +++ b/man5/hosts.equiv.5 @@ -81,7 +81,7 @@ character which means "any host" only when the word is added to the auth component line in your PAM file for the particular service .RB "(e.g., " rlogin ). -.SH EXAMPLE +.SH EXAMPLES Below are some example .I /etc/host.equiv or diff --git a/man5/nss.5 b/man5/nss.5 index b6ab83fb3..078c5d961 100644 --- a/man5/nss.5 +++ b/man5/nss.5 @@ -97,7 +97,7 @@ call might result in a network communication with the server to get the next entry. .SH FILES \fI/etc/default/nss\fR -.SH EXAMPLE +.SH EXAMPLES The default configuration corresponds to the following configuration file: .PP .in +4n diff --git a/man5/repertoiremap.5 b/man5/repertoiremap.5 index a46a617e5..c99fec060 100644 --- a/man5/repertoiremap.5 +++ b/man5/repertoiremap.5 @@ -65,7 +65,7 @@ Usual default repertoire map path. POSIX.2. .SH NOTES Repertoire maps are deprecated in favor of Unicode code points. -.SH EXAMPLE +.SH EXAMPLES A mnemonic for the Euro sign can be defined as follows: .PP .nf diff --git a/man5/shells.5 b/man5/shells.5 index 3e2104c4a..cd2d48b79 100644 --- a/man5/shells.5 +++ b/man5/shells.5 @@ -42,7 +42,7 @@ FTP daemons traditionally disallow access to users with shells not included in this file. .SH FILES .I /etc/shells -.SH EXAMPLE +.SH EXAMPLES .I /etc/shells may contain the following paths: .PP diff --git a/man5/ttytype.5 b/man5/ttytype.5 index 8506c8701..bdd9d8a30 100644 --- a/man5/ttytype.5 +++ b/man5/ttytype.5 @@ -54,7 +54,7 @@ It is little used on modern workstation and personal UNIX systems. .TP .I /etc/ttytype the tty definitions file. -.SH EXAMPLE +.SH EXAMPLES A typical .I /etc/ttytype is: diff --git a/man7/aio.7 b/man7/aio.7 index b5d14684a..f44ea7197 100644 --- a/man7/aio.7 +++ b/man7/aio.7 @@ -193,7 +193,7 @@ reimplemented using the kernel system calls. .\" http://lse.sourceforge.net/io/aio.html .\" http://lse.sourceforge.net/io/aionotes.txt .\" http://lwn.net/Articles/148755/ -.SH EXAMPLE +.SH EXAMPLES The program below opens each of the files named in its command-line arguments and queues a request on the resulting file descriptor using .BR aio_read (3). diff --git a/man7/complex.7 b/man7/complex.7 index 964f0f3c3..37b239792 100644 --- a/man7/complex.7 +++ b/man7/complex.7 @@ -33,7 +33,7 @@ The basic operations are defined on z = a+b*i and w = c+d*i as: .PP Nearly all math function have a complex counterpart but there are some complex-only functions. -.SH EXAMPLE +.SH EXAMPLES Your C-compiler can work with complex numbers if it supports the C99 standard. Link with \fI\-lm\fP. The imaginary unit is represented by I. diff --git a/man7/cpuset.7 b/man7/cpuset.7 index ac91a8017..ac1f57a2d 100644 --- a/man7/cpuset.7 +++ b/man7/cpuset.7 @@ -1362,7 +1362,7 @@ and the creation and truncation options on .BR open (2) have no effect. .\" ================== EXAMPLE ================== -.SH EXAMPLE +.SH EXAMPLES The following examples demonstrate querying and setting cpuset options using shell commands. .SS Creating and attaching to a cpuset. diff --git a/man7/fanotify.7 b/man7/fanotify.7 index ac6fbbcae..065d121f8 100644 --- a/man7/fanotify.7 +++ b/man7/fanotify.7 @@ -693,7 +693,7 @@ The return value will not be \-1, and .I errno will not be set. Thus, the reading application has no way to detect the error. -.SH EXAMPLE +.SH EXAMPLES The two example programs below demonstrate the usage of the fanotify API. .SS Example program: fanotify_example.c The first program is an example of fanotify being diff --git a/man7/feature_test_macros.7 b/man7/feature_test_macros.7 index 83034c889..82e8abb5f 100644 --- a/man7/feature_test_macros.7 +++ b/man7/feature_test_macros.7 @@ -787,7 +787,7 @@ Programs should define these macros directly: instead, the appropriate feature test macro(s) from the list above should be employed. -.SH EXAMPLE +.SH EXAMPLES The program below can be used to explore how the various feature test macros are set depending on the glibc version and what feature test macros are explicitly set. diff --git a/man7/inotify.7 b/man7/inotify.7 index 45a39b495..1e60e45ad 100644 --- a/man7/inotify.7 +++ b/man7/inotify.7 @@ -877,7 +877,7 @@ of the bug occurring in real-world applications, as of Linux 3.15, .\" FIXME . https://bugzilla.kernel.org/show_bug.cgi?id=77111 no kernel changes have yet been made to eliminate this possible bug. -.SH EXAMPLE +.SH EXAMPLES The following program demonstrates the usage of the inotify API. It marks the directories passed as a command-line arguments and waits for events of type diff --git a/man7/man-pages.7 b/man7/man-pages.7 index 04b270190..104ce560c 100644 --- a/man7/man-pages.7 +++ b/man7/man-pages.7 @@ -993,7 +993,7 @@ For some examples of what example programs should look like, see .BR wait (2) and .BR pipe (2). -.SH EXAMPLE +.SH EXAMPLES For canonical examples of how man pages in the .I man-pages package should look, see diff --git a/man7/mount_namespaces.7 b/man7/mount_namespaces.7 index 42ad4e413..d1f85b590 100644 --- a/man7/mount_namespaces.7 +++ b/man7/mount_namespaces.7 @@ -1116,7 +1116,7 @@ and creating bind mounts .RB ( MS_BIND ), see .IR Documentation/filesystems/sharedsubtree.txt . -.SH EXAMPLE +.SH EXAMPLES See .BR pivot_root (2). .SH SEE ALSO diff --git a/man7/mq_overview.7 b/man7/mq_overview.7 index 89c6ac6cd..10667c3ca 100644 --- a/man7/mq_overview.7 +++ b/man7/mq_overview.7 @@ -390,7 +390,7 @@ This behavioral regression was rectified in Linux 4.2 (and earlier stable kernel series), so that the count once more included just the bytes of user data in messages in the queue. -.SH EXAMPLE +.SH EXAMPLES An example of the use of various message queue functions is shown in .BR mq_notify (3). .SH SEE ALSO diff --git a/man7/namespaces.7 b/man7/namespaces.7 index 6f816b5c6..bb75250d9 100644 --- a/man7/namespaces.7 +++ b/man7/namespaces.7 @@ -405,7 +405,7 @@ refers to this namespace. It is a PID namespace, and a corresponding mount of a .BR proc (5) filesystem refers to this namespace. -.SH EXAMPLE +.SH EXAMPLES See .BR clone (2) and diff --git a/man7/netlink.7 b/man7/netlink.7 index 260198657..6b18c0265 100644 --- a/man7/netlink.7 +++ b/man7/netlink.7 @@ -486,7 +486,7 @@ or than via the low-level kernel interface. .SH BUGS This manual page is not complete. -.SH EXAMPLE +.SH EXAMPLES The following example creates a .B NETLINK_ROUTE netlink socket which will listen to the diff --git a/man7/network_namespaces.7 b/man7/network_namespaces.7 index 18a1bcad0..6d1097d96 100644 --- a/man7/network_namespaces.7 +++ b/man7/network_namespaces.7 @@ -62,7 +62,7 @@ devices that it contains are destroyed. Use of network namespaces requires a kernel that is configured with the .B CONFIG_NET_NS option. -.\" FIXME .SH EXAMPLE +.\" FIXME .SH EXAMPLES .SH SEE ALSO .BR nsenter (1), .BR unshare (1), diff --git a/man7/pid_namespaces.7 b/man7/pid_namespaces.7 index 1cea76fc9..2d14cf195 100644 --- a/man7/pid_namespaces.7 +++ b/man7/pid_namespaces.7 @@ -389,7 +389,7 @@ it is translated into the corresponding PID value in the receiving process's PID namespace. .SH CONFORMING TO Namespaces are a Linux-specific feature. -.SH EXAMPLE +.SH EXAMPLES See .BR user_namespaces (7). .SH SEE ALSO diff --git a/man7/pkeys.7 b/man7/pkeys.7 index ffbc13e6a..644def60b 100644 --- a/man7/pkeys.7 +++ b/man7/pkeys.7 @@ -162,7 +162,7 @@ The Linux pkey system calls are available only if the kernel was configured and built with the .BR CONFIG_X86_INTEL_MEMORY_PROTECTION_KEYS option. -.SH EXAMPLE +.SH EXAMPLES .PP The program below allocates a page of memory with read and write permissions. It then writes some data to the memory and successfully reads it diff --git a/man7/rtld-audit.7 b/man7/rtld-audit.7 index eaa17a153..b9751551d 100644 --- a/man7/rtld-audit.7 +++ b/man7/rtld-audit.7 @@ -500,7 +500,7 @@ This is reportedly fixed in glibc 2.10. .\" My simple tests on Solaris work okay, but not on Linux -- mtk, Jan 2009 .\" glibc bug filed: http://sourceware.org/bugzilla/show_bug.cgi?id=9733 .\" Reportedly, this is fixed on 16 Mar 2009 (i.e., for glibc 2.10) -.SH EXAMPLE +.SH EXAMPLES .EX #include #include diff --git a/man7/sem_overview.7 b/man7/sem_overview.7 index cdf7958c5..9362f06ec 100644 --- a/man7/sem_overview.7 +++ b/man7/sem_overview.7 @@ -144,7 +144,7 @@ POSIX semaphores provide a simpler, and better designed interface than System V semaphores; on the other hand POSIX semaphores are less widely available (especially on older systems) than System V semaphores. -.SH EXAMPLE +.SH EXAMPLES An example of the use of various POSIX semaphore functions is shown in .BR sem_wait (3). .SH SEE ALSO diff --git a/man7/sock_diag.7 b/man7/sock_diag.7 index abd9542c2..dc1f31d73 100644 --- a/man7/sock_diag.7 +++ b/man7/sock_diag.7 @@ -637,7 +637,7 @@ and were introduced in Linux 3.6. .SH CONFORMING TO The NETLINK_SOCK_DIAG API is Linux-specific. -.SH EXAMPLE +.SH EXAMPLES The following example program prints inode number, peer's inode number, and name of all UNIX domain sockets in the current namespace. .PP diff --git a/man7/spufs.7 b/man7/spufs.7 index 5b02c6ba9..72398886d 100644 --- a/man7/spufs.7 +++ b/man7/spufs.7 @@ -756,7 +756,7 @@ Any previous value of the object ID is overwritten. Reading this file gives an ASCII hex string representing the object ID for this SPU context. .RE -.SH EXAMPLE +.SH EXAMPLES .TP .IR /etc/fstab " entry" none /spu spufs gid=spu 0 0 diff --git a/man7/time_namespaces.7 b/man7/time_namespaces.7 index 5152d054f..1a76bd204 100644 --- a/man7/time_namespaces.7 +++ b/man7/time_namespaces.7 @@ -211,7 +211,7 @@ For redability, the use of the symbolic names over the numbers is preferred. The motivation for adding time namespaces was to allow the monotonic and boot-time clocks to maintain consistent values during container migration and checkpoint/restore. -.SH EXAMPLE +.SH EXAMPLES .PP The following shell session demonstrates the operation of time namespaces. We begin by displaying the inode number of the time namespace diff --git a/man7/unix.7 b/man7/unix.7 index 60d633c9c..b9fdbdcdc 100644 --- a/man7/unix.7 +++ b/man7/unix.7 @@ -870,7 +870,7 @@ that the applications that .I create pathname sockets follow the rules outlined above under .IR "Pathname sockets" . -.SH EXAMPLE +.SH EXAMPLES The following code demonstrates the use of sequenced-packet sockets for local interprocess communication. It consists of two programs. diff --git a/man7/user_namespaces.7 b/man7/user_namespaces.7 index 1975daf5e..9077498a2 100644 --- a/man7/user_namespaces.7 +++ b/man7/user_namespaces.7 @@ -981,7 +981,7 @@ Linux 3.12 added support for the last of the unsupported major filesystems, .\" commit d6970d4b726cea6d7a9bc4120814f95c09571fc3 XFS. .\" -.SH EXAMPLE +.SH EXAMPLES The program below is designed to allow experimenting with user namespaces, as well as other types of namespaces. It creates namespaces as specified by command-line options and then executes