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
.BR sendfile ()
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"
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
.I "struct statvfs"
(defined in
.IR "<sys/statvfs.h>" )
.IR <sys/statvfs.h> )
containing an
.I "unsigned long"
.IR f_fsid .
@ -219,7 +219,7 @@ Linux, SunOS, HP-UX, 4.4BSD have a system call
that returns a
.I "struct statfs"
(defined in
.IR "<sys/vfs.h>" )
.IR <sys/vfs.h> )
containing a
.I fsid_t
.IR f_fsid ,
@ -228,7 +228,7 @@ where
is defined as
.IR "struct { int val[2]; }" .
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
.I f_fsid

View File

@ -142,7 +142,9 @@ There is no GNU version of
.LP
With glibc, one gets the POSIX version of
.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
In the glibc implementation of the POSIX versions of these functions
they modify their argument, and segfault when called with a static string

View File

@ -101,7 +101,9 @@ flags are meaningful.
.PP
The
.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.
.PP
The
@ -115,7 +117,9 @@ and the access method.
.PP
.BR dbopen ()
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:
.sp
.nf

View File

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

View File

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

View File

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

View File

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

View File

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

View File

@ -135,7 +135,7 @@ define
or
.B _BSD_SOURCE
before including
.IR "<stdio.h>" .
.IR <stdio.h> .
.SH BUGS
Never use this function.
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>,
.\" Tomas Berndtsson <tomas@nocrew.org>.
.SH "SEE ALSO"
linux/include/asm-m68k/dsp56k.h,
linux/drivers/char/dsp56k.c,
http://dsp56k.nocrew.org/,
.IR linux/include/asm-m68k/dsp56k.h ,
.IR linux/drivers/char/dsp56k.c ,
.IR http://dsp56k.nocrew.org/ ,
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
.PP
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.,
.BR "#include <stdio.h>" ).
.PP

View File

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

View File

@ -343,7 +343,8 @@ greater (>= 128Mb), and reduced to 128 for those systems with
very low memory (<= 32Mb).
It is recommended that if this
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
recompiled.
.TP
@ -681,7 +682,7 @@ code intended to be portable.
.B TCP_INFO
Used to collect information about this socket.
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.
.TP
.B TCP_KEEPCNT