diff options
| author | Alejandro Colomar <alx@kernel.org> | 2023-10-22 14:57:46 +0200 |
|---|---|---|
| committer | Alejandro Colomar <alx@kernel.org> | 2023-10-23 22:13:39 +0200 |
| commit | 6fdb1c03075b31364968bcccf472a4d4a86952a6 (patch) | |
| tree | d68dd6326fb842f90e18b84401789af20aee67e6 | |
| parent | 59804ef61b00a6b463434a949c80f264f4ff0516 (diff) | |
| download | man-pages-6fdb1c03075b31364968bcccf472a4d4a86952a6.tar.gz | |
man*/: ffix (Use '.TQ' where appropriate)
When there are multiple tags for a paragraph, using a single TP and
separating the tags with commas makes the man(7) source more complex.
It also has a disadvantage: when searching through a manual page,
heuristics such as " --option" don't work so well.
By using GNU's TQ, we simplify the source of the pages, and improve the
ability to search them.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
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 @@ -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 |