From c9942389360ee3142dfdcd4129cea83d0145631e Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Fri, 7 Jun 2013 18:00:11 +0200 Subject: [PATCH] ioctl_list.2, sched_yield.2, vm86.2, backtrace.3, catopen.3, daemon.3, dl_iterate_phdr.3, fnmatch.3, getfsent.3, glob.3, grantpt.3, infnan.3, putgrent.3, setaliasent.3, shm_open.3, stdin.3, ttyS.4: Convert inline formatting (\fX...\fP) to dot-directive formatting Signed-off-by: Michael Kerrisk --- man2/ioctl_list.2 | 3 ++- man2/sched_yield.2 | 3 ++- man2/vm86.2 | 4 +++- man3/backtrace.3 | 4 +++- man3/catopen.3 | 3 ++- man3/daemon.3 | 3 ++- man3/dl_iterate_phdr.3 | 9 ++++----- man3/fnmatch.3 | 3 ++- man3/getfsent.3 | 14 ++++++++++---- man3/glob.3 | 7 +++++-- man3/grantpt.3 | 3 ++- man3/infnan.3 | 6 +++++- man3/putgrent.3 | 8 ++++++-- man3/setaliasent.3 | 3 ++- man3/shm_open.3 | 4 +++- man3/stdin.3 | 2 +- man4/ttyS.4 | 3 ++- 17 files changed, 56 insertions(+), 26 deletions(-) diff --git a/man2/ioctl_list.2 b/man2/ioctl_list.2 index bab8579af..acf73cd40 100644 --- a/man2/ioctl_list.2 +++ b/man2/ioctl_list.2 @@ -85,7 +85,8 @@ followed by an 8-bit type (collecting the ioctls in groups for a common purpose or a common driver), and an 8-bit serial number. .LP -The macros describing this structure live in \fI\fP +The macros describing this structure live in +.I and are .B _IO(type,nr) and diff --git a/man2/sched_yield.2 b/man2/sched_yield.2 index 77c395bb0..89cf79c90 100644 --- a/man2/sched_yield.2 +++ b/man2/sched_yield.2 @@ -61,7 +61,8 @@ POSIX systems on which .BR sched_yield () is available define .B _POSIX_PRIORITY_SCHEDULING -in \fI\fP. +in +.IR . Strategic calls to .BR sched_yield () diff --git a/man2/vm86.2 b/man2/vm86.2 index ce8177c04..b52b542f4 100644 --- a/man2/vm86.2 +++ b/man2/vm86.2 @@ -41,7 +41,9 @@ In Linux 2.1.15 and 2.0.28 it was renamed to and a new .BR vm86 () was introduced. -The definition of \fIstruct vm86_struct\fP was changed +The definition of +.IR "struct vm86_struct" +was changed in 1.1.8 and 1.1.9. .LP These calls cause the process to enter VM86 mode (virtual-8086 in Intel diff --git a/man3/backtrace.3 b/man3/backtrace.3 index 85ce885bb..1b21794c4 100644 --- a/man3/backtrace.3 +++ b/man3/backtrace.3 @@ -56,7 +56,9 @@ A backtrace is the series of currently active function calls for the program. Each item in the array pointed to by .I buffer -is of type \fIvoid *\fP, and is the return address from +is of type +.IR "void\ *" , +and is the return address from the corresponding stack frame. The .I size diff --git a/man3/catopen.3 b/man3/catopen.3 index 62d292985..1563e5dc3 100644 --- a/man3/catopen.3 +++ b/man3/catopen.3 @@ -115,7 +115,8 @@ The function returns a message catalog descriptor of type .I nl_catd on success. -On failure, it returns \fI(nl_catd)\ \-1\fP +On failure, it returns +.IR "(nl_catd)\ \-1" and sets .I errno to indicate the error. diff --git a/man3/daemon.3 b/man3/daemon.3 index 0fe77e396..9c8215b64 100644 --- a/man3/daemon.3 +++ b/man3/daemon.3 @@ -67,7 +67,8 @@ If is zero, .BR daemon () redirects standard input, standard output and standard error -to \fI/dev/null\fP; +to +.IR /dev/null ; otherwise, no changes are made to these file descriptors. .SH RETURN VALUE (This function forks, and if the diff --git a/man3/dl_iterate_phdr.3 b/man3/dl_iterate_phdr.3 index 316d5e8b7..d57bf6626 100644 --- a/man3/dl_iterate_phdr.3 +++ b/man3/dl_iterate_phdr.3 @@ -30,11 +30,10 @@ dl_iterate_phdr \- walk through list of shared objects .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .B #include -\fBint dl_iterate_phdr(\fP - \fBint (*\fPcallback\fB) \ -(struct dl_phdr_info *\fPinfo\fB,\fP - \fBsize_t\fP size\fB, void *\fPdata\fB),\fP - \fBvoid *\fPdata\fB);\fP +.BI "int dl_iterate_phdr(" +.BI " int (*" callback ") (struct dl_phdr_info *" info , +.BI " size_t " size ", void *" data , +.BI " void *" data ; .fi .SH DESCRIPTION The diff --git a/man3/fnmatch.3 b/man3/fnmatch.3 index 508bec664..b743d5dc0 100644 --- a/man3/fnmatch.3 +++ b/man3/fnmatch.3 @@ -72,7 +72,8 @@ or if both is set and the period immediately follows a slash. .TP .B FNM_FILE_NAME -This is a GNU synonym for \fBFNM_PATHNAME\fR. +This is a GNU synonym for +.BR FNM_PATHNAME . .TP .B FNM_LEADING_DIR If this flag (a GNU extension) is set, the pattern is considered to be diff --git a/man3/getfsent.3 b/man3/getfsent.3 index cb3ac4078..00f895761 100644 --- a/man3/getfsent.3 +++ b/man3/getfsent.3 @@ -42,7 +42,9 @@ getfsent, getfsspec, getfsfile, setfsent, endfsent \- handle fstab entries .SH DESCRIPTION These functions read from the file .IR /etc/fstab . -The \fIstruct fstab\fP is defined by: +The +.IR "struct fstab" +is defined by: .LP .in +4n .nf @@ -100,7 +102,9 @@ Upon success, the functions .BR getfsfile (), and .BR getfsspec () -return a pointer to a \fIstruct fstab\fP, while +return a pointer to a +.IR "struct fstab" , +while .BR setfsent () returns 1. Upon failure or end-of-file, these functions return NULL and 0, respectively. @@ -114,8 +118,10 @@ Several operating systems have them, e.g., *BSD, SunOS, Digital UNIX, AIX (which also has a .BR getfstype ()). HP-UX has functions of the same names, -that however use a \fIstruct checklist\fP -instead of a \fIstruct fstab\fP, +that however use a +.IR "struct checklist" +instead of a +.IR "struct fstab" , and calls these functions obsolete, superseded by .BR getmntent (3). .SH NOTES diff --git a/man3/glob.3 b/man3/glob.3 index 66935b2c5..e4bf7b682 100644 --- a/man3/glob.3 +++ b/man3/glob.3 @@ -159,7 +159,8 @@ functions. .B GLOB_BRACE Expand .BR csh (1) -style brace expressions of the form \fB{a,b}\fR. +style brace expressions of the form +.BR {a,b} . Brace expressions can be nested. Thus, for example, specifying the pattern "{foo/{,cat,dog},bar}" would return the same results as four separate @@ -253,7 +254,9 @@ on the second and later invocations. .PP As a GNU extension, .I pglob\->gl_flags -is set to the flags specified, \fBor\fRed with +is set to the flags specified, +.BR or ed +with .B GLOB_MAGCHAR if any metacharacters were found. .SH RETURN VALUE diff --git a/man3/grantpt.3 b/man3/grantpt.3 index 5870df1a3..7cc0de02f 100644 --- a/man3/grantpt.3 +++ b/man3/grantpt.3 @@ -20,7 +20,8 @@ function changes the mode and owner of the slave pseudoterminal device corresponding to the master pseudoterminal referred to by .IR fd . The user ID of the slave is set to the real UID of the calling process. -The group ID is set to an unspecified value (e.g., \fItty\fP). +The group ID is set to an unspecified value (e.g., +.IR tty ). The mode of the slave is set to 0620 (crw\-\-w\-\-\-\-). .PP The behavior of diff --git a/man3/infnan.3 b/man3/infnan.3 index 7e88689fc..f6373a4ca 100644 --- a/man3/infnan.3 +++ b/man3/infnan.3 @@ -64,7 +64,11 @@ is returned. .PP If .I error -is \-\fBERANGE\fP (\-Infinity), \-\fBHUGE_VAL\fP is returned. +is +.RB \- ERANGE +(\-Infinity), +.RB \- HUGE_VAL +is returned. .PP If .I error diff --git a/man3/putgrent.3 b/man3/putgrent.3 index 84ac732a1..0d59c825a 100644 --- a/man3/putgrent.3 +++ b/man3/putgrent.3 @@ -18,12 +18,16 @@ The .BR putgrent () function is the counterpart for .BR fgetgrent (3). -The function writes the content of the provided \fIstruct group\fP into the +The function writes the content of the provided +.IR "struct group" +into the file pointed to by .IR fp . The list of group members must be NULL-terminated or NULL-initialized. .sp -The \fIstruct group\fP is defined as follows: +The +.IR "struct group" +is defined as follows: .sp .in +4n .nf diff --git a/man3/setaliasent.3 b/man3/setaliasent.3 index 0bf148b52..d78fd437e 100644 --- a/man3/setaliasent.3 +++ b/man3/setaliasent.3 @@ -31,7 +31,8 @@ getaliasbyname, getaliasbyname_r \- read an alias entry .SH DESCRIPTION One of the databases available with the Name Service Switch (NSS) is the aliases database, that contains mail aliases. -(To find out which databases are supported, try \fIgetent \-\-help\fP.) +(To find out which databases are supported, try +.IR "getent \-\-help" .) Six functions are provided to access the aliases database. .PP The diff --git a/man3/shm_open.3 b/man3/shm_open.3 index 90991a439..c7c71458a 100644 --- a/man3/shm_open.3 +++ b/man3/shm_open.3 @@ -83,7 +83,9 @@ and any of the other flags listed here: Open the object for read access. A shared memory object opened in this way can be .BR mmap (2)ed -only for read (\fBPROT_READ\fP) access. +only for read +.RB ( PROT_READ ) +access. .TP .B O_RDWR Open the object for read-write access. diff --git a/man3/stdin.3 b/man3/stdin.3 index 448323f4f..226ef0561 100644 --- a/man3/stdin.3 +++ b/man3/stdin.3 @@ -74,7 +74,7 @@ The preprocessor symbols and .B STDERR_FILENO are defined with these values in -\fI\fP. +.IR . (Applying .BR freopen (3) to one of these streams can change the file descriptor number diff --git a/man4/ttyS.4 b/man4/ttyS.4 index a4ca20795..939bada6c 100644 --- a/man4/ttyS.4 +++ b/man4/ttyS.4 @@ -27,7 +27,8 @@ .SH NAME ttyS \- serial terminal lines .SH DESCRIPTION -\fBttyS[0\-3]\fP are character devices for the serial terminal lines. +.B ttyS[0\-3] +are character devices for the serial terminal lines. .LP They are typically created by: .RS