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 1) change "-0.0" to "\-0.0" in the file "signbit.3". 2) added '\' in front of a '-' for a option in the file "scanf.3". Signed-off-by: Bjarni Ingi Gislason <bjarniig@xxxxxxxxx> --- man3/scalb.3 | 2 +- man3/scalbln.3 | 2 +- man3/scanf.3 | 10 +++++----- man3/sem_open.3 | 2 +- man3/setenv.3 | 4 ++-- man3/setjmp.3 | 12 ++++++------ man3/setlogmask.3 | 2 +- man3/shm_open.3 | 2 +- man3/signbit.3 | 4 ++-- man3/sigwait.3 | 2 +- man3/sin.3 | 2 +- man3/sleep.3 | 2 +- man3/statvfs.3 | 4 ++-- man3/stdarg.3 | 2 +- man3/strcasecmp.3 | 2 +- man3/strcat.3 | 8 ++++---- man3/strcmp.3 | 2 +- man3/strcpy.3 | 4 ++-- man3/strerror.3 | 2 +- man3/strfmon.3 | 2 +- man3/strfromd.3 | 4 ++-- man3/strftime.3 | 12 ++++++------ man3/strptime.3 | 2 +- man3/strtod.3 | 4 ++-- man3/strtok.3 | 2 +- man3/strtol.3 | 2 +- man3/strtoul.3 | 2 +- man3/syslog.3 | 2 +- man3/system.3 | 2 +- 29 files changed, 52 insertions(+), 52 deletions(-) diff --git a/man3/scalb.3 b/man3/scalb.3 index 2db0bd9ad..b94c70373 100644 --- a/man3/scalb.3 +++ b/man3/scalb.3 @@ -82,7 +82,7 @@ can be obtained by including .\" not in /usr/include but in a gcc lib .SH RETURN VALUE On success, these functions return -.IR x +.I x * .B FLT_RADIX ** diff --git a/man3/scalbln.3 b/man3/scalbln.3 index 6c926dae5..741fdc8de 100644 --- a/man3/scalbln.3 +++ b/man3/scalbln.3 @@ -89,7 +89,7 @@ can be obtained by including .\" not in /usr/include but in a gcc lib .SH RETURN VALUE On success, these functions return -.IR x +.I x * .B FLT_RADIX ** diff --git a/man3/scanf.3 b/man3/scanf.3 index 502569a45..33bd5d845 100644 --- a/man3/scanf.3 +++ b/man3/scanf.3 @@ -199,7 +199,7 @@ included in the count of successful assignments returned by For decimal conversions, an optional quote character (\(aq). This specifies that the input number may include thousands' separators as defined by the -.BR LC_NUMERIC +.B LC_NUMERIC category of the current locale. (See .BR setlocale (3).) @@ -660,9 +660,9 @@ modifier for assignment allocation (as documented in DESCRIPTION, above). Note that the .B a modifier is not available if the program is compiled with -.I "gcc -std=c99" +.I gcc \-std=c99 or -.IR "gcc -D_ISOC99_SOURCE" +.I gcc \-D_ISOC99_SOURCE (unless .B _GNU_SOURCE is also specified), in which case the @@ -679,7 +679,7 @@ As well as being standardized by POSIX, the .B m modifier has the following further advantages over the use of -.BR a: +.B a: .IP * 2 It may also be applied to .B %c @@ -689,7 +689,7 @@ conversion specifiers (e.g., It avoids ambiguity with respect to the .B %a floating-point conversion specifier (and is unaffected by -.IR "gcc -std=c99" +.I gcc \-std=c99 etc.). .SH BUGS All functions are fully C89 conformant, but provide the diff --git a/man3/sem_open.3 b/man3/sem_open.3 index a5c716591..8b5b1069d 100644 --- a/man3/sem_open.3 +++ b/man3/sem_open.3 @@ -153,7 +153,7 @@ The system-wide limit on the total number of open files has been reached. The .B O_CREAT flag was not specified in -.IR oflag +.I oflag and no semaphore with this .I name exists; diff --git a/man3/setenv.3 b/man3/setenv.3 index cd4fbcd6a..560d3f109 100644 --- a/man3/setenv.3 +++ b/man3/setenv.3 @@ -75,12 +75,12 @@ If .I name does exist in the environment, then its value is changed to -.IR value +.I value if .I overwrite is nonzero; if -.IR overwrite +.I overwrite is zero, then the value of .I name is not changed (and diff --git a/man3/setjmp.3 b/man3/setjmp.3 index f97133cd7..0e58bde97 100644 --- a/man3/setjmp.3 +++ b/man3/setjmp.3 @@ -62,7 +62,7 @@ function saves various information about the calling environment (typically, the stack pointer, the instruction pointer, possibly the values of other registers and the signal mask) in the buffer -.IR env +.I env for later use by .BR longjmp (). In this case, @@ -72,7 +72,7 @@ returns 0. The .BR longjmp () function uses the information saved in -.IR env +.I env to transfer control back to the point where .BR setjmp () was called and to restore ("rewind") the stack to its state at the time of the @@ -175,7 +175,7 @@ On Linux with glibc versions before 2.19, .BR setjmp () follows the System V behavior by default, but the BSD behavior is provided if the -.BR _BSD_SOURCE +.B _BSD_SOURCE feature test macro is explicitly defined .\" so that _FAVOR_BSD is triggered and none of @@ -188,7 +188,7 @@ or .B _SVID_SOURCE is defined. Since glibc 2.19, -.IR <setjmp.h> +.I <setjmp.h> exposes only the System V version of .BR setjmp (). Programs that need the BSD semantics should replace calls to @@ -247,7 +247,7 @@ allow the programmer to easily perceive the flow of control. Nonlocal gotos provide no such cues: multiple .BR setjmp () calls might employ the same -.IR jmp_buf +.I jmp_buf variable so that the content of the variable may change over the lifetime of the application. Consequently, the programmer may be forced to perform detailed @@ -257,7 +257,7 @@ call. (To make the programmer's life easier, each .BR setjmp () call should employ a unique -.IR jmp_buf +.I jmp_buf variable.) .PP Adding further difficulty, the diff --git a/man3/setlogmask.3 b/man3/setlogmask.3 index e24b01a90..3b5f24195 100644 --- a/man3/setlogmask.3 +++ b/man3/setlogmask.3 @@ -62,7 +62,7 @@ The bit corresponding to a priority is .IR LOG_MASK(p) . Some systems also provide a macro -.IR LOG_UPTO(p) +.I LOG_UPTO(p) for the mask of all priorities in the above list up to and including .IR p . diff --git a/man3/shm_open.3 b/man3/shm_open.3 index 95bc7cb45..05acd4611 100644 --- a/man3/shm_open.3 +++ b/man3/shm_open.3 @@ -61,7 +61,7 @@ For portable use, a shared memory object should be identified by a name of the form .IR /somename ; that is, a null-terminated string of up to -.BI NAME_MAX +.B NAME_MAX (i.e., 255) characters consisting of an initial slash, .\" glibc allows the initial slash to be omitted, and makes .\" multiple initial slashes equivalent to a single slash. diff --git a/man3/signbit.3 b/man3/signbit.3 index 698bdb289..eedebdedf 100644 --- a/man3/signbit.3 +++ b/man3/signbit.3 @@ -40,9 +40,9 @@ This is not the same as .IR "x < 0.0" , because IEEE 754 floating point allows zero to be signed. The comparison -.IR "-0.0 < 0.0" +.I \-0.0 < 0.0 is false, but -.IR "signbit(\-0.0)" +.I signbit(\-0.0) will return a nonzero value. .PP NaNs and infinities have a sign bit. diff --git a/man3/sigwait.3 b/man3/sigwait.3 index 17a5c57a9..02e11fc09 100644 --- a/man3/sigwait.3 +++ b/man3/sigwait.3 @@ -53,7 +53,7 @@ The .BR sigwait () function suspends execution of the calling thread until one of the signals specified in the signal set -.IR set +.I set becomes pending. The function accepts the signal (removes it from the pending list of signals), diff --git a/man3/sin.3 b/man3/sin.3 index 3cc445972..cb13b4719 100644 --- a/man3/sin.3 +++ b/man3/sin.3 @@ -94,7 +94,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/sleep.3 b/man3/sleep.3 index db50baa95..246a580c7 100644 --- a/man3/sleep.3 +++ b/man3/sleep.3 @@ -71,7 +71,7 @@ On some systems, may be implemented using .BR alarm (2) and -.BR SIGALRM +.B SIGALRM (POSIX.1 permits this); mixing calls to .BR alarm (2) diff --git a/man3/statvfs.3 b/man3/statvfs.3 index f379894f2..2082b7901 100644 --- a/man3/statvfs.3 +++ b/man3/statvfs.3 @@ -223,13 +223,13 @@ In glibc versions before 2.13, .\" glibc commit 3cdaa6adb113a088fdfb87aa6d7747557eccc58d .BR statvfs () populated the bits of the -.IR f_flag +.I f_flag field by scanning the mount options shown in .IR /proc/mounts . However, starting with Linux 2.6.36, the underlying .BR statfs (2) system call provides the necessary information via the -.IR f_flags +.I f_flags field, and since glibc version 2.13, the .BR statvfs () function will use information from that field rather than scanning diff --git a/man3/stdarg.3 b/man3/stdarg.3 index 951836cbb..c87b1d8a3 100644 --- a/man3/stdarg.3 +++ b/man3/stdarg.3 @@ -162,7 +162,7 @@ to The behavior is as if .BR va_start () were applied to -.IR dest +.I dest with the same .I last argument, followed by the same number of diff --git a/man3/strcasecmp.3 b/man3/strcasecmp.3 index 642de4f98..f6eb38c52 100644 --- a/man3/strcasecmp.3 +++ b/man3/strcasecmp.3 @@ -59,7 +59,7 @@ function is similar, except that it compares no more than .I n bytes of -.IR s1 +.I s1 and .IR s2 . .SH RETURN VALUE diff --git a/man3/strcat.3 b/man3/strcat.3 index 6b0edf0a9..621306849 100644 --- a/man3/strcat.3 +++ b/man3/strcat.3 @@ -82,7 +82,7 @@ the resulting string in is always null-terminated. .PP If -.IR src +.I src contains .I n or more bytes, @@ -152,12 +152,12 @@ This function appends the null-terminated string to the string .IR dest , copying at most -.IR "size\-strlen(dest)\-1" +.I size\-strlen(dest)\-1 from .IR src , and adds a terminating null byte to the result, .I unless -.IR size +.I size is less than .IR strlen(dest) . This function fixes the buffer overrun problem of @@ -177,7 +177,7 @@ either check the arguments before the call, or test the function return value. is not present in glibc and is not standardized by POSIX, .\" https://lwn.net/Articles/506530/ but is available on Linux via the -.IR libbsd +.I libbsd library. .\" .SH EXAMPLE diff --git a/man3/strcmp.3 b/man3/strcmp.3 index 5f5b84f5d..9ff62e1d9 100644 --- a/man3/strcmp.3 +++ b/man3/strcmp.3 @@ -60,7 +60,7 @@ The .BR strncmp () function is similar, except it compares only the first (at most) -.IR n +.I n bytes of .I s1 and diff --git a/man3/strcpy.3 b/man3/strcpy.3 index f80b5fcf5..307a7d832 100644 --- a/man3/strcpy.3 +++ b/man3/strcpy.3 @@ -54,7 +54,7 @@ to the buffer pointed to by The strings may not overlap, and the destination string .I dest must be large enough to receive the copy. -.IR "Beware of buffer overruns!" +.I Beware of buffer overruns! (See BUGS.) .PP The @@ -217,7 +217,7 @@ or test the function return value. is not present in glibc and is not standardized by POSIX, .\" https://lwn.net/Articles/506530/ but is available on Linux via the -.IR libbsd +.I libbsd library. .SH BUGS If the destination string of a diff --git a/man3/strerror.3 b/man3/strerror.3 index 39de2c499..a4b69e2aa 100644 --- a/man3/strerror.3 +++ b/man3/strerror.3 @@ -155,7 +155,7 @@ The behavior of is undefined if .I locale is the special locale object -.BR LC_GLOBAL_LOCALE +.B LC_GLOBAL_LOCALE or is not a valid locale object handle. .SH RETURN VALUE The diff --git a/man3/strfmon.3 b/man3/strfmon.3 index a0f475491..b60b96e3d 100644 --- a/man3/strfmon.3 +++ b/man3/strfmon.3 @@ -58,7 +58,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. diff --git a/man3/strfromd.3 b/man3/strfromd.3 index 013ac3411..6d798659b 100644 --- a/man3/strfromd.3 +++ b/man3/strfromd.3 @@ -64,7 +64,7 @@ These functions convert a floating-point value, into a string of characters, .IR str , with a configurable -.IR format +.I format string. At most .I n @@ -128,7 +128,7 @@ infinity values: If .I fp is a NaN, +NaN, or -NaN, and -.BR f +.B f (or .BR a , .BR e , diff --git a/man3/strftime.3 b/man3/strftime.3 index 942550797..fb274515e 100644 --- a/man3/strftime.3 +++ b/man3/strftime.3 @@ -288,7 +288,7 @@ See also and .BR %W . (Calculated from -.IR tm_yday +.I tm_yday and .IR tm_wday .) .TP @@ -318,7 +318,7 @@ See also The week number of the current year as a decimal number, range 00 to 53, starting with the first Monday as the first day of week 01. (Calculated from -.IR tm_yday +.I tm_yday and .IR tm_wday .) .TP @@ -472,7 +472,7 @@ included a double leap second .BR %G , .BR %g , and -.BR %V +.B %V yield values calculated from the week-based year defined by the ISO\ 8601 standard. In this system, weeks start on a Monday, and are numbered from 01, @@ -584,17 +584,17 @@ my_strftime(char *s, size_t max, const char *fmt, Nowadays, .BR gcc (1) provides the -.IR \-Wno\-format\-y2k +.I \-Wno\-format\-y2k option to prevent the warning, so that the above workaround is no longer required. .SH EXAMPLE -.BR "RFC\ 2822-compliant date format" +.B RFC\ 2822-compliant date format (with an English locale for %a and %b) .PP .in +2n "%a,\ %d\ %b\ %Y\ %T\ %z" .PP -.BR "RFC\ 822-compliant date format" +.B RFC\ 822-compliant date format (with an English locale for %a and %b) .PP .in +2n diff --git a/man3/strptime.3 b/man3/strptime.3 index 6a82b04f4..b371393f6 100644 --- a/man3/strptime.3 +++ b/man3/strptime.3 @@ -55,7 +55,7 @@ using the format specified by The broken-down time structure .I tm is defined in -.IR <time.h> +.I <time.h> as follows: .PP .in +4n diff --git a/man3/strtod.3 b/man3/strtod.3 index d3b6de005..deb04f4c2 100644 --- a/man3/strtod.3 +++ b/man3/strtod.3 @@ -117,7 +117,7 @@ A is "NAN" (disregarding case) optionally followed by a string, .IR (n-char-sequence) , where -.IR n-char-sequence +.I n-char-sequence specifies in an implementation-dependent way the type of NAN (see NOTES). .SH RETURN VALUE @@ -184,7 +184,7 @@ and then determine if an error occurred by checking whether has a nonzero value after the call. .PP In the glibc implementation, the -.IR n-char-sequence +.I n-char-sequence that optionally follows "NAN" is interpreted as an integer number (with an optional '0' or '0x' prefix to select base 8 or 16) diff --git a/man3/strtok.3 b/man3/strtok.3 index 2e8192f99..efa5dabc8 100644 --- a/man3/strtok.3 +++ b/man3/strtok.3 @@ -136,7 +136,7 @@ function is a reentrant version The .I saveptr argument is a pointer to a -.IR "char\ *" +.I char\ * variable that is used internally by .BR strtok_r () in order to maintain context between successive calls that parse the diff --git a/man3/strtol.3 b/man3/strtol.3 index 8131a6860..10d4d526b 100644 --- a/man3/strtol.3 +++ b/man3/strtol.3 @@ -150,7 +150,7 @@ contains an unsupported value. The resulting value was out of range. .PP The implementation may also set -.IR errno +.I errno to .B EINVAL in case diff --git a/man3/strtoul.3 b/man3/strtoul.3 index 1e488c02d..af9cde280 100644 --- a/man3/strtoul.3 +++ b/man3/strtoul.3 @@ -154,7 +154,7 @@ contains an unsupported value. The resulting value was out of range. .PP The implementation may also set -.IR errno +.I errno to .B EINVAL in case diff --git a/man3/syslog.3 b/man3/syslog.3 index 94272c7a9..e02c27b5f 100644 --- a/man3/syslog.3 +++ b/man3/syslog.3 @@ -119,7 +119,7 @@ then the default value set by is used, or, if there was no preceding .BR openlog () call, a default of -.BR LOG_USER +.B LOG_USER is employed. .PP The remaining arguments are a diff --git a/man3/system.3 b/man3/system.3 index 66a3ced18..0fd416fc7 100644 --- a/man3/system.3 +++ b/man3/system.3 @@ -219,7 +219,7 @@ from a privileged program because strange values for some environment variables might be used to subvert system integrity. For example, -.BR PATH +.B PATH could be manipulated so that an arbitrary program is executed with privilege. Use the -- 2.20.1