Use a single-font-style macro (".B", ".I") for a single argument. Remove unneeded quotation marks ("). The output from "nroff" and "groff" is unchanged. Signed-off-by: Bjarni Ingi Gislason <bjarniig@xxxxxxxxx> --- man3/rand.3 | 6 +++--- man3/random_r.3 | 8 ++++---- man3/rcmd.3 | 20 ++++++++++---------- man3/readdir.3 | 10 +++++----- man3/readdir_r.3 | 6 +++--- man3/realpath.3 | 6 +++--- man3/remainder.3 | 6 +++--- man3/remquo.3 | 2 +- man3/resolver.3 | 8 ++++---- man3/rexec.3 | 14 +++++++------- man3/round.3 | 4 ++-- man3/rpc.3 | 10 +++++----- 12 files changed, 50 insertions(+), 50 deletions(-) diff --git a/man3/rand.3 b/man3/rand.3 index 6a1bee31a..82102482a 100644 --- a/man3/rand.3 +++ b/man3/rand.3 @@ -69,7 +69,7 @@ Glibc 2.23 and earlier The .BR rand () function returns a pseudo-random integer in the range 0 to -.BR RAND_MAX +.B RAND_MAX inclusive (i.e., the mathematical range [0,\ \fBRAND_MAX\fR]). .PP The @@ -103,7 +103,7 @@ returns a pseudo-random integer in the range [0,\ \fBRAND_MAX\fR]. The .I seedp argument is a pointer to an -.IR "unsigned int" +.I unsigned int that is used to store state between calls. If .BR rand_r () @@ -127,7 +127,7 @@ The and .BR rand_r () functions return a value between 0 and -.BR RAND_MAX +.B RAND_MAX (inclusive). The .BR srand () diff --git a/man3/random_r.3 b/man3/random_r.3 index 1406cf0e8..bb38da1b7 100644 --- a/man3/random_r.3 +++ b/man3/random_r.3 @@ -95,7 +95,7 @@ except that it initializes the state in the object pointed to by .IR buf , rather than initializing the global state variable. Before calling this function, the -.IR buf.state +.I buf.state field must be initialized to NULL. The .BR initstate_r () @@ -104,9 +104,9 @@ function records a pointer to the argument inside the structure pointed to by .IR buf . Thus, -.IR statebuf +.I statebuf should not be deallocated so long as -.IR buf +.I buf is still in use. (So, .I statebuf @@ -181,7 +181,7 @@ The interface is confusing. .\" FIXME . https://sourceware.org/bugzilla/show_bug.cgi?id=3662 It appears that the -.IR random_data +.I random_data type is intended to be opaque, but the implementation requires the user to either initialize the .I buf.state diff --git a/man3/rcmd.3 b/man3/rcmd.3 index eed86c853..4eb18a637 100644 --- a/man3/rcmd.3 +++ b/man3/rcmd.3 @@ -132,10 +132,10 @@ residing at the well-known Internet port .PP If the connection succeeds, a socket in the Internet domain of type -.BR SOCK_STREAM +.B SOCK_STREAM is returned to the caller, and given to the remote command as -.IR stdin +.I stdin and .IR stdout . If @@ -151,10 +151,10 @@ forwarded to the process group of the command. If .I fd2p is 0, then the -.IR stderr +.I stderr (unit 2 of the remote command) will be made the same as the -.IR stdout +.I stdout and no provision is made for sending arbitrary signals to the remote process, although you may be able to get its attention by using out-of-band data. @@ -197,10 +197,10 @@ name is that of the superuser. Then, if the user is .I not the superuser, it checks the -.IR /etc/hosts.equiv +.I /etc/hosts.equiv file. If that lookup is not done, or is unsuccessful, the -.IR .rhosts +.I .rhosts in the local user's home directory is checked to see if the request for service is allowed. .PP @@ -208,9 +208,9 @@ If this file does not exist, is not a regular file, is owned by anyone other than the user or the superuser, is writable by anyone other than the owner, or is hardlinked anywhere, the check automatically fails. Zero is returned if the machine name is listed in the -.IR hosts.equiv +.I hosts.equiv file, or the host and remote username are found in the -.IR .rhosts +.I .rhosts file; otherwise .BR iruserok () and @@ -234,7 +234,7 @@ socket address family to be specified. For these functions, the .I af argument can be specified as -.BR AF_INET +.B AF_INET or .BR AF_INET6 . In addition, @@ -256,7 +256,7 @@ It returns \-1 on error with the global value .I errno set according to the reason for failure. The error code -.BR EAGAIN +.B EAGAIN is overloaded to mean "All network ports in use." .PP For information on the return from diff --git a/man3/readdir.3 b/man3/readdir.3 index b9ae265fc..84e2acb57 100644 --- a/man3/readdir.3 +++ b/man3/readdir.3 @@ -71,7 +71,7 @@ struct dirent { The only fields in the .I dirent structure that are mandated by POSIX.1 are -.IR d_name +.I d_name and .IR d_ino . The other fields are unstandardized, and not present on all systems; @@ -112,7 +112,7 @@ if further actions depend on the type of the file. When a suitable feature test macro is defined .RB ( _DEFAULT_SOURCE on glibc versions since 2.19, or -.BR _BSD_SOURCE +.B _BSD_SOURCE on glibc versions 2.19 and earlier), glibc defines the following macro constants for the value returned in .IR d_type : @@ -274,14 +274,14 @@ POSIX.1 explicitly notes that this field should not be used as an lvalue. The standard also notes that the use of .I sizeof(d_name) is incorrect; use -.IR strlen(d_name) +.I strlen(d_name) instead. (On some systems, this field is defined as .IR char\ d_name[1] !) By implication, the use -.IR "sizeof(struct dirent)" +.I sizeof(struct dirent) to capture the size of the record including the size of -.IR d_name +.I d_name is also incorrect. .PP Note that while the call diff --git a/man3/readdir_r.3 b/man3/readdir_r.3 index 8c5cc07c8..e12296c62 100644 --- a/man3/readdir_r.3 +++ b/man3/readdir_r.3 @@ -60,7 +60,7 @@ It reads the next directory entry from the directory stream and returns it in the caller-allocated buffer pointed to by .IR entry . For details of the -.IR dirent +.I dirent structure, see .BR readdir (3). .PP @@ -79,7 +79,7 @@ Furthermore, since version 2.24, glibc deprecates The reasons are as follows: .IP * 3 On systems where -.BR NAME_MAX +.B NAME_MAX is undefined, calling .BR readdir_r () may be unsafe because the interface does not allow the caller to specify @@ -96,7 +96,7 @@ fails with the error On some other systems, .BR readdir_r () may return a success status, but the returned -.IR d_name +.I d_name field may not be null terminated or may be truncated. .IP * In the current POSIX.1 specification (POSIX.1-2008), diff --git a/man3/realpath.3 b/man3/realpath.3 index 57b56d336..28917a9f9 100644 --- a/man3/realpath.3 +++ b/man3/realpath.3 @@ -113,7 +113,7 @@ is NULL. .\" (In libc5 this would just cause a segfault.) (In glibc versions before 2.3, this error is also returned if -.IR resolved_path +.I resolved_path is NULL.) .TP .B EIO @@ -198,9 +198,9 @@ A typical source fragment would be .\" but in \fI<stdlib.h>\fP everywhere else. .SS GNU extensions If the call fails with either -.BR EACCES +.B EACCES or -.BR ENOENT +.B ENOENT and .I resolved_path is not NULL, then the prefix of diff --git a/man3/remainder.3 b/man3/remainder.3 index 59b2038e8..5cbe1932f 100644 --- a/man3/remainder.3 +++ b/man3/remainder.3 @@ -154,14 +154,14 @@ The following errors can occur: Domain error: \fIx\fP is an infinity and \fIy\fP is not a NaN .I errno is set to -.BR EDOM +.B EDOM (but see BUGS). An invalid floating-point exception .RB ( FE_INVALID ) is raised. .IP These functions do not set -.IR errno +.I errno for this case. .TP Domain error: \fIy\fP is zero\" [XXX see bug above] and \fIx\fP is not a NaN @@ -228,7 +228,7 @@ Before glibc 2.15, .\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=6783 .I errno was not set to -.BR EDOM +.B EDOM for the domain error that occurs when .I x is an infinity and diff --git a/man3/remquo.3 b/man3/remquo.3 index ebc681a1b..aed816c6e 100644 --- a/man3/remquo.3 +++ b/man3/remquo.3 @@ -54,7 +54,7 @@ function. The value stored via the .I quo pointer has the sign of -.IR "x\ /\ y" +.I x\ /\ y and agrees with the quotient in at least the low order 3 bits. .PP For example, \fIremquo(29.0,\ 3.0)\fP returns \-1.0 and might store 2. diff --git a/man3/resolver.3 b/man3/resolver.3 index 3cd659d33..e66f19566 100644 --- a/man3/resolver.3 +++ b/man3/resolver.3 @@ -253,15 +253,15 @@ the message. .PP The resolver routines use configuration and state information contained in a -.IR __res_state +.I __res_state structure (either passed as the -.IR statep +.I statep argument, or in the global variable .IR _res , in the case of the older nonreentrant functions). The only field of this structure that is normally manipulated by the user is the -.IR options +.I options field. This field can contain the bitwise "OR" of the following options: @@ -428,7 +428,7 @@ Do not look up unqualified name as a top-level domain (TLD). Default option which implies: .BR RES_RECURSE , .BR RES_DEFNAMES , -.BR RES_DNSRCH +.B RES_DNSRCH and .BR RES_NOIP6DOTINT . .\" diff --git a/man3/rexec.3 b/man3/rexec.3 index 2b8e5c57a..9a09a47a3 100644 --- a/man3/rexec.3 +++ b/man3/rexec.3 @@ -69,12 +69,12 @@ The .BR rexec () function looks up the host -.IR *ahost +.I *ahost using .BR gethostbyname (3), returning \-1 if the host does not exist. Otherwise, -.IR *ahost +.I *ahost is set to the standard name of the host. If a username and password are both specified, then these are used to authenticate to the foreign host; otherwise @@ -97,10 +97,10 @@ The protocol for connection is described in detail in .PP If the connection succeeds, a socket in the Internet domain of type -.BR SOCK_STREAM +.B SOCK_STREAM is returned to the caller, and given to the remote command as -.IR stdin +.I stdin and .IR stdout . If @@ -120,10 +120,10 @@ verified. If .I fd2p is 0, then the -.IR stderr +.I stderr (unit 2 of the remote command) will be made the same as the -.IR stdout +.I stdout and no provision is made for sending arbitrary signals to the remote process, although you may be able to get its attention by using out-of-band data. @@ -141,7 +141,7 @@ This argument can be specified as .BR AF_INET , .BR AF_INET6 , or -.BR AF_UNSPEC +.B AF_UNSPEC (to allow the implementation to select the protocol). .SH VERSIONS The diff --git a/man3/round.3 b/man3/round.3 index cc58117a1..cec9ac571 100644 --- a/man3/round.3 +++ b/man3/round.3 @@ -62,9 +62,9 @@ instead of to the nearest even integer like .BR rint (3). .PP For example, -.IR round(0.5) +.I round(0.5) is 1.0, and -.IR round(\-0.5) +.I round(\-0.5) is \-1.0. .SH RETURN VALUE These functions return the rounded integer value. diff --git a/man3/rpc.3 b/man3/rpc.3 index f931c3d64..95eccbd04 100644 --- a/man3/rpc.3 +++ b/man3/rpc.3 @@ -45,7 +45,7 @@ See the header files for the declarations of the .IR CLIENT , .IR SVCXPRT , and -.IR XDR +.I XDR types. .PP .nf @@ -61,7 +61,7 @@ is undefined after calling .BR auth_destroy (). .PP .nf -.BI "AUTH *authnone_create(void);" +.B AUTH *authnone_create(void); .fi .IP Create and return an RPC @@ -90,7 +90,7 @@ refer to a counted array of groups to which the user belongs. It is easy to impersonate a user. .PP .nf -.BI "AUTH *authunix_create_default(void);" +.B AUTH *authunix_create_default(void); .fi .IP Calls @@ -538,7 +538,7 @@ program-to-port mappings on the host located at IP address .IR *addr . This routine can return NULL. The command -.IR "rpcinfo\ \-p" +.I rpcinfo\ \-p uses this routine. .PP .nf @@ -933,7 +933,7 @@ indicate sizes for the send and receive buffers. If they are zero, a reasonable default is chosen. .PP .nf -.BI "SVCXPRT *svcraw_create(void);" +.B SVCXPRT *svcraw_create(void); .fi .IP This routine creates a toy RPC -- 2.20.1