aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--man1/getent.123
-rw-r--r--man1/iconv.126
-rw-r--r--man1/ldd.116
-rw-r--r--man1/locale.128
-rw-r--r--man1/localedef.118
-rw-r--r--man1/pldd.18
-rw-r--r--man1/sprof.120
-rw-r--r--man2/accept.24
-rw-r--r--man2/close.24
-rw-r--r--man2/connect.24
-rw-r--r--man2/eventfd.26
-rw-r--r--man2/fcntl.24
-rw-r--r--man2/fsync.28
-rw-r--r--man2/memfd_create.26
-rw-r--r--man2/mmap.24
-rw-r--r--man2/perf_event_open.272
-rw-r--r--man2/prctl.24
-rw-r--r--man2/ptrace.224
-rw-r--r--man2/reboot.28
-rw-r--r--man2/shmget.24
-rw-r--r--man2/signalfd.26
-rw-r--r--man2/sync.24
-rw-r--r--man2/sysctl.24
-rw-r--r--man2/timerfd_create.26
-rw-r--r--man3/getaddrinfo.34
-rw-r--r--man3/getdate.34
-rw-r--r--man3/getnameinfo.34
-rw-r--r--man4/hpsa.410
-rw-r--r--man4/lirc.45
-rw-r--r--man4/loop.44
-rw-r--r--man4/random.44
-rw-r--r--man4/rtc.436
-rw-r--r--man4/smartpqi.46
-rw-r--r--man5/elf.537
-rw-r--r--man5/proc_pid_status.530
-rw-r--r--man7/address_families.74
-rw-r--r--man7/feature_test_macros.72
-rw-r--r--man7/ip.78
-rw-r--r--man7/netdevice.754
-rw-r--r--man7/netlink.74
-rw-r--r--man7/rtnetlink.748
-rw-r--r--man7/socket.712
-rw-r--r--man7/spufs.751
-rw-r--r--man7/standards.78
-rw-r--r--man8/iconvconfig.814
45 files changed, 508 insertions, 152 deletions
diff --git a/man1/getent.1 b/man1/getent.1
index badf4d6e26..4fcc27abfd 100644
--- a/man1/getent.1
+++ b/man1/getent.1
@@ -325,32 +325,41 @@ in succession to
and display the result.
.SH OPTIONS
.TP
-.BR \-s\ \fIservice\fP ", " \-\-service\ \fIservice\fP
+.BI \-s\~ service
+.TQ
+.BI \-\-service\~ service
.\" commit 9d0881aa76b399e6a025c5cf44bebe2ae0efa8af (glibc)
Override all databases with the specified service.
(Since glibc 2.2.5.)
.TP
-.BR \-s\ \fIdatabase\fP:\fIservice\fP ", "\
-\-\-service\ \fIdatabase\fP:\fIservice\fP
+.BI \-s\~ database : service
+.TQ
+.BI \-\-service\~ database : service
.\" commit b4f6f4be85d32b9c03361c38376e36f08100e3e8 (glibc)
Override only specified databases with the specified service.
The option may be used multiple times,
but only the last service for each database will be used.
(Since glibc 2.4.)
.TP
-.BR \-i ", " \-\-no\-idn
+.B \-i
+.TQ
+.B \-\-no\-idn
.\" commit a160f8d808cf8020b13bd0ef4a9eaf3c11f964ad (glibc)
Disables IDN encoding in lookups for
.BR ahosts / getaddrinfo (3)
(Since glibc-2.13.)
.TP
-.BR \-? ", " \-\-help
+.B \-?
+.TQ
+.B \-\-help
Print a usage summary and exit.
.TP
-.B "\-\-usage"
+.B \-\-usage
Print a short usage summary and exit.
.TP
-.BR \-V ", " \-\-version
+.B \-V
+.TQ
+.B \-\-version
Print the version number, license, and disclaimer of warranty for
.BR getent .
.SH EXIT STATUS
diff --git a/man1/iconv.1 b/man1/iconv.1
index 959275183c..7a44a5bf1d 100644
--- a/man1/iconv.1
+++ b/man1/iconv.1
@@ -62,32 +62,42 @@ looking characters.
Characters that are outside of the target character set and cannot be
transliterated are replaced with a question mark (?) in the output.
.TP
-.BR \-l ", " \-\-list
+.B \-l
+.TQ
+.B \-\-list
List all known character set encodings.
.TP
-.B "\-c"
+.B \-c
Silently discard characters that cannot be converted instead of
terminating when encountering such characters.
.TP
-.BI \-o " outputfile" "\fR, \fP\-\-output=" outputfile
+.BI \-o\~ outputfile
+.TQ
+.BI \-\-output= outputfile
Use
.I outputfile
for output.
.TP
-.BR \-s ", " \-\-silent
+.B \-s
+.TQ
+.B \-\-silent
This option is ignored; it is provided only for compatibility.
.TP
-.B "\-\-verbose"
+.B \-\-verbose
Print progress information on standard error when processing
multiple files.
.TP
-.BR \-? ", " \-\-help
+.B \-?
+.TQ
+.B \-\-help
Print a usage summary and exit.
.TP
-.B "\-\-usage"
+.B \-\-usage
Print a short usage summary and exit.
.TP
-.BR \-V ", " \-\-version
+.B \-V
+.TQ
+.B \-\-version
Print the version number, license, and disclaimer of warranty for
.BR iconv .
.SH EXIT STATUS
diff --git a/man1/ldd.1 b/man1/ldd.1
index cca96ec4de..1e115b9d75 100644
--- a/man1/ldd.1
+++ b/man1/ldd.1
@@ -114,18 +114,26 @@ shows the entire dependency tree of the executable.
Print the version number of
.BR ldd .
.TP
-.BR \-v ", " \-\-verbose
+.B \-v
+.TQ
+.B \-\-verbose
Print all information, including, for example,
symbol versioning information.
.TP
-.BR \-u ", " \-\-unused
+.B \-u
+.TQ
+.B \-\-unused
Print unused direct dependencies.
(Since glibc 2.3.4.)
.TP
-.BR \-d ", " \-\-data\-relocs
+.B \-d
+.TQ
+.B \-\-data\-relocs
Perform relocations and report any missing objects (ELF only).
.TP
-.BR \-r ", " \-\-function\-relocs
+.B \-r
+.TQ
+.B \-\-function\-relocs
Perform relocations for both data objects and functions, and
report any missing objects or functions (ELF only).
.TP
diff --git a/man1/locale.1 b/man1/locale.1
index 6754aa1f0e..db85098b10 100644
--- a/man1/locale.1
+++ b/man1/locale.1
@@ -35,7 +35,9 @@ or the
option (or one of their long-format equivalents) is specified,
the behavior is as follows:
.TP
-.BR \-a ", " \-\-all\-locales
+.B \-a
+.TQ
+.B \-\-all\-locales
Display a list of all available locales.
The
.B \-v
@@ -43,7 +45,9 @@ option causes the
.B LC_IDENTIFICATION
metadata about each locale to be included in the output.
.TP
-.BR \-m ", " \-\-charmaps
+.B \-m
+.TQ
+.B \-\-charmaps
Display the available charmaps (character set description files).
To display the current character set for the locale, use
\fBlocale \-c charmap\fR.
@@ -70,7 +74,9 @@ the values of all keywords in that category are displayed.
.PP
When arguments are supplied, the following options are meaningful:
.TP
-.BR \-c ", " \-\-category\-name
+.B \-c
+.TQ
+.B \-\-category\-name
For a category name argument,
write the name of the locale category
on a separate line preceding the list of keyword values for that category.
@@ -84,7 +90,9 @@ It can be combined with the
.B \-k
option.
.TP
-.BR \-k ", " \-\-keyword\-name
+.B \-k
+.TQ
+.B \-\-keyword\-name
For each keyword whose value is being displayed,
include also the name of that keyword,
so that the output has the format:
@@ -99,17 +107,23 @@ The
.B locale
command also knows about the following options:
.TP
-.BR \-v ", " \-\-verbose
+.B \-v
+.TQ
+.B \-\-verbose
Display additional information for some command-line option and argument
combinations.
.TP
-.BR \-? ", " \-\-help
+.B \-?
+.TQ
+.B \-\-help
Display a summary of command-line options and arguments and exit.
.TP
.B \-\-usage
Display a short usage message and exit.
.TP
-.BR \-V ", " \-\-version
+.B \-V
+.TQ
+.B \-\-version
Display the program version and exit.
.SH FILES
.TP
diff --git a/man1/localedef.1 b/man1/localedef.1
index cab34f0c65..c59a9c8c53 100644
--- a/man1/localedef.1
+++ b/man1/localedef.1
@@ -206,11 +206,15 @@ Use
to look up aliases for locale names.
There is no default aliases file.
.TP
-.BR \-c ", " \-\-force
+.B \-c
+.TQ
+.B \-\-force
Write the output files even if warnings were generated about the input
file.
.TP
-.BR \-v ", " \-\-verbose
+.B \-v
+.TQ
+.B \-\-verbose
Generate extra warnings about errors that are normally ignored.
.TP
.B \-\-big\-endian
@@ -274,15 +278,19 @@ Supported warnings are
and
.IR intcurrsym .
.TP
-.BR \-? ", " \-\-help
+.B \-?
+.TQ
+.B \-\-help
Print a usage summary and exit.
Also prints the default paths used by
.BR localedef .
.TP
-.B "\-\-usage"
+.B \-\-usage
Print a short usage summary and exit.
.TP
-.BR \-V ", " \-\-version
+.B \-V
+.TQ
+.B \-\-version
Print the version number,
license,
and disclaimer of warranty for
diff --git a/man1/pldd.1 b/man1/pldd.1
index f7bff8c2ff..3a7c02b928 100644
--- a/man1/pldd.1
+++ b/man1/pldd.1
@@ -19,13 +19,17 @@ The list includes the libraries that have been dynamically loaded using
.BR dlopen (3).
.SH OPTIONS
.TP
-.BR \-? ", " \-\-help
+.B \-?
+.TQ
+.B \-\-help
Display a help message and exit.
.TP
.B \-\-usage
Display a short usage message and exit.
.TP
-.BR \-V ", " \-\-version
+.B \-V
+.TQ
+.B \-\-version
Display program version information and exit.
.SH EXIT STATUS
On success,
diff --git a/man1/sprof.1 b/man1/sprof.1
index 0807ee5bd1..1f99bc932e 100644
--- a/man1/sprof.1
+++ b/man1/sprof.1
@@ -27,16 +27,22 @@ in the current directory.
The following command-line options specify the profile output
to be produced:
.TP
-.BR \-c ", " \-\-call\-pairs
+.B \-c
+.TQ
+.B \-\-call\-pairs
Print a list of pairs of call paths for the interfaces exported
by the shared object,
along with the number of times each path is used.
.TP
-.BR \-p ", " \-\-flat\-profile
+.B \-p
+.TQ
+.B \-\-flat\-profile
Generate a flat profile of all of the functions in the monitored object,
with counts and ticks.
.TP
-.BR \-q ", " \-\-graph
+.B \-q
+.TQ
+.B \-\-graph
Generate a call graph.
.PP
If none of the above options is specified,
@@ -44,13 +50,17 @@ then the default behavior is to display a flat profile and a call graph.
.PP
The following additional command-line options are available:
.TP
-.BR \-? ", " \-\-help
+.B \-?
+.TQ
+.B \-\-help
Display a summary of command-line options and arguments and exit.
.TP
.B \-\-usage
Display a short usage message and exit.
.TP
-.BR \-V ", " \-\-version
+.B \-V
+.TQ
+.B \-\-version
Display the program version and exit.
.SH STANDARDS
GNU.
diff --git a/man2/accept.2 b/man2/accept.2
index ee1935c9a4..788a814c24 100644
--- a/man2/accept.2
+++ b/man2/accept.2
@@ -222,7 +222,9 @@ The per-process limit on the number of open file descriptors has been reached.
.B ENFILE
The system-wide limit on the total number of open files has been reached.
.TP
-.BR ENOBUFS ", " ENOMEM
+.B ENOBUFS
+.TQ
+.B ENOMEM
Not enough free memory.
This often means that the memory allocation is limited by the socket buffer
limits, not by the system memory.
diff --git a/man2/close.2 b/man2/close.2
index f8a4ccc2d7..2d37e2b127 100644
--- a/man2/close.2
+++ b/man2/close.2
@@ -74,7 +74,9 @@ call was interrupted by a signal; see
.B EIO
An I/O error occurred.
.TP
-.BR ENOSPC ", " EDQUOT
+.B ENOSPC
+.TQ
+.B EDQUOT
On NFS, these errors are not normally reported against the first write
which exceeds the available storage space, but instead against a
subsequent
diff --git a/man2/connect.2 b/man2/connect.2
index 2db2711803..dab9b4954a 100644
--- a/man2/connect.2
+++ b/man2/connect.2
@@ -104,7 +104,9 @@ in the path prefix.
(See also
.BR path_resolution (7).)
.TP
-.BR EACCES ", " EPERM
+.B EACCES
+.TQ
+.B EPERM
The user tried to connect to a broadcast address without having the socket
broadcast flag enabled or the connection request failed because of a local
firewall rule.
diff --git a/man2/eventfd.2 b/man2/eventfd.2
index 3af3c3a3e5..5ef10d73be 100644
--- a/man2/eventfd.2
+++ b/man2/eventfd.2
@@ -142,7 +142,11 @@ fails with the error
if the size of the supplied buffer is less than 8 bytes,
or if an attempt is made to write the value 0xffffffffffffffff.
.TP
-.BR poll "(2), " select "(2) (and similar)"
+.BR poll (2)
+.TQ
+.BR select (2)
+.TQ
+(and similar)
The returned file descriptor supports
.BR poll (2)
(and analogously
diff --git a/man2/fcntl.2 b/man2/fcntl.2
index 7bb9099124..e497a01dfa 100644
--- a/man2/fcntl.2
+++ b/man2/fcntl.2
@@ -1629,7 +1629,9 @@ for traditional
.B SIGIO
behavior.
.TP
-.BR F_GETPIPE_SZ ", " F_SETPIPE_SZ
+.B F_GETPIPE_SZ
+.TQ
+.B F_SETPIPE_SZ
The pipe capacity.
.TP
.B F_GET_SEALS
diff --git a/man2/fsync.2 b/man2/fsync.2
index 036af0a9ef..ab3241cbe0 100644
--- a/man2/fsync.2
+++ b/man2/fsync.2
@@ -130,12 +130,16 @@ all file descriptors that were open on the file when the error was recorded.
.B ENOSPC
Disk space was exhausted while synchronizing.
.TP
-.BR EROFS ", " EINVAL
+.B EROFS
+.TQ
+.B EINVAL
.I fd
is bound to a special file (e.g., a pipe, FIFO, or socket)
which does not support synchronization.
.TP
-.BR ENOSPC ", " EDQUOT
+.B ENOSPC
+.TQ
+.B EDQUOT
.I fd
is bound to a file on NFS or another filesystem which does not allocate
space at the time of a
diff --git a/man2/memfd_create.2 b/man2/memfd_create.2
index 8731637192..c157bb78bd 100644
--- a/man2/memfd_create.2
+++ b/man2/memfd_create.2
@@ -105,7 +105,11 @@ in
.I flags
is supported since Linux 4.16.
.TP
-.BR MFD_HUGE_2MB ", " MFD_HUGE_1GB ", " "..."
+.B MFD_HUGE_2MB
+.TQ
+.B MFD_HUGE_1GB
+.TQ
+\&.\|.\|.
Used in conjunction with
.B MFD_HUGETLB
to select alternative hugetlb page sizes (respectively, 2\ MB, 1\ GB, ...)
diff --git a/man2/mmap.2 b/man2/mmap.2
index f7e32013af..e787467212 100644
--- a/man2/mmap.2
+++ b/man2/mmap.2
@@ -299,7 +299,9 @@ See the Linux kernel source file
.I Documentation/admin\-guide/mm/hugetlbpage.rst
for further information, as well as NOTES, below.
.TP
-.BR MAP_HUGE_2MB ", " MAP_HUGE_1GB " (since Linux 3.8)"
+.B MAP_HUGE_2MB
+.TQ
+.BR MAP_HUGE_1GB " (since Linux 3.8)"
.\" See https://lwn.net/Articles/533499/
Used in conjunction with
.B MAP_HUGETLB
diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2
index aa23a4977d..44a2ecbeb1 100644
--- a/man2/perf_event_open.2
+++ b/man2/perf_event_open.2
@@ -698,7 +698,13 @@ and
for more details.
.RE
.TP
-.IR kprobe_func ", " uprobe_path ", " kprobe_addr ", and " probe_offset
+.I kprobe_func
+.TQ
+.I uprobe_path
+.TQ
+.I kprobe_addr
+.TQ
+.I probe_offset
These fields describe the kprobe/uprobe for dynamic PMUs
.B kprobe
and
@@ -721,7 +727,9 @@ use
and
.IR probe_offset .
.TP
-.IR sample_period ", " sample_freq
+.I sample_period
+.TQ
+.I sample_freq
A "sampling" event is one that generates an overflow notification
every N events, where N is given by
.IR sample_period .
@@ -1354,7 +1362,9 @@ This enables synchronous signal delivery of
.B SIGTRAP
on event overflow.
.TP
-.IR wakeup_events ", " wakeup_watermark
+.I wakeup_events
+.TQ
+.I wakeup_watermark
This union sets how many samples
.RI ( wakeup_events )
or bytes
@@ -1644,7 +1654,9 @@ Available only if
.B PERF_FORMAT_GROUP
was specified.
.TP
-.IR time_enabled ", " time_running
+.I time_enabled
+.TQ
+.I time_running
Total time the event was enabled and running.
Normally these values are the same.
Multiplexing happens if the number of events is more than the
@@ -1861,7 +1873,11 @@ count += pmc;
.EE
.in
.TP
-.IR time_shift ", " time_mult ", " time_offset
+.I time_shift
+.TQ
+.I time_mult
+.TQ
+.I time_offset
.IP
If
.IR cap_usr_time ,
@@ -1966,7 +1982,13 @@ where perf sample data begins.
Contains the size of the perf sample region within
the mmap buffer.
.TP
-.IR aux_head ", " aux_tail ", " aux_offset ", " aux_size " (since Linux 4.1)"
+.I aux_head
+.TQ
+.I aux_tail
+.TQ
+.I aux_offset
+.TQ
+.I aux_size " (since Linux 4.1)"
.\" commit 45bfb2e50471abbbfd83d40d28c986078b0d24ff
The AUX region allows
.BR mmap (2)-ing
@@ -2260,7 +2282,9 @@ struct {
.EE
.in
.TP
-.BR PERF_RECORD_THROTTLE ", " PERF_RECORD_UNTHROTTLE
+.B PERF_RECORD_THROTTLE
+.TQ
+.B PERF_RECORD_UNTHROTTLE
This record indicates a throttle/unthrottle event.
.IP
.in +4n
@@ -2373,7 +2397,9 @@ If
is enabled, then a 64-bit instruction
pointer value is included.
.TP
-.IR pid ", " tid
+.I pid
+.TQ
+.I tid
If
.B PERF_SAMPLE_TID
is enabled, then a 32-bit process ID
@@ -2412,7 +2438,9 @@ the actual ID is returned, not the group leader.
This ID is the same as the one returned by
.BR PERF_FORMAT_ID .
.TP
-.IR cpu ", " res
+.I cpu
+.TQ
+.I res
If
.B PERF_SAMPLE_CPU
is enabled, this is a 32-bit value indicating
@@ -2436,7 +2464,9 @@ value used at
.BR perf_event_open ()
time.
.TP
-.IR nr ", " ips[nr]
+.I nr
+.TQ
+.I ips[nr]
If
.B PERF_SAMPLE_CALLCHAIN
is enabled, then a 64-bit number is included
@@ -2444,7 +2474,9 @@ which indicates how many following 64-bit instruction pointers will
follow.
This is the current callchain.
.TP
-.IR size ", " data[size]
+.I size
+.TQ
+.I data[size]
If
.B PERF_SAMPLE_RAW
is enabled, then a 32-bit value indicating size
@@ -2456,7 +2488,9 @@ The ABI doesn't make any promises with respect to the stability
of its content, it may vary depending
on event, hardware, and kernel version.
.TP
-.IR bnr ", " lbr[bnr]
+.I bnr
+.TQ
+.I lbr[bnr]
If
.B PERF_SAMPLE_BRANCH_STACK
is enabled, then a 64-bit value indicating
@@ -2507,7 +2541,9 @@ The type of branches recorded is specified by the
field.
.RE
.TP
-.IR abi ", " regs[weight(mask)]
+.I abi
+.TQ
+.I regs[weight(mask)]
If
.B PERF_SAMPLE_REGS_USER
is enabled, then the user CPU registers are recorded.
@@ -2530,7 +2566,11 @@ The number of values is the number of bits set in the
.I sample_regs_user
bit mask.
.TP
-.IR size ", " data[size] ", " dyn_size
+.I size
+.TQ
+.I data[size]
+.TQ
+.I dyn_size
If
.B PERF_SAMPLE_STACK_USER
is enabled, then the user stack is recorded.
@@ -2754,7 +2794,9 @@ the high 32 bits of the field by shifting right by
and masking with the value
.BR PERF_TXN_ABORT_MASK .
.TP
-.IR abi ", " regs[weight(mask)]
+.I abi
+.TQ
+.I regs[weight(mask)]
If
.B PERF_SAMPLE_REGS_INTR
is enabled, then the user CPU registers are recorded.
diff --git a/man2/prctl.2 b/man2/prctl.2
index de53acfb0b..f72aeb700c 100644
--- a/man2/prctl.2
+++ b/man2/prctl.2
@@ -806,7 +806,9 @@ except \[aq][\[aq], \[aq]]\[aq], \[aq]\e\[aq], \[aq]$\[aq], and \[aq]\[ga]\[aq].
.RE
.\" prctl PR_MPX_ENABLE_MANAGEMENT
.TP
-.BR PR_MPX_ENABLE_MANAGEMENT ", " PR_MPX_DISABLE_MANAGEMENT " (since Linux 3.19, removed in Linux 5.4; only on x86)"
+.B PR_MPX_ENABLE_MANAGEMENT
+.TQ
+.BR PR_MPX_DISABLE_MANAGEMENT " (since Linux 3.19, removed in Linux 5.4; only on x86)"
.\" commit fe3d197f84319d3bce379a9c0dc17b1f48ad358c
.\" See also http://lwn.net/Articles/582712/
.\" See also https://gcc.gnu.org/wiki/Intel%20MPX%20support%20in%20the%20GCC%20compiler
diff --git a/man2/ptrace.2 b/man2/ptrace.2
index 34152c09c0..0f6e3ac78a 100644
--- a/man2/ptrace.2
+++ b/man2/ptrace.2
@@ -203,7 +203,9 @@ and
.BR PTRACE_KILL ,
the tracee must be stopped.
.TP
-.BR PTRACE_PEEKTEXT ", " PTRACE_PEEKDATA
+.B PTRACE_PEEKTEXT
+.TQ
+.B PTRACE_PEEKDATA
Read a word at the address
.I addr
in the tracee's memory, returning the word as the result of the
@@ -232,7 +234,9 @@ See NOTES.
.RI ( data
is ignored; but see NOTES.)
.TP
-.BR PTRACE_POKETEXT ", " PTRACE_POKEDATA
+.B PTRACE_POKETEXT
+.TQ
+.B PTRACE_POKEDATA
Copy the word
.I data
to the address
@@ -260,7 +264,9 @@ some modifications to the USER area are disallowed.
.\" FIXME In the preceding sentence, which modifications are disallowed,
.\" and when they are disallowed, how does user space discover that fact?
.TP
-.BR PTRACE_GETREGS ", " PTRACE_GETFPREGS
+.B PTRACE_GETREGS
+.TQ
+.B PTRACE_GETFPREGS
Copy the tracee's general-purpose or floating-point registers,
respectively, to the address
.I data
@@ -304,7 +310,9 @@ On return, the kernel modifies
.B iov.len
to indicate the actual number of bytes returned.
.TP
-.BR PTRACE_SETREGS ", " PTRACE_SETFPREGS
+.B PTRACE_SETREGS
+.TQ
+.B PTRACE_SETFPREGS
Modify the tracee's general-purpose or floating-point registers,
respectively, from the address
.I data
@@ -696,7 +704,9 @@ whether a signal sent to the tracee is delivered or not.
.RI ( addr
is ignored.)
.TP
-.BR PTRACE_SYSCALL ", " PTRACE_SINGLESTEP
+.B PTRACE_SYSCALL
+.TQ
+.B PTRACE_SINGLESTEP
Restart the stopped tracee as for
.BR PTRACE_CONT ,
but arrange for the tracee to be stopped at
@@ -740,7 +750,9 @@ system call number in).
.\" see change_syscall in tools/testing/selftests/seccomp/seccomp_bpf.c
.\" and also strace's linux/*/set_scno.c files.
.TP
-.BR PTRACE_SYSEMU ", " PTRACE_SYSEMU_SINGLESTEP " (since Linux 2.6.14)"
+.B PTRACE_SYSEMU
+.TQ
+.BR PTRACE_SYSEMU_SINGLESTEP " (since Linux 2.6.14)"
For
.BR PTRACE_SYSEMU ,
continue and stop on entry to the next system call,
diff --git a/man2/reboot.2 b/man2/reboot.2
index 2896ed5170..9d8dcc4259 100644
--- a/man2/reboot.2
+++ b/man2/reboot.2
@@ -170,7 +170,9 @@ when calling
.BR reboot ()
in this case are as follows:
.TP
-.BR LINUX_REBOOT_CMD_RESTART ", " LINUX_REBOOT_CMD_RESTART2
+.B LINUX_REBOOT_CMD_RESTART
+.TQ
+.B LINUX_REBOOT_CMD_RESTART2
The "init" process is terminated,
and
.BR wait (2)
@@ -178,7 +180,9 @@ in the parent process reports that the child was killed with a
.B SIGHUP
signal.
.TP
-.BR LINUX_REBOOT_CMD_POWER_OFF ", " LINUX_REBOOT_CMD_HALT
+.B LINUX_REBOOT_CMD_POWER_OFF
+.TQ
+.B LINUX_REBOOT_CMD_HALT
The "init" process is terminated,
and
.BR wait (2)
diff --git a/man2/shmget.2 b/man2/shmget.2
index c0b1a669c9..6cef406c81 100644
--- a/man2/shmget.2
+++ b/man2/shmget.2
@@ -102,7 +102,9 @@ See the Linux kernel source file
.I Documentation/admin\-guide/mm/hugetlbpage.rst
for further information.
.TP
-.BR SHM_HUGE_2MB ", " SHM_HUGE_1GB " (since Linux 3.8)"
+.B SHM_HUGE_2MB
+.TQ
+.BR SHM_HUGE_1GB " (since Linux 3.8)"
.\" See https://lwn.net/Articles/533499/
Used in conjunction with
.B SHM_HUGETLB
diff --git a/man2/signalfd.2 b/man2/signalfd.2
index 2b97c4640e..d6ea006bde 100644
--- a/man2/signalfd.2
+++ b/man2/signalfd.2
@@ -131,7 +131,11 @@ or fails with the error
.B EAGAIN
if the file descriptor has been made nonblocking.
.TP
-.BR poll "(2), " select "(2) (and similar)"
+.BR poll (2)
+.TQ
+.BR select (2)
+.TQ
+(and similar)
The file descriptor is readable
(the
.BR select (2)
diff --git a/man2/sync.2 b/man2/sync.2
index c1257fdc25..f11c6a992f 100644
--- a/man2/sync.2
+++ b/man2/sync.2
@@ -81,7 +81,9 @@ metadata related to the filesystem itself.
.B ENOSPC
Disk space was exhausted while synchronizing.
.TP
-.BR ENOSPC ", " EDQUOT
+.B ENOSPC
+.TQ
+.B EDQUOT
Data was written to a file on NFS or another filesystem which does not
allocate space at the time of a
.BR write (2)
diff --git a/man2/sysctl.2 b/man2/sysctl.2
index 44134d82bc..6881e75170 100644
--- a/man2/sysctl.2
+++ b/man2/sysctl.2
@@ -56,7 +56,9 @@ Otherwise, a value of \-1 is returned and
is set to indicate the error.
.SH ERRORS
.TP
-.BR EACCES ", " EPERM
+.B EACCES
+.TQ
+.B EPERM
No search permission for one of the encountered "directories",
or no read permission where
.I oldval
diff --git a/man2/timerfd_create.2 b/man2/timerfd_create.2
index d68206b054..c0506e7c17 100644
--- a/man2/timerfd_create.2
+++ b/man2/timerfd_create.2
@@ -317,7 +317,11 @@ but before the
.BR read (2)
on the file descriptor.
.TP
-.BR poll "(2), " select "(2) (and similar)"
+.BR poll (2)
+.TQ
+.BR select (2)
+.TQ
+(and similar)
The file descriptor is readable
(the
.BR select (2)
diff --git a/man3/getaddrinfo.3 b/man3/getaddrinfo.3
index f3677b4973..dc3adf8154 100644
--- a/man3/getaddrinfo.3
+++ b/man3/getaddrinfo.3
@@ -462,7 +462,9 @@ The resulting string is encoded using the current locale's encoding.
.\"If no component of the returned name starts with xn\-\- the IDN
.\"step can be skipped, therefore avoiding unnecessary slowdowns.
.TP
-.BR AI_IDN_ALLOW_UNASSIGNED ", " AI_IDN_USE_STD3_ASCII_RULES
+.B AI_IDN_ALLOW_UNASSIGNED
+.TQ
+.B AI_IDN_USE_STD3_ASCII_RULES
Setting these flags will enable the
IDNA_ALLOW_UNASSIGNED (allow unassigned Unicode code points) and
IDNA_USE_STD3_ASCII_RULES (check output to make sure it is a STD3
diff --git a/man3/getdate.3 b/man3/getdate.3
index 9c93300f7b..88efaf9171 100644
--- a/man3/getdate.3
+++ b/man3/getdate.3
@@ -174,7 +174,9 @@ Invalid input specification.
.B DATEMSK
File containing format patterns.
.TP
-.BR TZ ", " LC_TIME
+.B TZ
+.TQ
+.B LC_TIME
Variables used by
.BR strptime (3).
.SH ATTRIBUTES
diff --git a/man3/getnameinfo.3 b/man3/getnameinfo.3
index 23cd8caf9e..6d5ace9e62 100644
--- a/man3/getnameinfo.3
+++ b/man3/getnameinfo.3
@@ -140,7 +140,9 @@ converted from IDN format to the locale's encoding if necessary.
ASCII-only names are not affected by the conversion, which
makes this flag usable in existing programs and environments.
.TP
-.BR NI_IDN_ALLOW_UNASSIGNED ", " NI_IDN_USE_STD3_ASCII_RULES
+.B NI_IDN_ALLOW_UNASSIGNED
+.TQ
+.B NI_IDN_USE_STD3_ASCII_RULES
Setting these flags will enable the
IDNA_ALLOW_UNASSIGNED (allow unassigned Unicode code points) and
IDNA_USE_STD3_ASCII_RULES (check output to make sure it is a STD3
diff --git a/man4/hpsa.4 b/man4/hpsa.4
index 17a533c619..856d205f63 100644
--- a/man4/hpsa.4
+++ b/man4/hpsa.4
@@ -185,7 +185,11 @@ The data structures used by these ioctls are described in
the Linux kernel source file
.IR include/linux/cciss_ioctl.h .
.TP
-.BR CCISS_DEREGDISK ", " CCISS_REGNEWDISK ", " CCISS_REGNEWD
+.B CCISS_DEREGDISK
+.TQ
+.B CCISS_REGNEWDISK
+.TQ
+.B CCISS_REGNEWD
These three ioctls all do exactly the same thing,
which is to cause the driver to rescan for new devices.
This does exactly the same thing as writing to the
@@ -204,7 +208,9 @@ Returns driver version in three bytes encoded as:
.EE
.in
.TP
-.BR CCISS_PASSTHRU ", " CCISS_BIG_PASSTHRU
+.B CCISS_PASSTHRU
+.TQ
+.B CCISS_BIG_PASSTHRU
Allows "BMIC" and "CISS" commands to be passed through to the Smart Array.
These are used extensively by the HP Array Configuration Utility,
SNMP storage agents, and so on.
diff --git a/man4/lirc.4 b/man4/lirc.4
index 4bd356d2e6..98ec067697 100644
--- a/man4/lirc.4
+++ b/man4/lirc.4
@@ -215,8 +215,9 @@ describes the pulse width as a percentage of the total cycle.
Currently, no special meaning is defined for 0 or 100, but the values
are reserved for future use.
.TP
-.BR LIRC_GET_MIN_TIMEOUT " (\fIvoid\fP)", " "\
-LIRC_GET_MAX_TIMEOUT " (\fIvoid\fP)"
+.BI LIRC_GET_MIN_TIMEOUT( void )
+.TQ
+.BI LIRC_GET_MAX_TIMEOUT( void )
Some devices have internal timers that can be used to detect when
there has been no IR activity for a long time.
This can help
diff --git a/man4/loop.4 b/man4/loop.4
index 72a2431921..b156de505c 100644
--- a/man4/loop.4
+++ b/man4/loop.4
@@ -219,7 +219,9 @@ Since Linux 2.6, there are two new
.BR ioctl (2)
operations:
.TP
-.BR LOOP_SET_STATUS64 ", " LOOP_GET_STATUS64
+.B LOOP_SET_STATUS64
+.TQ
+.B LOOP_GET_STATUS64
These are similar to
.BR LOOP_SET_STATUS " and " LOOP_GET_STATUS
described above but use the
diff --git a/man4/random.4 b/man4/random.4
index edd047b77f..89a738b4f1 100644
--- a/man4/random.4
+++ b/man4/random.4
@@ -321,7 +321,9 @@ is the buffer of size
.I buf_size
which gets added to the entropy pool.
.TP
-.BR RNDZAPENTCNT ", " RNDCLEARPOOL
+.B RNDZAPENTCNT
+.TQ
+.B RNDCLEARPOOL
Zero the entropy count of all pools and add some system data (such as
wall clock) to the pools.
.SH FILES
diff --git a/man4/rtc.4 b/man4/rtc.4
index 55dc1ff6b9..ecd12fd541 100644
--- a/man4/rtc.4
+++ b/man4/rtc.4
@@ -145,7 +145,9 @@ RTC's time the process must be privileged (i.e., have the
.B CAP_SYS_TIME
capability).
.TP
-.BR RTC_ALM_READ ", " RTC_ALM_SET
+.B RTC_ALM_READ
+.TQ
+.B RTC_ALM_SET
Read and set the alarm time, for RTCs that support alarms.
The alarm interrupt must be separately enabled or disabled using the
.BR RTC_AIE_ON ", " RTC_AIE_OFF
@@ -162,7 +164,9 @@ and
.I tm_hour
fields of this structure are used.
.TP
-.BR RTC_IRQP_READ ", " RTC_IRQP_SET
+.B RTC_IRQP_READ
+.TQ
+.B RTC_IRQP_SET
Read and set the frequency for periodic interrupts,
for RTCs that support periodic interrupts.
The periodic interrupt must be separately enabled or disabled using the
@@ -184,20 +188,26 @@ capability) can set frequencies above the value specified in
.IR /proc/sys/dev/rtc/max\-user\-freq .
(This file contains the value 64 by default.)
.TP
-.BR RTC_AIE_ON ", " RTC_AIE_OFF
+.B RTC_AIE_ON
+.TQ
+.B RTC_AIE_OFF
Enable or disable the alarm interrupt, for RTCs that support alarms.
The third
.BR ioctl (2)
argument is ignored.
.TP
-.BR RTC_UIE_ON ", " RTC_UIE_OFF
+.B RTC_UIE_ON
+.TQ
+.B RTC_UIE_OFF
Enable or disable the interrupt on every clock update,
for RTCs that support this once-per-second interrupt.
The third
.BR ioctl (2)
argument is ignored.
.TP
-.BR RTC_PIE_ON ", " RTC_PIE_OFF
+.B RTC_PIE_ON
+.TQ
+.B RTC_PIE_OFF
Enable or disable the periodic interrupt,
for RTCs that support these periodic interrupts.
The third
@@ -209,7 +219,9 @@ capability) can enable the periodic interrupt if the frequency is
currently set above the value specified in
.IR /proc/sys/dev/rtc/max\-user\-freq .
.TP
-.BR RTC_EPOCH_READ ", " RTC_EPOCH_SET
+.B RTC_EPOCH_READ
+.TQ
+.B RTC_EPOCH_SET
Many RTCs encode the year in an 8-bit register which is either
interpreted as an 8-bit binary number or as a BCD number.
In both cases,
@@ -232,7 +244,9 @@ To set the RTC's Epoch the process must be privileged (i.e., have the
.B CAP_SYS_TIME
capability).
.TP
-.BR RTC_WKALM_RD ", " RTC_WKALM_SET
+.B RTC_WKALM_RD
+.TQ
+.B RTC_WKALM_SET
Some RTCs support a more powerful alarm interface, using these ioctls
to read or write the RTC's alarm time (respectively) with this structure:
.PP
@@ -278,7 +292,13 @@ A pointer to this structure should be passed as the third
argument.
.SH FILES
.TP
-.IR /dev/rtc ", " /dev/rtc0 ", " /dev/rtc1 ", etc."
+.I /dev/rtc
+.TQ
+.I /dev/rtc0
+.TQ
+.I /dev/rtc1
+.TQ
+\&.\|.\|.
RTC special character device files.
.TP
.I /proc/driver/rtc
diff --git a/man4/smartpqi.4 b/man4/smartpqi.4
index 8227f455e0..26ab98802c 100644
--- a/man4/smartpqi.4
+++ b/man4/smartpqi.4
@@ -38,7 +38,11 @@ The data structures used by these operations
are described in the Linux kernel source file
.IR include/linux/cciss_ioctl.h .
.TP
-.BR CCISS_DEREGDISK ", " CCISS_REGNEWDISK ", " CCISS_REGNEWD
+.B CCISS_DEREGDISK
+.TQ
+.B CCISS_REGNEWDISK
+.TQ
+.B CCISS_REGNEWD
These operations
all do exactly the same thing, which is to cause the driver to re-scan
for new devices.
diff --git a/man5/elf.5 b/man5/elf.5
index 1518a2ac81..824476bcf9 100644
--- a/man5/elf.5
+++ b/man5/elf.5
@@ -727,7 +727,9 @@ occur only if the program header table is part of the memory image of the
program.
If it is present, it must precede any loadable segment entry.
.TP
-.BR PT_LOPROC ", " PT_HIPROC
+.B PT_LOPROC
+.TQ
+.B PT_HIPROC
Values in the inclusive range
.RB [ PT_LOPROC ,
.BR PT_HIPROC ]
@@ -848,7 +850,9 @@ or otherwise meaningless section reference.
.B SHN_LORESERVE
This value specifies the lower bound of the range of reserved indices.
.TP
-.BR SHN_LOPROC ", " SHN_HIPROC
+.B SHN_LOPROC
+.TQ
+.B SHN_HIPROC
Values greater in the inclusive range
.RB [ SHN_LOPROC ,
.BR SHN_HIPROC ]
@@ -1002,7 +1006,9 @@ object file can also contain a
.B SHT_SYMTAB
section.
.TP
-.BR SHT_LOPROC ", " SHT_HIPROC
+.B SHT_LOPROC
+.TQ
+.B SHT_HIPROC
Values in the inclusive range
.RB [ SHT_LOPROC ,
.BR SHT_HIPROC ]
@@ -1520,7 +1526,9 @@ and it precedes the other
.B STB_LOCAL
symbols of the file, if it is present.
.TP
-.BR STT_LOPROC ", " STT_HIPROC
+.B STT_LOPROC
+.TQ
+.B STT_HIPROC
Values in the inclusive range
.RB [ STT_LOPROC ,
.BR STT_HIPROC ]
@@ -1542,7 +1550,9 @@ reference to the same symbol.
Weak symbols resemble global symbols, but their definitions have lower
precedence.
.TP
-.BR STB_LOPROC ", " STB_HIPROC
+.B STB_LOPROC
+.TQ
+.B STB_HIPROC
Values in the inclusive range
.RB [ STB_LOPROC ,
.BR STB_HIPROC ]
@@ -1552,18 +1562,23 @@ are reserved for processor-specific semantics.
There are macros for packing and unpacking the binding and type fields:
.RS
.TP
-.BR ELF32_ST_BIND( \fIinfo\fP ) ", " ELF64_ST_BIND( \fIinfo\fP )
+.BI ELF32_ST_BIND( info )
+.TQ
+.BI ELF64_ST_BIND( info )
Extract a binding from an
.I st_info
value.
.TP
-.BR ELF32_ST_TYPE( \fIinfo ) ", " ELF64_ST_TYPE( \fIinfo\fP )
+.BI ELF32_ST_TYPE( info )
+.TQ
+.BI ELF64_ST_TYPE( info )
Extract a type from an
.I st_info
value.
.TP
-.BR ELF32_ST_INFO( \fIbind\fP ", " \fItype\fP ) ", " \
-ELF64_ST_INFO( \fIbind\fP ", " \fItype\fP )
+.BI ELF32_ST_INFO( bind ", " type )
+.TQ
+.BI ELF64_ST_INFO( bind ", " type )
Convert a binding and a type into an
.I st_info
value.
@@ -1806,7 +1821,9 @@ transferring control to the executable
.B DT_RUNPATH
String table offset to library search path
.TP
-.BR DT_LOPROC ", " DT_HIPROC
+.B DT_LOPROC
+.TQ
+.B DT_HIPROC
Values in the inclusive range
.RB [ DT_LOPROC ,
.BR DT_HIPROC ]
diff --git a/man5/proc_pid_status.5 b/man5/proc_pid_status.5
index 597c70f7b8..65a75546ed 100644
--- a/man5/proc_pid_status.5
+++ b/man5/proc_pid_status.5
@@ -121,7 +121,9 @@ PID of parent process.
.I TracerPid
PID of process tracing this process (0 if not being traced).
.TP
-.IR Uid ", " Gid
+.I Uid
+.TQ
+.I Gid
Real, effective, saved set, and filesystem UIDs (GIDs).
.TP
.I FDSize
@@ -224,7 +226,11 @@ and shared anonymous mappings).
.\" commit bf9683d6990589390b5178dafe8fd06808869293
(since Linux 4.5).
.TP
-.IR VmData ", " VmStk ", " VmExe
+.I VmData
+.TQ
+.I VmStk
+.TQ
+.I VmExe
Size of data, stack, and text segments.
This value is inaccurate; see
.IR /proc/ pid /statm
@@ -276,19 +282,29 @@ resource limit on the number of queued signals for this process
in
.BR getrlimit (2)).
.TP
-.IR SigPnd ", " ShdPnd
+.I SigPnd
+.TQ
+.I ShdPnd
Mask (expressed in hexadecimal)
of signals pending for thread and for process as a whole (see
.BR pthreads (7)
and
.BR signal (7)).
.TP
-.IR SigBlk ", " SigIgn ", " SigCgt
+.I SigBlk
+.TQ
+.I SigIgn
+.TQ
+.I SigCgt
Masks (expressed in hexadecimal)
indicating signals being blocked, ignored, and caught (see
.BR signal (7)).
.TP
-.IR CapInh ", " CapPrm ", " CapEff
+.I CapInh
+.TQ
+.I CapPrm
+.TQ
+.I CapEff
Masks (expressed in hexadecimal)
of capabilities enabled in inheritable, permitted, and effective sets
(see
@@ -359,7 +375,9 @@ Same as previous, but in "list format"
(since Linux 2.6.26, see
.BR cpuset (7)).
.TP
-.IR voluntary_ctxt_switches ", " nonvoluntary_ctxt_switches
+.I voluntary_ctxt_switches
+.TQ
+.I nonvoluntary_ctxt_switches
Number of voluntary and involuntary context switches (since Linux 2.6.23).
.RE
.SH SEE ALSO
diff --git a/man7/address_families.7 b/man7/address_families.7
index 0e00f113c2..0c577cc953 100644
--- a/man7/address_families.7
+++ b/man7/address_families.7
@@ -24,7 +24,9 @@ These families are defined in
.IR <sys/socket.h> .
The formats currently understood by the Linux kernel include:
.TP
-.BR AF_UNIX ", " AF_LOCAL
+.B AF_UNIX
+.TQ
+.B AF_LOCAL
Local communication.
For further information, see
.BR unix (7).
diff --git a/man7/feature_test_macros.7 b/man7/feature_test_macros.7
index 10e973dbca..3539e4315d 100644
--- a/man7/feature_test_macros.7
+++ b/man7/feature_test_macros.7
@@ -722,7 +722,7 @@ is defined with the value 1; and
.IP \[bu]
.B _POSIX_C_SOURCE
is defined with one of the following values:
-.RS 3
+.RS
.IP \[bu] 3
2,
if
diff --git a/man7/ip.7 b/man7/ip.7
index 524e81e0c1..ac8dec4a60 100644
--- a/man7/ip.7
+++ b/man7/ip.7
@@ -1287,7 +1287,9 @@ Time in seconds to keep an IPv6 fragment in memory.
Regeneration interval (in seconds) of the hash secret (or lifetime
for the hash secret) for IPv6 fragments.
.TP
-.IR ipfrag_high_thresh " (integer), " ipfrag_low_thresh " (integer)"
+.IR ipfrag_high_thresh " (integer)"
+.TQ
+.IR ipfrag_low_thresh " (integer)"
If the amount of queued IP fragments reaches
.IR ipfrag_high_thresh ,
the queue is pruned down to
@@ -1365,7 +1367,9 @@ was called on an already connected socket.
.B EMSGSIZE
Datagram is bigger than an MTU on the path and it cannot be fragmented.
.TP
-.BR ENOBUFS ", " ENOMEM
+.B ENOBUFS
+.TQ
+.B ENOMEM
Not enough free memory.
This often means that the memory allocation is limited by the socket
buffer limits, not by the system memory, but this is not 100% consistent.
diff --git a/man7/netdevice.7 b/man7/netdevice.7
index 0087a8115c..cc4a4666b2 100644
--- a/man7/netdevice.7
+++ b/man7/netdevice.7
@@ -96,7 +96,9 @@ This is the only ioctl which returns its result in
Retrieve the interface index of the interface into
.IR ifr_ifindex .
.TP
-.BR SIOCGIFFLAGS ", " SIOCSIFFLAGS
+.B SIOCGIFFLAGS
+.TQ
+.B SIOCSIFFLAGS
Get or set the active flag word of the device.
.I ifr_flags
contains a bit mask of the following values:
@@ -136,7 +138,9 @@ IFF_ECHO:Echo sent packets (since Linux 2.6.25)
Setting the active flag word is a privileged operation, but any
process may read it.
.TP
-.BR SIOCGIFPFLAGS ", " SIOCSIFPFLAGS
+.B SIOCGIFPFLAGS
+.TQ
+.B SIOCSIFPFLAGS
Get or set extended (private) flags for the device.
.I ifr_flags
contains a bit mask of the following values:
@@ -157,7 +161,11 @@ IFF_ISATAP:Interface is RFC4214 ISATAP interface.
.PP
Setting the extended (private) interface flags is a privileged operation.
.TP
-.BR SIOCGIFADDR ", " SIOCSIFADDR ", " SIOCDIFADDR
+.B SIOCGIFADDR
+.TQ
+.B SIOCSIFADDR
+.TQ
+.B SIOCDIFADDR
Get, set, or delete the address of the device using
.IR ifr_addr ,
or
@@ -185,7 +193,9 @@ A
address can be deleted by setting it to zero via
.BR SIOCSIFADDR .
.TP
-.BR SIOCGIFDSTADDR ", " SIOCSIFDSTADDR
+.B SIOCGIFDSTADDR
+.TQ
+.B SIOCSIFDSTADDR
Get or set the destination address of a point-to-point device using
.IR ifr_dstaddr .
For compatibility, only
@@ -193,7 +203,9 @@ For compatibility, only
addresses are accepted or returned.
Setting the destination address is a privileged operation.
.TP
-.BR SIOCGIFBRDADDR ", " SIOCSIFBRDADDR
+.B SIOCGIFBRDADDR
+.TQ
+.B SIOCSIFBRDADDR
Get or set the broadcast address for a device using
.IR ifr_brdaddr .
For compatibility, only
@@ -201,7 +213,9 @@ For compatibility, only
addresses are accepted or returned.
Setting the broadcast address is a privileged operation.
.TP
-.BR SIOCGIFNETMASK ", " SIOCSIFNETMASK
+.B SIOCGIFNETMASK
+.TQ
+.B SIOCSIFNETMASK
Get or set the network mask for a device using
.IR ifr_netmask .
For compatibility, only
@@ -209,7 +223,9 @@ For compatibility, only
addresses are accepted or returned.
Setting the network mask is a privileged operation.
.TP
-.BR SIOCGIFMETRIC ", " SIOCSIFMETRIC
+.B SIOCGIFMETRIC
+.TQ
+.B SIOCSIFMETRIC
Get or set the metric of the device using
.IR ifr_metric .
This is currently not implemented; it sets
@@ -218,14 +234,18 @@ to 0 if you attempt to read it and returns
.B EOPNOTSUPP
if you attempt to set it.
.TP
-.BR SIOCGIFMTU ", " SIOCSIFMTU
+.B SIOCGIFMTU
+.TQ
+.B SIOCSIFMTU
Get or set the MTU (Maximum Transfer Unit) of a device using
.IR ifr_mtu .
Setting the MTU is a privileged operation.
Setting the MTU to
too small values may cause kernel crashes.
.TP
-.BR SIOCGIFHWADDR ", " SIOCSIFHWADDR
+.B SIOCGIFHWADDR
+.TQ
+.B SIOCSIFHWADDR
Get or set the hardware address of a device using
.IR ifr_hwaddr .
The hardware address is specified in a struct
@@ -241,7 +261,9 @@ Set the hardware broadcast address of a device from
.IR ifr_hwaddr .
This is a privileged operation.
.TP
-.BR SIOCGIFMAP ", " SIOCSIFMAP
+.B SIOCGIFMAP
+.TQ
+.B SIOCSIFMAP
Get or set the interface's hardware parameters using
.IR ifr_map .
Setting the parameters is a privileged operation.
@@ -262,7 +284,9 @@ struct ifmap {
The interpretation of the ifmap structure depends on the device driver
and the architecture.
.TP
-.BR SIOCADDMULTI ", " SIOCDELMULTI
+.B SIOCADDMULTI
+.TQ
+.B SIOCDELMULTI
Add an address to or delete an address from the device's link layer
multicast filters using
.IR ifr_hwaddr .
@@ -271,7 +295,9 @@ See also
.BR packet (7)
for an alternative.
.TP
-.BR SIOCGIFTXQLEN ", " SIOCSIFTXQLEN
+.B SIOCGIFTXQLEN
+.TQ
+.B SIOCSIFTXQLEN
Get or set the transmit queue length of a device using
.IR ifr_qlen .
Setting the transmit queue length is a privileged operation.
@@ -357,7 +383,9 @@ will be returned.
.\" Slaving isn't supported in Linux 2.2
.\" .
.\" .TP
-.\" .BR SIOCGIFSLAVE ", " SIOCSIFSLAVE
+.\" .B SIOCGIFSLAVE
+.\" .TQ
+.\" .B SIOCSIFSLAVE
.\" Get or set the slave device using
.\" .IR ifr_slave .
.\" Setting the slave device is a privileged operation.
diff --git a/man7/netlink.7 b/man7/netlink.7
index e2205482da..679bb48aba 100644
--- a/man7/netlink.7
+++ b/man7/netlink.7
@@ -443,7 +443,9 @@ Enable
control messages for received packets to get the extended
destination group number.
.TP
-.BR NETLINK_ADD_MEMBERSHIP ,\ NETLINK_DROP_MEMBERSHIP " (since Linux 2.6.14)"
+.B NETLINK_ADD_MEMBERSHIP
+.TQ
+.BR NETLINK_DROP_MEMBERSHIP " (since Linux 2.6.14)"
.\" commit 9a4595bc7e67962f13232ee55a64e063062c3a99
.\" Author: Patrick McHardy <kaber@trash.net>
Join/leave a group specified by
diff --git a/man7/rtnetlink.7 b/man7/rtnetlink.7
index 379a082f88..1246da5cc1 100644
--- a/man7/rtnetlink.7
+++ b/man7/rtnetlink.7
@@ -53,7 +53,11 @@ or libnetlink, see
Rtnetlink consists of these message types
(in addition to standard netlink messages):
.TP
-.BR RTM_NEWLINK ", " RTM_DELLINK ", " RTM_GETLINK
+.B RTM_NEWLINK
+.TQ
+.B RTM_DELLINK
+.TQ
+.B RTM_GETLINK
Create, remove, or get information about a specific network interface.
These messages contain an
.I ifinfomsg
@@ -112,7 +116,11 @@ is
.RI ( "struct net_device_stats"
in Linux 2.4 and earlier).
.TP
-.BR RTM_NEWADDR ", " RTM_DELADDR ", " RTM_GETADDR
+.B RTM_NEWADDR
+.TQ
+.B RTM_DELADDR
+.TQ
+.B RTM_GETADDR
Add, remove, or receive information about an IP address associated with
an interface.
In Linux 2.2, an interface can carry multiple IP addresses,
@@ -170,7 +178,11 @@ IFA_CACHEINFO:struct ifa_cacheinfo:Address information
.TE
.\" FIXME Document struct ifa_cacheinfo
.TP
-.BR RTM_NEWROUTE ", " RTM_DELROUTE ", " RTM_GETROUTE
+.B RTM_NEWROUTE
+.TQ
+.B RTM_DELROUTE
+.TQ
+.B RTM_GETROUTE
Create, remove, or receive information about a network route.
These messages contain an
.I rtmsg
@@ -423,7 +435,11 @@ defined in
.IP
.B Fill these values in!
.TP
-.BR RTM_NEWNEIGH ", " RTM_DELNEIGH ", " RTM_GETNEIGH
+.B RTM_NEWNEIGH
+.TQ
+.B RTM_DELNEIGH
+.TQ
+.B RTM_GETNEIGH
Add, remove, or receive information about a neighbor table
entry (e.g., an ARP entry).
The message contains an
@@ -496,12 +512,20 @@ then a
.I struct nda_cacheinfo
header follows.
.TP
-.BR RTM_NEWRULE ", " RTM_DELRULE ", " RTM_GETRULE
+.B RTM_NEWRULE
+.TQ
+.B RTM_DELRULE
+.TQ
+.B RTM_GETRULE
Add, delete, or retrieve a routing rule.
Carries a
.I struct rtmsg
.TP
-.BR RTM_NEWQDISC ", " RTM_DELQDISC ", " RTM_GETQDISC
+.B RTM_NEWQDISC
+.TQ
+.B RTM_DELQDISC
+.TQ
+.B RTM_GETQDISC
Add, remove, or get a queueing discipline.
The message contains a
.I struct tcmsg
@@ -535,13 +559,21 @@ TCA_RATE:struct tc_estimator:Rate limit
In addition, various other qdisc-module-specific attributes are allowed.
For more information see the appropriate include files.
.TP
-.BR RTM_NEWTCLASS ", " RTM_DELTCLASS ", " RTM_GETTCLASS
+.B RTM_NEWTCLASS
+.TQ
+.B RTM_DELTCLASS
+.TQ
+.B RTM_GETTCLASS
Add, remove, or get a traffic class.
These messages contain a
.I struct tcmsg
as described above.
.TP
-.BR RTM_NEWTFILTER ", " RTM_DELTFILTER ", " RTM_GETTFILTER
+.B RTM_NEWTFILTER
+.TQ
+.B RTM_DELTFILTER
+.TQ
+.B RTM_GETTFILTER
Add, remove, or receive information about a traffic filter.
These messages contain a
.I struct tcmsg
diff --git a/man7/socket.7 b/man7/socket.7
index 3828751cea..7fddbaad2a 100644
--- a/man7/socket.7
+++ b/man7/socket.7
@@ -303,7 +303,9 @@ The value 0 indicates that this is not a listening socket,
the value 1 indicates that this is a listening socket.
This socket option is read-only.
.TP
-.BR SO_ATTACH_FILTER " (since Linux 2.2), " SO_ATTACH_BPF " (since Linux 3.19)"
+.BR SO_ATTACH_FILTER " (since Linux 2.2)"
+.TQ
+.BR SO_ATTACH_BPF " (since Linux 3.19)"
Attach a classic BPF
.RB ( SO_ATTACH_FILTER )
or an extended BPF
@@ -348,7 +350,9 @@ never has more than one filter defined.
Both classic and extended BPF are explained in the kernel source file
.I Documentation/networking/filter.txt
.TP
-.BR SO_ATTACH_REUSEPORT_CBPF ", " SO_ATTACH_REUSEPORT_EBPF
+.B SO_ATTACH_REUSEPORT_CBPF
+.TQ
+.B SO_ATTACH_REUSEPORT_EBPF
For use with the
.B SO_REUSEPORT
option, these options allow the user to set a classic BPF
@@ -451,7 +455,9 @@ Allowed only for processes with the
.B CAP_NET_ADMIN
capability or an effective user ID of 0.
.TP
-.BR SO_DETACH_FILTER " (since Linux 2.2), " SO_DETACH_BPF " (since Linux 3.19)"
+.BR SO_DETACH_FILTER " (since Linux 2.2)"
+.TQ
+.BR SO_DETACH_BPF " (since Linux 3.19)"
These two options, which are synonyms,
may be used to remove the classic or extended BPF
program attached to a socket with either
diff --git a/man7/spufs.7 b/man7/spufs.7
index 39fdf583a0..e23b5b06a0 100644
--- a/man7/spufs.7
+++ b/man7/spufs.7
@@ -119,7 +119,15 @@ The possible operations on an open
file are:
.RS
.TP
-.BR read "(2), " pread "(2), " write "(2), " pwrite "(2), " lseek (2)
+.BR read (2)
+.TQ
+.BR pread (2)
+.TQ
+.BR write (2)
+.TQ
+.BR pwrite (2)
+.TQ
+.BR lseek (2)
These operate as usual, with the exception that
.BR lseek (2),
.BR write (2),
@@ -289,7 +297,11 @@ file returns
whenever space is available for writing.
.RE
.TP
-.IR /mbox_stat ", " /ibox_stat ", " /wbox_stat
+.I /mbox_stat
+.TQ
+.I /ibox_stat
+.TQ
+.I /wbox_stat
These are read-only files that contain the length of the current
queue of each mailbox\[em]that is, how many words can be read from
.IR mbox " or " ibox
@@ -324,8 +336,21 @@ the respective mailbox without blocking or returning an
error.
.RE
.TP
-.IR /npc ", " /decr ", " /decr_status ", " /spu_tag_mask ", " \
-/event_mask ", " /event_status ", " /srr0 ", " /lslr
+.I /npc
+.TQ
+.I /decr
+.TQ
+.I /decr_status
+.TQ
+.I /spu_tag_mask
+.TQ
+.I /event_mask
+.TQ
+.I /event_status
+.TQ
+.I /srr0
+.TQ
+.I /lslr
Internal registers of the SPU.
These files contain an ASCII string
representing the hex value of the specified register.
@@ -433,7 +458,9 @@ updating the value of the
register.
.RE
.TP
-.IR /signal1 ", " /signal2
+.I /signal1
+.TQ
+.I /signal2
The files provide access to the two signal notification channels
of an SPU.
These are read-write files that operate on four-byte words.
@@ -484,7 +511,9 @@ or
files respectively.
.RE
.TP
-.IR /signal1_type ", " /signal2_type
+.I /signal1_type
+.TQ
+.I /signal2_type
These two files change the behavior of the
.I signal1
and
@@ -524,7 +553,15 @@ Subsequent writes to the same file descriptor overwrite the
previous setting.
.RE
.TP
-.IR /mbox_info ", " /ibox_info ", " /wbox_info ", " /dma_into ", " /proxydma_info
+.I /mbox_info
+.TQ
+.I /ibox_info
+.TQ
+.I /wbox_info
+.TQ
+.I /dma_into
+.TQ
+.I /proxydma_info
Read-only files that contain the saved state of the SPU mailboxes and
DMA queues.
This allows the SPU status to be inspected, mainly for debugging.
diff --git a/man7/standards.7 b/man7/standards.7
index 82b8ac4ff2..b29c5c3e54 100644
--- a/man7/standards.7
+++ b/man7/standards.7
@@ -183,7 +183,9 @@ See also
.UR http://www.unix.org\:/version2/
.UE .)
.TP
-.B POSIX.1-2001, SUSv3
+.B POSIX.1-2001
+.TQ
+.B SUSv3
This was a 2001 revision and consolidation of the
POSIX.1, POSIX.2, and SUS standards into a single document,
conducted under the auspices of the Austin Group
@@ -233,7 +235,9 @@ of the original 2001 standard have occurred:
TC1 in 2003
and TC2 in 2004.
.TP
-.B POSIX.1-2008, SUSv4
+.B POSIX.1-2008
+.TQ
+.B SUSv4
Work on the next revision of POSIX.1/SUS was completed and
ratified in 2008.
The standard is available online at
diff --git a/man8/iconvconfig.8 b/man8/iconvconfig.8
index 83cdfb2533..95cfcdb039 100644
--- a/man8/iconvconfig.8
+++ b/man8/iconvconfig.8
@@ -40,7 +40,9 @@ is not set.
Do not search the system default gconv directory,
only the directories provided on the command line.
.TP
-.BI \-o " outputfile" ", \-\-output=" outputfile
+.BI \-o\~ outputfile
+.TQ
+.BI \-\-output= outputfile
Use
.I outputfile
for output instead of the system default cache location.
@@ -56,13 +58,17 @@ the gconv module configuration would be read from
and the cache would be written to
.IR foo/usr/lib/gconv/gconv\-modules.cache .
.TP
-.BR \-? ", " \-\-help
+.B \-?
+.TQ
+.B \-\-help
Print a usage summary and exit.
.TP
-.B "\-\-usage"
+.B \-\-usage
Print a short usage summary and exit.
.TP
-.BR \-V ", " \-\-version
+.B \-V
+.TQ
+.B \-\-version
Print the version number, license, and disclaimer of warranty for
.BR iconv .
.SH EXIT STATUS