Formatting fixes

This commit is contained in:
Michael Kerrisk 2006-02-09 20:24:53 +00:00
parent c4d4162c93
commit 9ff08aad91
27 changed files with 57 additions and 58 deletions

View File

@ -75,12 +75,12 @@ POSIX.1 standard (see paragraphs B.1.1.1.3 and B.8.3.3).
.SH NOTES
Various systems use various types for the parameter of
.BR sbrk ().
Common are \fBint\fP, \fBssize_t\fP, \fBptrdiff_t\fP, \fBintptr_t\fP.
Common are \fIint\fP, \fIssize_t\fP, \fIptrdiff_t\fP, \fIintptr_t\fP.
.\" One sees
.\" \fBint\fP (e.g. XPGv4, DU 4.0, HP-UX 11, FreeBSD 4.0, OpenBSD 3.2),
.\" \fBssize_t\fP (OSF1 2.0, Irix 5.3, 6.5),
.\" \fBptrdiff_t\fP (libc4, libc5, ulibc, glibc2.0, 2.1),
.\" \fBintptr_t\fP (e.g. XPGv5, AIX, SunOS 5.8, 5.9, FreeBSD 4.7, NetBSD 1.6,
.\" \fIint\fP (e.g. XPGv4, DU 4.0, HP-UX 11, FreeBSD 4.0, OpenBSD 3.2),
.\" \fIssize_t\fP (OSF1 2.0, Irix 5.3, 6.5),
.\" \fIptrdiff_t\fP (libc4, libc5, ulibc, glibc2.0, 2.1),
.\" \fIintptr_t\fP (e.g. XPGv5, AIX, SunOS 5.8, 5.9, FreeBSD 4.7, NetBSD 1.6,
.\" Tru64 5.1, glibc2.2).
XPGv6 obsoletes this function.
.SH "SEE ALSO"

View File

@ -139,7 +139,7 @@ L_INCR SEEK_CUR
L_XTND SEEK_END
.TE
.PP
SVR1-3 returns \fBlong\fP instead of \fBoff_t\fP, BSD returns \fBint\fP.
SVR1-3 returns \fIlong\fP instead of \fIoff_t\fP, BSD returns \fIint\fP.
.PP
Note that file descriptors created by
.BR dup (2)

View File

@ -113,8 +113,8 @@ permitted maximum.
and
.BR writev ()
functions first appeared in 4.2BSD), Unix98, POSIX 1003.1-2001.
Linux libc5 used \fBsize_t\fR as the type of the \fIcount\fR parameter,
and \fBint\fP as return type for these functions.
Linux libc5 used \fIsize_t\fR as the type of the \fIcount\fR parameter,
and \fIint\fP as return type for these functions.
.\" The readv/writev system calls were buggy before Linux 1.3.40.
.\" (Says release.libc.)
.SH "LINUX NOTES"

View File

@ -188,7 +188,7 @@ that returns a
(defined in
.IR "<sys/statvfs.h>" )
containing an
.B "unsigned long"
.I "unsigned long"
.IR f_fsid .
Linux, SunOS, HPUX, 4.4BSD have a system call
.BR statfs ()
@ -197,7 +197,7 @@ that returns a
(defined in
.IR "<sys/vfs.h>" )
containing a
.B fsid_t
.I fsid_t
.IR f_fsid ,
where
.I fsid_t

View File

@ -68,7 +68,7 @@ and
are defined in
.IR <sys/types.h> .
Both used to be
.BR "unsigned long" .
.IR "unsigned long" .
The field
.I f_flag

View File

@ -57,7 +57,7 @@ No value is returned.
ISO9899 (ANSI C). In the 1990 standard,
.I expression
is required to be of type
.B int
.I int
and undefined behavior results if it is not, but in the 1999 standard
it may have any scalar type.
.\" See Defect Report 107 for more details.

View File

@ -347,10 +347,11 @@ does the same as
but takes a version string as an additional argument.
.SH EXAMPLE
.B Load the math library, and print the cosine of 2.0:
Load the math library, and print the cosine of 2.0:
.RS
.nf
.if t .ft CW
#include <stdio.h>
#include <dlfcn.h>

View File

@ -52,7 +52,7 @@ one has to zero
before the call in order to detect possible errors.
\fBerrno\fR is defined by the ISO C standard to be a modifiable lvalue
of type \fBint\fR, and must not be explicitly declared; \fBerrno\fR
of type \fIint\fR, and must not be explicitly declared; \fBerrno\fR
may be a macro. \fBerrno\fR is thread-local; setting it in one thread
does not affect its value in any other thread.

View File

@ -37,17 +37,17 @@ The \fBfseeko\fP() and \fBftello\fP() functions are identical to
\fBfseek\fP() and \fBftell\fP() (see
.BR fseek (3)),
respectively, except that the \fIoffset\fP argument of \fBfseeko\fP()
and the return value of \fBftello\fP() is of type \fBoff_t\fP
instead of \fBlong\fP.
and the return value of \fBftello\fP() is of type \fIoff_t\fP
instead of \fIlong\fP.
.LP
On many architectures both \fBoff_t\fP and \fBlong\fP are 32-bit types,
On many architectures both \fIoff_t\fP and \fIlong\fP are 32-bit types,
but compilation with
.RS
.nf
#define _FILE_OFFSET_BITS 64
.fi
.RE
will turn \fBoff_t\fP into a 64-bit type.
will turn \fIoff_t\fP into a 64-bit type.
.SH RETURN VALUE
On successful completion,
.BR fseeko ()

View File

@ -75,7 +75,7 @@ Under libc4 and libc5 (and under SunOS 4.x) the prototype was
Today
.I proj_id
is an
.BR int ,
.IR int ,
but still only 8 bits are used. Typical usage has an ASCII character
.IR proj_id ,
that is why the behaviour is said to be undefined when

View File

@ -45,9 +45,9 @@ fgetc, fgets, getc, getchar, gets, ungetc \- input of characters and strings
reads the next character from
.I stream
and returns it as an
.B unsigned char
.I unsigned char
cast to an
.BR int ,
.IR int ,
or
.B EOF
on end of file or error.
@ -95,7 +95,7 @@ pushes
back to
.IR stream ,
cast to
.BR "unsigned char" ,
.IR "unsigned char" ,
where it is available for subsequent read operations. Pushed-back characters
will be returned in reverse order; only one pushback is guaranteed.
.PP
@ -112,9 +112,9 @@ For non-locking counterparts, see
and
.BR getchar ()
return the character read as an
.B unsigned char
.I unsigned char
cast to an
.B int
.I int
or
.B EOF
on end of file or error.

View File

@ -195,7 +195,7 @@ struct spwd {
.SH "RETURN VALUE"
The functions that return a pointer return NULL if no more entries
are available or if an error occurs during processing.
The functions which have \fBint\fR as the return value return 0 for
The functions which have \fIint\fR as the return value return 0 for
success and \-1 for failure.
.LP
For the non-reentrant functions, the return value may point to static area,

View File

@ -32,11 +32,11 @@ getw, putw \- input and output of words (ints)
.BI "int putw(int " w ", FILE *" stream );
.nl
.SH DESCRIPTION
\fBgetw\fP() reads a word (that is, an \fBint\fP) from \fIstream\fP. It's
\fBgetw\fP() reads a word (that is, an \fIint\fP) from \fIstream\fP. It's
provided for compatibility with SVID. We recommend you use
\fBfread\fP(3) instead.
.P
\fBputw\fP() writes the word \fIw\fP (that is, an \fBint\fP) to \fIstream\fP. It
\fBputw\fP() writes the word \fIw\fP (that is, an \fIint\fP) to \fIstream\fP. It
is provided for compatibility with SVID, but we recommend you use
\fBfwrite\fP(3) instead.
.SH "RETURN VALUE"

View File

@ -241,7 +241,7 @@ are declared as
.BR size_t
in glibc 2.1, as they should according to POSIX.2,
but are declared as
.B int
.I int
in libc4, libc5 and glibc 2.0.
.SH "SEE ALSO"
.BR ls (1),

View File

@ -65,7 +65,7 @@ classification routines
These functions check whether
.IR c ,
which must have the value of an
.B unsigned char
.I unsigned char
or
.BR EOF ,
falls into a certain character class according to the current locale.

View File

@ -42,7 +42,7 @@ fputc, fputs, putc, putchar, puts \- output of characters and strings
writes the character
.IR c ,
cast to an
.BR "unsigned char" ,
.IR "unsigned char" ,
to
.IR stream .
.PP
@ -85,9 +85,9 @@ For non-locking counterparts, see
and
.BR putchar ()
return the character written as an
.B unsigned char
.I unsigned char
cast to an
.B int
.I int
or
.B EOF
on error.

View File

@ -48,7 +48,7 @@ are identical to
and
.BR gcvt
respectively, except that they use a
.B "long double"
.I "long double"
argument
.IR number .
See

View File

@ -64,10 +64,10 @@ and
functions convert the initial portion of the string pointed to by
.I nptr
to
.BR double ,
.BR float ,
.IR double ,
.IR float ,
and
.B long double
.I long double
representation, respectively.
The expected form of the (initial portion of the) string is

View File

@ -34,7 +34,7 @@ toascii \- convert character to ASCII
.BI "int toascii(int " "c" );
.fi
.SH DESCRIPTION
\fBtoascii\fP() converts \fIc\fP to a 7-bit \fBunsigned char\fP value
\fBtoascii\fP() converts \fIc\fP to a 7-bit \fIunsigned char\fP value
that fits into the ASCII character set, by clearing the
high-order bits.
.SH "RETURN VALUE"

View File

@ -28,9 +28,7 @@ ualarm \- schedule signal after given number of microseconds
/* BSD version */
.B "#include <unistd.h>"
.sp
.BI "unsigned int"
.br
.BI "ualarm(unsigned int " usecs ", unsigned int " interval );
.BI "unsigned int ualarm(unsigned int " usecs ", unsigned int " interval );
.sp
/* SUSv2 version */
.B "#define _XOPEN_SOURCE 500"

View File

@ -39,9 +39,9 @@ These functions are just like
and
.BR wcstoul (),
except that they return a value of type
.B intmax_t
.I intmax_t
and
.BR uintmax_t ,
.IR uintmax_t ,
respectively.
.SH "CONFORMING TO"
C99, POSIX 1003.1-2003.

View File

@ -134,7 +134,7 @@ If the \fIformat\fP string contains non-ASCII wide characters, the program
will only work correctly if the LC_CTYPE category of the current locale at
run time is the same as the LC_CTYPE category of the current locale at
compile time. This is because the
.B wchar_t
.I wchar_t
representation is platform and locale dependent. (The GNU libc represents
wide characters using their Unicode (ISO-10646) code point, but other
platforms don't do this. Also, the use of ISO C99 universal character names

View File

@ -139,7 +139,7 @@ double *dp;
.ft R
.IP
A filter primitive that translates between C
.B double
.I double
precision numbers and their external representations.
This routine returns one if it succeeds, zero otherwise.
.br
@ -246,7 +246,7 @@ to a contiguous piece of the stream's buffer;
.I len
is the byte length of the desired buffer.
Note: pointer is cast to
.BR "long *" .
.IR "long *" .
.IP
Warning:
.BR xdr_inline ()
@ -284,7 +284,7 @@ long *lp;
.ft R
.IP
A filter primitive that translates between C
.B long
.I long
integers and their external representations.
This routine returns one if it succeeds, zero otherwise.
.br
@ -635,7 +635,7 @@ unsigned char *ucp;
.ft R
.IP
A filter primitive that translates between
.B unsigned
.I unsigned
C characters and their external representations.
This routine returns one if it succeeds, zero otherwise.
.br
@ -651,7 +651,7 @@ unsigned *up;
.ft R
.IP
A filter primitive that translates between C
.B unsigned
.I unsigned
integers and their external representations.
This routine returns one if it succeeds, zero otherwise.
.br
@ -667,7 +667,7 @@ unsigned long *ulp;
.ft R
.IP
A filter primitive that translates between C
.B "unsigned long"
.I "unsigned long"
integers and their external representations.
This routine returns one if it succeeds, zero otherwise.
.br
@ -683,7 +683,7 @@ unsigned short *usp;
.ft R
.IP
A filter primitive that translates between C
.B "unsigned short"
.I "unsigned short"
integers and their external representations.
This routine returns one if it succeeds, zero otherwise.
.br

View File

@ -108,16 +108,16 @@ BLKGETSIZE
Returns the device size in sectors. The
.BR ioctl (2)
parameter should be a pointer to a
.BR long .
.IR long .
.TP
BLKRRPART
Forces a re-read of the SCSI disk partition tables. No parameter is needed.
The
.BR scsi (4)
.IR ioctl s
are also supported. If the
.BR ioctl (2)
operations are also supported. If the
.BR ioctl ()
parameter is required, and it is NULL, then
.BR ioctl ()
will return \-EINVAL.

View File

@ -131,7 +131,7 @@ is a
.B key_t
type, while all the other symbolic constants are flag fields and can
be OR'ed into an
.B int
.I int
type variable.
.SS Message Queues
A message queue is uniquely identified by a positive integer

View File

@ -44,7 +44,7 @@ stored in the file.
The above header is followed by
.I tzh_timecnt
four-byte values of type
.BR long ,
.IR long ,
sorted in ascending order.
These values are written in ``standard'' byte order.
Each is used as a transition time (as returned by
@ -53,7 +53,7 @@ at which the rules for computing local time change.
Next come
.I tzh_timecnt
one-byte values of type
.BR "unsigned char" ;
.IR "unsigned char" ;
each one tells which of the different types of ``local time'' types
described in the file is associated with the same-indexed transition time.
These values serve as indices into an array of
@ -75,7 +75,7 @@ struct ttinfo {
Each structure is written as a four-byte value for
.I tt_gmtoff
of type
.BR long ,
.IR long ,
in a standard byte order, followed by a one-byte value for
.I tt_isdst
and a one-byte value for

View File

@ -191,7 +191,7 @@ such as
and
.BR mbsrtowcs (3)
can be used to transform the internal
.B wchar_t
.I wchar_t
characters and strings into the system character encoding and back
and
.BR wcwidth (3)