Use a single-font-style macro (".B", ".I") for a single argument. Remove a single line ".BI" in file "fseeko.3". The output from "nroff" and "groff" is unchanged. Signed-off-by: Bjarni Ingi Gislason <bjarniig@xxxxxxxxx> --- man3/end.3 | 2 +- man3/erfc.3 | 2 +- man3/errno.3 | 4 +- man3/euidaccess.3 | 2 +- man3/exec.3 | 4 +- man3/expm1.3 | 2 +- man3/fenv.3 | 4 +- man3/fexecve.3 | 2 +- man3/floor.3 | 4 +- man3/fmemopen.3 | 6 +-- man3/fmod.3 | 4 +- man3/fopen.3 | 2 +- man3/fopencookie.3 | 2 +- man3/fpathconf.3 | 2 +- man3/fseeko.3 | 5 +-- man3/fts.3 | 98 +++++++++++++++++++++++----------------------- man3/ftw.3 | 4 +- 17 files changed, 74 insertions(+), 75 deletions(-) diff --git a/man3/end.3 b/man3/end.3 index 83677bec2..fbf586a64 100644 --- a/man3/end.3 +++ b/man3/end.3 @@ -64,7 +64,7 @@ These symbols are also defined for programs compiled on Linux. .PP At the start of program execution, the program break will be somewhere near -.IR &end +.I &end (perhaps at the start of the following page). However, the break will change as memory is allocated via .BR brk (2) diff --git a/man3/erfc.3 b/man3/erfc.3 index 2986ac793..33415ee14 100644 --- a/man3/erfc.3 +++ b/man3/erfc.3 @@ -142,7 +142,7 @@ and .BR erfcl () functions are provided to avoid the loss accuracy that would occur for the calculation 1-erf(x) for large values of -.IR x +.I x (for which the value of erf(x) approaches 1). .SH SEE ALSO .BR cerf (3), diff --git a/man3/errno.3 b/man3/errno.3 index 301abd9cd..19c62e7bb 100644 --- a/man3/errno.3 +++ b/man3/errno.3 @@ -352,7 +352,7 @@ Wrong medium type. .B EMFILE Too many open files (POSIX.1-2001). Commonly caused by exceeding the -.BR RLIMIT_NOFILE +.B RLIMIT_NOFILE resource limit described in .BR getrlimit (2). .TP @@ -382,7 +382,7 @@ Network unreachable (POSIX.1-2001). .B ENFILE Too many open files in system (POSIX.1-2001). On Linux, this is probably a result of encountering the -.IR /proc/sys/fs/file-max +.I /proc/sys/fs/file-max limit (see .BR proc (5)). .TP diff --git a/man3/euidaccess.3 b/man3/euidaccess.3 index 24e66ec1f..72a408ca1 100644 --- a/man3/euidaccess.3 +++ b/man3/euidaccess.3 @@ -101,7 +101,7 @@ This function always dereferences symbolic links. If you need to check the permissions on a symbolic link, use .BR faccessat (2) with the flags -.BR AT_EACCESS +.B AT_EACCESS and .BR AT_SYMLINK_NOFOLLOW . .SH SEE ALSO diff --git a/man3/exec.3 b/man3/exec.3 index 0d531e921..c7547db5b 100644 --- a/man3/exec.3 +++ b/man3/exec.3 @@ -147,7 +147,7 @@ specified in the environment variable. If this variable isn't defined, the path list defaults to a list that includes the directories returned by -.IR confstr(_CS_PATH) +.I confstr(_CS_PATH) (which typically returns the value "/bin:/usr/bin") and possibly also the current working directory; see NOTES for further details. @@ -225,7 +225,7 @@ shows some variation across systems. It generally includes .I /bin and -.IR /usr/bin +.I /usr/bin (in that order) and may also include the current working directory. On some other systems, the current working is included after .I /bin diff --git a/man3/expm1.3 b/man3/expm1.3 index a1fe0f7b2..14b75d86c 100644 --- a/man3/expm1.3 +++ b/man3/expm1.3 @@ -118,7 +118,7 @@ The following errors can occur: Range error, overflow .I errno is set to -.BR ERANGE +.B ERANGE (but see BUGS). An overflow floating-point exception .RB ( FE_OVERFLOW ) diff --git a/man3/fenv.3 b/man3/fenv.3 index ed3b2cc4e..1461fe202 100644 --- a/man3/fenv.3 +++ b/man3/fenv.3 @@ -158,7 +158,7 @@ Each of the macros .BR FE_UPWARD , .BR FE_DOWNWARD , and -.BR FE_TOWARDZERO +.B FE_TOWARDZERO is defined when the implementation supports getting and setting the corresponding rounding direction. .PP @@ -193,7 +193,7 @@ Rounding is toward negative infinity. Other values represent machine-dependent, nonstandard rounding modes. .PP The value of -.BR FLT_ROUNDS +.B FLT_ROUNDS should reflect the current rounding mode as set by .BR fesetround () (but see BUGS). diff --git a/man3/fexecve.3 b/man3/fexecve.3 index 25cf049dc..c0c659c88 100644 --- a/man3/fexecve.3 +++ b/man3/fexecve.3 @@ -126,7 +126,7 @@ if the underlying kernel supports the system call, then .BR fexecve () is implemented using that system call, with the benefit that -.IR /proc +.I /proc does not need to be mounted. .PP The idea behind diff --git a/man3/floor.3 b/man3/floor.3 index 6c6ff3d87..840d26006 100644 --- a/man3/floor.3 +++ b/man3/floor.3 @@ -57,9 +57,9 @@ These functions return the largest integral value that is not greater than .IR x . .PP For example, -.IR floor(0.5) +.I floor(0.5) is 0.0, and -.IR floor(\-0.5) +.I floor(\-0.5) is \-1.0. .SH RETURN VALUE These functions return the floor of diff --git a/man3/fmemopen.3 b/man3/fmemopen.3 index e77d9b530..9f4673a7b 100644 --- a/man3/fmemopen.3 +++ b/man3/fmemopen.3 @@ -168,7 +168,7 @@ This function is not specified in POSIX.1-2001, and is not widely available on other systems. .PP POSIX.1-2008 specifies that \(aqb\(aq in -.IR mode +.I mode shall be ignored. However, Technical Corrigendum 1 .\" http://austingroupbugs.net/view.php?id=396 @@ -208,7 +208,7 @@ character in Thus, for example, "wb+" has the desired effect, but "w+b" does not. This is inconsistent with the treatment of .\" http://sourceware.org/bugzilla/show_bug.cgi?id=12836 -.IR mode +.I mode by .BR fopen (3). .PP @@ -267,7 +267,7 @@ was performed on a stream created by the .I offset was -.IR subtracted +.I subtracted from the end-of-stream position, instead of being added. This bug is fixed in glibc 2.22. .PP diff --git a/man3/fmod.3 b/man3/fmod.3 index 2e89f8cc1..91f0aabae 100644 --- a/man3/fmod.3 +++ b/man3/fmod.3 @@ -66,7 +66,7 @@ These functions compute the floating-point remainder of dividing by .IR y . The return value is -.IR x +.I x \- .I n * @@ -122,7 +122,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/fopen.3 b/man3/fopen.3 index a0f564c39..b23d7c046 100644 --- a/man3/fopen.3 +++ b/man3/fopen.3 @@ -386,7 +386,7 @@ the stream is marked wide-oriented, and functions to convert to the coded character set are loaded. .SH BUGS When parsing for individual flag characters in -.IR mode +.I mode (i.e., the characters preceding the "ccs" specification), the glibc implementation of .\" FIXME . http://sourceware.org/bugzilla/show_bug.cgi?id=12685 diff --git a/man3/fopencookie.3 b/man3/fopencookie.3 index 40dee961d..04feb9c92 100644 --- a/man3/fopencookie.3 +++ b/man3/fopencookie.3 @@ -57,7 +57,7 @@ a structure that provides bookkeeping information (e.g., where to store data) used by the aforementioned hook functions. The standard I/O package knows nothing about the contents of this cookie (thus it is typed as -.IR "void\ *" +.I "void\ *" when passed to .BR fopencookie ()), but automatically supplies the cookie diff --git a/man3/fpathconf.3 b/man3/fpathconf.3 index 775219eae..cf4a7c79e 100644 --- a/man3/fpathconf.3 +++ b/man3/fpathconf.3 @@ -108,7 +108,7 @@ The corresponding macro is The maximum length of a filename in the directory .I path or -.IR fd +.I fd that the process is allowed to create. The corresponding macro is .BR _POSIX_NAME_MAX . diff --git a/man3/fseeko.3 b/man3/fseeko.3 index 15ce87f77..ec3ec8134 100644 --- a/man3/fseeko.3 +++ b/man3/fseeko.3 @@ -32,7 +32,6 @@ fseeko, ftello \- seek to or report file position .BI "int fseeko(FILE *" stream ", off_t " offset ", int " whence ); .PP .BI "off_t ftello(FILE *" stream ); -.BI .fi .PP .in -4n @@ -73,11 +72,11 @@ instead of .IR long . .PP On some architectures, both -.IR off_t +.I off_t and .I long are 32-bit types, but defining -.BR _FILE_OFFSET_BITS +.B _FILE_OFFSET_BITS with the value 64 (before including .I any header files) diff --git a/man3/fts.3 b/man3/fts.3 index e15f308eb..e73b419cc 100644 --- a/man3/fts.3 +++ b/man3/fts.3 @@ -143,7 +143,7 @@ typedef struct _ftsent { These fields are defined as follows: .\" .Bl -tag -width "fts_namelen" .TP 12 -.IR fts_info +.I fts_info One of the following values describing the returned .I FTSENT structure and @@ -156,10 +156,10 @@ of their descendants be visited. .\" .Bl -tag -width FTS_DEFAULT .RS 12 .TP 12 -.BR FTS_D +.B FTS_D A directory being visited in preorder. .TP -.BR FTS_DC +.B FTS_DC A directory that causes a cycle in the tree. (The .I fts_cycle @@ -167,7 +167,7 @@ field of the .I FTSENT structure will be filled in as well.) .TP -.BR FTS_DEFAULT +.B FTS_DEFAULT Any .I FTSENT structure that represents a file type not explicitly described @@ -175,13 +175,13 @@ by one of the other .I fts_info values. .TP -.BR FTS_DNR +.B FTS_DNR A directory which cannot be read. This is an error return, and the .I fts_errno field will be set to indicate what caused the error. .TP -.BR FTS_DOT +.B FTS_DOT A file named "." or @@ -191,7 +191,7 @@ which was not specified as a filename to (see .BR FTS_SEEDOT ). .TP -.BR FTS_DP +.B FTS_DP A directory being visited in postorder. The contents of the .I FTSENT @@ -201,15 +201,15 @@ it was returned in preorder, that is, with the field set to .BR FTS_D . .TP -.BR FTS_ERR +.B FTS_ERR This is an error return, and the .I fts_errno field will be set to indicate what caused the error. .TP -.BR FTS_F +.B FTS_F A regular file. .TP -.BR FTS_NS +.B FTS_NS A file for which no .BR stat (2) information was available. @@ -220,7 +220,7 @@ This is an error return, and the .I fts_errno field will be set to indicate what caused the error. .TP -.BR FTS_NSOK +.B FTS_NSOK A file for which no .BR stat (2) information was requested. @@ -228,10 +228,10 @@ The contents of the .I fts_statp field are undefined. .TP -.BR FTS_SL +.B FTS_SL A symbolic link. .TP -.BR FTS_SLNONE +.B FTS_SLNONE A symbolic link with a nonexistent target. The contents of the .I fts_statp @@ -240,29 +240,29 @@ itself. .\" .El .RE .TP -.IR fts_accpath +.I fts_accpath A path for accessing the file from the current directory. .TP -.IR fts_path +.I fts_path The path for the file relative to the root of the traversal. This path contains the path specified to .BR fts_open () as a prefix. .TP -.IR fts_pathlen +.I fts_pathlen The sum of the lengths of the strings referenced by -.IR fts_path +.I fts_path and .IR fts_name . .TP -.IR fts_name +.I fts_name The name of the file. .TP -.IR fts_namelen +.I fts_namelen The length of the string referenced by .IR fts_name . .TP -.IR fts_level +.I fts_level The depth of the traversal, numbered from \-1 to N, where this file was found. The @@ -273,7 +273,7 @@ of the traversal is numbered \-1, and the structure for the root itself is numbered 0. .TP -.IR fts_errno +.I fts_errno If .BR fts_children () or @@ -290,27 +290,27 @@ or the .I fts_errno field contains the error number (i.e., the -.IR errno +.I errno value) specifying the cause of the error. Otherwise, the contents of the .I fts_errno field are undefined. .TP -.IR fts_number +.I fts_number This field is provided for the use of the application program and is not modified by the fts functions. It is initialized to 0. .TP -.IR fts_pointer +.I fts_pointer This field is provided for the use of the application program and is not modified by the fts functions. It is initialized to NULL. .TP -.IR fts_parent +.I fts_parent A pointer to the .I FTSENT structure referencing the file in the hierarchy @@ -324,7 +324,7 @@ and .I fts_pointer fields are guaranteed to be initialized. .TP -.IR fts_link +.I fts_link Upon return from the .BR fts_children () function, the @@ -335,7 +335,7 @@ Otherwise, the contents of the .I fts_link field are undefined. .TP -.IR fts_cycle +.I fts_cycle If a directory causes a cycle in the hierarchy (see .BR FTS_DC ), either because @@ -351,7 +351,7 @@ Otherwise, the contents of the .I fts_cycle field are undefined. .TP -.IR fts_statp +.I fts_statp A pointer to .BR stat (2) information for the file. @@ -393,7 +393,7 @@ null pointer. .PP There are a number of options, at least one of which (either -.BR FTS_LOGICAL +.B FTS_LOGICAL or .BR FTS_PHYSICAL ) must be specified. @@ -401,13 +401,13 @@ The options are selected by ORing the following values: .\" .Bl -tag -width "FTS_PHYSICAL" .TP 14 -.BR FTS_COMFOLLOW +.B FTS_COMFOLLOW This option causes any symbolic link specified as a root path to be followed immediately whether or not -.BR FTS_LOGICAL +.B FTS_LOGICAL is also specified. .TP -.BR FTS_LOGICAL +.B FTS_LOGICAL This option causes the fts routines to return .I FTSENT @@ -418,31 +418,31 @@ If this option is set, the only symbolic links for which structures are returned to the application are those referencing nonexistent files. Either -.BR FTS_LOGICAL +.B FTS_LOGICAL or -.BR FTS_PHYSICAL +.B FTS_PHYSICAL .I must be provided to the .BR fts_open () function. .TP -.BR FTS_NOCHDIR +.B FTS_NOCHDIR As a performance optimization, the fts functions change directories as they walk the file hierarchy. This has the side-effect that an application cannot rely on being in any particular directory during the traversal. The -.BR FTS_NOCHDIR +.B FTS_NOCHDIR option turns off this optimization, and the fts functions will not change the current directory. Note that applications should not themselves change their current directory and try to access files unless -.BR FTS_NOCHDIR +.B FTS_NOCHDIR is specified and absolute pathnames were provided as arguments to .BR fts_open (). .TP -.BR FTS_NOSTAT +.B FTS_NOSTAT By default, returned .I FTSENT structures reference file characteristic information (the @@ -453,12 +453,12 @@ allowing the fts functions to set the .I fts_info field to -.BR FTS_NSOK +.B FTS_NSOK and leave the contents of the .I statp field undefined. .TP -.BR FTS_PHYSICAL +.B FTS_PHYSICAL This option causes the fts routines to return .I FTSENT @@ -469,15 +469,15 @@ If this option is set, structures for all symbolic links in the hierarchy are returned to the application. Either -.BR FTS_LOGICAL +.B FTS_LOGICAL or -.BR FTS_PHYSICAL +.B FTS_PHYSICAL .I must be provided to the .BR fts_open () function. .TP -.BR FTS_SEEDOT +.B FTS_SEEDOT By default, unless they are specified as path arguments to .BR fts_open (), any files named @@ -490,7 +490,7 @@ fts routines to return .I FTSENT structures for them. .TP -.BR FTS_XDEV +.B FTS_XDEV This option prevents fts from descending into directories that have a different device number than the file from which the descent began. @@ -520,7 +520,7 @@ be used in this comparison. If the .I fts_info field is set to -.BR FTS_NS +.B FTS_NS or .BR FTS_NSOK , the @@ -648,7 +648,7 @@ The argument is either zero or the following value: .\" .Bl -tag -width FTS_NAMEONLY .TP 13 -.BR FTS_NAMEONLY +.B FTS_NAMEONLY Only the names of the files are needed. The contents of all the fields in the returned linked list of structures are undefined with the exception of the @@ -675,7 +675,7 @@ The argument is either 0 (meaning "do nothing") or one of the following values: .\" .Bl -tag -width FTS_PHYSICAL .TP 13 -.BR FTS_AGAIN +.B FTS_AGAIN Revisit the file; any file type may be revisited. The next call to .BR fts_read () @@ -693,7 +693,7 @@ Normal use is for postorder directory visits, where it causes the directory to be revisited (in both preorder and postorder) as well as all of its descendants. .TP -.BR FTS_FOLLOW +.B FTS_FOLLOW The referenced file must be a symbolic link. If the referenced file is the one most recently returned by .BR fts_read (), @@ -725,7 +725,7 @@ If the target of the link is a directory, the preorder return, followed by the return of all of its descendants, followed by a postorder return, is done. .TP -.BR FTS_SKIP +.B FTS_SKIP No descendants of this file are visited. The file may be one of those most recently returned by either .BR fts_children () diff --git a/man3/ftw.3 b/man3/ftw.3 index d4dc41fb9..f024f550f 100644 --- a/man3/ftw.3 +++ b/man3/ftw.3 @@ -96,7 +96,7 @@ and is expressed either as a pathname relative to the calling process's current working directory at the time of the call to .BR nftw (), if -.IR dirpath +.I dirpath was expressed as a relative pathname, or as an absolute pathname, if .I dirpath @@ -324,7 +324,7 @@ The notable differences are as follows: .IP * 3 .BR ftw () has no -.IR flags +.I flags argument. It behaves the same as when .BR nftw () -- 2.20.1