From d8a86e74a28498c4b016f40cb4b323267bd5a9f0 Mon Sep 17 00:00:00 2001 From: Bjarni Ingi Gislason Date: Tue, 29 Jan 2019 01:47:52 +0000 Subject: [PATCH] man3/t-v.3: srcfix: Use a single-font-style macro for a single argument 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". Signed-off-by: Bjarni Ingi Gislason Signed-off-by: Michael Kerrisk --- 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 b8b05fcbe5..6a0c3d966e 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 c73c3e5053..819a2cd468 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 fee346d550..b32a67ab4b 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 ebcab498f6..f036acf8c1 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 6806bc97f0..d2bc548d00 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 dba616a11a..4384c04806 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 8624196ba9..742842eab9 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 a90e8edc8b..4a28822125 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 fd74bee1ea..fcdaaa40e5 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 .) @@ -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 7414843722..6641894594 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 b80d6b1663..76938f9a74 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 . Since glibc 2.24, -.IR +.I also provides the declaration with the following feature test macro definitions: .PP diff --git a/man3/ungetwc.3 b/man3/ungetwc.3 index a9f1a2c232..9615f11385 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 b413ea8d10..f3f14baaca 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. -- 2.39.2