From cab87712a17ffff5e2df81787450211020307e5c Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Mon, 9 Jul 2007 20:43:38 +0000 Subject: [PATCH] ffix --- man3/btowc.3 | 14 ++++++++++---- man3/fgetwc.3 | 9 ++++++--- man3/fmtmsg.3 | 20 ++++++++++++++------ man3/fopen.3 | 10 ++++++---- man3/fputwc.3 | 11 +++++++---- man3/fseeko.3 | 2 ++ man3/ftime.3 | 8 ++++---- man3/ftok.3 | 4 +++- man3/getwchar.3 | 9 ++++++--- man3/iswctype.3 | 4 +++- man3/putwchar.3 | 11 +++++++---- man3/tgamma.3 | 12 +++++++++--- man3/toupper.3 | 4 +++- 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