Use a single-font-style macro (".B", ".I") for a single argument.
Remove unneeded quotation marks (").
The output from "nroff" and "groff" is unchanged.
Signed-off-by: Bjarni Ingi Gislason <bjarniig@xxxxxxxxx>
---
man2/shmctl.2 | 2 +-
man2/shmget.2 | 6 +++---
man2/shmop.2 | 2 +-
man2/shutdown.2 | 2 +-
man2/sigaction.2 | 36 ++++++++++++++++++------------------
man2/sigaltstack.2 | 8 ++++----
man2/signal.2 | 6 +++---
man2/signalfd.2 | 10 +++++-----
man2/sigpending.2 | 4 ++--
man2/sigprocmask.2 | 12 ++++++------
man2/sigreturn.2 | 10 +++++-----
man2/sigsuspend.2 | 6 +++---
man2/sigwaitinfo.2 | 8 ++++----
13 files changed, 56 insertions(+), 56 deletions(-)
diff --git a/man2/shmctl.2 b/man2/shmctl.2
index 010c3be6b..7a8288428 100644
--- a/man2/shmctl.2
+++ b/man2/shmctl.2
@@ -254,7 +254,7 @@ However,
is not checked for read access for
.IR shmid ,
meaning that any user can employ this operation (just as any user may read
-.IR /proc/sysvipc/shm
+.I /proc/sysvipc/shm
to obtain the same information).
.PP
The caller can prevent or allow swapping of a shared
diff --git a/man2/shmget.2 b/man2/shmget.2
index adc839f03..02cd5e956 100644
--- a/man2/shmget.2
+++ b/man2/shmget.2
@@ -229,9 +229,9 @@ shared memory segment, and does not have the
capability in the user namespace that governs its IPC namespace.
.TP
.B EEXIST
-.BR IPC_CREAT
+.B IPC_CREAT
and
-.BR IPC_EXCL
+.B IPC_EXCL
were specified in
.IR shmflg ,
but a shared memory segment already exists for
@@ -365,7 +365,7 @@ The effect of this value
(which is suitable for both 32-bit and 64-bit systems)
is to impose no limitation on allocations.
See the description of
-.BR SHMALL
+.B SHMALL
for a discussion of why this default value (rather than
.BR ULONG_MAX )
is used.
diff --git a/man2/shmop.2 b/man2/shmop.2
index 2a4e7908e..864e7818b 100644
--- a/man2/shmop.2
+++ b/man2/shmop.2
@@ -92,7 +92,7 @@ bit-mask argument:
Allow the contents of the segment to be executed.
The caller must have execute permission on the segment.
.TP
-.BR SHM_RDONLY
+.B SHM_RDONLY
Attach the segment for read-only access.
The process must have read permission for the segment.
If this flag is not specified,
diff --git a/man2/shutdown.2 b/man2/shutdown.2
index 9c85fa1fa..d10a5d81c 100644
--- a/man2/shutdown.2
+++ b/man2/shutdown.2
@@ -79,7 +79,7 @@ is not a valid file descriptor.
.TP
.B EINVAL
An invalid value was specified in
-.IR how
+.I how
(but see BUGS).
.TP
.B ENOTCONN
diff --git a/man2/sigaction.2 b/man2/sigaction.2
index fc4425105..d7e3788bc 100644
--- a/man2/sigaction.2
+++ b/man2/sigaction.2
@@ -218,7 +218,7 @@ Call the signal handler on an alternate signal stack provided by
If an alternate stack is not available, the default stack will be used.
This flag is meaningful only when establishing a signal handler.
.TP
-.BR SA_RESETHAND
+.B SA_RESETHAND
Restore the signal action to the default upon entry to the signal handler.
This flag is meaningful only when establishing a signal handler.
.B SA_ONESHOT
@@ -232,10 +232,10 @@ See
.BR signal (7)
for a discussion of system call restarting.
.TP
-.BR SA_RESTORER
+.B SA_RESTORER
.IR "Not intended for application use" .
This flag is used by C libraries to indicate that the
-.IR sa_restorer
+.I sa_restorer
field contains the address of a "signal trampoline".
See
.BR sigreturn (2)
@@ -258,7 +258,7 @@ When the
flag is specified in
.IR act.sa_flags ,
the signal handler address is passed via the
-.IR act.sa_sigaction
+.I act.sa_sigaction
field.
This handler takes three arguments, as follows:
.PP
@@ -292,7 +292,7 @@ signal context information that was saved
on the user-space stack by the kernel; for details, see
.BR sigreturn (2).
Further information about the
-.IR ucontext_t
+.I ucontext_t
structure can be found in
.BR getcontext (3).
Commonly, the handler function doesn't make any use of the third argument.
@@ -453,7 +453,7 @@ of the (configurable) system jiffy (see
.BR SIGSEGV ,
.BR SIGBUS ,
and
-.BR SIGTRAP
+.B SIGTRAP
fill in
.I si_addr
with the address of the fault.
@@ -477,7 +477,7 @@ For example, if a full page was corrupted,
contains
.IR log2(sysconf(_SC_PAGESIZE)) .
When
-.BR SIGTRAP
+.B SIGTRAP
is delivered in response to a
.BR ptrace (2)
event (PTRACE_EVENT_foo),
@@ -497,16 +497,16 @@ and
are Linux-specific extensions.
.IP
The
-.BR SEGV_BNDERR
+.B SEGV_BNDERR
suberror of
.B SIGSEGV
populates
-.IR si_lower
+.I si_lower
and
.IR si_upper .
.IP
The
-.BR SEGV_PKUERR
+.B SEGV_PKUERR
suberror of
.B SIGSEGV
populates
@@ -526,7 +526,7 @@ The
.I si_fd
field indicates the file descriptor for which the I/O event occurred;
for further details, see the description of
-.BR F_SETSIG
+.B F_SETSIG
in
.BR fcntl (2).
.IP *
@@ -558,7 +558,7 @@ For a
event,
.I si_code
will contain
-.BR SIGTRAP
+.B SIGTRAP
and have the ptrace event in the high byte:
.PP
.in +4n
@@ -826,7 +826,7 @@ Device disconnected.
The following value can be placed in
.I si_code
for a
-.BR SIGSYS
+.B SIGSYS
signal:
.RS 4
.TP
@@ -969,7 +969,7 @@ places the address of the trampoline code in the
field and sets the
.B SA_RESTORER
flag in the
-.IR act.sa_flags
+.I act.sa_flags
field.
See
.BR sigreturn (2).
@@ -978,21 +978,21 @@ The original Linux system call was named
.BR sigaction ().
However, with the addition of real-time signals in Linux 2.2,
the fixed-size, 32-bit
-.IR sigset_t
+.I sigset_t
type supported by that system call was no longer fit for purpose.
Consequently, a new system call,
.BR rt_sigaction (),
was added to support an enlarged
-.IR sigset_t
+.I sigset_t
type.
The new system call takes a fourth argument,
.IR "size_t sigsetsize" ,
which specifies the size in bytes of the signal sets in
-.IR act.sa_mask
+.I act.sa_mask
and
.IR oldact.sa_mask .
This argument is currently required to have the value
-.IR sizeof(sigset_t)
+.I sizeof(sigset_t)
(or the error
.B EINVAL
results).
diff --git a/man2/sigaltstack.2 b/man2/sigaltstack.2
index 22f57b92a..e95e7c886 100644
--- a/man2/sigaltstack.2
+++ b/man2/sigaltstack.2
@@ -121,7 +121,7 @@ the state of the switched-away signal handler.
On kernels where this flag is not supported,
.BR sigaltstack ()
fails with the error
-.BR EINVAL
+.B EINVAL
when this flag is supplied.
.RE
.TP
@@ -141,7 +141,7 @@ size required to execute a signal handler.
To disable an existing stack, specify \fIss.ss_flags\fP
as \fBSS_DISABLE\fP.
In this case, the kernel ignores any other flags in
-.IR ss.ss_flags
+.I ss.ss_flags
and the remaining fields
in \fIss\fP.
.PP
@@ -293,7 +293,7 @@ The following code segment demonstrates the use of
.BR sigaction (2))
to install an alternate signal stack that is employed by a handler
for the
-.BR SIGSEGV
+.B SIGSEGV
signal:
.PP
.in +4n
@@ -339,7 +339,7 @@ a change was made to allow
to allow
.I ss.ss_flags==SS_ONSTACK
with the same meaning as
-.IR "ss.ss_flags==0"
+.I ss.ss_flags==0
(i.e., the inclusion of
.B SS_ONSTACK
in
diff --git a/man2/signal.2 b/man2/signal.2
index 3d79a5ae3..e6f1962a8 100644
--- a/man2/signal.2
+++ b/man2/signal.2
@@ -157,7 +157,7 @@ if
.B _BSD_SOURCE
(glibc 2.19 and earlier)
or
-.BR _DEFAULT_SOURCE
+.B _DEFAULT_SOURCE
(glibc 2.19 and later)
is defined.
Without use of such a type, the declaration of
@@ -173,7 +173,7 @@ is the somewhat harder to read:
The only portable use of
.BR signal ()
is to set a signal's disposition to
-.BR SIG_DFL
+.B SIG_DFL
or
.BR SIG_IGN .
The semantics when using
@@ -244,7 +244,7 @@ This default behavior is provided as long as a suitable
feature test macro is defined:
.B _BSD_SOURCE
on glibc 2.19 and earlier or
-.BR _DEFAULT_SOURCE
+.B _DEFAULT_SOURCE
in glibc 2.19 and later.
(By default, these macros are defined; see
.BR feature_test_macros (7)
diff --git a/man2/signalfd.2 b/man2/signalfd.2
index 87a975cc2..48c2d0deb 100644
--- a/man2/signalfd.2
+++ b/man2/signalfd.2
@@ -71,13 +71,13 @@ then it must specify a valid existing signalfd file descriptor, and
is used to replace the signal set associated with that file descriptor.
.PP
Starting with Linux 2.6.27, the following values may be bitwise ORed in
-.IR flags
+.I flags
to change the behavior of
.BR signalfd ():
.TP 14
.B SFD_NONBLOCK
Set the
-.BR O_NONBLOCK
+.B O_NONBLOCK
file status flag on the open file description (see
.BR open (2))
referred to by the new file descriptor.
@@ -347,7 +347,7 @@ are silently ignored.
.PP
The signal mask employed by a signalfd file descriptor can be viewed
via the entry for the corresponding file descriptor in the process's
-.IR /proc/[pid]/fdinfo
+.I /proc/[pid]/fdinfo
directory.
See
.BR proc (5)
@@ -356,10 +356,10 @@ for further details.
.SS Limitations
The signalfd mechanism can't be used to receive signals that
are synchronously generated, such as the
-.BR SIGSEGV
+.B SIGSEGV
signal that results from accessing an invalid memory address
or the
-.BR SIGFPE
+.B SIGFPE
signal that results from an arithmetic error.
Such signals can be caught only via signal handler.
.PP
diff --git a/man2/sigpending.2 b/man2/sigpending.2
index 874d1dd5b..bc2dc65c8 100644
--- a/man2/sigpending.2
+++ b/man2/sigpending.2
@@ -88,12 +88,12 @@ The original Linux system call was named
.BR sigpending ().
However, with the addition of real-time signals in Linux 2.2,
the fixed-size, 32-bit
-.IR sigset_t
+.I sigset_t
argument supported by that system call was no longer fit for purpose.
Consequently, a new system call,
.BR rt_sigpending (),
was added to support an enlarged
-.IR sigset_t
+.I sigset_t
type.
The new system call takes a second argument,
.IR "size_t sigsetsize" ,
diff --git a/man2/sigprocmask.2 b/man2/sigprocmask.2
index a032620a9..7a4397047 100644
--- a/man2/sigprocmask.2
+++ b/man2/sigprocmask.2
@@ -167,7 +167,7 @@ as NULL.
.SS C library/kernel differences
.PP
The kernel's definition of
-.IR sigset_t
+.I sigset_t
differs in size from that used
by the C library.
In this manual page, the former is referred to as
@@ -188,23 +188,23 @@ The original Linux system call was named
.BR sigprocmask ().
However, with the addition of real-time signals in Linux 2.2,
the fixed-size, 32-bit
-.IR sigset_t
+.I sigset_t
(referred to as
-.IR old_kernel_sigset_t
+.I old_kernel_sigset_t
in this manual page)
type supported by that system call was no longer fit for purpose.
Consequently, a new system call,
.BR rt_sigprocmask (),
was added to support an enlarged
-.IR sigset_t
+.I sigset_t
type
(referred to as
-.IR kernel_sigset_t
+.I kernel_sigset_t
in this manual page).
The new system call takes a fourth argument,
.IR "size_t sigsetsize" ,
which specifies the size in bytes of the signal sets in
-.IR set
+.I set
and
.IR oldset .
This argument is currently required to have a fixed architecture specific value
diff --git a/man2/sigreturn.2 b/man2/sigreturn.2
index 690c34efb..667aeaac4 100644
--- a/man2/sigreturn.2
+++ b/man2/sigreturn.2
@@ -31,7 +31,7 @@
.SH NAME
sigreturn, rt_sigreturn \- return from signal handler and cleanup stack frame
.SH SYNOPSIS
-.BI "int sigreturn(...);"
+.B "int sigreturn(...);"
.SH DESCRIPTION
If the Linux kernel determines that an unblocked
signal is pending for a process, then,
@@ -116,9 +116,9 @@ field of the
.I sigaction
structure,
and sets the
-.BR SA_RESTORER
+.B SA_RESTORER
flag in the
-.IR sa_flags
+.I sa_flags
field.
.PP
The saved process context information is placed in a
@@ -129,7 +129,7 @@ That structure is visible within the signal handler
as the third argument of a handler established via
.BR sigaction (2)
with the
-.BR SA_SIGINFO
+.B SA_SIGINFO
flag.
.PP
On some other UNIX systems,
@@ -147,7 +147,7 @@ However, with the addition of real-time signals in Linux 2.2,
a new system call,
.BR rt_sigreturn ()
was added to support an enlarged
-.IR sigset_t
+.I sigset_t
type.
The GNU C library
hides these details from us, transparently employing
diff --git a/man2/sigsuspend.2 b/man2/sigsuspend.2
index 19e2a7c37..e77288067 100644
--- a/man2/sigsuspend.2
+++ b/man2/sigsuspend.2
@@ -112,19 +112,19 @@ The original Linux system call was named
.BR sigsuspend ().
However, with the addition of real-time signals in Linux 2.2,
the fixed-size, 32-bit
-.IR sigset_t
+.I sigset_t
type supported by that system call was no longer fit for purpose.
Consequently, a new system call,
.BR rt_sigsuspend (),
was added to support an enlarged
-.IR sigset_t
+.I sigset_t
type.
The new system call takes a second argument,
.IR "size_t sigsetsize" ,
which specifies the size in bytes of the signal set in
.IR mask .
This argument is currently required to have the value
-.IR sizeof(sigset_t)
+.I sizeof(sigset_t)
(or the error
.B EINVAL
results).
diff --git a/man2/sigwaitinfo.2 b/man2/sigwaitinfo.2
index 4aa311ab9..45c16ee5d 100644
--- a/man2/sigwaitinfo.2
+++ b/man2/sigwaitinfo.2
@@ -177,10 +177,10 @@ or
.BR sigtimedwait (),
can't be used to receive signals that
are synchronously generated, such as the
-.BR SIGSEGV
+.B SIGSEGV
signal that results from accessing an invalid memory address
or the
-.BR SIGFPE
+.B SIGFPE
signal that results from an arithmetic error.
Such signals can be caught only via signal handler.
.PP
@@ -218,14 +218,14 @@ type supported by that system call was no longer fit for purpose.
Consequently, a new system call,
.BR rt_sigtimedwait (),
was added to support an enlarged
-.IR sigset_t
+.I sigset_t
type.
The new system call takes a fourth argument,
.IR "size_t sigsetsize" ,
which specifies the size in bytes of the signal set in
.IR set .
This argument is currently required to have the value
-.IR sizeof(sigset_t)
+.I sizeof(sigset_t)
(or the error
.B EINVAL
results).
--
2.20.1
