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 <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2013-06-07 18:00:11 +02:00
parent 40aa0db03c
commit c994238936
17 changed files with 56 additions and 26 deletions

View File

@ -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 for a common purpose or a common driver), and an 8-bit
serial number. serial number.
.LP .LP
The macros describing this structure live in \fI<asm/ioctl.h>\fP The macros describing this structure live in
.I <asm/ioctl.h>
and are and are
.B _IO(type,nr) .B _IO(type,nr)
and and

View File

@ -61,7 +61,8 @@ POSIX systems on which
.BR sched_yield () .BR sched_yield ()
is available define is available define
.B _POSIX_PRIORITY_SCHEDULING .B _POSIX_PRIORITY_SCHEDULING
in \fI<unistd.h>\fP. in
.IR <unistd.h> .
Strategic calls to Strategic calls to
.BR sched_yield () .BR sched_yield ()

View File

@ -41,7 +41,9 @@ In Linux 2.1.15 and 2.0.28 it was renamed to
and a new and a new
.BR vm86 () .BR vm86 ()
was introduced. 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. in 1.1.8 and 1.1.9.
.LP .LP
These calls cause the process to enter VM86 mode (virtual-8086 in Intel These calls cause the process to enter VM86 mode (virtual-8086 in Intel

View File

@ -56,7 +56,9 @@ A backtrace is the series of currently active function calls for
the program. the program.
Each item in the array pointed to by Each item in the array pointed to by
.I buffer .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 corresponding stack frame.
The The
.I size .I size

View File

@ -115,7 +115,8 @@ The function
returns a message catalog descriptor of type returns a message catalog descriptor of type
.I nl_catd .I nl_catd
on success. on success.
On failure, it returns \fI(nl_catd)\ \-1\fP On failure, it returns
.IR "(nl_catd)\ \-1"
and sets and sets
.I errno .I errno
to indicate the error. to indicate the error.

View File

@ -67,7 +67,8 @@ If
is zero, is zero,
.BR daemon () .BR daemon ()
redirects standard input, standard output and standard error 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. otherwise, no changes are made to these file descriptors.
.SH RETURN VALUE .SH RETURN VALUE
(This function forks, and if the (This function forks, and if the

View File

@ -30,11 +30,10 @@ dl_iterate_phdr \- walk through list of shared objects
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <link.h> .B #include <link.h>
\fBint dl_iterate_phdr(\fP .BI "int dl_iterate_phdr("
\fBint (*\fPcallback\fB) \ .BI " int (*" callback ") (struct dl_phdr_info *" info ,
(struct dl_phdr_info *\fPinfo\fB,\fP .BI " size_t " size ", void *" data ,
\fBsize_t\fP size\fB, void *\fPdata\fB),\fP .BI " void *" data ;
\fBvoid *\fPdata\fB);\fP
.fi .fi
.SH DESCRIPTION .SH DESCRIPTION
The The

View File

@ -72,7 +72,8 @@ or if both
is set and the period immediately follows a slash. is set and the period immediately follows a slash.
.TP .TP
.B FNM_FILE_NAME .B FNM_FILE_NAME
This is a GNU synonym for \fBFNM_PATHNAME\fR. This is a GNU synonym for
.BR FNM_PATHNAME .
.TP .TP
.B FNM_LEADING_DIR .B FNM_LEADING_DIR
If this flag (a GNU extension) is set, the pattern is considered to be If this flag (a GNU extension) is set, the pattern is considered to be

View File

@ -42,7 +42,9 @@ getfsent, getfsspec, getfsfile, setfsent, endfsent \- handle fstab entries
.SH DESCRIPTION .SH DESCRIPTION
These functions read from the file These functions read from the file
.IR /etc/fstab . .IR /etc/fstab .
The \fIstruct fstab\fP is defined by: The
.IR "struct fstab"
is defined by:
.LP .LP
.in +4n .in +4n
.nf .nf
@ -100,7 +102,9 @@ Upon success, the functions
.BR getfsfile (), .BR getfsfile (),
and and
.BR getfsspec () .BR getfsspec ()
return a pointer to a \fIstruct fstab\fP, while return a pointer to a
.IR "struct fstab" ,
while
.BR setfsent () .BR setfsent ()
returns 1. returns 1.
Upon failure or end-of-file, these functions return NULL and 0, respectively. 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 e.g., *BSD, SunOS, Digital UNIX, AIX (which also has a
.BR getfstype ()). .BR getfstype ()).
HP-UX has functions of the same names, HP-UX has functions of the same names,
that however use a \fIstruct checklist\fP that however use a
instead of a \fIstruct fstab\fP, .IR "struct checklist"
instead of a
.IR "struct fstab" ,
and calls these functions obsolete, superseded by and calls these functions obsolete, superseded by
.BR getmntent (3). .BR getmntent (3).
.SH NOTES .SH NOTES

View File

@ -159,7 +159,8 @@ functions.
.B GLOB_BRACE .B GLOB_BRACE
Expand Expand
.BR csh (1) .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. Brace expressions can be nested.
Thus, for example, specifying the pattern Thus, for example, specifying the pattern
"{foo/{,cat,dog},bar}" would return the same results as four separate "{foo/{,cat,dog},bar}" would return the same results as four separate
@ -253,7 +254,9 @@ on the second and later invocations.
.PP .PP
As a GNU extension, As a GNU extension,
.I pglob\->gl_flags .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 .B GLOB_MAGCHAR
if any metacharacters were found. if any metacharacters were found.
.SH RETURN VALUE .SH RETURN VALUE

View File

@ -20,7 +20,8 @@ function changes the mode and owner of the slave pseudoterminal device
corresponding to the master pseudoterminal referred to by corresponding to the master pseudoterminal referred to by
.IR fd . .IR fd .
The user ID of the slave is set to the real UID of the calling process. 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\-\-\-\-). The mode of the slave is set to 0620 (crw\-\-w\-\-\-\-).
.PP .PP
The behavior of The behavior of

View File

@ -64,7 +64,11 @@ is returned.
.PP .PP
If If
.I error .I error
is \-\fBERANGE\fP (\-Infinity), \-\fBHUGE_VAL\fP is returned. is
.RB \- ERANGE
(\-Infinity),
.RB \- HUGE_VAL
is returned.
.PP .PP
If If
.I error .I error

View File

@ -18,12 +18,16 @@ The
.BR putgrent () .BR putgrent ()
function is the counterpart for function is the counterpart for
.BR fgetgrent (3). .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 file pointed to by
.IR fp . .IR fp .
The list of group members must be NULL-terminated or NULL-initialized. The list of group members must be NULL-terminated or NULL-initialized.
.sp .sp
The \fIstruct group\fP is defined as follows: The
.IR "struct group"
is defined as follows:
.sp .sp
.in +4n .in +4n
.nf .nf

View File

@ -31,7 +31,8 @@ getaliasbyname, getaliasbyname_r \- read an alias entry
.SH DESCRIPTION .SH DESCRIPTION
One of the databases available with the Name Service Switch (NSS) One of the databases available with the Name Service Switch (NSS)
is the aliases database, that contains mail aliases. 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. Six functions are provided to access the aliases database.
.PP .PP
The The

View File

@ -83,7 +83,9 @@ and any of the other flags listed here:
Open the object for read access. Open the object for read access.
A shared memory object opened in this way can be A shared memory object opened in this way can be
.BR mmap (2)ed .BR mmap (2)ed
only for read (\fBPROT_READ\fP) access. only for read
.RB ( PROT_READ )
access.
.TP .TP
.B O_RDWR .B O_RDWR
Open the object for read-write access. Open the object for read-write access.

View File

@ -74,7 +74,7 @@ The preprocessor symbols
and and
.B STDERR_FILENO .B STDERR_FILENO
are defined with these values in are defined with these values in
\fI<unistd.h>\fP. .IR <unistd.h> .
(Applying (Applying
.BR freopen (3) .BR freopen (3)
to one of these streams can change the file descriptor number to one of these streams can change the file descriptor number

View File

@ -27,7 +27,8 @@
.SH NAME .SH NAME
ttyS \- serial terminal lines ttyS \- serial terminal lines
.SH DESCRIPTION .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 .LP
They are typically created by: They are typically created by:
.RS .RS