[PATCH] man3/s*.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, 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



[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