On 1/29/19 2:47 AM, Bjarni Ingi Gislason wrote:
> Use a single-font-style macro (".B", ".I") for a single argument.
>
> Remove unneeded quotation marks (").
>
> The output from "nroff" and "groff" is unchanged, except for the change
>
> 1) '-1' to '\-1' in the file "timegm.3"
>
> 2) to separate ',' from a word in the file "uselocale.3".
Applied, mainly because of 1 and 2.
Thanks,
Michael
> Signed-off-by: Bjarni Ingi Gislason <bjarniig@xxxxxxxxx>
> ---
> man3/tan.3 | 2 +-
> man3/termios.3 | 2 +-
> man3/timegm.3 | 2 +-
> man3/toupper.3 | 2 +-
> man3/towctrans.3 | 4 ++--
> man3/towlower.3 | 4 ++--
> man3/towupper.3 | 4 ++--
> man3/trunc.3 | 2 +-
> man3/tsearch.3 | 26 +++++++++++++-------------
> man3/ttyname.3 | 2 +-
> man3/ttyslot.3 | 2 +-
> man3/ungetwc.3 | 4 ++--
> man3/uselocale.3 | 4 ++--
> 13 files changed, 30 insertions(+), 30 deletions(-)
>
> diff --git a/man3/tan.3 b/man3/tan.3
> index b8b05fcbe..6a0c3d966 100644
> --- a/man3/tan.3
> +++ b/man3/tan.3
> @@ -109,7 +109,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/termios.3 b/man3/termios.3
> index c73c3e505..819a2cd46 100644
> --- a/man3/termios.3
> +++ b/man3/termios.3
> @@ -608,7 +608,7 @@ Status character (STATUS).
> Display status information at terminal,
> including state of foreground process and amount of CPU time it has consumed.
> Also sends a
> -.BR SIGINFO
> +.B SIGINFO
> signal (not supported on Linux) to the foreground process group.
> .TP
> .B VSTOP
> diff --git a/man3/timegm.3 b/man3/timegm.3
> index fee346d55..b32a67ab4 100644
> --- a/man3/timegm.3
> +++ b/man3/timegm.3
> @@ -67,7 +67,7 @@ these functions return the calendar time (seconds since the Epoch),
> expressed as a value of type
> .IR time_t .
> On error, they return the value
> -.IR "(time_t)\ -1"
> +.I (time_t)\ \-1
> and set
> .I errno
> to indicate the cause of the error.
> diff --git a/man3/toupper.3 b/man3/toupper.3
> index ebcab498f..f036acf8c 100644
> --- a/man3/toupper.3
> +++ b/man3/toupper.3
> @@ -103,7 +103,7 @@ and
> is undefined if
> .I locale
> is the special locale object
> -.BR LC_GLOBAL_LOCALE
> +.B LC_GLOBAL_LOCALE
> (see
> .BR duplocale (3))
> or is not a valid locale object handle.
> diff --git a/man3/towctrans.3 b/man3/towctrans.3
> index 6806bc97f..d2bc548d0 100644
> --- a/man3/towctrans.3
> +++ b/man3/towctrans.3
> @@ -31,7 +31,7 @@ function
> translates it according to the transliteration descriptor
> .IR desc .
> If
> -.IR wc
> +.I wc
> is
> .BR WEOF ,
> .B WEOF
> @@ -47,7 +47,7 @@ The
> .BR towctrans ()
> function returns the translated wide character,
> or
> -.BR WEOF
> +.B WEOF
> if
> .I wc
> is
> diff --git a/man3/towlower.3 b/man3/towlower.3
> index dba616a11..4384c0480 100644
> --- a/man3/towlower.3
> +++ b/man3/towlower.3
> @@ -69,7 +69,7 @@ The behavior of
> is undefined if
> .I locale
> is the special locale object
> -.BR LC_GLOBAL_LOCALE
> +.B LC_GLOBAL_LOCALE
> (see
> .BR duplocale (3))
> or is not a valid locale object handle.
> @@ -77,7 +77,7 @@ or is not a valid locale object handle.
> The argument
> .I wc
> must be representable as a
> -.IR wchar_t
> +.I wchar_t
> and be a valid character in the locale or be the value
> .BR WEOF .
> .SH RETURN VALUE
> diff --git a/man3/towupper.3 b/man3/towupper.3
> index 8624196ba..742842eab 100644
> --- a/man3/towupper.3
> +++ b/man3/towupper.3
> @@ -69,7 +69,7 @@ The behavior of
> is undefined if
> .I locale
> is the special locale object
> -.BR LC_GLOBAL_LOCALE
> +.B LC_GLOBAL_LOCALE
> (see
> .BR duplocale (3))
> or is not a valid locale object handle.
> @@ -77,7 +77,7 @@ or is not a valid locale object handle.
> The argument
> .I wc
> must be representable as a
> -.IR wchar_t
> +.I wchar_t
> and be a valid character in the locale or be the value
> .BR WEOF .
> .SH RETURN VALUE
> diff --git a/man3/trunc.3 b/man3/trunc.3
> index a90e8edc8..4a2882212 100644
> --- a/man3/trunc.3
> +++ b/man3/trunc.3
> @@ -58,7 +58,7 @@ to the nearest integer value that is not larger in magnitude than
> These functions return the rounded integer value, in floating format.
> .PP
> If
> -.IR x
> +.I x
> is integral, infinite, or NaN,
> .I x
> itself is returned.
> diff --git a/man3/tsearch.3 b/man3/tsearch.3
> index fd74bee1e..fcdaaa40e 100644
> --- a/man3/tsearch.3
> +++ b/man3/tsearch.3
> @@ -59,7 +59,7 @@ They are generalized from Knuth (6.2.2) Algorithm T.
> The first field in each node of the tree is a pointer to the
> corresponding data item.
> (The calling program must store the actual data.)
> -.IR compar
> +.I compar
> points to a comparison routine, which takes
> pointers to two items.
> It should return an integer which is negative,
> @@ -68,13 +68,13 @@ equal to, or greater than the second.
> .PP
> .BR tsearch ()
> searches the tree for an item.
> -.IR key
> +.I key
> points to the item to be searched for.
> -.IR rootp
> +.I rootp
> points to a variable which points to the root of the tree.
> If the tree is empty,
> then the variable that
> -.IR rootp
> +.I rootp
> points to should be set to NULL.
> If the item is found in the tree, then
> .BR tsearch ()
> @@ -104,12 +104,12 @@ Its arguments are the same as for
> .BR twalk ()
> performs depth-first, left-to-right traversal of a binary
> tree.
> -.IR root
> +.I root
> points to the starting node for the traversal.
> If that node is not the root, then only part of the tree will be visited.
> .BR twalk ()
> calls the user function
> -.IR action
> +.I action
> each time a node is
> visited (that is, three times for an internal node, and once for a
> leaf).
> @@ -125,11 +125,11 @@ takes one of the values
> .BR preorder ,
> .BR postorder ,
> or
> -.BR endorder
> +.B endorder
> depending on whether this is the first, second, or
> third visit to the internal node,
> or the value
> -.BR leaf
> +.B leaf
> if this is the single visit to a leaf node.
> (These symbols are defined in
> .IR <search.h> .)
> @@ -140,7 +140,7 @@ the root node has depth zero.
> .BR preorder ,
> .BR postorder ,
> and
> -.BR endorder
> +.B endorder
> are known as
> .BR preorder ,
> .BR inorder ,
> @@ -149,7 +149,7 @@ and
> before visiting the children, after the first and before the second,
> and after visiting the children.
> Thus, the choice of name
> -.BR post\%order
> +.B post\%order
> is rather confusing.)
> .PP
> .BR tdestroy ()
> @@ -159,11 +159,11 @@ freeing all resources allocated by the
> .BR tsearch ()
> function.
> For the data in each tree node the function
> -.IR free_node
> +.I free_node
> is called.
> The pointer to the data is passed as the argument to the function.
> If no such work is necessary,
> -.IR free_node
> +.I free_node
> must point to a function
> doing nothing.
> .SH RETURN VALUE
> @@ -190,7 +190,7 @@ and
> .BR tdelete ()
> also
> return NULL if
> -.IR rootp
> +.I rootp
> was NULL on entry.
> .SH ATTRIBUTES
> For an explanation of the terms used in this section, see
> diff --git a/man3/ttyname.3 b/man3/ttyname.3
> index 741484372..664189459 100644
> --- a/man3/ttyname.3
> +++ b/man3/ttyname.3
> @@ -97,7 +97,7 @@ POSIX.1-2001, POSIX.1-2008, 4.2BSD.
> A process that keeps a file descriptor that refers to a
> .BR pts (4)
> device open when switching to another mount namespace that uses a different
> -.IR /dev/ptmx
> +.I /dev/ptmx
> instance may still accidentally find that a device path of the same name
> for that file descriptor exists.
> However, this device path refers to a different device and thus
> diff --git a/man3/ttyslot.3 b/man3/ttyslot.3
> index b80d6b166..76938f9a7 100644
> --- a/man3/ttyslot.3
> +++ b/man3/ttyslot.3
> @@ -162,7 +162,7 @@ is provided by
> On System V-like systems, the declaration is provided by
> .IR <stdlib.h> .
> Since glibc 2.24,
> -.IR <stdlib.h>
> +.I <stdlib.h>
> also provides the declaration with the following
> feature test macro definitions:
> .PP
> diff --git a/man3/ungetwc.3 b/man3/ungetwc.3
> index a9f1a2c23..9615f1138 100644
> --- a/man3/ungetwc.3
> +++ b/man3/ungetwc.3
> @@ -42,7 +42,7 @@ If
> .I wc
> is an invalid wide character,
> it sets
> -.IR errno
> +.I errno
> to
> .B EILSEQ
> and returns
> @@ -69,7 +69,7 @@ level of push-back is guaranteed.
> The
> .BR ungetwc ()
> function returns
> -.IR wc
> +.I wc
> when successful, or
> .B WEOF
> upon
> diff --git a/man3/uselocale.3 b/man3/uselocale.3
> index b413ea8d1..f3f14baac 100644
> --- a/man3/uselocale.3
> +++ b/man3/uselocale.3
> @@ -80,10 +80,10 @@ On success,
> returns the locale handle that was set by the previous call to
> .BR uselocale ()
> in this thread, or
> -.BR LC_GLOBAL_LOCALE
> +.B LC_GLOBAL_LOCALE
> if there was no such previous call.
> On error, it returns
> -.IR "(locale_t)\ 0",
> +.IR "(locale_t)\ 0" ,
> and sets
> .I errno
> to indicate the cause of the error.
>
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
