Format include files consistently (".I <.*\.h>").

This commit is contained in:
Michael Kerrisk 2007-12-09 08:08:53 +00:00
parent 5ec8d26f78
commit a9a13a5057
14 changed files with 37 additions and 21 deletions

View File

@ -135,7 +135,9 @@ Insufficient memory to read from
.SH VERSIONS .SH VERSIONS
.BR sendfile () .BR sendfile ()
is a new feature in Linux 2.2. is a new feature in Linux 2.2.
The include file <sys/sendfile.h> is present since glibc 2.1. The include file
.I <sys/sendfile.h>
is present since glibc 2.1.
.SH "CONFORMING TO" .SH "CONFORMING TO"
Not specified in POSIX.1-2001, or other standards. Not specified in POSIX.1-2001, or other standards.

View File

@ -210,7 +210,7 @@ Solaris, Irix and POSIX have a system call
that returns a that returns a
.I "struct statvfs" .I "struct statvfs"
(defined in (defined in
.IR "<sys/statvfs.h>" ) .IR <sys/statvfs.h> )
containing an containing an
.I "unsigned long" .I "unsigned long"
.IR f_fsid . .IR f_fsid .
@ -219,7 +219,7 @@ Linux, SunOS, HP-UX, 4.4BSD have a system call
that returns a that returns a
.I "struct statfs" .I "struct statfs"
(defined in (defined in
.IR "<sys/vfs.h>" ) .IR <sys/vfs.h> )
containing a containing a
.I fsid_t .I fsid_t
.IR f_fsid , .IR f_fsid ,
@ -228,7 +228,7 @@ where
is defined as is defined as
.IR "struct { int val[2]; }" . .IR "struct { int val[2]; }" .
The same holds for FreeBSD, except that it uses the include file The same holds for FreeBSD, except that it uses the include file
.IR "<sys/mount.h>" . .IR <sys/mount.h> .
The general idea is that The general idea is that
.I f_fsid .I f_fsid

View File

@ -142,7 +142,9 @@ There is no GNU version of
.LP .LP
With glibc, one gets the POSIX version of With glibc, one gets the POSIX version of
.BR basename () .BR basename ()
when <libgen.h> is included, and the GNU version otherwise. when
.I <libgen.h>
is included, and the GNU version otherwise.
.SH BUGS .SH BUGS
In the glibc implementation of the POSIX versions of these functions In the glibc implementation of the POSIX versions of these functions
they modify their argument, and segfault when called with a static string they modify their argument, and segfault when called with a static string

View File

@ -101,7 +101,9 @@ flags are meaningful.
.PP .PP
The The
.I type .I type
argument is of type DBTYPE (as defined in the <db.h> include file) and argument is of type DBTYPE (as defined in the
.I <db.h>
include file) and
may be set to DB_BTREE, DB_HASH or DB_RECNO. may be set to DB_BTREE, DB_HASH or DB_RECNO.
.PP .PP
The The
@ -115,7 +117,9 @@ and the access method.
.PP .PP
.BR dbopen () .BR dbopen ()
returns a pointer to a DB structure on success and NULL on error. returns a pointer to a DB structure on success and NULL on error.
The DB structure is defined in the <db.h> include file, and contains at The DB structure is defined in the
.I <db.h>
include file, and contains at
least the following fields: least the following fields:
.sp .sp
.nf .nf

View File

@ -133,7 +133,9 @@ The structure \fIin_addr\fP as used in
.BR inet_lnaof () .BR inet_lnaof ()
and and
.BR inet_netof () .BR inet_netof ()
is defined in \fInetinet/in.h\fP as: is defined in
.I <netinet/in.h>
as:
.sp .sp
.RS .RS
.nf .nf

View File

@ -89,7 +89,7 @@ variable
.I errno .I errno
to a value describing what went wrong. to a value describing what went wrong.
(These values can be found in (These values can be found in
.IR "<errno.h>" .) .IR <errno.h> .)
Many library functions do likewise. Many library functions do likewise.
The function The function
.BR perror () .BR perror ()

View File

@ -62,7 +62,9 @@ one record.
.PP .PP
The recno access method specific data structure provided to The recno access method specific data structure provided to
.I dbopen .I dbopen
is defined in the <db.h> include file as follows: is defined in the
.I <db.h>
include file as follows:
.PP .PP
.nf .nf
typedef struct { typedef struct {
@ -166,7 +168,9 @@ The
.I data .I data
field of the key should be a pointer to a memory location of type field of the key should be a pointer to a memory location of type
.IR recno_t , .IR recno_t ,
as defined in the <db.h> include file. as defined in th
.I <db.h
include file.
This type is normally the largest unsigned integral type available to This type is normally the largest unsigned integral type available to
the implementation. the implementation.
The The

View File

@ -180,7 +180,7 @@ The
structure which is the type of structure which is the type of
.I pmatch .I pmatch
is defined in is defined in
.IR regex.h . .IR <regex.h> .
.RS .RS
.nf .nf

View File

@ -222,7 +222,7 @@ These macros are
.I not .I not
compatible with the historic macros they replace. compatible with the historic macros they replace.
A backward compatible version can be found in the include file A backward compatible version can be found in the include file
.IR varargs.h . .IR <varargs.h> .
.PP .PP
The historic setup is: The historic setup is:
.in +0.5i .in +0.5i

View File

@ -135,7 +135,7 @@ define
or or
.B _BSD_SOURCE .B _BSD_SOURCE
before including before including
.IR "<stdio.h>" . .IR <stdio.h> .
.SH BUGS .SH BUGS
Never use this function. Never use this function.
Use Use

View File

@ -111,7 +111,7 @@ user-defined command handled by the program running in the DSP56001.
.\" Fredrik Noring <noring@nocrew.org>, lars brinkhoff <lars@nocrew.org>, .\" Fredrik Noring <noring@nocrew.org>, lars brinkhoff <lars@nocrew.org>,
.\" Tomas Berndtsson <tomas@nocrew.org>. .\" Tomas Berndtsson <tomas@nocrew.org>.
.SH "SEE ALSO" .SH "SEE ALSO"
linux/include/asm-m68k/dsp56k.h, .IR linux/include/asm-m68k/dsp56k.h ,
linux/drivers/char/dsp56k.c, .IR linux/drivers/char/dsp56k.c ,
http://dsp56k.nocrew.org/, .IR http://dsp56k.nocrew.org/ ,
DSP56000/DSP56001 Digital Signal Processor User's Manual DSP56000/DSP56001 Digital Signal Processor User's Manual

View File

@ -379,7 +379,7 @@ where the rest of the function is specified in bold:
.RE .RE
.PP .PP
Filenames are always in italics (e.g., Filenames are always in italics (e.g.,
.IR "/usr/include/stdio.h" ), .IR /usr/include/stdio.h ),
except in the SYNOPSIS section, where included files are in bold (e.g., except in the SYNOPSIS section, where included files are in bold (e.g.,
.BR "#include <stdio.h>" ). .BR "#include <stdio.h>" ).
.PP .PP

View File

@ -251,7 +251,8 @@ Local IPv6 IP addresses can be found via /proc/net or via
.SH BUGS .SH BUGS
glibc 2.1 is missing the glibc 2.1 is missing the
.I ifr_newname .I ifr_newname
macro in net/if.h. macro in
.IR <net/if.h> .
Add the following to your program as a workaround: Add the following to your program as a workaround:
.sp .sp
.RS .RS

View File

@ -343,7 +343,8 @@ greater (>= 128Mb), and reduced to 128 for those systems with
very low memory (<= 32Mb). very low memory (<= 32Mb).
It is recommended that if this It is recommended that if this
needs to be increased above 1024, TCP_SYNQ_HSIZE in needs to be increased above 1024, TCP_SYNQ_HSIZE in
include/net/tcp.h be modified to keep .I include/net/tcp.h
be modified to keep
TCP_SYNQ_HSIZE*16<=tcp_max_syn_backlog, and the kernel be TCP_SYNQ_HSIZE*16<=tcp_max_syn_backlog, and the kernel be
recompiled. recompiled.
.TP .TP
@ -681,7 +682,7 @@ code intended to be portable.
.B TCP_INFO .B TCP_INFO
Used to collect information about this socket. Used to collect information about this socket.
The kernel returns a \fIstruct tcp_info\fP as defined in the file The kernel returns a \fIstruct tcp_info\fP as defined in the file
/usr/include/linux/tcp.h. .IR /usr/include/linux/tcp.h .
This option should not be used in code intended to be portable. This option should not be used in code intended to be portable.
.TP .TP
.B TCP_KEEPCNT .B TCP_KEEPCNT