Use a single-font-style macro (".B", ".I") for a single argument.
Remove unneeded quotation marks (").
Separate "()" from a function name in file "posix_spawn.3".
Separate punctuation mark from a word in file "posix_spawn.3".
The output from "nroff" and "groff" is unchanged, except for the
style of "()" and of a punctuation mark in the file "posix_spawn.3".
Signed-off-by: Bjarni Ingi Gislason <bjarniig@xxxxxxxxx>
---
man3/open_memstream.3 | 4 ++--
man3/posix_madvise.3 | 2 +-
man3/posix_memalign.3 | 2 +-
man3/posix_spawn.3 | 24 ++++++++++++------------
man3/pow.3 | 4 ++--
man3/printf.3 | 6 +++---
man3/pthread_atfork.3 | 2 +-
man3/pthread_attr_init.3 | 2 +-
man3/pthread_attr_setaffinity_np.3 | 8 ++++----
man3/pthread_attr_setdetachstate.3 | 4 ++--
man3/pthread_attr_setinheritsched.3 | 6 +++---
man3/pthread_attr_setschedparam.3 | 4 ++--
man3/pthread_attr_setschedpolicy.3 | 4 ++--
man3/pthread_attr_setscope.3 | 6 +++---
man3/pthread_attr_setstack.3 | 14 +++++++-------
man3/pthread_attr_setstacksize.3 | 4 ++--
16 files changed, 48 insertions(+), 48 deletions(-)
diff --git a/man3/open_memstream.3 b/man3/open_memstream.3
index b3cc47b32..f0f75e488 100644
--- a/man3/open_memstream.3
+++ b/man3/open_memstream.3
@@ -51,7 +51,7 @@ After closing the stream, the caller should
this buffer.
.PP
The locations pointed to by
-.IR ptr
+.I ptr
and
.I sizeloc
are used to report, respectively,
@@ -115,7 +115,7 @@ Interface Attribute Value
T{
.BR open_memstream (),
.br
-.BR open_wmemstream
+.B open_wmemstream
T} Thread safety MT-Safe
.TE
.sp 1
diff --git a/man3/posix_madvise.3 b/man3/posix_madvise.3
index fe0781dec..985c5fa19 100644
--- a/man3/posix_madvise.3
+++ b/man3/posix_madvise.3
@@ -117,7 +117,7 @@ as 0 is permitted (as a successful no-op).
In glibc, this function is implemented using
.BR madvise (2).
However, since glibc 2.6,
-.BR POSIX_MADV_DONTNEED
+.B POSIX_MADV_DONTNEED
is treated as a no-op, because the corresponding
.BR madvise (2)
value,
diff --git a/man3/posix_memalign.3 b/man3/posix_memalign.3
index b4e355662..ce6adc0c0 100644
--- a/man3/posix_memalign.3
+++ b/man3/posix_memalign.3
@@ -95,7 +95,7 @@ If
.I size
is 0, then
the value placed in
-.IR "*memptr"
+.I *memptr
is either NULL,
.\" glibc does this:
or a unique pointer value that can later be successfully passed to
diff --git a/man3/posix_spawn.3 b/man3/posix_spawn.3
index 3e1e9011c..c600b4ce9 100644
--- a/man3/posix_spawn.3
+++ b/man3/posix_spawn.3
@@ -91,7 +91,7 @@ With
.BR posix_spawnp (),
the executable file is specified as a simple filename;
the system searches for this file in the list of directories specified by
-.BR PATH
+.B PATH
(in the same way as for
.BR execvp (3)).
For the remainder of this page, the discussion is phrased in terms of
@@ -147,7 +147,7 @@ that is executed in the child process, as for
.BR execve (2).
.PP
Below, the functions are described in terms of a three-step process: the
-.BR fork()
+.BR fork ()
step, the
.RB pre- exec ()
step (executed in the child),
@@ -224,7 +224,7 @@ and
functions support a small, well-defined set of system tasks that the child
process can accomplish before it executes the executable file.
These operations are controlled by the attributes object pointed to by
-.IR attrp
+.I attrp
and the file actions object pointed to by
.IR file_actions .
In the child, processing is done in the following sequence:
@@ -249,7 +249,7 @@ flag set are closed.
All process attributes in the child,
other than those affected by attributes specified in the
object pointed to by
-.IR attrp
+.I attrp
and the file actions in the object pointed to by
.IR file_actions ,
will be affected as though the child was created with
@@ -269,7 +269,7 @@ and other attributes in the object specify values
to be used during those actions.
.PP
The effects of the flags that may be specified in
-.IR spawn-flags
+.I spawn-flags
are as follows:
.TP 8
.B POSIX_SPAWN_SETSIGMASK
@@ -293,7 +293,7 @@ attribute
.\" (see
.\" .BR posix_spawnattr_setsigdefault (3))
of the object pointed to by
-.IR attrp
+.I attrp
to the default.
For the treatment of the dispositions of signals not specified in the
.I spawn-sigdefault
@@ -337,7 +337,7 @@ attribute
.\" (see
.\" .BR posix_spawnattr_setschedparam (3))
of the object pointed to by
-.IR attrp
+.I attrp
(but see BUGS).
.PP
If the
@@ -463,7 +463,7 @@ If there is an error before or during the
.BR fork (2),
then no child is created,
the contents of
-.IR *pid
+.I *pid
are unspecified,
and these functions return an error number as described below.
.PP
@@ -546,7 +546,7 @@ is to
However, this functionality can be obtained by specifying the
.I path
argument as one of the files in the caller's
-.IR /proc/self/fd
+.I /proc/self/fd
directory.
.SH BUGS
POSIX.1 says that when
@@ -560,7 +560,7 @@ However, before glibc 2.14, calls to
.BR posix_spawn ()
failed with an error if
.\" http://sourceware.org/bugzilla/show_bug.cgi?id=12052
-.BR POSIX_SPAWN_SETSCHEDULER
+.B POSIX_SPAWN_SETSCHEDULER
was specified without also specifying
.BR POSIX_SPAWN_SETSCHEDPARAM .
.SH EXAMPLE
@@ -613,7 +613,7 @@ Consequently, trying to kill child with the default signal sent by
.BR SIGTERM )
fails, because that signal is blocked.
Therefore, to kill the child,
-.BR SIGKILL
+.B SIGKILL
is necessary
.RB ( SIGKILL
can't be blocked).
@@ -803,6 +803,6 @@ main(int argc, char *argv[])
.BR posix_spawnattr_setsigdefault (3),
.BR posix_spawnattr_setsigmask (3),
.BR pthread_atfork (3),
-.BR <spawn.h>,
+.BR <spawn.h> ,
Base Definitions volume of POSIX.1-2001,
.I http://www.opengroup.org/unix/online.html
diff --git a/man3/pow.3 b/man3/pow.3
index 2f8b340bb..c21a634aa 100644
--- a/man3/pow.3
+++ b/man3/pow.3
@@ -286,7 +286,7 @@ is raised.
Pole error: \fIx\fP is zero, and \fIy\fP is negative
.I errno
is set to
-.BR ERANGE
+.B ERANGE
(but see BUGS).
A divide-by-zero floating-point exception
.RB ( FE_DIVBYZERO )
@@ -348,7 +348,7 @@ In glibc 2.9 and earlier,
when a pole error occurs,
.I errno
is set to
-.BR EDOM
+.B EDOM
instead of the POSIX-mandated
.BR ERANGE .
Since version 2.10,
diff --git a/man3/printf.3 b/man3/printf.3
index 7dc136f90..0291393a9 100644
--- a/man3/printf.3
+++ b/man3/printf.3
@@ -553,7 +553,7 @@ argument.
.TP
.B Z
A nonstandard synonym for
-.BR z
+.B z
that predates the appearance of
.BR z .
Do not use in new code.
@@ -603,11 +603,11 @@ As a nonstandard extension, the GNU implementations treats
and
.B L
as synonyms, so that one can, for example, write
-.BR llg
+.B llg
(as a synonym for the standards-compliant
.RB Lg )
and
-.BR Ld
+.B Ld
(as a synonym for the standards compliant
.BR lld ).
Such usage is nonportable.
diff --git a/man3/pthread_atfork.3 b/man3/pthread_atfork.3
index 003833ab6..faf9a2fca 100644
--- a/man3/pthread_atfork.3
+++ b/man3/pthread_atfork.3
@@ -46,7 +46,7 @@ The handlers are executed in the context of the thread that calls
.PP
Three kinds of handler can be registered:
.IP * 3
-.IR prepare
+.I prepare
specifies a handler that is executed before
.BR fork (2)
processing starts.
diff --git a/man3/pthread_attr_init.3 b/man3/pthread_attr_init.3
index b42e1798e..def0a4f9c 100644
--- a/man3/pthread_attr_init.3
+++ b/man3/pthread_attr_init.3
@@ -40,7 +40,7 @@ Compile and link with \fI\-pthread\fP.
The
.BR pthread_attr_init ()
function initializes the thread attributes object pointed to by
-.IR attr
+.I attr
with default attribute values.
After this call, individual attributes of the object can be set
using various related functions (listed under SEE ALSO),
diff --git a/man3/pthread_attr_setaffinity_np.3 b/man3/pthread_attr_setaffinity_np.3
index 22f2847a0..dfd612d86 100644
--- a/man3/pthread_attr_setaffinity_np.3
+++ b/man3/pthread_attr_setaffinity_np.3
@@ -57,7 +57,7 @@ The
function
returns the CPU affinity mask attribute of the thread attributes object
referred to by
-.IR attr
+.I attr
in the buffer pointed to by
.IR cpuset .
.PP
@@ -78,12 +78,12 @@ On success, these functions return 0;
on error, they return a nonzero error number.
.SH ERRORS
.TP
-.BR EINVAL
+.B EINVAL
.RB ( pthread_attr_setaffinity_np ())
.I cpuset
specified a CPU that was outside the set supported by the kernel.
(The kernel configuration option
-.BR CONFIG_NR_CPUS
+.B CONFIG_NR_CPUS
defines the range of the set supported by the kernel data type
.\" cpumask_t
used to represent CPU sets.)
@@ -95,7 +95,7 @@ used to represent CPU sets.)
A CPU in the affinity mask of the thread attributes object referred to by
.I attr
lies outside the range specified by
-.IR cpusetsize
+.I cpusetsize
(i.e.,
.IR cpuset / cpusetsize
is too small).
diff --git a/man3/pthread_attr_setdetachstate.3 b/man3/pthread_attr_setdetachstate.3
index 76c63fb8f..70b4014fa 100644
--- a/man3/pthread_attr_setdetachstate.3
+++ b/man3/pthread_attr_setdetachstate.3
@@ -43,7 +43,7 @@ The
.BR pthread_attr_setdetachstate ()
function sets the detach state attribute of the
thread attributes object referred to by
-.IR attr
+.I attr
to the value specified in
.IR detachstate .
The detach state attribute determines whether a thread created using
@@ -71,7 +71,7 @@ thread attributes object is
The
.BR pthread_attr_getdetachstate ()
returns the detach state attribute of the thread attributes object
-.IR attr
+.I attr
in the buffer pointed to by
.IR detachstate .
.SH RETURN VALUE
diff --git a/man3/pthread_attr_setinheritsched.3 b/man3/pthread_attr_setinheritsched.3
index cdbc0db7e..cf8dca49a 100644
--- a/man3/pthread_attr_setinheritsched.3
+++ b/man3/pthread_attr_setinheritsched.3
@@ -43,7 +43,7 @@ The
.BR pthread_attr_setinheritsched ()
function sets the inherit-scheduler attribute of the
thread attributes object referred to by
-.IR attr
+.I attr
to the value specified in
.IR inheritsched .
The inherit-scheduler attribute determines whether a thread created using
@@ -87,7 +87,7 @@ a newly initialized thread attributes object is
The
.BR pthread_attr_getinheritsched ()
returns the inherit-scheduler attribute of the thread attributes object
-.IR attr
+.I attr
in the buffer pointed to by
.IR inheritsched .
.SH RETURN VALUE
@@ -126,7 +126,7 @@ POSIX.1-2001, POSIX.1-2008.
As at glibc 2.8, if a thread attributes object is initialized using
.BR pthread_attr_init (3),
then the scheduling policy of the attributes object is set to
-.BR SCHED_OTHER
+.B SCHED_OTHER
and the scheduling priority is set to 0.
However, if the inherit-scheduler attribute is then set to
.BR PTHREAD_EXPLICIT_SCHED ,
diff --git a/man3/pthread_attr_setschedparam.3 b/man3/pthread_attr_setschedparam.3
index 003c88ebb..5ed24d446 100644
--- a/man3/pthread_attr_setschedparam.3
+++ b/man3/pthread_attr_setschedparam.3
@@ -43,7 +43,7 @@ The
.BR pthread_attr_setschedparam ()
function sets the scheduling parameter attributes of the
thread attributes object referred to by
-.IR attr
+.I attr
to the values specified in the buffer pointed to by
.IR param .
These attributes determine the scheduling parameters of
@@ -53,7 +53,7 @@ a thread created using the thread attributes object
The
.BR pthread_attr_getschedparam ()
returns the scheduling parameter attributes of the thread attributes object
-.IR attr
+.I attr
in the buffer pointed to by
.IR param .
.PP
diff --git a/man3/pthread_attr_setschedpolicy.3 b/man3/pthread_attr_setschedpolicy.3
index 9b1dd2588..8fc9ee68c 100644
--- a/man3/pthread_attr_setschedpolicy.3
+++ b/man3/pthread_attr_setschedpolicy.3
@@ -43,7 +43,7 @@ The
.BR pthread_attr_setschedpolicy ()
function sets the scheduling policy attribute of the
thread attributes object referred to by
-.IR attr
+.I attr
to the value specified in
.IR policy .
This attribute determines the scheduling policy of
@@ -66,7 +66,7 @@ with the semantics described in
The
.BR pthread_attr_getschedpolicy ()
returns the scheduling policy attribute of the thread attributes object
-.IR attr
+.I attr
in the buffer pointed to by
.IR policy .
.PP
diff --git a/man3/pthread_attr_setscope.3 b/man3/pthread_attr_setscope.3
index 6922fef85..c158dc332 100644
--- a/man3/pthread_attr_setscope.3
+++ b/man3/pthread_attr_setscope.3
@@ -62,9 +62,9 @@ according to their scheduling policy and priority.
.B PTHREAD_SCOPE_PROCESS
The thread competes for resources with all other threads
in the same process that were also created with the
-.BR PTHREAD_SCOPE_PROCESS
+.B PTHREAD_SCOPE_PROCESS
contention scope.
-.BR PTHREAD_SCOPE_PROCESS
+.B PTHREAD_SCOPE_PROCESS
threads are scheduled relative to other threads in the process
according to their scheduling policy and priority.
POSIX.1 leaves it unspecified how these threads contend
@@ -112,7 +112,7 @@ An invalid value was specified in
.IR scope .
.TP
.B ENOTSUP
-.IR scope
+.I scope
specified the value
.BR PTHREAD_SCOPE_PROCESS ,
which is not supported on Linux.
diff --git a/man3/pthread_attr_setstack.3 b/man3/pthread_attr_setstack.3
index 54759838b..fd7dc5065 100644
--- a/man3/pthread_attr_setstack.3
+++ b/man3/pthread_attr_setstack.3
@@ -58,7 +58,7 @@ function sets the stack address and stack size attributes of the
thread attributes object referred to by
.I attr
to the values specified in
-.IR stackaddr
+.I stackaddr
and
.IR stacksize ,
respectively.
@@ -78,7 +78,7 @@ function returns the stack address and stack size attributes of the
thread attributes object referred to by
.I attr
in the buffers pointed to by
-.IR stackaddr
+.I stackaddr
and
.IR stacksize ,
respectively.
@@ -92,16 +92,16 @@ can fail with the following error:
.B EINVAL
.I stacksize
is less than
-.BR PTHREAD_STACK_MIN
+.B PTHREAD_STACK_MIN
(16384) bytes.
On some systems, this error may also occur if
-.IR stackaddr
+.I stackaddr
or
-.IR "stackaddr\ +\ stacksize"
+.I stackaddr\ +\ stacksize
is not suitably aligned.
.PP
POSIX.1 also documents an
-.BR EACCES
+.B EACCES
error if the stack area described by
.I stackaddr
and
@@ -152,7 +152,7 @@ for full portability, align it on a page boundary
.BR posix_memalign (3)
may be useful for allocation.
Probably,
-.IR stacksize
+.I stacksize
should also be a multiple of the system page size.
.PP
If
diff --git a/man3/pthread_attr_setstacksize.3 b/man3/pthread_attr_setstacksize.3
index 9f01b4039..487a0526d 100644
--- a/man3/pthread_attr_setstacksize.3
+++ b/man3/pthread_attr_setstacksize.3
@@ -67,7 +67,7 @@ can fail with the following error:
.TP
.B EINVAL
The stack size is less than
-.BR PTHREAD_STACK_MIN
+.B PTHREAD_STACK_MIN
(16384) bytes.
.PP
On some systems,
@@ -111,7 +111,7 @@ As at glibc 2.8,
if the specified
.I stacksize
is not a multiple of
-.BR STACK_ALIGN
+.B STACK_ALIGN
(16 bytes on most architectures), it may be rounded
.IR downward ,
in violation of POSIX.1, which says that the allocated stack will
--
2.20.1
