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/get_nprocs_conf.3 | 4 +-- man3/getaddrinfo.3 | 18 ++++++------- man3/getaddrinfo_a.3 | 10 ++++---- man3/getauxval.3 | 58 +++++++++++++++++++++--------------------- man3/getcontext.3 | 2 +- man3/getcwd.3 | 4 +-- man3/getdate.3 | 4 +-- man3/getfsent.3 | 4 +-- man3/getgrnam.3 | 2 +- man3/getgrouplist.3 | 4 +-- man3/gethostbyname.3 | 8 +++--- man3/getifaddrs.3 | 2 +- man3/getmntent.3 | 4 +-- man3/getnameinfo.3 | 4 +-- man3/getopt.3 | 6 ++--- man3/getpwnam.3 | 2 +- man3/getrpcent.3 | 4 +-- man3/glob.3 | 2 +- 18 files changed, 71 insertions(+), 71 deletions(-) diff --git a/man3/get_nprocs_conf.3 b/man3/get_nprocs_conf.3 index 28329b4d1..1240ec90a 100644 --- a/man3/get_nprocs_conf.3 +++ b/man3/get_nprocs_conf.3 @@ -29,9 +29,9 @@ get_nprocs, get_nprocs_conf \- get number of processors .SH SYNOPSIS .B #include <sys/sysinfo.h> .PP -.BI "int get_nprocs(void);" +.B "int get_nprocs(void);" .br -.BI "int get_nprocs_conf(void);" +.B "int get_nprocs_conf(void);" .SH DESCRIPTION The function .BR get_nprocs_conf () diff --git a/man3/getaddrinfo.3 b/man3/getaddrinfo.3 index 95262c173..8f3b531d6 100644 --- a/man3/getaddrinfo.3 +++ b/man3/getaddrinfo.3 @@ -142,7 +142,7 @@ as follows: .I ai_family This field specifies the desired address family for the returned addresses. Valid values for this field include -.BR AF_INET +.B AF_INET and .BR AF_INET6 . The value @@ -157,7 +157,7 @@ and .TP .I ai_socktype This field specifies the preferred socket type, for example -.BR SOCK_STREAM +.B SOCK_STREAM or .BR SOCK_DGRAM . Specifying 0 in this field indicates that socket addresses of any type @@ -228,7 +228,7 @@ connections. The returned socket address will contain the "wildcard address" .RB ( INADDR_ANY for IPv4 addresses, -.BR IN6ADDR_ANY_INIT +.B IN6ADDR_ANY_INIT for IPv6 address). The wildcard address is used by applications (typically servers) that intend to accept connections on any of the host's network addresses. @@ -253,7 +253,7 @@ is NULL, then the network address will be set to the loopback interface address .RB ( INADDR_LOOPBACK for IPv4 addresses, -.BR IN6ADDR_LOOPBACK_INIT +.B IN6ADDR_LOOPBACK_INIT for IPv6 address); this is used by applications that intend to communicate with peers running on the same host. @@ -308,7 +308,7 @@ the linked list may have more than one .I addrinfo structure, including: the network host is multihomed, accessible over multiple protocols (e.g., both -.BR AF_INET +.B AF_INET and .BR AF_INET6 ); or the same service is available from multiple socket types (one @@ -322,7 +322,7 @@ The sorting function used within .BR getaddrinfo () is defined in RFC\ 3484; the order can be tweaked for a particular system by editing -.IR /etc/gai.conf +.I /etc/gai.conf (available since glibc 2.5). .PP If @@ -565,7 +565,7 @@ or the error could occur if was not NULL, and .I hints.ai_socktype was -.BR SOCK_RAW +.B SOCK_RAW (a socket type that does not support the concept of services). .TP .B EAI_SOCKTYPE @@ -575,7 +575,7 @@ This could occur, for example, if and .I hints.ai_protocol are inconsistent (e.g., -.BR SOCK_DGRAM +.B SOCK_DGRAM and .BR IPPROTO_TCP , respectively). @@ -634,7 +634,7 @@ as NULL should cause .I ai_flags to be assumed as 0. The GNU C library instead assumes a value of -.BR "(AI_V4MAPPED\ |\ AI_ADDRCONFIG)" +.B "(AI_V4MAPPED\ |\ AI_ADDRCONFIG)" for this case, since this value is considered an improvement on the specification. .SH EXAMPLE diff --git a/man3/getaddrinfo_a.3 b/man3/getaddrinfo_a.3 index 1a9d36f07..1f35fc932 100644 --- a/man3/getaddrinfo_a.3 +++ b/man3/getaddrinfo_a.3 @@ -143,10 +143,10 @@ The .I sevp\->sigev_notify field can have the following values: .TP -.BR SIGEV_NONE +.B SIGEV_NONE Don't provide any notification. .TP -.BR SIGEV_SIGNAL +.B SIGEV_SIGNAL When a look-up completes, generate the signal .I sigev_signo for the process. @@ -162,7 +162,7 @@ structure will be set to .\" si_pid and si_uid are also set, to the values of the calling process, .\" which doesn't provide useful information, so we'll skip mentioning it. .TP -.BR SIGEV_THREAD +.B SIGEV_THREAD When a look-up completes, invoke .I sigev_notify_function as if it were the start function of a new thread. @@ -171,11 +171,11 @@ See for details. .PP For -.BR SIGEV_SIGNAL +.B SIGEV_SIGNAL and .BR SIGEV_THREAD , it may be useful to point -.IR sevp\->sigev_value.sival_ptr +.I sevp\->sigev_value.sival_ptr to .IR list . .PP diff --git a/man3/getauxval.3 b/man3/getauxval.3 index a787797f9..8d43d108a 100644 --- a/man3/getauxval.3 +++ b/man3/getauxval.3 @@ -56,56 +56,56 @@ Not all .I type values are present on all architectures. .TP -.BR AT_BASE +.B AT_BASE The base address of the program interpreter (usually, the dynamic linker). .TP -.BR AT_BASE_PLATFORM +.B AT_BASE_PLATFORM A string identifying the real platform; may differ from -.BR AT_PLATFORM +.B AT_PLATFORM (PowerPC only). .TP -.BR AT_CLKTCK +.B AT_CLKTCK The frequency with which .BR times (2) counts. This value can also be obtained via .IR sysconf(_SC_CLK_TCK) . .TP -.BR AT_DCACHEBSIZE +.B AT_DCACHEBSIZE The data cache block size. .TP -.BR AT_EGID +.B AT_EGID The effective group ID of the thread. .TP -.BR AT_ENTRY +.B AT_ENTRY The entry address of the executable. .TP -.BR AT_EUID +.B AT_EUID The effective user ID of the thread. .TP -.BR AT_EXECFD +.B AT_EXECFD File descriptor of program. .TP -.BR AT_EXECFN +.B AT_EXECFN Pathname used to execute program. .TP -.BR AT_FLAGS +.B AT_FLAGS Flags (unused). .TP -.BR AT_FPUCW +.B AT_FPUCW Used FPU control word (SuperH architecture only). This gives some information about the FPU initialization performed by the kernel. .TP -.BR AT_GID +.B AT_GID The real group ID of the thread. .TP -.BR AT_HWCAP +.B AT_HWCAP An architecture and ABI dependent bit-mask whose settings indicate detailed processor capabilities. The contents of the bit mask are hardware dependent (for example, see the kernel source file -.IR arch/x86/include/asm/cpufeature.h +.I arch/x86/include/asm/cpufeature.h for details relating to the Intel x86 architecture; the value returned is the first 32-bit word of the array described there). A human-readable version of the same information is available via @@ -114,7 +114,7 @@ A human-readable version of the same information is available via .BR AT_HWCAP2 " (since glibc 2.18)" Further machine-dependent hints about processor capabilities. .TP -.BR AT_ICACHEBSIZE +.B AT_ICACHEBSIZE The instruction cache block size. .\" .TP .\" .BR AT_IGNORE @@ -123,30 +123,30 @@ The instruction cache block size. .\" .TP .\" .BR AT_NOTELF .TP -.BR AT_PAGESZ +.B AT_PAGESZ The system page size (the same value returned by .IR sysconf(_SC_PAGESIZE) ). .TP -.BR AT_PHDR +.B AT_PHDR The address of the program headers of the executable. .TP -.BR AT_PHENT +.B AT_PHENT The size of program header entry. .TP -.BR AT_PHNUM +.B AT_PHNUM The number of program headers. .TP -.BR AT_PLATFORM +.B AT_PLATFORM A pointer to a string that identifies the hardware platform that the program is running on. The dynamic linker uses this in the interpretation of -.IR rpath +.I rpath values. .TP -.BR AT_RANDOM +.B AT_RANDOM The address of sixteen bytes containing a random value. .TP -.BR AT_SECURE +.B AT_SECURE Has a nonzero value if this executable should be treated securely. Most commonly, a nonzero value indicates that the process is executing a set-user-ID or set-group-ID binary @@ -163,19 +163,19 @@ and glibc changes other aspects of its behavior. (See also .BR secure_getenv (3).) .TP -.BR AT_SYSINFO +.B AT_SYSINFO The entry point to the system call function in the vDSO. Not present/needed on all architectures (e.g., absent on x86-64). .TP -.BR AT_SYSINFO_EHDR +.B AT_SYSINFO_EHDR The address of a page containing the virtual Dynamic Shared Object (vDSO) that the kernel creates in order to provide fast implementations of certain system calls. .TP -.BR AT_UCACHEBSIZE +.B AT_UCACHEBSIZE The unified cache block size. .TP -.BR AT_UID +.B AT_UID The real user ID of the thread. .SH RETURN VALUE On success, @@ -190,7 +190,7 @@ is not found, 0 is returned. .BR ENOENT " (since glibc 2.19)" .\" commit b9ab448f980e296eac21ac65f53783967cc6037b No entry corresponding to -.IR type +.I type could be found in the auxiliary vector. .SH VERSIONS The diff --git a/man3/getcontext.3 b/man3/getcontext.3 index 7e6b2f230..4e8bfd0c6 100644 --- a/man3/getcontext.3 +++ b/man3/getcontext.3 @@ -68,7 +68,7 @@ typedef struct ucontext_t { .in .PP with -.IR sigset_t +.I sigset_t and .I stack_t defined in diff --git a/man3/getcwd.3 b/man3/getcwd.3 index c8a691b4a..9f057df3f 100644 --- a/man3/getcwd.3 +++ b/man3/getcwd.3 @@ -271,13 +271,13 @@ On Linux, the kernel provides a system call, which the functions described in this page will use if possible. The system call takes the same arguments as the library function of the same name, but is limited to returning at most -.BR PATH_MAX +.B PATH_MAX bytes. (Before Linux 3.12, .\" commit 3272c544da48f8915a0e34189182aed029bd0f2b the limit on the size of the returned pathname was the system page size. On many architectures, -.BR PATH_MAX +.B PATH_MAX and the system page size are both 4096 bytes, but a few architectures have a larger page size.) If the length of the pathname of the current working directory diff --git a/man3/getdate.3 b/man3/getdate.3 index c9d23b240..86fcc2815 100644 --- a/man3/getdate.3 +++ b/man3/getdate.3 @@ -141,7 +141,7 @@ When successful, returns a pointer to a .IR "struct tm" . Otherwise, it returns NULL and sets the global variable -.IR getdate_err +.I getdate_err to one of the error numbers shown below. Changes to .I errno @@ -153,7 +153,7 @@ returns 0; on error it returns one of the error numbers shown below. .SH ERRORS The following errors are returned via -.IR getdate_err +.I getdate_err (for .BR getdate ()) or as the function result (for diff --git a/man3/getfsent.3 b/man3/getfsent.3 index 74a57b8eb..0c5408100 100644 --- a/man3/getfsent.3 +++ b/man3/getfsent.3 @@ -43,7 +43,7 @@ getfsent, getfsspec, getfsfile, setfsent, endfsent \- handle fstab entries These functions read from the file .IR /etc/fstab . The -.IR "struct fstab" +.I "struct fstab" is defined by: .PP .in +4n @@ -140,7 +140,7 @@ Several operating systems have them, for example, .BR getfstype ()). HP-UX has functions of the same names, that however use a -.IR "struct checklist" +.I "struct checklist" instead of a .IR "struct fstab" , and calls these functions obsolete, superseded by diff --git a/man3/getgrnam.3 b/man3/getgrnam.3 index aa25864d0..50497059d 100644 --- a/man3/getgrnam.3 +++ b/man3/getgrnam.3 @@ -162,7 +162,7 @@ On success, and .BR getgrgid_r () return zero, and set -.IR *result +.I *result to .IR grp . If no matching group record was found, diff --git a/man3/getgrouplist.3 b/man3/getgrouplist.3 index 2f75f9b84..c78eae58d 100644 --- a/man3/getgrouplist.3 +++ b/man3/getgrouplist.3 @@ -93,7 +93,7 @@ groups, then .BR getgrouplist () returns \-1. In this case, the value returned in -.IR *ngroups +.I *ngroups can be used to resize the buffer passed to a further call .BR getgrouplist (). .SH VERSIONS @@ -116,7 +116,7 @@ This function is nonstandard; it appears on most BSDs. In glibc versions before 2.3.3, the implementation of this function contains a buffer-overrun bug: it returns the complete list of groups for -.IR user +.I user in the array .IR groups , even when the number of groups exceeds diff --git a/man3/gethostbyname.3 b/man3/gethostbyname.3 index 5b680e521..d1be81d8b 100644 --- a/man3/gethostbyname.3 +++ b/man3/gethostbyname.3 @@ -251,7 +251,7 @@ file is the modern way of controlling the order of host lookups. In glibc 2.4 and earlier, the .I order keyword was used to control the order of host lookups as defined in -.IR /etc/host.conf +.I /etc/host.conf .RB ( host.conf (5)). .PP .PP @@ -312,12 +312,12 @@ The variable \fIh_errno\fP can have the following values: .B HOST_NOT_FOUND The specified host is unknown. .TP -.BR NO_DATA +.B NO_DATA The requested name is valid but does not have an IP address. Another type of request to the name server for this domain may return an answer. The constant -.BR NO_ADDRESS +.B NO_ADDRESS is a synonym for .BR NO_DATA . .TP @@ -420,7 +420,7 @@ and .BR gethostbyname (), .BR gethostbyaddr (), and -.IR h_errno +.I h_errno are marked obsolescent in that standard. POSIX.1-2008 removes the specifications of .BR gethostbyname (), diff --git a/man3/getifaddrs.3 b/man3/getifaddrs.3 index cdd52f3fc..d43418c8d 100644 --- a/man3/getifaddrs.3 +++ b/man3/getifaddrs.3 @@ -212,7 +212,7 @@ In this case, the field may contain a pointer to a .IR "struct rtnl_link_stats" , defined in -.IR <linux/if_link.h> +.I <linux/if_link.h> (in Linux 2.4 and earlier, .IR "struct net_device_stats" , defined in diff --git a/man3/getmntent.3 b/man3/getmntent.3 index 6ccc26b5f..44b7c40eb 100644 --- a/man3/getmntent.3 +++ b/man3/getmntent.3 @@ -114,7 +114,7 @@ the end of the open The .BR endmntent () function closes the -.IR stream +.I stream associated with the filesystem description file. .PP The @@ -139,7 +139,7 @@ The reentrant function is similar to .BR getmntent (), but stores the -.IR "struct mount" +.I "struct mount" in the provided .I *mntbuf and stores the strings pointed to by the entries in that struct diff --git a/man3/getnameinfo.3 b/man3/getnameinfo.3 index 90f4a284f..e0c00b580 100644 --- a/man3/getnameinfo.3 +++ b/man3/getnameinfo.3 @@ -237,10 +237,10 @@ Since glibc 2.8, these definitions are exposed only if suitable feature test macros are defined, namely: .BR _GNU_SOURCE , -.BR _DEFAULT_SOURCE +.B _DEFAULT_SOURCE (since glibc 2.19), or (in glibc versions up to and including 2.19) -.BR _BSD_SOURCE +.B _BSD_SOURCE or .BR _SVID_SOURCE . .PP diff --git a/man3/getopt.3 b/man3/getopt.3 index 2f1c70ef9..6b1be64e8 100644 --- a/man3/getopt.3 +++ b/man3/getopt.3 @@ -171,7 +171,7 @@ While processing the option list, .BR getopt () can detect two kinds of errors: (1) an option character that was not specified in -.IR optstring +.I optstring and (2) a missing option argument (i.e., an option at the end of the command line without an expected argument). Such errors are handled and reported as follows: @@ -184,14 +184,14 @@ places the erroneous option character in and returns \(aq?\(aq as the function result. .IP * If the caller has set the global variable -.IR opterr +.I opterr to zero, then .BR getopt () does not print an error message. The caller can determine that there was an error by testing whether the function return value is \(aq?\(aq. (By default, -.IR opterr +.I opterr has a nonzero value.) .IP * If the first character diff --git a/man3/getpwnam.3 b/man3/getpwnam.3 index 2f1db3f0c..09205ebab 100644 --- a/man3/getpwnam.3 +++ b/man3/getpwnam.3 @@ -168,7 +168,7 @@ On success, and .BR getpwuid_r () return zero, and set -.IR *result +.I *result to .IR pwd . If no matching password record was found, diff --git a/man3/getrpcent.3 b/man3/getrpcent.3 index 191e31c7d..68855dc95 100644 --- a/man3/getrpcent.3 +++ b/man3/getrpcent.3 @@ -13,7 +13,7 @@ RPC entry .nf .B #include <netdb.h> .PP -.BI "struct rpcent *getrpcent(void);" +.B "struct rpcent *getrpcent(void);" .PP .BI "struct rpcent *getrpcbyname(const char *" name ); .PP @@ -21,7 +21,7 @@ RPC entry .PP .BI "void setrpcent(int " stayopen ); .PP -.BI "void endrpcent(void);" +.B "void endrpcent(void);" .fi .SH DESCRIPTION .PP diff --git a/man3/glob.3 b/man3/glob.3 index d55f55e4c..d7d59631d 100644 --- a/man3/glob.3 +++ b/man3/glob.3 @@ -193,7 +193,7 @@ home directory cannot be determined, then instead of using the pattern itself as the name, .BR glob () returns -.BR GLOB_NOMATCH +.B GLOB_NOMATCH to indicate an error. .TP .B GLOB_ONLYDIR -- 2.20.1