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> --- man3/carg.3 | 6 +++--- man3/catopen.3 | 2 +- man3/ceil.3 | 4 ++-- man3/clock.3 | 2 +- man3/cos.3 | 2 +- man3/cpow.3 | 2 +- man3/crypt.3 | 4 ++-- man3/ctime.3 | 2 +- man3/des_crypt.3 | 14 +++++++------- man3/dl_iterate_phdr.3 | 10 +++++----- man3/dladdr.3 | 20 ++++++++++---------- man3/dlinfo.3 | 14 +++++++------- man3/dlopen.3 | 18 +++++++++--------- man3/dlsym.3 | 4 ++-- man3/drand48.3 | 2 +- man3/duplocale.3 | 2 +- 16 files changed, 54 insertions(+), 54 deletions(-) diff --git a/man3/carg.3 b/man3/carg.3 index 96e3b6c0c..d0c916342 100644 --- a/man3/carg.3 +++ b/man3/carg.3 @@ -30,7 +30,7 @@ One may use rectangular coordinates and gets .fi .PP where -.IR "x\ =\ creal(z)" +.I "x\ =\ creal(z)" and .IR "y\ =\ cimag(z)" . .PP @@ -41,11 +41,11 @@ Or one may use polar coordinates and gets .fi .PP where -.IR "r\ =\ cabs(z)" +.I "r\ =\ cabs(z)" is the "radius", the "modulus", the absolute value of .IR z , and -.IR "a\ =\ carg(z)" +.I "a\ =\ carg(z)" is the "phase angle", the argument of .IR z . .PP diff --git a/man3/catopen.3 b/man3/catopen.3 index f005d7002..53729298d 100644 --- a/man3/catopen.3 +++ b/man3/catopen.3 @@ -116,7 +116,7 @@ returns a message catalog descriptor of type .I nl_catd on success. On failure, it returns -.IR "(nl_catd)\ \-1" +.I "(nl_catd)\ \-1" and sets .I errno to indicate the error. diff --git a/man3/ceil.3 b/man3/ceil.3 index 06b7e4fcf..0e755000a 100644 --- a/man3/ceil.3 +++ b/man3/ceil.3 @@ -58,9 +58,9 @@ These functions return the smallest integral value that is not less than .IR x . .PP For example, -.IR ceil(0.5) +.I ceil(0.5) is 1.0, and -.IR ceil(\-0.5) +.I ceil(\-0.5) is 0.0. .SH RETURN VALUE These functions return the ceiling of diff --git a/man3/clock.3 b/man3/clock.3 index 174c18bab..22a9c49a6 100644 --- a/man3/clock.3 +++ b/man3/clock.3 @@ -105,7 +105,7 @@ For improved accuracy, since glibc 2.18, it is implemented on top of .BR clock_gettime (2) (using the -.BR CLOCK_PROCESS_CPUTIME_ID +.B CLOCK_PROCESS_CPUTIME_ID clock). .SH SEE ALSO .BR clock_gettime (2), diff --git a/man3/cos.3 b/man3/cos.3 index 4de93891f..57f4690a4 100644 --- a/man3/cos.3 +++ b/man3/cos.3 @@ -90,7 +90,7 @@ The following errors can occur: Domain error: \fIx\fP is an infinity .I errno is set to -.BR EDOM +.B EDOM (but see BUGS). An invalid floating-point exception .RB ( FE_INVALID ) diff --git a/man3/cpow.3 b/man3/cpow.3 index e49464ff7..a2e5ef4bc 100644 --- a/man3/cpow.3 +++ b/man3/cpow.3 @@ -22,7 +22,7 @@ Link with \fI\-lm\fP. These functions calculate .I x raised to the power -.IR z +.I z (with a branch cut for .I x along the negative real axis.) diff --git a/man3/crypt.3 b/man3/crypt.3 index d46cf5085..393a95a80 100644 --- a/man3/crypt.3 +++ b/man3/crypt.3 @@ -197,7 +197,7 @@ and functions are part of the POSIX.1-2008 XSI Options Group for Encryption and are optional. If the interfaces are not available, then the symbolic constant -.BR _XOPEN_CRYPT +.B _XOPEN_CRYPT is either not defined, or it is defined to \-1 and availability can be checked at run time with .BR sysconf (3). @@ -206,7 +206,7 @@ crypt to .IR libxcrypt . When recompiling applications in such distributions, the programmer must detect if -.BR _XOPEN_CRYPT +.B _XOPEN_CRYPT is not available and include .I <crypt.h> for the function prototypes; diff --git a/man3/ctime.3 b/man3/ctime.3 index d317fd398..648bbe504 100644 --- a/man3/ctime.3 +++ b/man3/ctime.3 @@ -248,7 +248,7 @@ attempt to determine whether DST is in effect at the specified time. The .BR mktime () function modifies the fields of the -.IR tm +.I tm structure as follows: .I tm_wday and diff --git a/man3/des_crypt.3 b/man3/des_crypt.3 index 3ce5aaac5..26de68d24 100644 --- a/man3/des_crypt.3 +++ b/man3/des_crypt.3 @@ -82,16 +82,16 @@ The fourth argument, .IR mode , is formed by ORing together some things. For the encryption direction OR in either -.BR DES_ENCRYPT +.B DES_ENCRYPT or .BR DES_DECRYPT . For software versus hardware encryption, OR in either -.BR DES_HW +.B DES_HW or .BR DES_SW . If -.BR DES_HW +.B DES_HW is specified, and there is no hardware, then the encryption is performed in software and the routine returns .BR DESERR_NOHWDEVICE . @@ -106,16 +106,16 @@ vector upon return. .SH RETURN VALUE .PD 0 .TP 20 -.BR DESERR_NONE +.B DESERR_NONE No error. .TP -.BR DESERR_NOHWDEVICE +.B DESERR_NOHWDEVICE Encryption succeeded, but done in software instead of the requested hardware. .TP -.BR DESERR_HWERROR +.B DESERR_HWERROR An error occurred in the hardware or driver. .TP -.BR DESERR_BADPARAM +.B DESERR_BADPARAM Bad argument to routine. .PD .PP diff --git a/man3/dl_iterate_phdr.3 b/man3/dl_iterate_phdr.3 index 9989573c9..9dc66ad14 100644 --- a/man3/dl_iterate_phdr.3 +++ b/man3/dl_iterate_phdr.3 @@ -30,7 +30,7 @@ dl_iterate_phdr \- walk through list of shared objects .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .B #include <link.h> .PP -.BI "int dl_iterate_phdr(" +.B "int dl_iterate_phdr(" .BI " int (*" callback ") (struct dl_phdr_info *" info , .BI " size_t " size ", void *" data ")," .BI " void *" data ");" @@ -175,7 +175,7 @@ addr == info\->dlpi_addr + info\->dlpi_phdr[x].p_vaddr; Possible values for .I p_type include the following (see -.IR <elf.h> +.I <elf.h> for further details): .PP .in +4n @@ -227,18 +227,18 @@ On the BSDs and Solaris, the structure includes the fields .IR dlpi_name , .IR dlpi_phdr , and -.IR dlpi_phnum +.I dlpi_phnum in addition to other implementation-specific fields. .SH NOTES Future versions of the C library may add further fields to the -.IR dl_phdr_info +.I dl_phdr_info structure; in that event, the .I size argument provides a mechanism for the callback function to discover whether it is running on a system with added fields. .PP The first object visited by -.IR callback +.I callback is the main program. For the main program, the .I dlpi_name diff --git a/man3/dladdr.3 b/man3/dladdr.3 index 2313236ce..51b4ee4d7 100644 --- a/man3/dladdr.3 +++ b/man3/dladdr.3 @@ -43,7 +43,7 @@ Link with \fI\-ldl\fP. The function .BR dladdr () determines whether the address specified in -.IR addr +.I addr is located in one of the shared objects loaded by the calling application. If it is, then .BR dladdr () @@ -89,7 +89,7 @@ which can have one of the following values: .B RTLD_DL_LINKMAP Obtain a pointer to the link map for the matched file. The -.IR extra_info +.I extra_info argument points to a pointer to a .I link_map structure (i.e., @@ -120,7 +120,7 @@ struct link_map { .B RTLD_DL_SYMENT Obtain a pointer to the ELF symbol table entry of the matching symbol. The -.IR extra_info +.I extra_info argument is a pointer to a symbol pointer: .IR "const ElfW(Sym) **" . The @@ -132,7 +132,7 @@ For example, on a 64-bit platform, yields the data type name .IR Elf64_Sym , which is defined in -.IR <elf.h> +.I <elf.h> as: .IP .in +4n @@ -156,9 +156,9 @@ The .I st_info field encodes the symbol's type and binding. The type can be extracted using the macro -.BR ELF64_ST_TYPE(st_info) +.B ELF64_ST_TYPE(st_info) (or -.BR ELF32_ST_TYPE() +.B ELF32_ST_TYPE() on 32-bit platforms), which yields one of the following values: .in +4n .TS @@ -179,9 +179,9 @@ STT_GNU_IFUNC Symbol is indirect code object The symbol binding can be extracted from the .I st_info field using the macro -.BR ELF64_ST_BIND(st_info) +.B ELF64_ST_BIND(st_info) (or -.BR ELF32_ST_BIND() +.B ELF32_ST_BIND() on 32-bit platforms), which yields one of the following values: .in +4n .TS @@ -198,9 +198,9 @@ STB_GNU_UNIQUE Unique symbol The .I st_other field contains the symbol's visibility, which can be extracted using the macro -.BR ELF64_ST_VISIBILITY(st_info) +.B ELF64_ST_VISIBILITY(st_info) (or -.BR ELF32_ST_VISIBILITY() +.B ELF32_ST_VISIBILITY() on 32-bit platforms), which yields one of the following values: .in +4n .TS diff --git a/man3/dlinfo.3 b/man3/dlinfo.3 index 70d914989..43aefbb37 100644 --- a/man3/dlinfo.3 +++ b/man3/dlinfo.3 @@ -41,7 +41,7 @@ The .BR dlinfo () function obtains information about the dynamically loaded object referred to by -.IR handle +.I handle (typically obtained by an earlier call to .BR dlopen (3) or @@ -56,9 +56,9 @@ returned by the call; the type of this argument depends on .IR request . .PP The following values are supported for -.IR request +.I request (with the corresponding type for -.IR info +.I info shown in parentheses): .TP .BR RTLD_DI_LMID " (\fILmid_t *\fP)" @@ -72,7 +72,7 @@ Obtain a pointer to the structure corresponding to .IR handle . The -.IR info +.I info argument points to a pointer to a .I link_map structure, defined in @@ -100,7 +100,7 @@ struct link_map { .TP .BR RTLD_DI_ORIGIN " (\fIchar *\fP)" Copy the pathname of the origin of the shared object corresponding to -.IR handle +.I handle to the location pointed to by .IR info . .TP @@ -114,7 +114,7 @@ argument is a pointer to a that contains the search paths. Because the number of search paths may vary, the size of the structure pointed to by -.IR info +.I info can vary. The .B RTLD_DI_SERINFOSIZE @@ -195,7 +195,7 @@ and fields of the .I Dl_serinfo structure pointed to by -.IR info +.I info with values suitable for allocating a buffer for use in a subsequent .B RTLD_DI_SERINFO request. diff --git a/man3/dlopen.3 b/man3/dlopen.3 index 4842c7725..7a638eacf 100644 --- a/man3/dlopen.3 +++ b/man3/dlopen.3 @@ -363,7 +363,7 @@ The .BR RTLD_NOLOAD , .BR RTLD_NODELETE , and -.BR RTLD_DEEPBIND +.B RTLD_DEEPBIND flags are GNU extensions; the first two of these flags are also present on Solaris. .SH NOTES @@ -399,16 +399,16 @@ flag. The .BR dlmopen () function also can be used to provide better isolation than the -.BR RTLD_LOCAL +.B RTLD_LOCAL flag. In particular, shared objects loaded with -.BR RTLD_LOCAL +.B RTLD_LOCAL may be promoted to -.BR RTLD_GLOBAL +.B RTLD_GLOBAL if they are dependencies of another shared object loaded with .BR RTLD_GLOBAL . Thus, -.BR RTLD_LOCAL +.B RTLD_LOCAL is insufficient to isolate a loaded shared object except in the (uncommon) case where one has explicit control over all shared object dependencies. .PP @@ -446,7 +446,7 @@ A shared object may export multiple constructors and destructors, and priorities can be associated with each function to determine the order in which they are executed. See the -.BR gcc +.B gcc info pages (under "Function attributes") .\" info gcc "C Extensions" "Function attributes" for further information. @@ -474,7 +474,7 @@ command-line option. Use of .B _init and -.BR _fini +.B _fini is now deprecated in favor of the aforementioned constructors and destructors, which among other advantages, @@ -500,13 +500,13 @@ called when a shared object is unloaded. These functions are part of the dlopen API, derived from SunOS. .SH BUGS As at glibc 2.24, specifying the -.BR RTLD_GLOBAL +.B RTLD_GLOBAL flag when calling .BR dlmopen () .\" dlerror(): "invalid mode" generates an error. Furthermore, specifying -.BR RTLD_GLOBAL +.B RTLD_GLOBAL when calling .BR dlopen () results in a program crash diff --git a/man3/dlsym.3 b/man3/dlsym.3 index 994488879..a85e91f06 100644 --- a/man3/dlsym.3 +++ b/man3/dlsym.3 @@ -77,10 +77,10 @@ using the default shared object search order. The search will include global symbols in the executable and its dependencies, as well as symbols in shared objects that were dynamically loaded with the -.BR RTLD_GLOBAL +.B RTLD_GLOBAL flag. .TP -.BR RTLD_NEXT +.B RTLD_NEXT Find the next occurrence of the desired symbol in the search order after the current object. This allows one to provide a wrapper diff --git a/man3/drand48.3 b/man3/drand48.3 index ed4fdaf3f..931d93c3b 100644 --- a/man3/drand48.3 +++ b/man3/drand48.3 @@ -135,7 +135,7 @@ The parameter Unless .BR lcong48 () is called, -.IR a +.I a and .I c are given by: diff --git a/man3/duplocale.3 b/man3/duplocale.3 index 5741c4802..6c5b76e14 100644 --- a/man3/duplocale.3 +++ b/man3/duplocale.3 @@ -107,7 +107,7 @@ which results in undefined behavior if passed to functions such as Calling .BR duplocale () can be used to ensure that the -.BR LC_GLOBAL_LOCALE +.B LC_GLOBAL_LOCALE value is converted into a usable locale object. See EXAMPLE, below. .PP -- 2.20.1