[PATCH] man3/q-r.3: srcfix: Use a single-font-style macro for a single argument

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



  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



[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux