Use a single-font-style macro (".B", ".I") for a single argument. The output from "nroff" and "groff" is unchanged. Signed-off-by: Bjarni Ingi Gislason <bjarniig@xxxxxxxxx> --- man2/socket.2 | 4 ++-- man2/socketpair.2 | 4 ++-- man2/spu_create.2 | 6 +++--- man2/spu_run.2 | 8 ++++---- man2/stat.2 | 22 +++++++++++----------- man2/statfs.2 | 2 +- man2/statx.2 | 20 ++++++++++---------- man2/subpage_prot.2 | 2 +- man2/symlink.2 | 6 +++--- man2/syscall.2 | 6 +++--- man2/sysinfo.2 | 4 ++-- man2/syslog.2 | 22 +++++++++++----------- 12 files changed, 53 insertions(+), 53 deletions(-) diff --git a/man2/socket.2 b/man2/socket.2 index fed3f4e25..c22f96de9 100644 --- a/man2/socket.2 +++ b/man2/socket.2 @@ -68,7 +68,7 @@ tab(:); l1 lw40 l. Name:Purpose:Man page T{ -.BR AF_UNIX +.B AF_UNIX T}:T{ Local communication T}:T{ @@ -257,7 +257,7 @@ to modify the behavior of .TP 16 .B SOCK_NONBLOCK Set the -.BR O_NONBLOCK +.B O_NONBLOCK file status flag on the open file description (see .BR open (2)) referred to by the new file descriptor. diff --git a/man2/socketpair.2 b/man2/socketpair.2 index 5a49d46ad..ac04cfaa7 100644 --- a/man2/socketpair.2 +++ b/man2/socketpair.2 @@ -120,9 +120,9 @@ and Since Linux 2.6.27, .BR socketpair () supports the -.BR SOCK_NONBLOCK +.B SOCK_NONBLOCK and -.BR SOCK_CLOEXEC +.B SOCK_CLOEXEC flags in the .I type argument, as described in diff --git a/man2/spu_create.2 b/man2/spu_create.2 index 875c5dcd3..454ba32d7 100644 --- a/man2/spu_create.2 +++ b/man2/spu_create.2 @@ -110,17 +110,17 @@ the creating process. .IP Because the context cannot be removed from the SPU, some functionality is disabled for -.BR SPU_CREATE_NOSCHED +.B SPU_CREATE_NOSCHED contexts. Only a subset of the files will be available in this context directory in .BR spufs . Additionally, -.BR SPU_CREATE_NOSCHED +.B SPU_CREATE_NOSCHED contexts cannot dump a core file when crashing. .IP Creating -.BR SPU_CREATE_NOSCHED +.B SPU_CREATE_NOSCHED contexts requires the .B CAP_SYS_NICE capability. diff --git a/man2/spu_run.2 b/man2/spu_run.2 index 0c6cbddf2..054143c16 100644 --- a/man2/spu_run.2 +++ b/man2/spu_run.2 @@ -113,19 +113,19 @@ The .I spu_status register value is a bit mask of status codes and optionally a 14-bit code returned from the -.BR stop-and-signal +.B stop-and-signal instruction on the SPU. The bit masks for the status codes are: .TP .B 0x02 SPU was stopped by a -.BR stop-and-signal +.B stop-and-signal instruction. .TP .B 0x04 SPU was stopped by a -.BR halt +.B halt instruction. .TP .B 0x08 @@ -142,7 +142,7 @@ SPU has tried to access an invalid channel. .TP .B 0x3fff0000 The bits masked with this value contain the code returned from a -.BR stop-and-signal +.B stop-and-signal instruction. These bits are valid only if the 0x02 bit is set. .PP diff --git a/man2/stat.2 b/man2/stat.2 index a58cbfb06..22cacc464 100644 --- a/man2/stat.2 +++ b/man2/stat.2 @@ -179,9 +179,9 @@ for performance and simplicity reasons, different fields in the structure may contain state information from different moments during the execution of the system call. For example, if -.IR st_mode +.I st_mode or -.IR st_uid +.I st_uid is changed by another process by calling .BR chmod (2) or @@ -307,7 +307,7 @@ can either be 0, or include one or more of the following flags ORed: If .I pathname is an empty string, operate on the file referred to by -.IR dirfd +.I dirfd (which may have been obtained using the .BR open (2) .B O_PATH @@ -480,9 +480,9 @@ According to POSIX.1-2001, on a symbolic link need return valid information only in the .I st_size field and the file type of the -.IR st_mode +.I st_mode field of the -.IR stat +.I stat structure. POSIX.1-2008 tightens the specification, requiring .BR lstat () @@ -507,7 +507,7 @@ Instead, there were three timestamp and .IR st_ctime \(emtyped as -.IR time_t +.I time_t that recorded timestamps with one-second precision. .PP Since kernel 2.5.48, the @@ -520,9 +520,9 @@ if suitable feature test macros are defined. Nanosecond timestamps were standardized in POSIX.1-2008, and, starting with version 2.12, glibc exposes the nanosecond component names if -.BR _POSIX_C_SOURCE +.B _POSIX_C_SOURCE is defined with the value 200809L or greater, or -.BR _XOPEN_SOURCE +.B _XOPEN_SOURCE is defined with the value 700 or greater. Up to and including glibc 2.19, the definitions of the nanoseconds components are also defined if @@ -564,16 +564,16 @@ The kernel-internal versions of the .I stat structure dealt with by the different versions are, respectively: .TP -.IR __old_kernel_stat +.I __old_kernel_stat The original structure, with rather narrow fields, and no padding. .TP -.IR stat +.I stat Larger .I st_ino field and padding added to various parts of the structure to allow for future expansion. .TP -.IR stat64 +.I stat64 Even larger .I st_ino field, diff --git a/man2/statfs.2 b/man2/statfs.2 index 276ce2061..507640bf8 100644 --- a/man2/statfs.2 +++ b/man2/statfs.2 @@ -165,7 +165,7 @@ Most of these MAGIC constants are defined in and some are hardcoded in kernel sources. .PP The -.IR f_flags +.I f_flags field is a bit mask indicating mount options for the filesystem. It contains zero or more of the following bits: .\" XXX Keep this list in sync with statvfs(3) diff --git a/man2/statx.2 b/man2/statx.2 index 7265d8ace..3652ce2b7 100644 --- a/man2/statx.2 +++ b/man2/statx.2 @@ -114,7 +114,7 @@ uses .IR pathname , .IR dirfd , and -.IR flags +.I flags to identify the target file in one of the following ways: .TP An absolute pathname @@ -130,7 +130,7 @@ A relative pathname If .I pathname is a string that begins with a character other than a slash and -.IR dirfd +.I dirfd is .BR AT_FDCWD , then @@ -151,11 +151,11 @@ referred to by .TP By file descriptor If -.IR pathname +.I pathname is an empty string and the .B AT_EMPTY_PATH flag is specified in -.IR flags +.I flags (see below), then the target file is the one referred to by the file descriptor .IR dirfd . @@ -166,12 +166,12 @@ A value for .I flags is constructed by ORing together zero or more of the following constants: .TP -.BR AT_EMPTY_PATH +.B AT_EMPTY_PATH .\" commit 65cfc6722361570bfe255698d9cd4dccaf47570d If .I pathname is an empty string, operate on the file referred to by -.IR dirfd +.I dirfd (which may have been obtained using the .BR open (2) .B O_PATH @@ -191,7 +191,7 @@ This flag is Linux-specific; define .\" Before glibc 2.16, defining _ATFILE_SOURCE sufficed to obtain its definition. .TP -.BR AT_NO_AUTOMOUNT +.B AT_NO_AUTOMOUNT Don't automount the terminal ("basename") component of .I pathname if it is a directory that is an automount point. @@ -329,9 +329,9 @@ for performance and simplicity reasons, different fields in the structure may contain state information from different moments during the execution of the system call. For example, if -.IR stx_mode +.I stx_mode or -.IR stx_uid +.I stx_uid is changed by another process by calling .BR chmod (2) or @@ -391,7 +391,7 @@ when the file has holes.) .TP .I stx_attributes_mask A mask indicating which bits in -.IR stx_attributes +.I stx_attributes are supported by the VFS and the filesystem. .TP .I stx_atime diff --git a/man2/subpage_prot.2 b/man2/subpage_prot.2 index c75675dc9..76bc901d0 100644 --- a/man2/subpage_prot.2 +++ b/man2/subpage_prot.2 @@ -129,5 +129,5 @@ hardware pages (on machines with hardware 64-kB page support). .BR mprotect (2), .BR syscall (2) .PP -.IR Documentation/admin-guide/mm/hugetlbpage.rst +.I Documentation/admin-guide/mm/hugetlbpage.rst in the Linux kernel source tree diff --git a/man2/symlink.2 b/man2/symlink.2 index d2842203f..f6fb461a1 100644 --- a/man2/symlink.2 +++ b/man2/symlink.2 @@ -216,7 +216,7 @@ is not a valid file descriptor. .B ENOENT .I linkpath is a relative pathname and -.IR newdirfd +.I newdirfd refers to a directory that has been deleted. .TP .B ENOTDIR @@ -256,9 +256,9 @@ When .I linkpath is a relative pathname, glibc constructs a pathname based on the symbolic link in -.IR /proc/self/fd +.I /proc/self/fd that corresponds to the -.IR newdirfd +.I newdirfd argument. .SH SEE ALSO .BR ln (1), diff --git a/man2/syscall.2 b/man2/syscall.2 index 77e6bccdd..f4bd05a8f 100644 --- a/man2/syscall.2 +++ b/man2/syscall.2 @@ -232,12 +232,12 @@ if it is less than 256. .IP [4] On SuperH, the trap number controls the maximum number of arguments passed. A -.IR "trap\ #0x10" +.I "trap\ #0x10" can be used with only 0-argument system calls, a -.IR "trap\ #0x11" +.I "trap\ #0x11" can be used with 0- or 1-argument system calls, and so on up to -.IR "trap #0x17" +.I "trap #0x17" for 7-argument system calls. .IP [5] The x32 ABI shares syscall table with x86-64 ABI, but there are some diff --git a/man2/sysinfo.2 b/man2/sysinfo.2 index a4b1e50d0..8538cb8e5 100644 --- a/man2/sysinfo.2 +++ b/man2/sysinfo.2 @@ -106,7 +106,7 @@ is set to indicate the cause of the error. .SH ERRORS .TP .B EFAULT -.IR info +.I info is not a valid address. .SH VERSIONS .BR sysinfo () @@ -116,7 +116,7 @@ This function is Linux-specific, and should not be used in programs intended to be portable. .SH NOTES All of the information provided by this system call is also available via -.IR /proc/meminfo +.I /proc/meminfo and .IR /proc/loadavg . .SH SEE ALSO diff --git a/man2/syslog.2 b/man2/syslog.2 index 99d4ff854..7d8b30c6e 100644 --- a/man2/syslog.2 +++ b/man2/syslog.2 @@ -194,11 +194,11 @@ to the value given in .IR len , which must be an integer between 1 and 8 (inclusive). The kernel silently enforces a minimum value of -.IR minimum_console_loglevel +.I minimum_console_loglevel for .IR len . See the -.IR "log level" +.I "log level" section for details. The .I bufp @@ -228,16 +228,16 @@ In Linux kernels before 2.6.37, command types 3 and 10 are allowed to unprivileged processes; since Linux 2.6.37, these commands are allowed to unprivileged processes only if -.IR /proc/sys/kernel/dmesg_restrict +.I /proc/sys/kernel/dmesg_restrict has the value 0. Before Linux 2.6.37, "privileged" means that the caller has the -.BR CAP_SYS_ADMIN +.B CAP_SYS_ADMIN capability. Since Linux 2.6.37, "privileged" means that the caller has either the -.BR CAP_SYS_ADMIN +.B CAP_SYS_ADMIN capability (now deprecated for this purpose) or the (new) -.BR CAP_SYSLOG +.B CAP_SYSLOG capability. .\" .\" @@ -259,7 +259,7 @@ The default value for this field is and to 15 in case of a kernel fault (the 10 and 15 are just silly, and equivalent to 8). The value of -.IR console_loglevel +.I console_loglevel can be set (to a value in the range 1\(en8) by a .BR syslog () call with a @@ -268,7 +268,7 @@ of 8. .TP .I default_message_loglevel This value will be used as the log level for -.IR printk() +.I printk() messages that do not have an explicit level. Up to and including Linux 2.6.38, the hard-coded default value for this field was 4 @@ -312,7 +312,7 @@ KERN_DEBUG 7 Debug-level messages .TE .sp 1 The kernel -.IR printk() +.I printk() routine will print a message on the console only if it has a log level less than the value of .IR console_loglevel . @@ -355,7 +355,7 @@ is outside the range 1 to 8). This .BR syslog () system call is not available, because the kernel was compiled with the -.BR CONFIG_PRINTK +.B CONFIG_PRINTK kernel-configuration option disabled. .TP .B EPERM @@ -366,7 +366,7 @@ message ring buffer by a process without sufficient privilege (more precisely: without the .B CAP_SYS_ADMIN or -.BR CAP_SYSLOG +.B CAP_SYSLOG capability). .TP .B ERESTARTSYS -- 2.20.1