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
serial number.
.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
.B _IO(type,nr)
and

View File

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

View File

@ -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

View File

@ -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.

View File

@ -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

View File

@ -30,11 +30,10 @@ dl_iterate_phdr \- walk through list of shared objects
.BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
.B #include <link.h>
\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

View File

@ -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

View File

@ -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

View File

@ -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

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
.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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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.

View File

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

View File

@ -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