summaryrefslogtreecommitdiff
path: root/man3
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2007-07-09 20:43:38 +0000
committerMichael Kerrisk <mtk.manpages@gmail.com>2007-07-09 20:43:38 +0000
commitcab87712a17ffff5e2df81787450211020307e5c (patch)
tree8639f87d49b46e427fd13681938be06bd7618b82 /man3
parent7f45503bd8249dc99e3145239853405354453ff2 (diff)
ffix
Diffstat (limited to 'man3')
-rw-r--r--man3/btowc.314
-rw-r--r--man3/fgetwc.39
-rw-r--r--man3/fmtmsg.320
-rw-r--r--man3/fopen.310
-rw-r--r--man3/fputwc.311
-rw-r--r--man3/fseeko.32
-rw-r--r--man3/ftime.38
-rw-r--r--man3/ftok.34
-rw-r--r--man3/getwchar.39
-rw-r--r--man3/iswctype.34
-rw-r--r--man3/putwchar.311
-rw-r--r--man3/tgamma.312
-rw-r--r--man3/toupper.34
13 files changed, 80 insertions, 38 deletions
diff --git a/man3/btowc.3 b/man3/btowc.3
index 7843b0aec..5328f0f24 100644
--- a/man3/btowc.3
+++ b/man3/btowc.3
@@ -27,17 +27,23 @@ function converts \fIc\fP,
interpreted as a multibyte sequence
of length 1, starting in the initial shift state, to a wide character and
returns it.
-If \fIc\fP is EOF or not a valid multibyte sequence of length 1,
+If \fIc\fP is
+.B EOF
+or not a valid multibyte sequence of length 1,
the
.BR btowc ()
-function returns WEOF.
+function returns
+.BR WEOF .
.SH "RETURN VALUE"
The
.BR btowc ()
function returns the wide character
converted from the single byte \fIc\fP.
-If \fIc\fP is EOF or not a valid multibyte sequence of length 1,
-it returns WEOF.
+If \fIc\fP is
+.B EOF
+or not a valid multibyte sequence of length 1,
+it returns
+.BR WEOF .
.SH "CONFORMING TO"
C99, POSIX.1-2001.
.SH NOTES
diff --git a/man3/fgetwc.3 b/man3/fgetwc.3
index 55878e10b..5194b5d0c 100644
--- a/man3/fgetwc.3
+++ b/man3/fgetwc.3
@@ -34,9 +34,11 @@ of the
function.
It reads a wide character from \fIstream\fP and returns it.
If the end of stream is reached, or if \fIferror(stream)\fP becomes true,
-it returns WEOF.
+it returns
+.BR WEOF .
If a wide-character conversion error occurs, it sets
-\fIerrno\fP to \fBEILSEQ\fP and returns WEOF.
+\fIerrno\fP to \fBEILSEQ\fP and returns
+.BR WEOF .
.PP
The
.BR getwc ()
@@ -52,7 +54,8 @@ For non-locking counterparts, see
The
.BR fgetwc ()
function returns the next wide-character
-from the stream, or WEOF.
+from the stream, or
+.BR WEOF .
.SH ERRORS
Apart from the usual ones, there is
.TP
diff --git a/man3/fmtmsg.3 b/man3/fmtmsg.3
index 281d11248..ca1a19a56 100644
--- a/man3/fmtmsg.3
+++ b/man3/fmtmsg.3
@@ -66,7 +66,9 @@ The values
.BR MM_NULLTXT ,
.BR MM_NULLACT ,
.BR MM_NULLTAG
-are synonyms for ((char *) 0), the empty string, and
+are synonyms for
+.IR "((char *) 0)" ,
+the empty string, and
.B MM_NULLSEV
is a synonym for
.BR NO_SEV .
@@ -266,17 +268,23 @@ main(void)
.PP
The output should be:
.nf
- util\-linux:mount: ERROR: unknown mount option
- TO FIX: See mount(8). util\-linux:mount:017
+
+ util\-linux:mount: ERROR: unknown mount option
+ TO FIX: See mount(8). util\-linux:mount:017
+
.fi
and after
.nf
- MSGVERB=text:action; export MSGVERB
+
+ MSGVERB=text:action; export MSGVERB
+
.fi
the output becomes:
.nf
- unknown mount option
- TO FIX: See mount(8).
+
+ unknown mount option
+ TO FIX: See mount(8).
+
.fi
.SH "SEE ALSO"
.BR addseverity (3),
diff --git a/man3/fopen.3 b/man3/fopen.3
index 34db7051e..345c43ae8 100644
--- a/man3/fopen.3
+++ b/man3/fopen.3
@@ -113,7 +113,7 @@ file and expect that your program may be ported to non-Unix
environments.)
.PP
Any created files will have mode
-.BR S_IRUSR \&| S_IWUSR \&| S_IRGRP \&| S_IWGRP \&| S_IROTH \&| S_IWOTH
+.BR S_IRUSR " | " S_IWUSR " | " S_IRGRP " | " S_IWGRP " | " S_IROTH " | " S_IWOTH
(0666), as modified by the process's umask value (see
.BR umask (2)).
.PP
@@ -136,9 +136,11 @@ Opening a file in append mode (\fBa\fR as the first character of
.IR mode )
causes all subsequent write operations to this stream to occur
at end-of-file, as if preceded by an
-.RS
-fseek(stream,0,SEEK_END);
-.RE
+.nf
+
+ fseek(stream,0,SEEK_END);
+.fi
+.PP
call.
.PP
The
diff --git a/man3/fputwc.3 b/man3/fputwc.3
index 71814249a..79c791482 100644
--- a/man3/fputwc.3
+++ b/man3/fputwc.3
@@ -32,9 +32,11 @@ equivalent of the
function.
It writes the wide character \fIwc\fP to \fIstream\fP.
If
-\fIferror(stream)\fP becomes true, it returns WEOF.
+\fIferror(stream)\fP becomes true, it returns
+.BR WEOF .
If a wide-character conversion error occurs,
-it sets \fIerrno\fP to \fBEILSEQ\fP and returns WEOF.
+it sets \fIerrno\fP to \fBEILSEQ\fP and returns
+.BR WEOF .
Otherwise it returns \fIwc\fP.
.PP
The
@@ -50,8 +52,9 @@ For non-locking counterparts, see
.SH "RETURN VALUE"
The
.BR fputwc ()
-function returns \fIwc\fP if no error occurred,
-or WEOF to indicate an error.
+function returns \fIwc\fP if no error occurred, or
+.B WEOF
+to indicate an error.
.SH ERRORS
Apart from the usual ones, there is
.TP
diff --git a/man3/fseeko.3 b/man3/fseeko.3
index ac30feabd..41ed2fcec 100644
--- a/man3/fseeko.3
+++ b/man3/fseeko.3
@@ -54,9 +54,11 @@ 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
+.PP
will turn \fIoff_t\fP into a 64-bit type.
.SH RETURN VALUE
On successful completion,
diff --git a/man3/ftime.3 b/man3/ftime.3
index 9efb008eb..0607e434b 100644
--- a/man3/ftime.3
+++ b/man3/ftime.3
@@ -39,13 +39,13 @@ Return current date and time in
.IR tp ,
which is declared as follows:
.sp
-.in +1i
+.in +0.5i
.nf
struct timeb {
- time_t time;
+ time_t time;
unsigned short millitm;
- short timezone;
- short dstflag;
+ short timezone;
+ short dstflag;
};
.fi
.in -1i
diff --git a/man3/ftok.3 b/man3/ftok.3
index 5fbba5c3d..d93f0d21d 100644
--- a/man3/ftok.3
+++ b/man3/ftok.3
@@ -70,10 +70,12 @@ system call.
.SH "CONFORMING TO"
POSIX.1-2001.
.SH NOTES
-Under libc4 and libc5 (and under SunOS 4.x) the prototype was
+Under libc4 and libc5 (and under SunOS 4.x) the prototype was:
+.sp
.RS
.BI "key_t ftok(char *" pathname ", char " proj_id );
.RE
+.PP
Today
.I proj_id
is an
diff --git a/man3/getwchar.3 b/man3/getwchar.3
index 5809d9eab..ae2e6bf6c 100644
--- a/man3/getwchar.3
+++ b/man3/getwchar.3
@@ -30,9 +30,11 @@ function.
It reads a wide character from \fIstdin\fP and returns
it.
If the end of stream is reached, or if \fIferror(stdin)\fP becomes
-true, it returns WEOF.
+true, it returns
+.BR WEOF .
If a wide-character conversion error occurs, it sets
-\fIerrno\fP to \fBEILSEQ\fP and returns WEOF.
+\fIerrno\fP to \fBEILSEQ\fP and returns
+.BR WEOF .
.PP
For a non-locking counterpart, see
.BR unlocked_stdio (3).
@@ -40,7 +42,8 @@ For a non-locking counterpart, see
The
.BR getwchar ()
function returns the next wide-character from
-standard input, or WEOF.
+standard input, or
+.BR WEOF .
.SH "CONFORMING TO"
C99
.SH NOTES
diff --git a/man3/iswctype.3 b/man3/iswctype.3
index 0bf3ce44f..6336cb66e 100644
--- a/man3/iswctype.3
+++ b/man3/iswctype.3
@@ -28,7 +28,9 @@ If \fIwc\fP is a wide character having the character property designated by
function returns non-zero.
Otherwise it
returns zero.
-If \fIwc\fP is WEOF, zero is returned.
+If \fIwc\fP is
+.BR WEOF ,
+zero is returned.
.PP
\fIdesc\fP must be a character property descriptor
returned by the \fBwctype\fP
diff --git a/man3/putwchar.3 b/man3/putwchar.3
index d01503f2d..b57875f9b 100644
--- a/man3/putwchar.3
+++ b/man3/putwchar.3
@@ -28,9 +28,11 @@ function is the wide-character equivalent of the
.BR putchar (3)
function.
It writes the wide character \fIwc\fP to \fIstdout\fP.
-If \fIferror(stdout)\fP becomes true, it returns WEOF.
+If \fIferror(stdout)\fP becomes true, it returns
+.BR WEOF .
If a wide character
-conversion error occurs, it sets \fIerrno\fP to \fBEILSEQ\fP and returns WEOF.
+conversion error occurs, it sets \fIerrno\fP to \fBEILSEQ\fP and returns
+.BR WEOF .
Otherwise it returns \fIwc\fP.
.PP
For a non-locking counterpart, see
@@ -38,8 +40,9 @@ For a non-locking counterpart, see
.SH "RETURN VALUE"
The
.BR putwchar ()
-function returns \fIwc\fP if no error occurred,
-or WEOF to indicate an error.
+function returns \fIwc\fP if no error occurred, or
+.B WEOF
+to indicate an error.
.SH "CONFORMING TO"
C99.
.SH NOTES
diff --git a/man3/tgamma.3 b/man3/tgamma.3
index 21ca6b9c8..12a1ab5dc 100644
--- a/man3/tgamma.3
+++ b/man3/tgamma.3
@@ -66,9 +66,15 @@ is non-zero or
.I fetestexcept(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW | FE_UNDERFLOW)
is non-zero, an error has occurred.
.LP
-A range error occurs if x is too large.
-A pole error occurs if x is zero.
-A domain error (or a pole error) occurs if x is a negative integer.
+A range error occurs if
+.I x
+is too large.
+A pole error occurs if
+.I x
+is zero.
+A domain error (or a pole error) occurs if
+.I x
+is a negative integer.
.SH "CONFORMING TO"
C99.
.SH "SEE ALSO"
diff --git a/man3/toupper.3 b/man3/toupper.3
index 0c9355432..29d5a554e 100644
--- a/man3/toupper.3
+++ b/man3/toupper.3
@@ -46,7 +46,9 @@ to lower case, if possible.
.PP
If
.I c
-is not an unsigned char value, or EOF, the behavior of these functions
+is not an unsigned char value, or
+.BR EOF ,
+the behavior of these functions
is undefined.
.SH "RETURN VALUE"
The value returned is that of the converted letter, or