diff options
| author | Krónos <Krónos@Sāturnus> | 1993-10-11 00:00:00 +0100 |
|---|---|---|
| committer | Alejandro Colomar <alx@kernel.org> | 2022-12-15 23:09:38 +0100 |
| commit | 9e0fdb0c0192079e5847f49832374ea28b5ad436 (patch) | |
| tree | 0eb6ca406983d655aa04225550ec9f8a6c265e90 /man3 | |
| parent | 3c23040573650f36a3f2778a3629f4ae7e6c10ab (diff) | |
| download | man-pages-prehistory-backwards.tar.gz | |
man-pages 1.0prehistory-backwards
man-pages-1.1 seems to be missing. :/
Link: <https://www.win.tue.nl/~aeb/ftpdocs/linux-local/manpages.archive/>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Diffstat (limited to 'man3')
203 files changed, 191 insertions, 3132 deletions
diff --git a/man3/abort.3 b/man3/abort.3 index 26c662ddfc..5dae01030d 100644 --- a/man3/abort.3 +++ b/man3/abort.3 @@ -26,5 +26,5 @@ function will still override it. The \fBabort()\fP function never returns. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR sigaction "(2), " exit (3) diff --git a/man3/abs.3 b/man3/abs.3 index 1b9d989cae..96c824579e 100644 --- a/man3/abs.3 +++ b/man3/abs.3 @@ -26,5 +26,5 @@ SVID 3, POSIX, BSD 4.3, ISO 9899 .SH NOTES Trying to take the absolute value of the most negative integer is not defined. -.SH "SEE ALSO" +.SH SEE ALSO .BR ceil "(3), " floor "(3), " fabs "(3), " labs "(3), " rint (3) diff --git a/man3/acos.3 b/man3/acos.3 index 471f7bcf02..a7b310846c 100644 --- a/man3/acos.3 +++ b/man3/acos.3 @@ -17,7 +17,7 @@ acos \- arc cosine function .SH DESCRIPTION The \fBacos()\fP function calculates the arc cosine of \fIx\fP; that is the value whose cosine is \fIx\fP. If \fIx\fP falls outside the range -\-1 to 1, \fBacos()\fP fails and \fIerrno\fP is set. +-1 to 1, \fBacos()\fP fails and \fIerrno\fP is set. .SH "RETURN VALUE" The \fBacos()\fP function returns the arc cosine in radians and the value is mathematically defined to be between 0 and PI (inclusive). @@ -27,5 +27,5 @@ value is mathematically defined to be between 0 and PI (inclusive). \fIx\fP is out of range. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR asin "(3), " atan "(3), " atan2 "(3), " cos "(3), " sin "(3), " tan (3) diff --git a/man3/acosh.3 b/man3/acosh.3 index bbecf0f646..0a432a21bb 100644 --- a/man3/acosh.3 +++ b/man3/acosh.3 @@ -25,5 +25,5 @@ is set. \fIx\fP is out of range. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR asinh "(3), " atanh "(3), " cosh "(3), " sinh "(3), " tanh (3) diff --git a/man3/alloca.3 b/man3/alloca.3 deleted file mode 100644 index 6703c4f7f5..0000000000 --- a/man3/alloca.3 +++ /dev/null @@ -1,75 +0,0 @@ -.\" Copyright (c) 1980, 1991 Regents of the University of California. -.\" All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)alloca.3 5.1 (Berkeley) 5/2/91 -.\" -.\" Converted for Linux, Mon Nov 29 11:05:55 1993, faith@cs.unc.edu -.\" -.TH ALLOCA 3 "29 November 1993" "GNU" "Linux Programmer's Manual" -.SH NAME -alloca \- memory allocator -.SH SYNOPSIS -.B #include <stdlib.h> -.sp -.BI "void *alloca( size_t " size ); -.SH DESCRIPTION -The -.B alloca -function allocates -.I size -bytes of space in the stack frame of the caller. This temporary space is -automatically freed on return. -.SH "RETURN VALUES" -The -.B alloca -function returns a pointer to the beginning of the allocated space. If the -allocation failed, a -.B NULL -pointer is returned. -.SH HISTORY -There is evidence that the -.B alloca -function appears in 32v, pwb, pwb.2, 3bsd, and 4bsd. There is a man page -for it in BSD 4.3. Linux uses the GNU version. -.SH BUGS -The -.B alloca -function is machine dependent. -.SH SEE ALSO -.BR brk "(2), " pagesize "(2), " calloc "(3), " malloc "(3), " realloc (3) -.\" .Sh HISTORY -.\" The -.\" .Fn alloca -.\" function appeared in -.\" .Bx ?? . -.\" The function appeared in 32v, pwb and pwb.2 and in 3bsd 4bsd -.\" The first man page (or link to a man page that I can find at the -.\" moment is 4.3... diff --git a/man3/asin.3 b/man3/asin.3 index 37cf8f14bc..675d56adce 100644 --- a/man3/asin.3 +++ b/man3/asin.3 @@ -17,7 +17,7 @@ asin \- arc sine function .SH DESCRIPTION The \fBasin()\fP function calculates the arc sine of \fIx\fP; that is the value whose sine is \fIx\fP. If \fIx\fP falls outside the range -\-1 to 1, \fBasin()\fP fails and \fIerrno\fP is set. +-1 to 1, \fBasin()\fP fails and \fIerrno\fP is set. .SH "RETURN VALUE" The \fBasin()\fP function returns the arc sine in radians and the value is mathematically defined to be between -PI/2 and PI/2 @@ -28,5 +28,5 @@ value is mathematically defined to be between -PI/2 and PI/2 \fIx\fP is out of range. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR acos "(3), " atan "(3), " atan2 "(3), " cos "(3), " sin "(3), " tan (3) diff --git a/man3/asinh.3 b/man3/asinh.3 index 1c7a6fca70..f91a9e24f7 100644 --- a/man3/asinh.3 +++ b/man3/asinh.3 @@ -19,5 +19,5 @@ The \fBasinh()\fP function calculates the inverse hyperbolic sine of \fIx\fP; that is the value whose hyperbolic sine is \fIx\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR acosh "(3), " atanh "(3), " cosh "(3), " sinh "(3), " tanh (3) diff --git a/man3/assert.3 b/man3/assert.3 index bbdfcd84d8..876d280007 100644 --- a/man3/assert.3 +++ b/man3/assert.3 @@ -31,5 +31,5 @@ is implemented as a macro; if the expression tested has side - effects, program behaviour will be different depending on wether .B NDEBUG is defined. This may create Heisenbugs which go away when debugging is turned on. -.SH "SEE ALSO" +.SH SEE ALSO .BR exit "(3), " abort (3) diff --git a/man3/atan.3 b/man3/atan.3 index e2b2a7da30..07001a4366 100644 --- a/man3/atan.3 +++ b/man3/atan.3 @@ -23,5 +23,5 @@ value is mathematically defined to be between -PI/2 and PI/2 (inclusive). .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR acos "(3), " asin "(3), " atan2 "(3), " cos "(3), " sin "(3), " tan (3) diff --git a/man3/atan2.3 b/man3/atan2.3 index b64e7fe317..a99344d90d 100644 --- a/man3/atan2.3 +++ b/man3/atan2.3 @@ -24,5 +24,5 @@ The \fBatan2()\fP function returns the result in radians, which is between -PI and PI (inclusive). .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR acos "(3), " asin "(3), " atan "(3), " cos "(3), " sin "(3), " tan(3) diff --git a/man3/atanh.3 b/man3/atanh.3 index 7f2a7e83ff..4c963d27d2 100644 --- a/man3/atanh.3 +++ b/man3/atanh.3 @@ -25,5 +25,5 @@ not-a-number (NaN) and \fIerrno\fP is set. \fIx\fP is out of range. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR asinh "(3), " acosh "(3), " cosh "(3), " sinh "(3), " tanh (3) diff --git a/man3/atexit.3 b/man3/atexit.3 index 48f933de99..a3a3af2034 100644 --- a/man3/atexit.3 +++ b/man3/atexit.3 @@ -24,7 +24,7 @@ from the program's \fBmain\fP. Functions so registered are called in the reverse order of their registration; no arguments are passed. .SH "RETURN VALUE" The \fBatexit()\fP function returns the value 0 if successful; otherwise -the value \-1 is returned and the global variable \fIerrno\fP is set to +the value -1 is returned and the global variable \fIerrno\fP is set to indicate the error. .SH "ERRORS" .TP @@ -32,5 +32,5 @@ indicate the error. Insufficient memory available to add the function. .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR exit "(3), " on_exit (3) diff --git a/man3/atof.3 b/man3/atof.3 index 3f813b9c85..e5ff4b7bec 100644 --- a/man3/atof.3 +++ b/man3/atof.3 @@ -28,5 +28,5 @@ except that \fBatof()\fP does not detect errors. The converted value. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR atoi "(3), " atol "(3), " strtod "(3), " strtol "(3), " strtoul (3) diff --git a/man3/atoi.3 b/man3/atoi.3 index f2dc21898c..757ea42d75 100644 --- a/man3/atoi.3 +++ b/man3/atoi.3 @@ -28,5 +28,5 @@ except that \fBatoi()\fP does not detect errors. The converted value. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR atof "(3), " atol "(3), " strtod "(3), " strtol "(3), " strtoul (3) diff --git a/man3/atol.3 b/man3/atol.3 index a174b93441..7ef53c32e6 100644 --- a/man3/atol.3 +++ b/man3/atol.3 @@ -28,5 +28,5 @@ except that \fBatol()\fP does not detect errors. The converted value. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR atof "(3), " atoi "(3), " strtod "(3), " strtol "(3), " strtoul (3) diff --git a/man3/bcmp.3 b/man3/bcmp.3 index 1a92edcdf7..1ee24b4d10 100644 --- a/man3/bcmp.3 +++ b/man3/bcmp.3 @@ -24,6 +24,6 @@ The \fBbcmp()\fP function returns 0 if the strings are equal, otherwise a non-zero result is returned. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR memcmp "(3), " strcasecmp "(3), " strcmp (3), .BR strcoll "(3), " strncmp "(3), " strncasecmp (3) diff --git a/man3/bcopy.3 b/man3/bcopy.3 index 177d33a449..7a3badc0a8 100644 --- a/man3/bcopy.3 +++ b/man3/bcopy.3 @@ -21,5 +21,5 @@ zero, no bytes are copied. The \fBbcopy()\fP function returns no value. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO memccpy(3), memcpy(3), memmove(3), strcpy(3), strncpy(3) diff --git a/man3/bsearch.3 b/man3/bsearch.3 index 188a90107f..1c5ba2a6fa 100644 --- a/man3/bsearch.3 +++ b/man3/bsearch.3 @@ -37,5 +37,5 @@ array, or NULL if no match is found. If there are multiple elements that match the key, the element returned is unspecified. .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR qsort (3) diff --git a/man3/bstring.3 b/man3/bstring.3 index 6a4ffe1284..1602129366 100644 --- a/man3/bstring.3 +++ b/man3/bstring.3 @@ -43,7 +43,7 @@ memmove, memset \- byte string operations The byte string functions perform operations on strings that are not NULL-terminated. See the individual man pages for descriptions of each function. -.SH "SEE ALSO" +.SH SEE ALSO .BR bcmp "(3), " bcopy "(3), " bzero "(3), " memccpy "(3), " memchr (3), .BR memcmp "(3), " memcpy "(3), " memfrob "(3), " memmem (3), .BR memmove "(3), " memset (3) diff --git a/man3/byteorder.3 b/man3/byteorder.3 index d552fc076b..3cdfd840b6 100644 --- a/man3/byteorder.3 +++ b/man3/byteorder.3 @@ -39,5 +39,5 @@ whereas the network byte order, as used on the Internet, is Most Significant Byte first. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR gethostbyname "(3), " getservent (3) diff --git a/man3/bzero.3 b/man3/bzero.3 index e0f235d557..2898d625fd 100644 --- a/man3/bzero.3 +++ b/man3/bzero.3 @@ -21,5 +21,5 @@ string \fIs\fP to zero. The \fBbcmp()\fP function returns no value. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR memset "(3), " swab (3) diff --git a/man3/ceil.3 b/man3/ceil.3 index aba468fd3c..e36fb2059e 100644 --- a/man3/ceil.3 +++ b/man3/ceil.3 @@ -19,5 +19,5 @@ The \fBceil()\fP function rounds \fIx\fP upwards to the nearest integer, returning that value as a double. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR abs "(3), " fabs "(3), " floor "(3), " labs "(3), " rint (3) diff --git a/man3/clearerr.3 b/man3/clearerr.3 deleted file mode 100644 index 196ef922de..0000000000 --- a/man3/clearerr.3 +++ /dev/null @@ -1 +0,0 @@ -man3/ferror.3 diff --git a/man3/clock.3 b/man3/clock.3 index b37ae2040d..9b115c469e 100644 --- a/man3/clock.3 +++ b/man3/clock.3 @@ -31,5 +31,5 @@ at the start of the program and the end to get maximum portability. The .B times() function call returns more information. -.SH "SEE ALSO" +.SH SEE ALSO .BR times (2) diff --git a/man3/closedir.3 b/man3/closedir.3 index 1b7a2a93f3..871045f7b4 100644 --- a/man3/closedir.3 +++ b/man3/closedir.3 @@ -19,13 +19,13 @@ The \fBclosedir()\fP function closes the directory stream associated with \fIdir\fP. The directory stream descriptor \fIdir\fP is not available after this call. .SH "RETURN VALUE" -The \fBclosedir()\fP function returns 0 on success or \-1 on failure. +The \fBclosedir()\fP function returns 0 on success or -1 on failure. .SH "ERRORS" .TP .B EBADF Invalid directory stream descriptor \fIdir\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR close "(2), " opendir "(3), " readdir "(3), " rewinddir (3), .BR seekdir "(3), " telldir "(3), " scandir (3) diff --git a/man3/confstr.3 b/man3/confstr.3 index d8efc5a52c..82d092e663 100644 --- a/man3/confstr.3 +++ b/man3/confstr.3 @@ -84,5 +84,5 @@ proposed POSIX.2 .SH "BUGS" POSIX.2 is not yet an approved standard; the information in this manpage is subject to change. -.SH "SEE ALSO" +.SH SEE ALSO .BR sh "(1), " exec "(2), " system (3) diff --git a/man3/cos.3 b/man3/cos.3 index 98473ec94a..d4158e362d 100644 --- a/man3/cos.3 +++ b/man3/cos.3 @@ -18,8 +18,8 @@ cos \- cosine function The \fBcos()\fP function returns the cosine of \fIx\fP, where \fIx\fP is given in radians. .SH "RETURN VALUE" -The \fBcos()\fP function returns a value between \-1 and 1. +The \fBcos()\fP function returns a value between -1 and 1. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR acos "(3), " asin "(3), " atan "(3), " atan2 "(3), " sin "(3), " tan (3) diff --git a/man3/cosh.3 b/man3/cosh.3 index 3885c05bdb..969a454fe2 100644 --- a/man3/cosh.3 +++ b/man3/cosh.3 @@ -19,5 +19,5 @@ The \fBcosh()\fP function returns the hyperbolic cosine of \fIx\fP, which is defined mathematically as exp(x) + exp(-x) / 2. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR acosh "(3), " asinh "(3), " atanh "(3), " sinh "(3), " tanh (3) diff --git a/man3/ctermid.3 b/man3/ctermid.3 index f9e8bf47b2..00f197a05f 100644 --- a/man3/ctermid.3 +++ b/man3/ctermid.3 @@ -35,5 +35,5 @@ terminal; it may, for example, be .BR /dev/tty . .PP It is not assured that the program can open the terminal. -.SH "SEE ALSO" +.SH SEE ALSO .BR ttyname (3) diff --git a/man3/ctime.3 b/man3/ctime.3 index d8c45bd32c..fd9db56eb9 100644 --- a/man3/ctime.3 +++ b/man3/ctime.3 @@ -131,10 +131,10 @@ them from the other information in the broken-down time structure. Calling \fBmktime()\fP also sets the external variable \fItzname\fP with information about the current time zone. If the specified broken-down time cannot be represented as calendar time, \fBmktime()\fP returns a -value of (time_t)(\-1) and does not alter the \fItm_wday\fP and \fItm_yday\fP +value of (time_t)(-1) and does not alter the \fItm_wday\fP and \fItm_yday\fP members of the broken-down time structure. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR date "(1), " gettimeofday "(2), " time "(2), " tzset (3), .BR difftime "(3), " strftime (3) diff --git a/man3/difftime.3 b/man3/difftime.3 index fc53aa1d1f..e0b35fa89f 100644 --- a/man3/difftime.3 +++ b/man3/difftime.3 @@ -21,6 +21,6 @@ specified in calendar time, which represents the time elapsed since 00:00:00 on January 1, 1970, Coordinated Universal Time (UTC). .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR date "(1), " gettimeofday "(2), " time (2), .BR ctime "(3), " gmtime "(3), " localtime (3) diff --git a/man3/div.3 b/man3/div.3 index 8ddb9b0a3b..58abb0fba2 100644 --- a/man3/div.3 +++ b/man3/div.3 @@ -23,5 +23,5 @@ contains two integer members named \fIquot\fP and \fIrem\fP. The \fIdiv_t\fP structure. .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR ldiv (3) diff --git a/man3/drand48.3 b/man3/drand48.3 index d561439553..b2c9cb4a5f 100644 --- a/man3/drand48.3 +++ b/man3/drand48.3 @@ -43,7 +43,7 @@ The \fBlrand48()\fP and \fBnrand48()\fP functions return non-negative long integers uniformly distributed between 0 and 2^31. .PP The \fBmrand48()\fP and \fBjrand48()\fP functions return signed long -integers uniformly distributed between \-2^31 and 2^31. +integers uniformly distributed between -2^31 and 2^31. .PP The \fBsrand48()\fP, \fBseed48()\fP and \fBlcong48()\fP functions are initialization functions, one of which should be called before using @@ -105,5 +105,5 @@ SVID 3 .SH NOTES These functions are declared obsolete by SVID 3, which states that rand(3) should be used instead. -.SH "SEE ALSO" +.SH SEE ALSO .BR rand "(3), " random (3) diff --git a/man3/drem.3 b/man3/drem.3 index e86650bb34..412a36899d 100644 --- a/man3/drem.3 +++ b/man3/drem.3 @@ -28,5 +28,5 @@ when the function fails and \fIerrno\fP is set. The denominator \fIy\fP is zero. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR fmod (3) diff --git a/man3/ecvt.3 b/man3/ecvt.3 index a55fa53be8..e45dd67721 100644 --- a/man3/ecvt.3 +++ b/man3/ecvt.3 @@ -33,5 +33,5 @@ Both the \fBecvt()\fP and \fBfcvt()\fP functions return a pointer to a static string containing the ASCII representation of \fInumber\fP. The static string is overwritten by each call to \fBecvt()\fP or \fBfcvt()\fP. -.SH "SEE ALSO" +.SH SEE ALSO .BR gcvt "(3), " sprintf (3) diff --git a/man3/erand48.3 b/man3/erand48.3 index 3133f7d62c..8d2bfcd5de 100644 --- a/man3/erand48.3 +++ b/man3/erand48.3 @@ -1 +1 @@ -.so man3/drand48.3 +.so man3/drand48.3
\ No newline at end of file diff --git a/man3/erf.3 b/man3/erf.3 index c692fb0b6e..05a7ef9ff1 100644 --- a/man3/erf.3 +++ b/man3/erf.3 @@ -26,5 +26,5 @@ The \fBerfc()\fP function returns the complementary error function of \fIx\fP, that is 1.0 - erf(x). .SH "CONFORMING TO" SVID 3, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR exp (3) diff --git a/man3/exec.3 b/man3/exec.3 deleted file mode 100644 index 8a90da03cb..0000000000 --- a/man3/exec.3 +++ /dev/null @@ -1,232 +0,0 @@ -.\" Copyright (c) 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)exec.3 6.4 (Berkeley) 4/19/91 -.\" -.\" Converted for Linux, Mon Nov 29 11:12:48 1993, faith@cs.unc.edu -.\" -.TH EXEC 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -execl, execlp, execle, exect, execv, execvp \- execute a file -.SH SYNOPSIS -.SH SYNOPSIS -.B #include <unistd.h> -.sp -.B extern char **environ; -.sp -.BI "int execl( const char *" path ", const char *" arg ", ...); -.br -.BI "int execlp( const char *" file ", const char *" arg ", ...); -.br -.BI "int execle( const char *" path ", const char *" arg -.BI ", ..., char * const " envp "[]);" -.br -.BI "int exect( const char *" path ", char *const " argv "[]);" -.br -.BI "int execv( const char *" path ", char *const " argv "[]);" -.br -.BI "int execvp( const char *" file ", char *const " argv "[]);" -.SH DESCRIPTION -The -.B exec -family of functions replaces the current process image with a new process -image. The functions described in this manual page are front-ends for the -function -.BR execve (2). -(See the manual page for -.B execve -for detailed information about the replacement of the current process.) -.PP -The initial argument for these functions is the pathname of a file which is -to be executed. -.PP -The -.I "const char *arg" -and subsequent ellipses in the -.BR execl , -.BR execlp , -and -.B execle -functions can be thought of as -.IR arg0 , -.IR arg1 , -\&..., -.IR argn . -Together they describe a list of one or more pointers to null-terminated -strings that represent the argument list available to the executed program. -The first argument, by convention, should point to the file name associated -with the file being executed. The list of arguments -.I must -be terminated by a -.B NULL -pointer. -.PP -The -.BR exect , -.BR execv , -and -.B execvp -functions provide an array of pointers to null-terminated strings that -represent the argument list available to the new program. The first -argument, by convention, should point to the file name associated with the -file begin executed. The array of pointers -.I must -be terminated by a -.B NULL -pointer. -.PP -The -.B execle -and -.B exect -functions also specify the environment of the executed process by following -the -.B NULL -pointer that terminates the list of arguments in the parameter list or the -pointer to the argv array with an additional parameter. This additional -parameter is an array of pointers to null-terminated strings and -.I must -be terminated by a -.B NULL -pointer. The other functions take the environment for the new process -image from the external variable -.I environ -in the current process. -.PP -Some of these functions have special semantics. -.PP -The functions -.B execlp -and -.B execvp -will duplicate the actions of the shell in searching for an executable file -if the specified file name does not contain a slash (/) character. The -search path is the path specified in the environment by the -.B PATH -variable. If this variable isn't specified, the default path -``/bin:/usr/bin:'' is used (is this true for Linux?). In addition, certain -errors are treated specially. -.PP -If permission is denied for a file (the attempted -.B execve -returned -.BR EACCES ), -these functions will continue searching the rest of the search path. If no -other file is found, however, they will return with the global variable -.I errno -set to -.BR EACCES . -.PP -If the header of a file isn't recognized (the attempted -.B execve -returned -.BR ENOEXEC ), -these functions will execute the shell with the path of the file as its -first argument. (If this attempt fails, no further searching is done.) -.PP -If the file is currently busy (the attempted -.B execve -returned -.BR ETXTBUSY ), -these functions will sleep for several seconds, periodically re-attempting -to execute the file. (Is this true for Linux?) -.PP -The function -.B exect -executes a file with the program tracing facilities enabled (see -.BR ptrace (2). -.SH "RETURN VALUES" -If any of the -.B exec -functions returns, an error will have occurred. The return value is \-1, -and the global variable -.I errno -will be set to indicate the error. -.SH FILES -.I /bin/sh -.SH ERRORS -.BR Execl , -.BR execle , -.BR execlp -and -.B execvp -may fail and set -.I errno -for any of the errors specified for the library functions -.BR execve (2) -and -.BR malloc (3). -.PP -.B Exect -and -.B execv -may fail and set -.I errno -for any of the errors specified for the library function -.BR execve (2). -.SH "SEE ALSO" -.BR sh "(1), " execve "(2), " fork "(2), " trace "(2), " environ "(7), " -.BR ptrace (2) -.SH COMPATIBILITY -Historically, the default path for the -.B execlp -and -.B execvp -functions was ``:/bin:/usr/bin''. This was changed to place the current -directory last to enhance system security. -.PP -The behavior of -.B execlp -and -.B execvp -when errors occur while attempting to execute the file is historic -practice, but has not traditionally been documented and is not specified by -the POSIX standard. -.PP -Traditionally, the functions -.B execlp -and -.B execvp -ignored all errors except for the ones described above and -.B ENOMEM -and -.BR E2BIG , -upon which they returned. They now return if any error other than the ones -described above occurs. -.SH STANDARDS -.BR Execl , -.BR execv , -.BR execle , -.B execlp -and -.B execvp -conform to -IEEE Std1003.1-88 (``POSIX''). diff --git a/man3/execl.3 b/man3/execl.3 deleted file mode 100644 index 4bf4872a68..0000000000 --- a/man3/execl.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/exec.3 diff --git a/man3/execle.3 b/man3/execle.3 deleted file mode 100644 index 4bf4872a68..0000000000 --- a/man3/execle.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/exec.3 diff --git a/man3/exect.3 b/man3/exect.3 deleted file mode 100644 index 4bf4872a68..0000000000 --- a/man3/exect.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/exec.3 diff --git a/man3/execv.3 b/man3/execv.3 deleted file mode 100644 index 4bf4872a68..0000000000 --- a/man3/execv.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/exec.3 diff --git a/man3/execvp.3 b/man3/execvp.3 deleted file mode 100644 index 4bf4872a68..0000000000 --- a/man3/execvp.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/exec.3 diff --git a/man3/exit.3 b/man3/exit.3 index 7559382399..612be5b4b2 100644 --- a/man3/exit.3 +++ b/man3/exit.3 @@ -24,5 +24,5 @@ closed. The \fBexit()\fP function does not return. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR _exit "(2), " atexit "(3), " on_exit (3) diff --git a/man3/exp.3 b/man3/exp.3 index 8d544d3600..af117d7338 100644 --- a/man3/exp.3 +++ b/man3/exp.3 @@ -46,5 +46,5 @@ The argument \fIx\fP is negative and \fIy\fP is not an integral value. This would result in a complex number. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR sqrt "(3), " cbrt (3) diff --git a/man3/fabs.3 b/man3/fabs.3 index ed1319cd17..c5f5301b2d 100644 --- a/man3/fabs.3 +++ b/man3/fabs.3 @@ -19,5 +19,5 @@ The \fBfabs()\fP function returns the absolute value of the floating-point number \fIx\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR abs "(3), " ceil "(3), " floor "(3), " labs "(3), " rint (3) diff --git a/man3/fclose.3 b/man3/fclose.3 deleted file mode 100644 index 81659bf1bb..0000000000 --- a/man3/fclose.3 +++ /dev/null @@ -1,82 +0,0 @@ -.\" Copyright (c) 1990, 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to Berkeley by -.\" Chris Torek and the American National Standards Committee X3, -.\" on Information Processing Systems. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)fclose.3 6.7 (Berkeley) 6/29/91 -.\" -.\" Converted for Linux, Mon Nov 29 15:19:14 1993, faith@cs.unc.edu -.\" -.TH FCLOSE 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -fclose \- close a stream -.SH SYNOPSIS -.B #include <stdio.h> -.sp -.BI "int fclose( FILE *" stream ); -.SH DESCRIPTION -The -.B fclose -function dissociates the named -.I stream -from its underlying file or set of functions. If the stream was being used -for output, any buffered data is written first, using -.BR fflush (3). -.SH "RETURN VALUES" -Upon successful completion 0 is returned. Otherwise, -.B EOF -is returned and the global variable -.I errno -is set to indicate the error. In either case no further access to the -stream is possible. -.SH ERRORS -.TP -.B EBADF -The argument -.I stream -is not an open stream. -.PP -The -.B fclose -function may also fail and set -.I errno -for any of the errors specified for the routines -.BR close (2) -or -.BR fflush (3). -.SH SEE ALSO -.BR close "(2), " fflush "(3), " fopen "(3), " setbuf (3) -.SH STANDARDS -The -.B fclose -function conforms to ANSI C3.159-1989 (``ANSI C''). diff --git a/man3/fdopen.3 b/man3/fdopen.3 deleted file mode 100644 index 9a4012491e..0000000000 --- a/man3/fdopen.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/fopen.3 diff --git a/man3/feof.3 b/man3/feof.3 deleted file mode 100644 index 196ef922de..0000000000 --- a/man3/feof.3 +++ /dev/null @@ -1 +0,0 @@ -man3/ferror.3 diff --git a/man3/ferror.3 b/man3/ferror.3 deleted file mode 100644 index fa0f6915cf..0000000000 --- a/man3/ferror.3 +++ /dev/null @@ -1,93 +0,0 @@ -.\" Copyright (c) 1990, 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to Berkeley by -.\" Chris Torek and the American National Standards Committee X3, -.\" on Information Processing Systems. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)ferror.3 6.8 (Berkeley) 6/29/91 -.\" -.\" -.\" Converted for Linux, Mon Nov 29 14:24:40 1993, faith@cs.unc.edu -.\" -.TH FERROR 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -clearerr, feof, ferror, fileno \- check and reset stream status -.SH SYNOPSIS -.B #include <stdio.h> -.sp -.BI "void clearerr( FILE *" stream ); -.br -.BI "int feof( FILE *" stream ); -.br -.BI "int ferror( FILE *" stream ); -.br -.BI "int fileno( FILE *" stream ); -.SH DESCRIPTION -The function -.B clearerr -clears the end-of-file and error indicators for the stream pointed to by -.IR stream . -.PP -The function -.B feof -tests the end-of-file indicator for the stream pointed to by -.IR stream , -returning non-zero if it is set. The end-of-file indicator can only be -cleared by the function -.BR clearerr . -.PP -The function -.B ferror -tests the error indicator for the stream pointed to by -.IR stream , -returning non-zero if it is set. The error indicator can only be reset by -the -.B clearerr -function. -.PP -The function -.B fileno -examines the argument -.I stream -and returns its integer desciptor. -.SH ERRORS -These functions should not fail and do not set the external variable -.IR errno . -.SH SEE ALSO -.BR open "(2), " stdio (3) -.SH STANDARDS -The functions -.BR clearerr , -.BR feof , -and -.BR ferror -conform to C3.159-1989 (``ANSI C''). diff --git a/man3/fflush.3 b/man3/fflush.3 deleted file mode 100644 index aec074dd1d..0000000000 --- a/man3/fflush.3 +++ /dev/null @@ -1,104 +0,0 @@ -.\" Copyright (c) 1990, 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to Berkeley by -.\" Chris Torek and the American National Standards Committee X3, -.\" on Information Processing Systems. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)fflush.3 5.4 (Berkeley) 6/29/91 -.\" -.\" Converted for Linux, Mon Nov 29 15:22:01 1993, faith@cs.unc.edu -.\" -.TH FFLUSH 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -fflush, fpurge \- flush a stream -.SH SYNOPSIS -.B #include <stdio.h> -.sp -.BI "int fflush( FILE *" stream ); -.br -.BI "int fpurge( FILE *" stream ); -.SH DESCRIPTION -The function -.B fflush -forces a write of all buffered data for the given output or update -.I stream -via the stream's underlying write function. The open status of the stream -is unaffected. -.PP -If the -.I stream -argument is -.BR NULL , -.B fflush -flushes -.I all -open output streams. (Does this happen under Linux?) -.PP -The function -.B fpurge -erases any input or output buffered in the given -.IR stream . -For output streams this discards any unwritten output. For input streams -this discards any input read from the underlying object but not yet -obtained via -.BR getc (3); -this includes any text pushed back via -.BR ungetc . -.SH "RETURN VALUES" -Upon successful completion 0 is returned. Otherwise, -.B EOF -is returned and the global variable -.I errno -is set to indicate the error. -.SH ERRORS -.TP -.B EBADF -.I Stream -is not an open stream, or, in the case of -.BR fflush , -not a stream open for writing. -.PP -The function -.B fflush -may also fail and set -.I errno -for any of the errors specified for the routine -.BR write (2). -.SH BUGS -Linux may not support -.BR fpurge . -.SH "SEE ALSO" -.BR write "(2), " fopen "(3), " fclose "(3), " setbuf (3) -.SH STANDARDS -The -.B fflush -function conforms to ANSI C3.159-1989 (``ANSI C''). diff --git a/man3/fgetgrent.3 b/man3/fgetgrent.3 index 05eaf9d745..c4e4f59bb8 100644 --- a/man3/fgetgrent.3 +++ b/man3/fgetgrent.3 @@ -45,6 +45,6 @@ or NULL if there are no more entries or an error occurs. Insufficient memory to allocate group information structure. .SH "CONFORMING TO" SVID 3 -.SH "SEE ALSO" +.SH SEE ALSO .BR getgrnam "(3), " getgrgid "(3), " getgrent (3), .BR setgrent "(3), " endgrent (3) diff --git a/man3/fgetpos.3 b/man3/fgetpos.3 deleted file mode 100644 index a1487b5a8c..0000000000 --- a/man3/fgetpos.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/fseek.3 diff --git a/man3/fgetpwent.3 b/man3/fgetpwent.3 index 1a59ef4851..c431737669 100644 --- a/man3/fgetpwent.3 +++ b/man3/fgetpwent.3 @@ -49,6 +49,6 @@ there are no more entries or an error occurs. Insufficient memory to allocate passwd structure. .SH "CONFORMING TO" SVID 3 -.SH "SEE ALSO" +.SH SEE ALSO .BR getpwnam "(3), " getpwuid "(3), " getpwent "(3), " setpwent (3), .BR endpwent "(3), " getpw "(3), " putpwent (3) diff --git a/man3/fileno.3 b/man3/fileno.3 deleted file mode 100644 index 196ef922de..0000000000 --- a/man3/fileno.3 +++ /dev/null @@ -1 +0,0 @@ -man3/ferror.3 diff --git a/man3/floor.3 b/man3/floor.3 index b818e0a5c1..93f003a90d 100644 --- a/man3/floor.3 +++ b/man3/floor.3 @@ -19,5 +19,5 @@ The \fBfloor()\fP function rounds \fIx\fP downwards to the nearest integer, returning that value as a double. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR abs "(3), " fabs "(3), " ceil "(3), " rint (3) diff --git a/man3/fmod.3 b/man3/fmod.3 index 0be7e3dd08..6cafed5cff 100644 --- a/man3/fmod.3 +++ b/man3/fmod.3 @@ -27,5 +27,5 @@ when the function fails and \fIerrno\fP is set. The denominator \fIy\fP is zero. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR drem (3) diff --git a/man3/fnmatch.3 b/man3/fnmatch.3 index 48abcbc0eb..a14864ebb3 100644 --- a/man3/fnmatch.3 +++ b/man3/fnmatch.3 @@ -58,5 +58,5 @@ proposed POSIX.2 .SH BUGS POSIX.2 is not yet an approved standard; the information in this manpage is subject to change. -.SH "SEE ALSO" +.SH SEE ALSO .BR sh "(1), " glob "(3), " glob (7) diff --git a/man3/fopen.3 b/man3/fopen.3 deleted file mode 100644 index 39938d08de..0000000000 --- a/man3/fopen.3 +++ /dev/null @@ -1,198 +0,0 @@ -.\" Copyright (c) 1990, 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to Berkeley by -.\" Chris Torek and the American National Standards Committee X3, -.\" on Information Processing Systems. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)fopen.3 6.8 (Berkeley) 6/29/91 -.\" -.\" Converted for Linux, Mon Nov 29 15:22:01 1993, faith@cs.unc.edu -.\" -.TH FOPEN 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -fopen, fdopen, freopen \- stream open functions -.SH SYNOPSIS -.B #include <stdio.h> -.sp -.BI "FILE *fopen( char *" path ", char *" mode ); -.br -.BI "FILE *fdopen( int " fildes ", char *" mode ); -.br -.BI "FILE *freopen( char *" path ", char *" mode ", FILE *" stream ); -.SH DESCRIPTION -The -.B fopen -function opens the file whose name is the string pointed to by -.I path -and associates a stream with it. -.PP -The argument -.I mode -points to a string beginning with one of the following sequences -(Additional characters may follow these sequences.): -.TP -.B r -Open text file for reading. The stream is positioned at the beginning of -the file. -.TP -.B r+ -Open for reading and writing. The stream is positioned at the beginning of -the file. -.TP -.B w -Truncate file to zero length or create text file for writing. The stream -is positioned at the beginning of the file. -.TP -.B w+ -Open for reading and writing. The file is created if it does not exist, -otherwise it is truncated. The stream is positioned at the beginning of -the file. -.TP -.B a -Open for writing. The file is created if it does not exist. The stream is -positioned at the end of the file. -.TP -.B a+ -Open for reading and writing. The file is created if it does not exist. -The stream is positioned at the end of the file. -.PP -The -.I mode -string can also include the letter ``b'' either as a third character or as -a character between the characters in any of the two-character strings -described above. This is strictly for compatibility with ANSI C3.159-1989 -(``ANSI C'') and has no effect; the ``b'' is ignored. Linux may not behave -this way. -.PP -Any created files will have mode -.BR S_IRUSR \&| S_IWUSR \&| S_IRGRP \&| S_IWGRP \&| S_IROTH \&| S_IWOTH -(0666), as modified by the process' umask value (see -.BR umask (2). -.PP -Reads and writes may be intermixed on read/write streams in any order, and -do not require an intermediate seek as in previous versions of -.IR stdio . -This is not portable to other systems, however, and may not work under -Linux (someone should find out and fix this manpage); ANSI C requires that -a file positioning function intervene between output and input, unless an -input operation encounters end-of-file. -.PP -The -.B fdopen -function associates a stream with the existing file descriptor, -.IR fildes . -The -.I mode -of the stream must be compatible with the mode of the file descriptor. -.PP -The -.B freopen -function opens the file whose name is the string pointed to by -.I path -and associates the stream pointed to by -.I stream -with it. The original stream (if it exists) is closed. The -.I mode -argument is used just as in the -.B fopen -function. The primary use of the -.B freopen -function is to change the file associated with a standard text stream -.IR "" ( stderr ", " stdin ", or " stdout ). -.SH "RETURN VALUES" -Upon successful completion -.BR fopen , -.B fdopen -and -.B freopen -return a -.B FILE -pointer. Otherwise, -.B NULL -is returned and the global variable -.I errno -is set to indicate the error. -.SH ERRORS -.TP -.B EINVAL -The -.I mode -provided to -.BR fopen , -.BR fdopen , -or -.B freopen -was invalid. -.PP -The -.BR fopen , -.B fdopen -and -.B freopen -functions may also fail and set -.I errno -for any of the errors specified for the routine -.BR malloc (3). -.PP -The -.B fopen -function may also fail and set -.I errno -for any of the errors specified for the routine -.BR open (2). -.PP -The -.B fdopen -function may also fail and set -.I errno -for any of the errors specified for the routine -.BR fcntl (2). -.PP -The -.B freopen -function may also fail and set -.I errno -for any of the errors specified for the routines -.BR open (2), -.BR fclose (3) -and -.BR fflush (3). -.SH "SEE ALSO" -.BR open "(2), " fclose (3) -.SH STANDARDS -The -.B fopen -and -.B freopen -functions conform to ANSI C3.159-1989 (``ANSI C''). The -.B fdopen -function conforms to IEEE Std1003.1-1988 (``POSIX''). diff --git a/man3/fpathconf.3 b/man3/fpathconf.3 index 8d432c02c5..69a985d04b 100644 --- a/man3/fpathconf.3 +++ b/man3/fpathconf.3 @@ -131,5 +131,5 @@ may exist in the given directory. .PP Some returned vaules may be huge; they are not suitable for allocating memory. -.SH "SEE ALSO" +.SH SEE ALSO .BR getconf "(1), " statfs "(2), " open "(2), " sysconf (3) diff --git a/man3/fprintf.3 b/man3/fprintf.3 deleted file mode 100644 index 975530d90a..0000000000 --- a/man3/fprintf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/printf.3 diff --git a/man3/fpurge.3 b/man3/fpurge.3 deleted file mode 100644 index 06ded25c9d..0000000000 --- a/man3/fpurge.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/fflush.3 diff --git a/man3/fread.3 b/man3/fread.3 deleted file mode 100644 index 4027135368..0000000000 --- a/man3/fread.3 +++ /dev/null @@ -1,97 +0,0 @@ -.\" Copyright (c) 1990, 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to Berkeley by -.\" Chris Torek and the American National Standards Committee X3, -.\" on Information Processing Systems. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)fread.3 6.6 (Berkeley) 6/29/91 -.\" -.\" Converted for Linux, Mon Nov 29 15:37:33 1993, faith@cs.unc.edu -.\" -.TH FREAD 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -fread, fwrite \- binary stream input/output -.SH SYNOPSIS -.B #include <stdio.h> -.sp -.BI "int fread( void *" ptr ", size_t " size ", size_t " nmemb , -.BI "FILE *" stream ); -.sp -.BI "int fwrite( void *" ptr ", size_t " size ", size_t " nmemb , -.BI "FILE *" stream ); -.SH DESCRIPTION -The function -.B fread -reads -.I nmemb -elements of data, each -.I size -bytes long, from the stream pointed to by -.IR stream , -storing them at the location given by -.IR ptr . -.PP -The function -.B fwrite -writes -.I nmemb -elements of data, each -.I size -bytes long, to the stream pointed to by -.IR stream , -obtaining them from the location given by -.IR ptr . -.SH "RETURN VALUES" -The functions -.B fread -and -.B fwrite -advance the file position indicator for the stream by the number of -characters successfully read or written and return that number. If an -error occurs, or the end-of-file is reached, the return value is a short -character count (or zero). -.PP -The function -.B fread -does not distinguish between end-of-file and error, and callers must use -.BR feof (3) -and -.BR ferror (3) -to determine which occurred. -.SH "SEE ALSO" -.BR read "(2), " write (2) -.SH STANDARDS -The functions -.B fread -and -.B fwrite -conform to ANSI C3.159-1989 (``ANSI C''). diff --git a/man3/freopen.3 b/man3/freopen.3 deleted file mode 100644 index 9a4012491e..0000000000 --- a/man3/freopen.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/fopen.3 diff --git a/man3/frexp.3 b/man3/frexp.3 index 349d36d32f..e04abab60c 100644 --- a/man3/frexp.3 +++ b/man3/frexp.3 @@ -26,5 +26,5 @@ times a power of two, and is always in the range 1/2 (inclusive) to zero and zero is stored in \fIexp\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR ldexp "(3), " modf (3) diff --git a/man3/fscanf.3 b/man3/fscanf.3 deleted file mode 100644 index 9fd424bb27..0000000000 --- a/man3/fscanf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/scanf.3 diff --git a/man3/fseek.3 b/man3/fseek.3 deleted file mode 100644 index ca1f54902d..0000000000 --- a/man3/fseek.3 +++ /dev/null @@ -1,169 +0,0 @@ -.\" Copyright (c) 1990, 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to Berkeley by -.\" Chris Torek and the American National Standards Committee X3, -.\" on Information Processing Systems. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)fseek.3 6.11 (Berkeley) 6/29/91 -.\" -.\" Converted for Linux, Mon Nov 29 15:22:01 1993, faith@cs.unc.edu -.\" -.TH FSEEK 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -fgetpos, fseek, fsetpos, ftell, rewind \- reposition a stream -.SH SYNOPSIS -.B #include <stdio.h> -.sp -.BI "int fseek( FILE *" stream ", long " offset ", int" whence ); -.br -.BI "long ftell( FILE *" stream ); -.br -.BI "void rewind( FILE *" stream ); -.br -.BI "int fgetpos( FILE *" stream ", fpos_t *" pos ); -.br -.BI "int fsetpos( FILE *" stream ", fpos_t *" pos ); -.SH DESCRIPTION -The -.B fseek -function sets the file position indicator for the stream pointed to by -.IR stream . -The new position, measured in bytes, is obtained by adding -.I offset -bytes to the position specified by -.IR whence . -If -.I whence -is set to -.BR SEEK_SET , -.BR SEEK_CUR , -or -.BR SEEK_END , -the offset is relative to the start of the file, the current position -indicator, or end-of-file, respectively. A successful call to the -.B fseek -function clears the end-of-file indicator for the stream and undoes -any effects of the -.BR ungetc (3) -function on the same stream. -.PP -The -.B ftell -function obtains the current value of the file position indicator for the -stream pointed to by -.IR stream . -.PP -The -.B rewind -function sets the file position indicator for the stream pointed to by -.I stream -to the beginning of the file. It is equivalent to: -.PP -.RS -(void)fseek(stream, 0L, SEEK_SET) -.RE -.PP -except that the error indicator for the stream is also cleared (see -.BR clearerr (3). -.PP -The -.B fgetpos -and -.B fsetpos -functions are alternate interfaces equivalent to -.B ftell -and -.B fseek -(with whence set to -.BR SEEK_SET ), -setting and storing the current value of the file offset into or from the -object referenced by -.IR pos . -On some non-UNIX systems an -.B fpos_t -object may be a complex object and these routines may be the only way to -portably reposition a text stream. -.SH "RETURN VALUES" -The -.B rewind -function returns no value. Upon successful completion, -.BR fgetpos , -.BR fseek , -.B fsetpos -return 0, -and -.B ftell -returns the current offset. Otherwise, \-1 is returned and the global -variable errno is set to indicate the error. -.SH ERRORS -.TP -.B EBADF -The -.I stream -specified is not a seekable stream. -.TP -.B EINVAL -The -.I whence -argument to -.B fseek -was not -.BR SEEK_SET , -.BR SEEK_END , -or -.BR SEEK_CUR . -.PP -The function -.BR fgetpos , -.BR fseek , -.BR fsetpos , -and -.B ftell -may also fail and set -.I errno -for any of the errors specified for the routines -.BR fflush (3), -.BR fstat (2), -.BR lseek (2), -and -.BR malloc (3). -.SH "SEE ALSO" -.BR lseek (2) -.SH STANDARDS -The -.BR fgetpos , -.BR fsetpos , -.BR fseek , -.BR ftell , -and -.BR rewind -functions conform to ANSI C3.159-1989 (``ANSI C''). diff --git a/man3/fsetpos.3 b/man3/fsetpos.3 deleted file mode 100644 index a1487b5a8c..0000000000 --- a/man3/fsetpos.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/fseek.3 diff --git a/man3/ftell.3 b/man3/ftell.3 deleted file mode 100644 index a1487b5a8c..0000000000 --- a/man3/ftell.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/fseek.3 diff --git a/man3/ftok.3 b/man3/ftok.3 deleted file mode 100644 index b16dfe7da1..0000000000 --- a/man3/ftok.3 +++ /dev/null @@ -1,63 +0,0 @@ -.\" Copyright 1993 Giorgio Ciucci (giorgio@crcc.it) -.\" May be distributed under the GNU General Public License. -.TH FTOK 3 "November 1, 1993" "Linux 0.99.13" "Linux Programmer's Manual" -.SH NAME -ftok \- convert a pathname and a project identifier to a System V IPC key -.SH SYNOPSIS -.nf -.B -# include <sys/types.h> -.B -# include <sys/ipc.h> -.fi -.sp -.BI "key_t ftok ( char *" pathname , -.BI "char " proj " )" -.SH DESCRIPTION -The function converts the pathname of an existing accessible -file and a project identifier into a -.B key_t -type System V IPC key. -.SH "RETURN VALUE" -On success the return value will be the converted -.B key_t -value, -otherwise -.B \-1 -with -.B errno -indicating the error as for the -.BR stat (2) -system call. -.SH BUGS -The generated -.B key_t -value is obtained -.BR stat \-ing -the disk file correspondig to -.I pathname -in order to get its i\-node number and the minor device number of the -filesystem on which the disk file resides, -then by combining the 8 bit -.I proj -value along with the the lower 16 bits of the i\-node number, -along with the 8 bits of the minor device number. -The algorithm does not guarantee a unique key value. -In fact -.IP \(bu -Two different names linking to the same file produce same -key values. -.IP \(bu -Using the lower 16 bits of the i\-node number, gives some -chance (also usually small) to have same key values for file names -referring to different i\-nodes. -.IP \(bu -Not discriminating among major device numbers, -gives some chance of collision (also usually small) for -systems with multiple disk controllers. -.SH "SEE ALSO" -.BR ipc (5), -.BR msgget (2), -.BR semget (2), -.BR shmget (2), -.BR stat (2). diff --git a/man3/fwrite.3 b/man3/fwrite.3 deleted file mode 100644 index 86906ede50..0000000000 --- a/man3/fwrite.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/fread.3 diff --git a/man3/gcvt.3 b/man3/gcvt.3 index 7f477adb87..d52ca95280 100644 --- a/man3/gcvt.3 +++ b/man3/gcvt.3 @@ -21,5 +21,5 @@ terminated ASCII string and stores the result in \fIbuf\fP. It produces .SH "RETURN VALUE" The \fBgcvt()\fP function returns the address of the string pointed to by \fIbuf\fP. -.SH "SEE ALSO" +.SH SEE ALSO .BR ecvt "(3), " fcvt "(3), " sprintf (3) diff --git a/man3/getcwd.3 b/man3/getcwd.3 index 647a7ab491..15f2cca137 100644 --- a/man3/getcwd.3 +++ b/man3/getcwd.3 @@ -80,5 +80,5 @@ set accordingly, and on success. .SH "CONFORMS TO" POSIX.1 -.SH "SEE ALSO" +.SH SEE ALSO .BR chdir "(2), ", free "(3), " malloc (3) diff --git a/man3/getdirentries.3 b/man3/getdirentries.3 index 3fd309245b..9154c629fa 100644 --- a/man3/getdirentries.3 +++ b/man3/getdirentries.3 @@ -31,10 +31,10 @@ is updated with the new position after reading. .SH "RETURN VALUE" .B getdirentries returns the number of bytes read or zero when at the end of the directory. -If an error occurs, \-1 is returned, and +If an error occurs, -1 is returned, and .I errno is set appropriately. .SH ERRORS See the Linux library source code for details. -.SH "SEE ALSO" +.SH SEE ALSO .BR open "(2), " lseek (2) diff --git a/man3/getenv.3 b/man3/getenv.3 index 71ec2bcbf7..9ea2733b3b 100644 --- a/man3/getenv.3 +++ b/man3/getenv.3 @@ -23,5 +23,5 @@ The \fBgetenv()\fP function returns a pointer to the value in the environment, or NULL if there is no match. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR putenv "(3), " setenv "(3), " unsetenv (3) diff --git a/man3/getgrent.3 b/man3/getgrent.3 index f20b10756f..f8d577b41c 100644 --- a/man3/getgrent.3 +++ b/man3/getgrent.3 @@ -56,5 +56,5 @@ Insufficient memory to allocate group information structure. .fi .SH "CONFORMING TO" SVID 3, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR fgetgrent "(3), " getgrnam "(3), " getgrgid (3) diff --git a/man3/getgrnam.3 b/man3/getgrnam.3 index e431506830..df1ff9afeb 100644 --- a/man3/getgrnam.3 +++ b/man3/getgrnam.3 @@ -54,5 +54,5 @@ Insufficient memory to allocate group information structure. .fi .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR fgetgrent "(3), " getgrent "(3), " setgrent "(3), " endgrent (3) diff --git a/man3/gethostbyname.3 b/man3/gethostbyname.3 index 2ad96f5ab7..d2ce471d2d 100644 --- a/man3/gethostbyname.3 +++ b/man3/gethostbyname.3 @@ -120,5 +120,5 @@ later. .fi .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR resolver "(3), " hosts "(5), " hostname "(7), " resolv+ " (8), " named (8) diff --git a/man3/getmntent.3 b/man3/getmntent.3 index cea8a721c3..0337c62098 100644 --- a/man3/getmntent.3 +++ b/man3/getmntent.3 @@ -85,5 +85,5 @@ a match is found and NULL otherwise. .fi .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR fopen "(3), " fstab (5) diff --git a/man3/getnetent.3 b/man3/getnetent.3 index b45548ebbc..210f018403 100644 --- a/man3/getnetent.3 +++ b/man3/getnetent.3 @@ -81,5 +81,5 @@ error occurs or the end of the file is reached. /etc/networks networks database file .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR getprotoent "(3), " getservent "(3), " networks (5) diff --git a/man3/getopt.3 b/man3/getopt.3 index 1742188bb3..c3ba2f3639 100644 --- a/man3/getopt.3 +++ b/man3/getopt.3 @@ -105,7 +105,7 @@ The .B getopt() function returns the option character if the option was found successfully, ':' if there was a missing parameter for one of the -options, '?' for an unknown option character and \-1 for the end of the +options, '?' for an unknown option character and -1 for the end of the option list. .SH "EXAMPLE" The following example program, from the source code, illustrates the diff --git a/man3/getpass.3 b/man3/getpass.3 deleted file mode 100644 index 9aa699ae6f..0000000000 --- a/man3/getpass.3 +++ /dev/null @@ -1,82 +0,0 @@ -.\" Copyright (c) 1989, 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)getpass.3 6.5 (Berkeley) 5/21/91 -.\" -.\" Converted for Linux, Mon Nov 29 14:41:51 1993, faith@cs.unc.edu -.\" -.TH PRINTF 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -getpass \- get a password -.SH SYNOPSIS -.B #include <pwd.h> -.br -..B #include <unistd.h> -.sp -.B "char *getpass( const char *" prompt ); -.SH DESCRIPTION -The -.B getpass -function displays a prompt to, and reads in a password from, -.IR /dev/tty . -If this file is not accessible, -.B getpass -displays the prompt on the standard error output and reads from the -standard input. -.PP -The password may be up to _PASSWORD_LEN (currently 128) characters in -length. Any additional characters and the terminating newline character -are discarded. (This may be different in Linux.) -.PP -.B Getpass -turns off character echoing while reading the password. -.PP -.SH "RETURN VALUES" -.B Getpass -returns a pointer to the null terminated password. -.SH FILES -.I /dev/tty -.SH "SEE ALSO" -.BR crypt (3) -.SH HISTORY -A -.B getpass -function appeared in Version 7 AT&T UNIX. -.SH BUGS -The -.B getpass -function leaves its result in an internal static object and returns a -pointer to that object. Subsequent calls to -.B getpass -will modify the same object. -.PP -The calling process should zero the password as soon as possible to avoid -leaving the cleartext password visible in the process's address space. diff --git a/man3/getprotoent.3 b/man3/getprotoent.3 index b92d7cac59..b9e1dabb6d 100644 --- a/man3/getprotoent.3 +++ b/man3/getprotoent.3 @@ -78,5 +78,5 @@ error occurs or the end of the file is reached. .fi .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR getservent "(3), " getnetent "(3), " protocols (5) diff --git a/man3/getpw.3 b/man3/getpw.3 index 7fbd56799c..9e23f7b240 100644 --- a/man3/getpw.3 +++ b/man3/getpw.3 @@ -42,7 +42,7 @@ struct passwd { .fi .RE .SH "RETURN VALUE" -The \fBgetpw()\fP function returns 0 on success, or \-1 if an error +The \fBgetpw()\fP function returns 0 on success, or -1 if an error occurs. .SH ERRORS .TP @@ -52,6 +52,6 @@ Insufficient memory to allocate passwd structure. .nf /etc/passwd password database file .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR fgetpwent "(3), " getpwent "(3), " setpwent "(3), " endpwent (3), .BR getpwnam "(3), " getpwuid "(3), " putpwent (3) diff --git a/man3/getpwent.3 b/man3/getpwent.3 index b3a873fcec..bed499522f 100644 --- a/man3/getpwent.3 +++ b/man3/getpwent.3 @@ -60,6 +60,6 @@ Insufficient memory to allocate passwd structure. .fi .SH "CONFORMING TO" SVID 3, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR fgetpwent "(3), " getpwnam "(3), " getpwuid "(3), " getpw (3), .BR putpwent (3) diff --git a/man3/getpwnam.3 b/man3/getpwnam.3 index 048e85aa2c..4ecf395407 100644 --- a/man3/getpwnam.3 +++ b/man3/getpwnam.3 @@ -56,6 +56,6 @@ Insufficient memory to allocate passwd structure. .fi .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR fgetpwent "(3), " getpwent "(3), " setpwent "(3), " endpwent (3), .BR getpw "(3), " putpwent (3) diff --git a/man3/gets.3 b/man3/gets.3 index e149355545..f18c812239 100644 --- a/man3/gets.3 +++ b/man3/gets.3 @@ -125,6 +125,6 @@ library with low - level calls to .B read() for the file descriptor associated with the input stream; the results will be undefined and very probably not what you want. -.SH "SEE ALSO" +.SH SEE ALSO .BR read "(2), " write "(2), " fopen "(3), " fread (3), .BR scanf "(3), " puts "(3), " fseek "(3), " ferror (3) diff --git a/man3/getservent.3 b/man3/getservent.3 index 19ae01f363..6fd6c10d5a 100644 --- a/man3/getservent.3 +++ b/man3/getservent.3 @@ -81,5 +81,5 @@ error occurs or the end of the file is reached. /etc/services services database file .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR getprotoent "(3), " getnetent "(3), " services (5) diff --git a/man3/getusershell.3 b/man3/getusershell.3 index 16adb62edc..5d43d8059c 100644 --- a/man3/getusershell.3 +++ b/man3/getusershell.3 @@ -36,5 +36,5 @@ The \fBgetusershell()\fP function returns a NULL pointer on end-of-file. .fi .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR shells (5) diff --git a/man3/glob.3 b/man3/glob.3 index c3f19a923c..93777bbb1a 100644 --- a/man3/glob.3 +++ b/man3/glob.3 @@ -174,6 +174,6 @@ These will store their error code in .PP POSIX.2 is not yet an approved standard; the information in this manpage is subject to change. -.SH "SEE ALSO" +.SH SEE ALSO .BR ls "(1), " sh "(1), " exec "(2), " stat "(2), " malloc (3), .BR opendir "(3), " readdir "(3), " wordexp "(3), " glob (7) diff --git a/man3/hypot.3 b/man3/hypot.3 index f3f56eb3e2..d17aae18ac 100644 --- a/man3/hypot.3 +++ b/man3/hypot.3 @@ -19,5 +19,5 @@ The \fBhypot()\fP function returns the sqrt(x*x + y*y). This is the length of the hypotenuse of a right-angle triangle with sides of length \fIx\fP and \fIy\fP, or the distance of the point (x, y) from the origin. .SH "CONFORMING TO" SVID 3, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR sqrt (3) diff --git a/man3/index.3 b/man3/index.3 index 2c4125bedc..6fc4a0f17c 100644 --- a/man3/index.3 +++ b/man3/index.3 @@ -31,6 +31,6 @@ The \fBindex()\fP and \fBrindex()\fP functions return a pointer to the matched character or NULL if the character is not found. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR memchr "(3), " strchr "(3), " strpbrk "(3), " strrchr (3), .BR strsep "(3), " strspn "(3), " strstr "(3), " strtok (3) diff --git a/man3/inet.3 b/man3/inet.3 index a253b4115b..033977a0d0 100644 --- a/man3/inet.3 +++ b/man3/inet.3 @@ -30,11 +30,11 @@ inet_netof \- Internet address manipulation routines .SH DESCRIPTION The \fBinet_addr()\fP function converts the Internet host address \fIcp\fP from numbers-and-dots notation into binary data in network -byte order. If the input is invalid, \-1 is returned. +byte order. If the input is invalid, -1 is returned. .PP The \fBinet_network()\fP function extracts the network number in network byte order from the address \fIcp\fP in numbers-and-dots -notation. If the input is invalid, \-1 is returned. +notation. If the input is invalid, -1 is returned. .PP The \fBinet_ntoa()\fP function converts the Internet host address \fIin\fP given in network byte order to a string in standard @@ -74,5 +74,5 @@ first, whereas the network byte order, as used on the Internet, is Most Significant Byte first. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR gethostbyname "(3), " getnetent "(3), " hosts "(5), " networks (5) diff --git a/man3/initgroups.3 b/man3/initgroups.3 index 3a9a3f4934..20e14672c5 100644 --- a/man3/initgroups.3 +++ b/man3/initgroups.3 @@ -21,7 +21,7 @@ reading the group database \fI/etc/group\fP and using all groups of which \fIuser\fP is a member. The additional group \fIgroup\fP is also added to the list. .SH "RETURN VALUE" -The \fBinitgroups()\fP function returns 0 on success, or \-1 if an error +The \fBinitgroups()\fP function returns 0 on success, or -1 if an error occurs. .SH "ERRORS" .TP @@ -36,5 +36,5 @@ Insufficient memory to allocate group information structure. .fi .SH "CONFORMING TO" SVID 3, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR getgroups "(2), " setgroups (2) diff --git a/man3/isinf.3 b/man3/isinf.3 index 58235420ee..b0e2b7146d 100644 --- a/man3/isinf.3 +++ b/man3/isinf.3 @@ -19,7 +19,7 @@ isinf, isnan, finite \- test for infinity or not-a-number (NaN) .BI "int finite(double " value ); .fi .SH DESCRIPTION -The \fBisinf()\fP function returns \-1 if \fIvalue\fP represents negative +The \fBisinf()\fP function returns -1 if \fIvalue\fP represents negative infinity, 1 if \fIvalue\fP represents positive infinity, and 0 otherwise. .PP The \fBisnan()\fP function returns a non-zero value if \fIvalue\fP is @@ -35,9 +35,9 @@ returns the Bessel function of \fIx\fP of the second kind of order \fIn\fP. .PP For the functions \fBy0()\fP, \fBy1()\fP and \fByn()\fP, the value of \fIx\fP must be positive. For negative values of \fIx\fP, these functions return -\-HUGE_VAL. +-HUGE_VAL. .SH "CONFORMING TO" SVID 3, BSD 4.3 .SH BUGS -There are errors of up to 2e\-16 in the values returned by \fBj0()\fP, -\fBj1()\fP and \fBjn()\fP for values of \fIx\fP between \-8 and 8. +There are errors of up to 2e-16 in the values returned by \fBj0()\fP, +\fBj1()\fP and \fBjn()\fP for values of \fIx\fP between -8 and 8. diff --git a/man3/jrand48.3 b/man3/jrand48.3 index 3133f7d62c..8d2bfcd5de 100644 --- a/man3/jrand48.3 +++ b/man3/jrand48.3 @@ -1 +1 @@ -.so man3/drand48.3 +.so man3/drand48.3
\ No newline at end of file diff --git a/man3/killpg.3 b/man3/killpg.3 index 138247dd62..a394c49d9d 100644 --- a/man3/killpg.3 +++ b/man3/killpg.3 @@ -46,5 +46,5 @@ process the signal ist sent to, and the userid is not that of the superuser. .SH "CONFORMS TO" ??? -.SH "SEE ALSO" +.SH SEE ALSO .BR kill "(2), " signal "(2), " signal (7) diff --git a/man3/labs.3 b/man3/labs.3 index 5bbeeeee69..51399fce8f 100644 --- a/man3/labs.3 +++ b/man3/labs.3 @@ -26,5 +26,5 @@ SVID 3, BSD 4.3, ISO 9899 .SH NOTES Trying to take the absolute value of the most negative integer is not defined. -.SH "SEE ALSO" +.SH SEE ALSO .BR abs "(3), " ceil "(3), " floor "(3), " fabs "(3), " rint (3) diff --git a/man3/lcong48.3 b/man3/lcong48.3 index 3133f7d62c..8d2bfcd5de 100644 --- a/man3/lcong48.3 +++ b/man3/lcong48.3 @@ -1 +1 @@ -.so man3/drand48.3 +.so man3/drand48.3
\ No newline at end of file diff --git a/man3/ldexp.3 b/man3/ldexp.3 index 971d1101a4..795dccae6c 100644 --- a/man3/ldexp.3 +++ b/man3/ldexp.3 @@ -19,5 +19,5 @@ The \fBldexp()\fP function returns the result of multiplying the floating-point number \fIx\fP by 2 raised to the power \fIexp\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR frexp "(3), " modf (3) diff --git a/man3/ldiv.3 b/man3/ldiv.3 index 54fec47154..0ddfd11f68 100644 --- a/man3/ldiv.3 +++ b/man3/ldiv.3 @@ -23,5 +23,5 @@ contains two long integer members named \fIquot\fP and \fIrem\fP. The \fIldiv_t\fP structure. .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR div (3) diff --git a/man3/lgamma.3 b/man3/lgamma.3 index 94751c0b1c..9c0e8e73cd 100644 --- a/man3/lgamma.3 +++ b/man3/lgamma.3 @@ -27,5 +27,5 @@ and \fIerrno\fP is set to ERANGE. Invalid argument - negative integer value of \fIx\fP. .SH "CONFORMING TO" SVID 3, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR infnan (3) diff --git a/man3/localeconv.3 b/man3/localeconv.3 index f593b9fd8f..9a2816927a 100644 --- a/man3/localeconv.3 +++ b/man3/localeconv.3 @@ -30,6 +30,6 @@ Support for other locales will be there Real Soon Now. The .B printf() family of functions may or may not honour the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR locale "(1), " localedef "(1), " strcoll "(3), " isalpha (3), .BR setlocale "(3), " strftime "(3), " locale (7) diff --git a/man3/lrand48.3 b/man3/lrand48.3 index 3133f7d62c..8d2bfcd5de 100644 --- a/man3/lrand48.3 +++ b/man3/lrand48.3 @@ -1 +1 @@ -.so man3/drand48.3 +.so man3/drand48.3
\ No newline at end of file diff --git a/man3/malloc.3 b/man3/malloc.3 index b0b8fed840..84255bf4bf 100644 --- a/man3/malloc.3 +++ b/man3/malloc.3 @@ -92,5 +92,5 @@ or if the request fails or if size was equal to 0. .SH "CONFORMS TO" ANSI - C -.SH "SEE ALSO" +.SH SEE ALSO .BR brk (2) diff --git a/man3/mblen.3 b/man3/mblen.3 index 39fa80cb4c..ce1889816a 100644 --- a/man3/mblen.3 +++ b/man3/mblen.3 @@ -26,9 +26,9 @@ mbtowc((wchat_t *)0, s, n); except that the shift state of the \fBmbtowc()\fP function is not affected. .SH "RETURN VALUE" -The \fBmblen()\fP returns the number of bytes in a character or \-1 if +The \fBmblen()\fP returns the number of bytes in a character or -1 if the character is invalid or 0 if \fIs\fP is a NULL string. .SH "CONFORMING TO" SVID 3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR mbstowcs "(3), " mbtowc "(3), " wcstombs "(3), " wctomb (3) diff --git a/man3/mbstowcs.3 b/man3/mbstowcs.3 index 2df5e3cc02..83144d69ba 100644 --- a/man3/mbstowcs.3 +++ b/man3/mbstowcs.3 @@ -19,9 +19,9 @@ The \fBmbstowcs()\fP function converts a sequence of multibyte characters from the array \fIs\fP into a sequence of wide characters and stores up to \fIn\fP wide characters in the array \fIpwcs\fP. .SH "RETURN VALUE" -\fBmbstowcs()\fP returns the number of wide characters stored or \-1 if +\fBmbstowcs()\fP returns the number of wide characters stored or -1 if \fIs\fP contains an invalid multibyte character. .SH "CONFORMING TO" SVID 3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR mblen "(3), " mbtowc "(3), " wcstombs "(3), " wctomb (3) diff --git a/man3/mbtowc.3 b/man3/mbtowc.3 index 08db293546..64144618a6 100644 --- a/man3/mbtowc.3 +++ b/man3/mbtowc.3 @@ -20,8 +20,8 @@ which is no longer than \fIn\fP bytes, into a wide character and, if \fIpwc\fP is not NULL, stores the wide character in \fIpwc\fP. .SH "RETURN VALUE" \fBmbtowc()\fP returns the number of bytes in the multibyte character -or \-1 if the multibyte character is not valid. +or -1 if the multibyte character is not valid. .SH "CONFORMING TO" SVID 3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR mblen "(3), " mbstowcs "(3), " wcstombs "(3), " wctomb (3) diff --git a/man3/memccpy.3 b/man3/memccpy.3 index 4a58bdc97c..4dd2247c44 100644 --- a/man3/memccpy.3 +++ b/man3/memccpy.3 @@ -24,5 +24,5 @@ in \fIdest\fP after \fIc\fP, or NULL if \fIc\fP was not found in the first \fIn\fP characters of \fIsrc\fP. .SH "CONFORMING TO" SVID 3, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR bcopy "(3), " memcpy "(3), " memmove "(3), " strcpy "(3), " strncpy (3) diff --git a/man3/memchr.3 b/man3/memchr.3 index 194e9e3bb2..6648126e39 100644 --- a/man3/memchr.3 +++ b/man3/memchr.3 @@ -24,6 +24,6 @@ The \fBmemchr()\fP function returns a pointer to the matching byte or NULL if the character does not occur in the given memory area. .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR index "(3), " rindex "(3), " strchr "(3), " strpbrk (3), .BR strrchr "(3), " strsep "(3), " strspn "(3), " strstr (3) diff --git a/man3/memcmp.3 b/man3/memcmp.3 index 9ed847be4a..d7572b63d3 100644 --- a/man3/memcmp.3 +++ b/man3/memcmp.3 @@ -26,6 +26,6 @@ respectively, to be less than, to match, or be greater than the first \fIn\fP bytes of \fIs2\fP. .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR bcmp "(3), " strcasecmp "(3), " strcmp "(3), " strcoll (3), .BR strncmp "(3), " strncasecmp (3) diff --git a/man3/memcpy.3 b/man3/memcpy.3 index b29341c1a1..d048b928ec 100644 --- a/man3/memcpy.3 +++ b/man3/memcpy.3 @@ -22,5 +22,5 @@ overlap. Use \fBmemmove\fP(3) if the memory areas do overlap. The \fBmemcpy()\fP function returns a pointer to \fIdest\fP. .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR bcopy "(3), " memccpy "(3), " memmove "(3), " strcpy "(3), " strncpy (3) diff --git a/man3/memfrob.3 b/man3/memfrob.3 index 9bd72a6add..1a2b46315a 100644 --- a/man3/memfrob.3 +++ b/man3/memfrob.3 @@ -28,5 +28,5 @@ area. .SH "CONFORMING TO" The \fBmemfrob()\fP function is unique to the Linux C Library and GNU C Library. -.SH "SEE ALSO" +.SH SEE ALSO .BR strfry (3) diff --git a/man3/memmem.3 b/man3/memmem.3 index eaeb3441ea..c783c55000 100644 --- a/man3/memmem.3 +++ b/man3/memmem.3 @@ -23,5 +23,5 @@ of length \fIhaystacklen\fP. .SH "RETURN VALUE" The \fBmemmem()\fP function returns a pointer to the beginning of the substring, or NULL if the substring is not found. -.SH "SEE ALSO" +.SH SEE ALSO .BR strstr (3) diff --git a/man3/memmove.3 b/man3/memmove.3 index fc9d62aab6..83bd125ed7 100644 --- a/man3/memmove.3 +++ b/man3/memmove.3 @@ -21,5 +21,5 @@ The \fBmemmove()\fP function copies \fIn\fP bytes from memory area The \fBmemmove()\fP function returns a pointer to \fIdest\fP. .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR bcopy "(3), " memccpy "(3), " memcpy "(3), " strcpy "(3), " strncpy (3) diff --git a/man3/memset.3 b/man3/memset.3 index e03019b99e..49d1f535a6 100644 --- a/man3/memset.3 +++ b/man3/memset.3 @@ -22,5 +22,5 @@ The \fBmemset()\fP function returns a pointer to the memory area \fIs\fP. .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR bzero "(3), " swab (3) diff --git a/man3/mkstemp.3 b/man3/mkstemp.3 index ba1e31e8da..0af4bb3fdf 100644 --- a/man3/mkstemp.3 +++ b/man3/mkstemp.3 @@ -32,5 +32,5 @@ The last six characters of \fItemplate\fP were not XXXXXX. The temporary file is not unique. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR mktemp "(3), " tmpnam "(3), " tempnam "(3), " tmpfile (3) diff --git a/man3/mktemp.3 b/man3/mktemp.3 index dc1807c771..8953eaa63c 100644 --- a/man3/mktemp.3 +++ b/man3/mktemp.3 @@ -28,5 +28,5 @@ success, and NULL on failure. The last six characters of \fItemplate\fP were not XXXXXX. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR mkstemp "(3), " tmpnam "(3), " tempnam "(3), " tmpfile (3) diff --git a/man3/modf.3 b/man3/modf.3 index 5a7edfa7d8..85db281e02 100644 --- a/man3/modf.3 +++ b/man3/modf.3 @@ -23,5 +23,5 @@ The integral part is stored in \fIiptr\fP. The \fBmodf()\fP function returns the fractional part of \fIx\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR frexp "(3), " ldexp (3) diff --git a/man3/mrand48.3 b/man3/mrand48.3 index 3133f7d62c..8d2bfcd5de 100644 --- a/man3/mrand48.3 +++ b/man3/mrand48.3 @@ -1 +1 @@ -.so man3/drand48.3 +.so man3/drand48.3
\ No newline at end of file diff --git a/man3/nrand48.3 b/man3/nrand48.3 index 3133f7d62c..8d2bfcd5de 100644 --- a/man3/nrand48.3 +++ b/man3/nrand48.3 @@ -1 +1 @@ -.so man3/drand48.3 +.so man3/drand48.3
\ No newline at end of file diff --git a/man3/on_exit.3 b/man3/on_exit.3 index 7eed9b37c8..0240956df9 100644 --- a/man3/on_exit.3 +++ b/man3/on_exit.3 @@ -26,6 +26,6 @@ to and the \fIarg\fP argument from \fBon_exit()\fP. .SH "RETURN VALUE" The \fBon_exit()\fP function returns the value 0 if successful; otherwise -the value \-1 is returned. -.SH "SEE ALSO" +the value -1 is returned. +.SH SEE ALSO .BR exit "(3), " atexit (3) diff --git a/man3/opendir.3 b/man3/opendir.3 index f94133c4e9..c460c45e95 100644 --- a/man3/opendir.3 +++ b/man3/opendir.3 @@ -42,6 +42,6 @@ Insufficient memory to complete the operation. \fIname\fP is not a directory. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR open "(2), " readdir "(3), " closedir "(3), " rewinddir (3), .BR seekdir "(3), " telldir "(3), " scandir (3) diff --git a/man3/pclose.3 b/man3/pclose.3 deleted file mode 100644 index 663d4a0815..0000000000 --- a/man3/pclose.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/popen.3 diff --git a/man3/popen.3 b/man3/popen.3 deleted file mode 100644 index 06f722f3c2..0000000000 --- a/man3/popen.3 +++ /dev/null @@ -1,146 +0,0 @@ -.\" Copyright 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)popen.3 6.4 (Berkeley) 4/30/91 -.\" -.\" Converted for Linux, Mon Nov 29 14:45:38 1993, faith@cs.unc.edu -.\" -.TH POPEN 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -popen, pclose \- process I/O -.SH SYNOPSIS -.B #include <stdio.h> -.br -.BI "FILE *popen( const char *" command ", const char *" type ); -.br -.BI "int pclose( FILE *" stream ); -.SH DESCRIPTION -The -.B popen -function opens a process by creating a pipe, forking, and invoking the -shell. Since a pipe is by definition unidirectional, the -.I type -argument may specify only reading or writing, not both; the resulting -stream is correspondingly read-only or write-only. -.PP -The -.I command -argument is a pointer to a null-terminated string containing a shell -command line. This command is passed to -.I /bin/sh -using the -.B \-c -flag; interpretation, if any, is performed by the shell. The -.I mode -argument is a pointer to a null-terminated string which must be either `r' -for reading or `w' for writing. -.PP -The return value from -.B popen -is a normal standard I/O stream in all respects save that it must be closed -with -.B pclose -rather than -.BR fclose . -Writing to such a stream writes to the standard input of the command; the -command's standard output is the same as that of the process that called -.BR popen , -unless this is altered by the command itself. Conversely, reading from a -``popened'' stream reads the command's standard output, and the command's -standard input is the same as that of the process that called -.BR popen . -.PP -Note that output -.B popen -streams are fully buffered by default. -.PP -The -.B pclose -function waits for the associated process to terminate and returns the exit -status of the command as returned by -.BR wait4 . -.SH "RETURN VALUE" -The -.B popen -function returns -.B NULL -if the -.BR fork (2) -or -.BR pipe (2) -calls fail, or if it cannot allocate memory. -.PP -The -.B pclose -function returns \-1 if -.I stream -is not associated with a ``popened'' command, if -.I stream -already ``pclosed'', or if -.B wait4 -returns an error. -.SH ERRORS -The -.B popen -function does not reliably set -.IR errno . -(Is this true for Linux?) -.SH "SEE ALSO" -.BR fork "(2), " sh "(1), " pipe "(2), " wait4 "(2), " fflush "(3), " -.BR fclose "(3), " fopen "(3), " stdio "(3), " system (3) -.SH BUGS -Since the standard input of a command opened for reading shares its seek -offset with the process that called -.BR popen , -if the original process has done a buffered read, the command's input -position may not be as expected. Similarly, the output from a command -opened for writing may become intermingled with that of the original -process. The latter can be avoided by calling -.BR fflush (3) -before -.BR popen . -.PP -Failure to execute the shell is indistinguishable from the shell's failure -to execute command, or an immediate exit of the command. The only hint is -an exit status of 127. (Is this true under Linux?) -.PP -The -.B popen -argument always calls -.BR sh , -never calls -.BR csh . -.SH HISTORY -A -.B popen -and a -.B pclose -function appeared in Version 7 AT&T UNIX. diff --git a/man3/printf.3 b/man3/printf.3 deleted file mode 100644 index 5f347822f6..0000000000 --- a/man3/printf.3 +++ /dev/null @@ -1,507 +0,0 @@ -.\" Copyright (c) 1990, 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to Berkeley by -.\" Chris Torek and the American National Standards Committee X3, -.\" on Information Processing Systems. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)printf.3 6.14 (Berkeley) 7/30/91 -.\" -.\" Converted for Linux, Mon Nov 29 12:06:07 1993, faith@cs.unc.edu -.\" -.TH PRINTF 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -printf, fprintf, sprintf, vprintf, vfprintf, vsprintf \- formatted output conversion -.SH SYNOPSIS -.B #include <stdio.h> -.sp -.BI "int printf( const char *" format ", ...);" -.br -.BI "int fprintf( FILE *" stream ", const char *" format ", ...);" -.br -.BI "int sprintf( char *" str ", const char *" format ", ...);" -.sp -.B #include <stdarg.h> -.sp -.BI "int vprintf( const char *" format ", va_list " ap ); -.br -.BI "int vfprintf( FILE *" stream ", const char *" format ", va_list " ap ); -.br -.BI "int vsprintf( char *" str ", char *" format ", va_list " ap ); -.SH DESCRIPTION -The -.B printf -family of functions produces output according to a -.I format -as described below. -.B Printf -and -.B vprintf -write output to -.IR stdout , -the standard output stream; -.B fprintf -and -.B vfprintf -write output to the given output -.IR stream ; -.BR sprintf , -and -.BR vsprintf -write to the character string -.IR str . -These functions write the output under the control of a -.I format -string that specifies how subsequent arguments (or arguments accessed via -the variable-length argument facilities of -.BR stdarg (3) -are converted for output. These functions return the number of characters -printed (not including the trailing `\e0' used to end output to strings). -.PP -The format string is composed of zero or more directives: ordinary -characters (not -.BR % ), -which are copied unchanged to the output stream; -and conversion specifications, each of which results in fetching zero or -more subsequent arguments. Each conversion specification is introduced by -the character -.BR % . -The arguments must correspond properly (after type promotion) with the -conversion specifier. After the -.BR % , -the following appear in sequence: -.TP -.B \(bu -Zero or more of the following flags: -.RS -.TP -.B # -specifying that the value should be converted to an ``alternate form''. -For -.BR c , -.BR d , -.BR i , -.BR n , -.BR p , -.BR s , -and -.BR u -conversions, this option has no effect. For -.BR o -conversions, the precision of the number is increased to force the first -character of the output string to a zero (except if a zero value is printed -with an explicit precision of zero). -For -.B x -and -.B X -conversions, a non-zero result has the string `0x' (or `0X' for -.B X -conversions) prepended to it. For -.BR e , -.BR E , -.BR f , -.BR g , -and -.B G -conversions, the result will always contain a decimal point, even if no -digits follow it (normally, a decimal point appears in the results of those -conversions only if a digit follows). For -.B g -and -.B G -conversions, trailing zeros are not removed from the result as they would -otherwise be. -.TP -.B \&0 -specifying zero padding. For all conversions except -.BR n , -the converted value is padded on the left with zeros rather than blanks. -If a precision is given with a numeric conversion -.BR "" ( d , -.BR i , -.BR o , -.BR u , -.BR i , -.BR x , -and -.BR X ), -the -.B \&0 -flag is ignored. -.TP -.B \- -(a negative field width flag) indicates the converted value is to be left -adjusted on the field boundary. Except for -.B n -conversions, the converted value is padded on the right with blanks, rather -than on the left with blanks or zeros. A -.B \- -overrides a -.B \&0 -if both are given. -.TP -.B "" -(a space) specifying that a blank should be left before a positive number -produced by a signed conversion -.BR "" ( d , -.BR e , -.BR E , -.BR f , -.BR g , -.BR G , -or -.BR i ). -.TP -.B + -specifying that a sign always be placed before a number produced by a -signed conversion. A -.B + -overrides a space if both are used. -.RE -.TP -.B \(bu -An optional decimal digit string specifying a minimum field width. If the -converted value has fewer characters than the field width, it will be -padded with spaces on the left (or right, if the left-adjustment flag has -been given) to fill out the field width. -.TP -.B \(bu -An optional precision, in the form of a period (`\&.') followed by an -optional digit string. If the digit string is omitted, the precision is -taken as zero. This gives the minimum number of digits to appear for -.BR d , -.BR i , -.BR o , -.BR u , -.BR x , -and -.B X -conversions, the number of digits to appear after the decimal-point for -.BR e , -.BR E , -and -.B f -conversions, the maximum number of significant digits for -.B g -and -.B G -conversions, or the maximum number of characters to be printed from a -string for -.B s -conversions. -.TP -.B \(bu -The optional character -.BR h , -specifying that a following -.BR d , -.BR i , -.BR o , -.BR u , -.BR x , -or -.BR X -conversion corresponds to a -.I short int -or -.I unsigned short int -argument, or that a following -.B n -conversion corresponds to a pointer to a -.I short int -argument. -.TP -.B \(bu -The optional character -.B l -(ell) specifying that a following -.BR d , -.BR i , -.BR o , -.BR u , -.BR x , -or -.BR X -conversion applies to a pointer to a -.I long int -or -.I unsigned long int -argument, or that a following -.B n -conversion corresponds to a pointer to a -.I long int -argument. -.TP -.B \(bu -The character -.BR L -specifying that a following -.BR e , -.BR E , -.BR f , -.BR g , -or -.B G -conversion corresponds to a -.I long double -argument. -.TP -.B \(bu -A character that specifies the type of conversion to be applied. -.PP -A field width or precision, or both, may be indicated by an asterisk `*' -instead of a digit string. In this case, an -.I int -argument supplies the field width or precision. A negative field width is -treated as a left adjustment flag followed by a positive field width; a -negative precision is treated as though it were missing. -.PP -The conversion specifiers and their meanings are: -.TP -.B diouxX -The -.I int -(or appropriate variant) argument is converted to signed decimal -.BR "" ( d -and -.BR i ), -unsigned octal -.BR "" ( o , -unsigned decimal -.BR "" ( u , -or unsigned hexadecimal -.BR "" ( x -and -.BR X ) -notation. The letters -.B abcdef -are used for -.B x -conversions; the letters -.B ABCDEF -are used for -.B X -conversions. The precision, if any, gives the minimum number of digits -that must appear; if the converted value requires fewer digits, it is -padded on the left with zeros. -.TP -.B DOU -The -.I long int -argument is converted to signed decimal, unsigned octal, or unsigned -decimal, as if the format had been -.BR ld , -.BR lo , -or -.B lu -respectively. These conversion characters are deprecated, and will -eventually disappear. -.TP -.B eE -The -.I double -argument is rounded and converted in the style -.BR "" [\-]d \&. ddd e \\*(Pmdd -where there is one digit before the decimal-point character and the number -of digits after it is equal to the precision; if the precision is missing, -it is taken as 6; if the precision is zero, no decimal-point character -appears. An -.B E -conversion uses the letter -.B E -(rather than -.BR e ) -to introduce the exponent. The exponent always contains at least two -digits; if the value is zero, the exponent is 00. -.TP -.B f -The -.I double -argument is rounded and converted to decimal notation in the style -.BR "" [-]ddd \&. ddd, -where the number of digits after the decimal-point character is equal to -the precision specification. If the precision is missing, it is taken as -6; if the precision is explicitly zero, no decimal-point character appears. -If a decimal point appears, at least one digit appears before it. -.TP -.B g -The -.I double -argument is converted in style -.B f -or -.B e -(or -.B E -for -.B G -conversions). The precision specifies the number of significant digits. -If the precision is missing, 6 digits are given; if the precision is zero, -it is treated as 1. Style -.B e -is used if the exponent from its conversion is less than \-4 or greater -than or equal to the precision. Trailing zeros are removed from the -fractional part of the result; a decimal point appears only if it is -followed by at least one digit. -.TP -.B c -The -.I int -argument is converted to an -.IR unsigned char , -and the resulting character is written. -.TP -.B s -The -.IR "" `` "char *" '' -argument is expected to be a pointer to an array of character type (pointer -to a string). Characters from the array are written up to (but not -including) a terminating -.B NUL -character; if a precision is specified, no more than the number specified -are written. If a precision is given, no null character need be present; -if the precision is not specified, or is greater than the size of the -array, the array must contain a terminating -.B NUL -character. -.TP -.B p -The -.IR "" `` "void *" '' -pointer argument is printed in hexadecimal (as if by -.B %#x -or -.BR %#lx ). -.TP -.B n -The number of characters written so far is stored into the integer -indicated by the -.IR "" `` "int *" '' -(or variant) pointer argument. No argument is converted. -.TP -.B % -A `%' is written. No argument is converted. The complete conversion -specification is `%%'. -.PP -In no case does a non-existent or small field width cause truncation of a -field; if the result of a conversion is wider than the field width, the -field is expanded to contain the conversion result. -.PP -.SH EXAMPLES -.br -To print a date and time in the form `Sunday, July 3, 10:02', -where -.I weekday -and -.I month -are pointers to strings: -.RS -.nf -#include <stdio.h> -fprintf(stdout, "%s, %s %d, %.2d:%.2d\en", - weekday, month, day, hour, min); -.fi -.RE -.PP -To print \*(Pi -to five decimal places: -.RS -.nf -#include <math.h> -#include <stdio.h> -fprintf(stdout, "pi = %.5f\en", 4 * atan(1.0)); -.fi -.RE -.PP -To allocate a 128 byte string and print into it: -.RS -.nf -#include <stdio.h> -#include <stdlib.h> -#include <stdarg.h> -char *newfmt(const char *fmt, ...) -{ - char *p; - va_list ap; - if ((p = malloc(128)) == NULL) - return (NULL); - va_start(ap, fmt); - (void) vsnprintf(p, 128, fmt, ap); - va_end(ap); - return (p); -} -.fi -.RE -.SH "SEE ALSO" -.BR printf "(1), " scanf (3) -.SH STANDARDS -The -.BR fprintf , -.BR printf , -.BR sprintf , -.BR vprintf , -.BR vfprintf , -and -.B vsprintf -functions conform to ANSI C3.159-1989 (``ANSI C''). -.SH BUGS -Some floating point conversions under Linux cause memory leaks. -.PP -The conversion formats -.BR \&%D , -.BR \&%O , -and -.B %U -are not standard and are provided only for backward compatibility. These -may not be provided under Linux. -.PP -The effect of padding the -.B %p -format with zeros (either by the -.B 0 -flag or by specifying a precision), and the benign effect (i.e., none) of -the -.B # -flag on -.B %n -and -.B %p -conversions, as well as other nonsensical combinations such as -.BR %Ld , -are not standard; such combinations should be avoided. -.PP -Because -.B sprintf -and -.B vsprintf -assume an infinitely long string, callers must be careful not to overflow -the actual space; this is often impossible to assure. diff --git a/man3/psignal.3 b/man3/psignal.3 index 9161f03a62..476c25dbc5 100644 --- a/man3/psignal.3 +++ b/man3/psignal.3 @@ -28,5 +28,5 @@ indexed by signal number. The \fBpsignal()\fP function returns no value. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR perror "(3), " strsignal (3) diff --git a/man3/putenv.3 b/man3/putenv.3 index 30a4e5bd30..d27407dbc7 100644 --- a/man3/putenv.3 +++ b/man3/putenv.3 @@ -23,7 +23,7 @@ If \fIname\fP does not already exist in the environment, then then the value of \fIname\fP in the environment is changed to \fIvalue\fP. .SH "RETURN VALUE" -The \fBputenv()\fP function returns zero on success, or \-1 if an error +The \fBputenv()\fP function returns zero on success, or -1 if an error occurs. .SH ERRORS .TP @@ -31,5 +31,5 @@ occurs. Insufficient space to allocate new environment. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR getenv "(3), " setenv "(3), " unsetenv (3) diff --git a/man3/putpwent.3 b/man3/putpwent.3 index db9fb67f02..1036ba2c28 100644 --- a/man3/putpwent.3 +++ b/man3/putpwent.3 @@ -38,7 +38,7 @@ struct passwd { .fi .RE .SH "RETURN VALUE" -The \fBputpwent()\fP function returns 0 on success, or \-1 if an error +The \fBputpwent()\fP function returns 0 on success, or -1 if an error occurs. .SH ERRORS .TP @@ -46,6 +46,6 @@ occurs. Invalid (NULL) argument given. .SH "CONFORMING TO" SVID 3 -.SH "SEE ALSO" +.SH SEE ALSO .BR fgetpwent "(3), " getpwent "(3), " setpwent (3), .BR endpwent "(3), " getpwnam "(3), " getpwuid "(3), " getpw (3) diff --git a/man3/puts.3 b/man3/puts.3 index 07f34eed98..d76054a0f3 100644 --- a/man3/puts.3 +++ b/man3/puts.3 @@ -84,6 +84,6 @@ library with low - level calls to .B write() for the file descriptor associated with the same output stream; the results will be undefined and very probably not what you want. -.SH "SEE ALSO" +.SH SEE ALSO .BR write "(2), " fopen "(3), " fwrite "(3), " scanf (3), .BR gets "(3), " fseek "(3), " ferror (3) diff --git a/man3/qsort.3 b/man3/qsort.3 index 1bd3f09686..39077365d0 100644 --- a/man3/qsort.3 +++ b/man3/qsort.3 @@ -34,5 +34,5 @@ as equal, their order in the sorted array is undefined. The \fBqsort()\fP function returns no value. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR sort (1) diff --git a/man3/raise.3 b/man3/raise.3 index 30267d4ac3..277cd147cd 100644 --- a/man3/raise.3 +++ b/man3/raise.3 @@ -20,5 +20,5 @@ It is equivalent to Zero for success, nonzero for failure. .SH "CONFORMS TO" ANSI - C -.SH "SEE ALSO" +.SH SEE ALSO .BR kill "(2), " signal "(2), " getpid (2) diff --git a/man3/rand.3 b/man3/rand.3 index 596dd05fe1..ab3c321636 100644 --- a/man3/rand.3 +++ b/man3/rand.3 @@ -55,5 +55,5 @@ return j % i; program, which credits Ken Arnold, Unix Review, October 1987). .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR random "(3), " srandom "(3), " initstate "(3), " setstate (3) diff --git a/man3/random.3 b/man3/random.3 index 92ceecea15..56a1d0e402 100644 --- a/man3/random.3 +++ b/man3/random.3 @@ -26,7 +26,7 @@ The \fBrandom()\fP function uses a non-linear additive feedback random number generator employing a default table of size 31 long integers to return successive pseudo-random numbers in the range from 0 to RAND_MAX. The period of this random number generator is very large, approximately -16*((2**31)\-1). +16*((2**31)-1). .PP The \fBsrandom()\fP function sets its argument as the seed for a new sequence of pseudo-random integers to be returned by \fBrandom()\fP. @@ -37,7 +37,7 @@ is automatically seeded with a value of 1. The \fBinitstate()\fP function allows a state array \fIstate\fP to be initialized for use by \fBrandom()\fP. The size of the state array \fIn\fP is used by \fBinitstate()\fP to decide how sophisticated a -random number generator it should use \(em the larger the state array, +random number generator it should use \- the larger the state array, the better the random numbers will be. \fIseed\fP is the seed for the initialization, which specifies a starting point for the random number sequence, and provides for restarting at the same point. @@ -63,5 +63,5 @@ the nearest known amount. Using less than 8 bytes will cause an error. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR rand "(3), " srand (3) diff --git a/man3/readdir.3 b/man3/readdir.3 index 5ddf3b0d24..c9a3a98436 100644 --- a/man3/readdir.3 +++ b/man3/readdir.3 @@ -35,6 +35,6 @@ In Linux 0.99.11, is implemented as a kernel function. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR read "(2), " opendir "(3), " closedir "(3), " rewinddir (3), .BR seekdir "(3), " telldir "(3), " scandir (3) diff --git a/man3/readv.3 b/man3/readv.3 index 9f7b8f1111..9ef10d34fb 100644 --- a/man3/readv.3 +++ b/man3/readv.3 @@ -70,7 +70,7 @@ except that multiple buffers are written out. .SH "RETURN VALUES" The .B readv() -function returns the number of bytes or \-1 on error; the +function returns the number of bytes or -1 on error; the .B writev() function returns the number of bytes written. .SH "ERRORS" @@ -111,5 +111,5 @@ It is not advisable to mix calls to functions like .BR readv() " or " writev() , which operate on file descriptors, with the functions from the stdio library; the results will be undefined and probably not what you want. -.SH "SEE ALSO" +.SH SEE ALSO .BR read "(2), " write (2) diff --git a/man3/resolver.3 b/man3/resolver.3 index de9283d133..fe0e0e9116 100644 --- a/man3/resolver.3 +++ b/man3/resolver.3 @@ -154,15 +154,15 @@ domain and in parent domains. This option is used by .BR gethostbyname (3). [Enabled by default]. .SH "RETURN VALUE" -The \fBres_init()\fP function returns 0 on success, or \-1 if an error +The \fBres_init()\fP function returns 0 on success, or -1 if an error occurs. .PP The \fBres_query()\fP, \fBres_search()\fP, \fBres_querydomain()\fP, \fBres_mkquery()\fP and \fBres_send()\fP functions return the length -of the response, or \-1 if an error occurs. +of the response, or -1 if an error occurs. .PP The \fBdn_comp()\fP and \fBdn_expand()\fP functions return the length -of the compressed name, or \-1 if an error occurs. +of the compressed name, or -1 if an error occurs. .SH FILES .nf /etc/resolv.conf resolver configuration file @@ -170,5 +170,5 @@ of the compressed name, or \-1 if an error occurs. .fi .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR gethostbyname "(3), " hostname "(7), " named "(8), " resolv+ (8) diff --git a/man3/rewind.3 b/man3/rewind.3 deleted file mode 100644 index a1487b5a8c..0000000000 --- a/man3/rewind.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/fseek.3 diff --git a/man3/rewinddir.3 b/man3/rewinddir.3 index 89a7980b0e..e548715fbf 100644 --- a/man3/rewinddir.3 +++ b/man3/rewinddir.3 @@ -21,6 +21,6 @@ stream \fIdir\fP to the beginning of the directory. The \fBreaddir()\fP function returns no value. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR opendir "(3), " readdir "(3), " closedir "(3), " seekdir (3), .BR telldir "(3), " scandir (3) diff --git a/man3/rint.3 b/man3/rint.3 index b2fb0e723d..f2e0a9f2d1 100644 --- a/man3/rint.3 +++ b/man3/rint.3 @@ -23,5 +23,5 @@ The \fBrint()\fP function returns the integer value as a floating-point number. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR abs "(3), " ceil "(3), " fabs "(3), " floor "(3), " labs (3) diff --git a/man3/scandir.3 b/man3/scandir.3 index 73a3eec182..0b348c393a 100644 --- a/man3/scandir.3 +++ b/man3/scandir.3 @@ -34,7 +34,7 @@ alphabetical order. Its parameters are the two directory entries, \fIa\fP and \fIb\fP, to compare. .SH "RETURN VALUE" The \fBscandir()\fP function returns the number of directory entries -selected or \-1 if an error occurs. +selected or -1 if an error occurs. .PP The \fBalphasort()\fP function returns an integer less than, equal to, or greater than zero if the first argument is considered to be @@ -43,8 +43,8 @@ respectively less than, equal to, or greater than the second. .TP .B ENOMEM Insufficient memory to complete the operation. -.SH "CONFORMING TO" +.SH CONFORMING TO BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR opendir "(3), " readdir "(3), " closedir "(3), " rewinddir (3), .BR telldir "(3), " seekdir (3) diff --git a/man3/scanf.3 b/man3/scanf.3 deleted file mode 100644 index e3e44b0186..0000000000 --- a/man3/scanf.3 +++ /dev/null @@ -1,363 +0,0 @@ -.\" Copyright (c) 1990, 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to Berkeley by -.\" Chris Torek and the American National Standards Committee X3, -.\" on Information Processing Systems. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)scanf.3 6.14 (Berkeley) 1/8/93 -.\" -.\" Converted for Linux, Mon Nov 29 15:22:01 1993, faith@cs.unc.edu -.\" -.TH SCANF 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -scanf, fscanf, sscanf, vscanf, vsscanf, vfscanf \- input format conversion -.SH SYNOPSIS -.nf -.B #include <stdio.h> -.na -.BI "int scanf( const char *" format ", ..." ); -.br -.BI "int fscanf( FILE *" stream ", const char *" format ", ..." ); -.br -.BI "int sscanf( const char *" str ", const char *" format ", ..." ); -.sp -.B #include <stdarg.h> -.BI "int vscanf( const char *" format ", va_list " ap ); -.br -.BI "int vsscanf( const char *" str ", const char *" format ", va_list " ap ); -.br -.BI "int vfscanf( FILE *" stream ", const char *" format ", va_list " ap ); -.ad -.SH DESCRIPTION -The -.B scanf -family of functions scans input according to a -.I format -as described below. This format may contain -.IR "conversion specifiers" ; -the results from such conversions, if any, are stored through the -.I pointer -arguments. The -.B scanf -function reads input from the standard input stream -.IR stdin , -.B fscanf -reads input from the stream pointer -.IR stream , -and -.B sscanf -reads its input from the character string pointed to by -.IR str . -.PP -The -.B vfscanf -function is analogous to -.BR vfprintf (3) -and reads input from the stream pointer -.I stream -using a variable argument list of pointers (see -.BR stdarg (3). -The -.B vscanf -function scans a variable argument list from the standard input and the -.B vsscanf -function scans it from a string; these are analogous to the -.B vprintf -and -.B vsprintf -functions respectively. -.PP -Each successive -.I pointer -argument must correspond properly with each successive conversion specifier -(but see `suppression' below). All conversions are introduced by the -.B % -(percent sign) character. The -.I format -string may also contain other characters. White space (such as blanks, -tabs, or newlines) in the -.I format -string match any amount of white space, including none, in the input. -Everything else matches only itself. Scanning stops when an input -character does not match such a format character. Scanning also stops when -an input conversion cannot be made (see below). -.SH CONVERSIONS -Following the -.B % -character introducing a conversion there may be a number of -.I flag -characters, as follows: -.TP -.B * -Suppresses assignment. The conversion that follows occurs as usual, but no -pointer is used; the result of the conversion is simply discarded. -.TP -.B h -Indicates that the conversion will be one of -.B dioux -or -.B n -and the next pointer is a pointer to a -.I short int -(rather than -.IR int ). -.TP -.B l -Indicates either that the conversion will be one of -.B dioux -or -.B n -and the next pointer is a pointer to a -.I long int -(rather than -.IR int ), -or that the conversion will be one of -.B efg -and the next pointer is a pointer to -.I double -(rather than -.IR float ). -.TP -.B L -Indicates that the conversion will be -.B efg -and the next pointer is a pointer to -.IR "long double" . -(This type is not implemented; the -.B L -flag is currently ignored\(emthis may not be true for Linux.) -.PP -In addition to these flags, there may be an optional maximum field width, -expressed as a decimal integer, between the -.B % -and the conversion. If no width is given, a default of `infinity' is used -(with one exception, below); otherwise at most this many characters are -scanned in processing the conversion. Before conversion begins, most -conversions skip white space; this white space is not counted against the -field width. -.PP -The following conversions are available: -.TP -.B % -Matches a literal `%'. That is, `%\&%' in the format string matches a -single input `%' character. No conversion is done, and assignment does not -occur. -.TP -.B d -Matches an optionally signed decimal integer; -the next pointer must be a pointer to -.IR int . -.TP -.B D -Equivalent to -.BR ld ; -this exists only for backwards compatibility. -.TP -.B i -Matches an optionally signed integer; the next pointer must be a pointer to -.IR int . -The integer is read in base 16 if it begins with `0x' or `0X', in base 8 if -it begins with `0', and in base 10 otherwise. Only characters that -correspond to the base are used. -.TP -.B o -Matches an octal integer; the next pointer must be a pointer to -.IR "unsigned int" . -.TP -.B O -Equivalent to -.BR lo ; -this exists for backwards compatibility. -.TP -.B u -Matches an optionally signed decimal integer; the next pointer must be a -pointer to -.IR "unsigned int" . -.TP -.B x -Matches an optionally a signed hexadecimal integer; the next pointer must -be a pointer to -.IR "unsigned int" . -.TP -.B X -Equivalent to -.BR lx ; -this violates the ANSI C3.159-1989 (``ANSI C'') but is backwards compatible -with previous UNIX systems\(emI don't know what Linux does with this. -.TP -.B f -Matches an optionally signed floating-point number; the next pointer must -be a pointer to -.IR float . -.TP -.B e -Equivalent to -.BR f . -.TP -.B g -Equivalent to -.BR f . -.TP -.B E -Equivalent to -.BR lf ; -this violates the ANSI C3.159-1989 (``ANSI C'') -but is backwards compatible with previous UNIX -systems\(emI don't know what Linux does with this. -.TP -.B F -Equivalent to -.BR lf ; -this exists only for backwards compatibility. -.TP -.B s -Matches a sequence of non-white-space characters; the next pointer must be -a pointer to -.IR char , -and the array must be large enough to accept all the sequence and the -terminating -.B NUL -character. The input string stops at white space or at the maximum field -width, whichever occurs first. -.TP -.B c -Matches a sequence of -.I width -count characters (default 1); the next pointer must be a pointer to -.IR char , -and there must be enough room for all the characters (no terminating -.B NUL -is added). The usual skip of leading white space is suppressed. To skip -white space first, use an explicit space in the format. -.TP -.B \&[ -Matches a nonempty sequence of characters from the specified set of -accepted characters; the next pointer must be a pointer to -.IR char , -and there must be enough room for all the characters in the string, plus a -terminating -.B NUL -character. The usual skip of leading white space is suppressed. The -string is to be made up of characters in (or not in) a particular set; the -set is defined by the characters between the open bracket -.B [ -character and a close bracket -.B ] -character. The set -.I excludes -those characters if the first character after the open bracket is a -circumflex -.BR ^ . -To include a close bracket in the set, make it the first character after -the open bracket or the circumflex; any other position will end the set. -The hyphen character -.B - -is also special; when placed between two other characters, it adds all -intervening characters to the set. To include a hyphen, make it the last -character before the final close bracket. For instance, `[^]0-9-]' means -the set `everything except close bracket, zero through nine, and hyphen'. -The string ends with the appearance of a character not in the (or, with a -circumflex, in) set or when the field width runs out. -.TP -.B p -Matches a pointer value (as printed by `%p' in -.BR printf (3); -the next pointer must be a pointer to -.IR void . -.TP -.B n -Nothing is expected; instead, the number of characters consumed thus far -from the input is stored through the next pointer, which must be a pointer -to -.IR int . -This is -.I not -a conversion, although it can be suppressed with the -.B * -flag. -.PP -For backwards compatibility, other conversion characters (except `\e0') are -taken as if they were `%d' or, if uppercase, `%ld', and a `conversion' of -`%\e0' causes an immediate return of -.BR EOF . -The -.B F -and -.B X -conversions will be changed in the future to conform to the - ANSI C standard, after which they will act like -.Cm f -and -.Cm x -respectively. The behavior of Linux on the non-standard points is not -known by this documenter. -.PP -.SH "RETURN VALUES" -These functions return the number of input items assigned, which can be -fewer than provided for, or even zero, in the event of a matching failure. -Zero indicates that, while there was input available, no conversions were -assigned; typically this is due to an invalid input character, such as an -alphabetic character for a `%d' conversion. The value -.B EOF -is returned if an input failure occurs before any conversion such as an -end-of-file occurs. If an error or end-of-file occurs after conversion has -begun, the number of conversions which were successfully completed is -returned. -.SH "SEE ALSO" -.BR strtol "(3), " strtoul "(3), " strtod "(3), " getc "(3), " printf (3) -.SH STANDARDS -The functions -.BR fscanf , -.BR scanf , -and -.BR sscanf -conform to ANSI C3.159-1989 (``ANSI C''). -.SH BUGS -Differences for Linux are not known at this time. The following is for the -BSD version: -.PP -The current situation with -.B %F -and -.B %X -conversions is unfortunate. -.PP -All of the backwards compatibility formats will be removed in the future. -.PP -Numerical strings are truncated to 512 characters; for example, -.B %f -and -.B %d -are implicitly -.B %512f -and -.BR %512d . diff --git a/man3/seed48.3 b/man3/seed48.3 index 3133f7d62c..8d2bfcd5de 100644 --- a/man3/seed48.3 +++ b/man3/seed48.3 @@ -1 +1 @@ -.so man3/drand48.3 +.so man3/drand48.3
\ No newline at end of file diff --git a/man3/seekdir.3 b/man3/seekdir.3 index 790990045d..13376463b6 100644 --- a/man3/seekdir.3 +++ b/man3/seekdir.3 @@ -23,6 +23,6 @@ should be used with an offset returned by \fBtelldir()\fP. The \fBseekdir()\fP function returns no value. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR lseek "(2), " opendir "(3), " readdir "(3), " closedir (3), .BR rewinddir "(3), telldir "(3), " scandir (3) diff --git a/man3/setbuf.3 b/man3/setbuf.3 deleted file mode 100644 index 6a993727b5..0000000000 --- a/man3/setbuf.3 +++ /dev/null @@ -1,151 +0,0 @@ -.\" Copyright (c) 1980, 1991 Regents of the University of California. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to Berkeley by -.\" the American National Standards Committee X3, on Information -.\" Processing Systems. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)setbuf.3 6.10 (Berkeley) 6/29/91 -.\" -.\" Converted for Linux, Mon Nov 29 14:55:24 1993, faith@cs.unc.edu -.\" -.TH SETBUF 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -setbuf, setbuffer, setlinebuf, setvbuf \- stream buffering operations -.SH SYNOPSIS -.na -.B #include <stdio.h> -.sp -.BI "int setbuf( FILE *" stream ", char *" buf ); -.br -.BI "int setbuffer( FILE *" stream ", char *" buf ", size_t" size ); -.br -.BI "int setlinebuf( FILE *" stream ); -.br -.BI "int setvbuf( FILE *" stream ", char *" buf ", int " mode -.BI ", size_t " size ); -.ad -.SH DESCRIPTION -The three types of buffering available are unbuffered, block buffered, and -line buffered. When an output stream is unbuffered, information appears on -the destination file or terminal as soon as written; when it is block -buffered many characters are saved up and written as a block; when it is -line buffered characters are saved up until a newline is output or input is -read from any stream attached to a terminal device (typically stdin). The -function -.BR fflush (3) -may be used to force the block out early. -(See -.BR fclose (3).) -Normally all files are block buffered. When the first I/O operation occurs -on a file, -.BR malloc (3) -is called, and a buffer is obtained. If a stream refers to a terminal (as -.I stdout -normally does) it is line buffered. The standard error stream -.I stderr -is always unbuffered. -.PP -The -.B setvbuf -function may be used at any time on any open stream to change its buffer. -The -.I mode -parameter must be one of the following three macros: -.RS -.TP -.B _IONBF -unbuffered -.TP -.B _IOLBF -line buffered -.TP -.B _IOFBF -fully buffered -.RE -.PP -Except for unbuffered files, the -.I buf -argument should point to a buffer at least -.I size -bytes long; this buffer will be used instead of the current buffer. If the -argument -.I buf -is -.BR NULL , -only the mode is affected; a new buffer will be allocated on the next read -or write operation. The -.I setvbuf -function may be used at any time, but can only change the mode of a stream -when it is not ``active'': that is, before any I/O, or immediately after a -call to -.BR fflush . -.PP -The other three calls are, in effect, simply aliases for calls to -.BR setvbuf . -The -.B setbuf -function is exactly equivalent to the call -.PP -.RS -setvbuf(stream, buf, buf ? _IOFBF : _IONBF, BUFSIZ); -.RE -.PP -The -.B setbuffer -function is the same, except that the size of the buffer is up to the -caller, rather than being determined by the default -.BR BUFSIZ . -The -.B setlinebuf -function is exactly equivalent to the call: -.PP -.RS -setvbuf(stream, (char *)NULL, _IOLBF, 0); -.RE -.SH "SEE ALSO" -.BR fopen "(3), " fclose "(3), " fread "(3), " malloc "(3), " puts "(3), " -.BR printf (3) -.SH STANDARDS -The -.B setbuf -and -.B setvbuf -functions conform to ANSI C3.159-1989 (``ANSI C''). -.SH BUGS -The -.B setbuffer -and -.B setlinebuf -functions are not portable to versions of BSD before 4.2BSD, and may not be -available under Linux. On 4.2BSD and 4.3BSD systems, -.B setbuf -always uses a suboptimal buffer size and should be avoided. diff --git a/man3/setbuffer.3 b/man3/setbuffer.3 deleted file mode 100644 index dc02d9e887..0000000000 --- a/man3/setbuffer.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/setbuf.3 diff --git a/man3/setenv.3 b/man3/setenv.3 index 87143c4b45..278fbfcfb4 100644 --- a/man3/setenv.3 +++ b/man3/setenv.3 @@ -27,9 +27,9 @@ changed. The \fBunsetenv()\fP function deletes the variable \fIname\fP from the environment. .SH "RETURN VALUE" -The \fBsetenv()\fP function returns zero on success, or \-1 if there +The \fBsetenv()\fP function returns zero on success, or -1 if there was insufficient space in the environment. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR getenv "(3), " putenv (3) diff --git a/man3/setlinebuf.3 b/man3/setlinebuf.3 deleted file mode 100644 index dc02d9e887..0000000000 --- a/man3/setlinebuf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/setbuf.3 diff --git a/man3/setlocale.3 b/man3/setlocale.3 index 87acc4c46f..6cfb466d55 100644 --- a/man3/setlocale.3 +++ b/man3/setlocale.3 @@ -85,6 +85,6 @@ Support for other locales will be there Real Soon Now. The .B printf() family of functions may or may not honour the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR locale "(1), " localedef "(1), " strcoll "(3), " isalpha (3), .BR localeconv "(3), " strftime "(3), " locale (7) diff --git a/man3/setvbuf.3 b/man3/setvbuf.3 deleted file mode 100644 index dc02d9e887..0000000000 --- a/man3/setvbuf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/setbuf.3 diff --git a/man3/siginterrupt.3 b/man3/siginterrupt.3 index 1eab83262e..6e2fdfb04d 100644 --- a/man3/siginterrupt.3 +++ b/man3/siginterrupt.3 @@ -23,14 +23,14 @@ Linux. However, when a new signal handler is specified with the \fBsignal\fP(2) function, the system call is interrupted by default. .PP If the \fIflags\fP argument is true (1) and no data has been transferred, -then a system call interrupted by the signal \fIsig\fP will return \-1 +then a system call interrupted by the signal \fIsig\fP will return -1 and the global variable \fIerrno\fP will be set to \fIEINTR\fP. .PP If the \fIflags\fP argument is true (1) and data transfer has started, then the system call will be interrupted and will return the actual amount of data transferred. .SH "RETURN VALUE" -The \fBsiginterrupt()\fP function returns 0 on success, or \-1 if the +The \fBsiginterrupt()\fP function returns 0 on success, or -1 if the signal number \fIsig\fP is invalid. .SH "ERRORS" .TP @@ -38,5 +38,5 @@ signal number \fIsig\fP is invalid. The specified signal number is invalid. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR signal (2) diff --git a/man3/sin.3 b/man3/sin.3 index 10207ed9a4..916b8fefc5 100644 --- a/man3/sin.3 +++ b/man3/sin.3 @@ -18,8 +18,8 @@ sin \- sine function The \fBsin()\fP function returns the sine of \fIx\fP, where \fIx\fP is given in radians. .SH "RETURN VALUE" -The \fBsin()\fP function returns a value between \-1 and 1. +The \fBsin()\fP function returns a value between -1 and 1. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR acos "(3), " asin "(3), " atan "(3), " atan2 "(3), " cos "(3), " tan (3) diff --git a/man3/sinh.3 b/man3/sinh.3 index 77f29b3c59..96bce69c09 100644 --- a/man3/sinh.3 +++ b/man3/sinh.3 @@ -19,5 +19,5 @@ The \fBsinh()\fP function returns the hyperbolic sine of \fIx\fP, which is defined mathematically as exp(x) - exp(-x) / 2. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR acosh "(3), " asinh "(3), " atanh "(3), " cosh "(3), " tanh (3) diff --git a/man3/sleep.3 b/man3/sleep.3 index 21c6ee6117..4799303c4a 100644 --- a/man3/sleep.3 +++ b/man3/sleep.3 @@ -35,5 +35,5 @@ Using from a signal handler or modifying the handling of .B SIGALRM while sleeping will cause undefined results. -.SH "SEE ALSO" +.SH SEE ALSO .BR signal "(2), " alarm (2) diff --git a/man3/sprintf.3 b/man3/sprintf.3 deleted file mode 100644 index 975530d90a..0000000000 --- a/man3/sprintf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/printf.3 diff --git a/man3/srand48.3 b/man3/srand48.3 index 3133f7d62c..8d2bfcd5de 100644 --- a/man3/srand48.3 +++ b/man3/srand48.3 @@ -1 +1 @@ -.so man3/drand48.3 +.so man3/drand48.3
\ No newline at end of file diff --git a/man3/sscanf.3 b/man3/sscanf.3 deleted file mode 100644 index 9fd424bb27..0000000000 --- a/man3/sscanf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/scanf.3 diff --git a/man3/stdarg.3 b/man3/stdarg.3 deleted file mode 100644 index 91daf50748..0000000000 --- a/man3/stdarg.3 +++ /dev/null @@ -1,193 +0,0 @@ -.\" Copyright (c) 1990, 1991 The Regents of the University of California. -.\" All rights reserved. -.\" -.\" This code is derived from software contributed to Berkeley by -.\" the American National Standards Committee X3, on Information -.\" Processing Systems. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)stdarg.3 6.8 (Berkeley) 6/29/91 -.\" -.\" Converted for Linux, Mon Nov 29 15:11:11 1993, faith@cs.unc.edu -.\" -.TH STDARG 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -stdarg \- variable argument lists -.SH SYNOPSIS -.B #include <stdarg.h> -.sp -.BI "void va_start( va_list " ap ", " last ); -.br -.BI "" type "va_arg( va_list " ap ", " type ); -.br -.BI "void va_end( va_list " ap ); -.SH DESCRIPTION -A function may be called with a varying number of arguments of varying -types. The include file -.I stdarg.h -declares a type -.B va_list -and defines three macros for stepping through a list of arguments whose -number and types are not known to the called function. -.PP -The called function must declare an object of type -.B va_list -which is used by the macros -.BR va_start , -.BR va_arg , -and -.BR va_end . -.PP -The -.B va_start -macro initializes -.I ap -for subsequent use by -.B va_arg -and -.BR va_end , -and must be called first. -.PP -The parameter -.I last -is the name of the last parameter before the variable argument list, i.e., -the last parameter of which the calling function knows the type. -.PP -Because the address of this parameter is used in the -.B va_start -macro, it should not be declared as a register variable, or as a function -or an array type. -.PP -The -.B va_start -macro returns no value. -.PP -The -.B va_arg -macro expands to an expression that has the type and value of the next -argument in the call. The parameter -.I ap -is the -.BI va_list " " ap -initialized by -.BR va_start . -Each call to -.B va_arg -modifies -.I ap -so that the next call returns the next argument. The parameter -.I type -is a type name specified so that the type of a pointer to an object that -has the specified type can be obtained simply by adding a * to -.IR type . -.PP -If there is no next argument, or if -.I type -is not compatible with the type of the actual next argument (as promoted -according to the default argument promotions), random errors will occur. -.PP -The first use of the -.B va_arg -macro after that of the -.B va_start -macro returns the argument after -.IR last . -Successive invocations return the values of the remaining arguments. -.PP -The -.B va_end -macro handles a normal return from the function whose variable argument -list was initialized by -.BR va_start . -.PP -The -.B va_end -macro returns no value. -.SH EXAMPLES -The function -.I foo -takes a string of format characters and prints out the argument associated -with each format character based on the type. -.RS -.nf -void foo(char *fmt, ...) -{ - va_list ap; - int d; - char c, *p, *s; - - va_start(ap, fmt); - while (*fmt) - switch(*fmt++) { - case 's': /* string */ - s = va_arg(ap, char *); - printf("string %s\en", s); - break; - case 'd': /* int */ - d = va_arg(ap, int); - printf("int %d\en", d); - break; - case 'c': /* char */ - c = va_arg(ap, char); - printf("char %c\en", c); - break; - } - va_end(ap); -} -.fi -.RE -.SH STANDARDS -The -.BR va_start , -.BR va_arg , -and -.B va_end -macros conform to ANSI C3.159-1989 (``ANSI C''). -.SH COMPATIBILITY -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 . -.SH BUGS -Unlike the -.B varargs -macros, the -.B stdarg -macros do not permit programmers to code a function with no fixed -arguments. This problem generates work mainly when converting -.B varargs -code to -.B stdarg -code, but it also creates difficulties for variadic functions that wish to -pass all of their arguments on to a function that takes a -.B va_list -argument, such as -.BR vfprintf (3). diff --git a/man3/stdio.3 b/man3/stdio.3 deleted file mode 100644 index a4192d5062..0000000000 --- a/man3/stdio.3 +++ /dev/null @@ -1,355 +0,0 @@ -.\" Copyright (c) 1990, 1991 Regents of the University of California. -.\" All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)stdio.3 6.5 (Berkeley) 5/6/91 -.\" -.\" Converted for Linux, Mon Nov 29 16:07:22 1993, faith@cs.unc.edu -.\" -.TH STDIO 3 "29 November 1993" "BSD MANPAGE" "Linux Programmer's Manual" -.SH NAME -stdio \- standard input/output library functions -.SH SYNOPSIS -.B #include <stdio.h> -.sp -.B FILE *stdin; -.br -.B FILE *stdout; -.br -.B FILE *stderr; -.SH DESCRIPTION -The standard I/O library provides a simple and efficient buffered stream -I/O interface. Input and ouput is mapped into logical data streams and the -physical I/O characteristics are concealed. The functions and macros are -listed below; more information is available from the individual man pages. -.PP -A stream is associated with an external file (which may be a physical -device) by -.I opening -a file, which may involve creating a new file. Creating an existing file -causes its former contents to be discarded. If a file can support -positioning requests (such as a disk file, as opposed to a terminal) then a -.I file position indicator -associated with the stream is positioned at the start of the file (byte -zero), unless the file is opened with appened mode. If append mode is used, -the position indicator will be placed the end-of-file. The position -indicator is maintained by subsequent reads, writes and positioning -requests. All input occurs as if the characters were read by successive -calls to the -.BR fgetc (3) -function; all ouput takes place as if all characters were read by -successive calls to the -.BR fputc (3) -function. -.PP -A file is disassociated from a stream by -.I closing -the file. Ouput streams are flushed (any unwritten buffer contents are -transfered to the host environment) before the stream is disassociated from -the file. The value of a pointer to a -.B FILE -object is indeterminate after a file is closed (garbage). -.PP -A file may be subsequently reopened, by the same or another program -execution, and its contents reclaimed or modified (if it can be -repositioned at the start). If the main function returns to its original -caller, or the -.BR exit (3) -function is called, all open files are closed (hence all output streams are -flushed) before program termination. Other methods of program termination, -such as -.BR abort (3) -do not bother about closing files properly. -.PP -At program startup, three text streams are predefined and need not be -opened explicitly \(em -.I standard input -(for reading converntional input), \(em -.I standard output -(for writing converntional input), and -.I standard error -(for writing diagnostic output). These streams are abbreviated -.IR stdin , stdout -and -.IR stderr . -When opened, the standard error stream is not fully buffered; the standard -input and output streams are fully buffered if and only if the streams do -not to refer to an interactive device. -.PP -Output streams that refer to terminal devices are always line buffered by -default; pending output to such streams is written automatically whenever -an input stream that refers to a terminal device is read. In cases where a -large amount of computation is done after printing part of a line on an -output terminal, it is necessary to -.BR fflush (3) -the standard output before going off and computing so that the output will -appear. -.PP -The -.B stdio -library is a part of the library -.B libc -and routines are automatically loaded as needed by the compilers -.BR cc (1) -and -.BR pc (1). -The -.B SYNOPSIS -sections of the following manual pages indicate which include files are to -be used, what the compiler declaration for the function looks like and -which external variables are of interest. -.PP -The following are defined as macros; these names may not be re-used without -first removing their current definitions with -.BR #undef : -.BR BUFSIZ , -.BR EOF , -.BR FILENAME_MAX , -.BR FOPEN_MAX , -.BR L_cuserid , -.BR L_ctermid , -.BR L_tmpnam, -.BR NULL , -.BR SEEK_END , -.BR SEEK_SET , -.BR SEE_CUR , -.BR TMP_MAX , -.BR clearerr , -.BR feof , -.BR ferror , -.BR fileno , -.BR fropen , -.BR fwopen , -.BR getc , -.BR getchar , -.BR putc , -.BR putchar , -.BR stderr , -.BR stdin , -.BR stdout . -Function versions of the macro functions -.BR feof , -.BR ferror , -.BR clearerr , -.BR fileno , -.BR getc , -.BR getchar , -.BR putc , -and -.B putchar -exist and will be used if the macros definitions are explicitly removed. -.SH "SEE ALSO" -.BR open "(2), " close "(2), " read "(2), " write (2) -.SH BUGS -The standard buffered functions do not interact well with certain other -library and system functions, especially -.B vfork -and -.BR abort . -This may not be the case under Linux. -.SH STANDARDS -The -.B stdio -library conforms to ANSI C3.159-1989 (``ANSI C''). -.SH "LIST OF FUNCTIONS" -.TP -.B Function -.B Description -.TP -clearerr -check and reset stream status -.TP -fclose -close a stream -.TP -fdopen -stream open functions -.TP -feof -check and reset stream status -.TP -ferror -check and reset stream status -.TP -fflush -flush a stream -.TP -fgetc -get next character or word from input stream -.TP -fgetline -get a line from a stream -.TP -fgetpos -reposition a stream -.TP -fgets -get a line from a stream -.TP -fileno -check and reset stream status -.TP -fopen -stream open functions -.TP -fprintf -formatted output conversion -.TP -fpurge -flush a stream -.TP -fputc -output a character or word to a stream -.TP -fputs -output a line to a stream -.TP -fread -binary stream input/output -.TP -freopen -stream open functions -.TP -fropen -open a stream -.TP -fscanf -input format conversion -.TP -fseek -reposition a stream -.TP -fsetpos -reposition a stream -.TP -ftell -reposition a stream -.TP -fwrite -binary stream input/output -.TP -getc -get next character or word from input stream -.TP -getchar -get next character or word from input stream -.TP -gets -get a line from a stream -.TP -getw -get next character or word from input stream -.TP -mktemp -make temporary file name (unique) -.TP -perror -system error messages -.TP -printf -formatted output conversion -.TP -putc -output a character or word to a stream -.TP -putchar -output a character or word to a stream -.TP -puts -output a line to a stream -.TP -putw -output a character or word to a stream -.TP -remove -remove directory entry -.TP -rewind -reposition a stream -.TP -scanf -input format conversion -.TP -setbuf -stream buffering operations -.TP -setbuffer -stream buffering operations -.TP -setlinebuf -stream buffering operations -.TP -setvbuf -stream buffering operations -.TP -sprintf -formatted output conversion -.TP -sscanf -input format conversion -.TP -strerror -system error messages -.TP -sys_errlist -system error messages -.TP -sys_nerr -system error messages -.TP -tempnam -temporary file routines -.TP -tmpfile -temporary file routines -.TP -tmpnam -temporary file routines -.TP -ungetc -un-get character from input stream -.TP -vfprintf -formatted output conversion -.TP -vfscanf -input format conversion -.TP -vprintf -formatted output conversion -.TP -vscanf -input format conversion -.TP -vsprintf -formatted output conversion -.TP -vsscanf -input format conversion diff --git a/man3/strcasecmp.3 b/man3/strcasecmp.3 index f266581015..8047858026 100644 --- a/man3/strcasecmp.3 +++ b/man3/strcasecmp.3 @@ -31,5 +31,5 @@ an integer less than, equal to, or greater than zero if \fIs1\fP less than, to match, or be greater than \fIs2\fP. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR bcmp "(3), " memcmp "(3), " strcmp "(3), " strcoll "(3), " strncmp (3) diff --git a/man3/strcat.3 b/man3/strcat.3 index 75523ec23a..53f2914f97 100644 --- a/man3/strcat.3 +++ b/man3/strcat.3 @@ -30,5 +30,5 @@ The \fBstrcat()\fP and \fBstrncat()\fP functions return a pointer to the resulting string \fIdest\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR bcopy "(3), " memccpy "(3), " memcpy "(3), " strcpy "(3), " strncpy (3) diff --git a/man3/strchr.3 b/man3/strchr.3 index 4c1bbdf56a..0152bc541a 100644 --- a/man3/strchr.3 +++ b/man3/strchr.3 @@ -27,6 +27,6 @@ The \fBstrchr()\fP and \fBstrrchr()\fP functions return a pointer to the matched character or NULL if the character is not found. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR index "(3), " memchr "(3), " rindex "(3), " strpbrk (3), .BR strsep "(3), " strspn "(3), " strstr "(3), " strtok (3) diff --git a/man3/strcmp.3 b/man3/strcmp.3 index 6b4b6c7450..bd9e3b9c34 100644 --- a/man3/strcmp.3 +++ b/man3/strcmp.3 @@ -31,6 +31,6 @@ less than, equal to, or greater than zero if \fIs1\fP (or the first match, or be greater than \fIs2\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR bcmp "(3), " memcmp "(3), " strcasecmp "(3), " strncasecmp (3), .BR strcoll (3) diff --git a/man3/strcoll.3 b/man3/strcoll.3 index 798c40810a..ad49838790 100644 --- a/man3/strcoll.3 +++ b/man3/strcoll.3 @@ -32,6 +32,6 @@ SVID 3, BSD 4.3, ISO 9899 The Linux C Library currently only understands the \fI"C"\fP or \fI"POSIX"\fP locales in which \fBstrcoll()\fP is equivalent to \fBstrcmp()\fP. -.SH "SEE ALSO" +.SH SEE ALSO .BR bcmp "(3), " memcmp "(3), " strcasecmp "(3), " strcmp (3), .BR strxfrm "(3), " setlocale (3) diff --git a/man3/strcpy.3 b/man3/strcpy.3 index 2e3b3a9e08..c4745ea15e 100644 --- a/man3/strcpy.3 +++ b/man3/strcpy.3 @@ -29,5 +29,5 @@ The \fBstrcpy()\fP and \fBstrncpy()\fP functions return a pointer to the destination string \fIdest\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR bcopy "(3), " memccpy "(3), " memcpy "(3), " memmove (3) diff --git a/man3/strdup.3 b/man3/strdup.3 index 2059f82edf..7d13b7ec5b 100644 --- a/man3/strdup.3 +++ b/man3/strdup.3 @@ -27,5 +27,5 @@ string, or NULL if insufficient memory was available. Insufficient memory available to allocate duplicate string. .SH "CONFORMING TO" SVID 3, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR calloc "(3), " malloc "(3), " realloc "(3), " free (3) diff --git a/man3/strerror.3 b/man3/strerror.3 index e39a47d7f5..abfe27ad32 100644 --- a/man3/strerror.3 +++ b/man3/strerror.3 @@ -23,5 +23,5 @@ The \fBstrerror()\fP function returns the appropriate description string, or an unknown error message if the error code is unknown. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR errno "(2), " perror "(3), " strsignal (3) diff --git a/man3/strfry.3 b/man3/strfry.3 index bb5a1123bd..62d19364b9 100644 --- a/man3/strfry.3 +++ b/man3/strfry.3 @@ -24,5 +24,5 @@ string. .SH "CONFORMING TO" The \fBstrfry()\fP function is unique to the Linux C Library and GNU C Library. -.SH "SEE ALSO" +.SH SEE ALSO .BR memfrob (3) diff --git a/man3/strftime.3 b/man3/strftime.3 index 6be3c2e5cf..48d69981df 100644 --- a/man3/strftime.3 +++ b/man3/strftime.3 @@ -154,7 +154,7 @@ in the array \fIs\fP, not including the terminating NULL character. If the value equals \fImax\fP, it means that the array was too small. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR date "(1), " time "(2), " ctime "(3), " setlocale "(3), " sprintf (3) .SH BUGS The function lacks locale support. diff --git a/man3/string.3 b/man3/string.3 index 36e8141dfd..58da764b97 100644 --- a/man3/string.3 +++ b/man3/string.3 @@ -65,7 +65,7 @@ strrchr, strsep, strspn, strstr, strtok, strxfrm, index, rindex The string functions perform string operations on NULL-terminated strings. See the individual man pages for descriptions of each function. -.SH "SEE ALSO" +.SH SEE ALSO .BR index "(3), " rindex "(3), " strcasecmp "(3), " strcat (3), .BR strchr "(3), " strcmp "(3), " strcoll "(3), " strcpy (3), .BR strcspn "(3), " strdup "(3), " strfry "(3), " strlen (3), diff --git a/man3/strlen.3 b/man3/strlen.3 index a698995bc7..b29735e9f1 100644 --- a/man3/strlen.3 +++ b/man3/strlen.3 @@ -21,5 +21,5 @@ The \fBstrlen()\fP function calculates the length of the string The \fBstrlen()\fP function returns the number of characters in \fIs\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR string (3) diff --git a/man3/strncasecmp.3 b/man3/strncasecmp.3 index fd3b6715e8..9733006a5f 100644 --- a/man3/strncasecmp.3 +++ b/man3/strncasecmp.3 @@ -1 +1 @@ -.so man3/strcasecmp.3 +.so man3/strcasecmp.3
\ No newline at end of file diff --git a/man3/strncmp.3 b/man3/strncmp.3 index 1007f4346c..5339168b84 100644 --- a/man3/strncmp.3 +++ b/man3/strncmp.3 @@ -1 +1 @@ -.so man3/strcmp.3 +.so man3/strcmp.3
\ No newline at end of file diff --git a/man3/strpbrk.3 b/man3/strpbrk.3 index 30b699d679..2370bd4508 100644 --- a/man3/strpbrk.3 +++ b/man3/strpbrk.3 @@ -22,6 +22,6 @@ The \fBstrpbrk()\fP function returns a pointer to the character in \fIs\fP that matches one of the characters in \fIaccept\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR index "(3), " memchr "(3), " rindex "(3), " strchr (3), .BR strsep "(3), " strspn "(3), " strstr "(3), " strtok (3) diff --git a/man3/strsep.3 b/man3/strsep.3 index 9d4d55d65c..88166df46a 100644 --- a/man3/strsep.3 +++ b/man3/strsep.3 @@ -24,6 +24,6 @@ The \fBstrsep()\fP function returns a pointer to the token, or NULL if \fIdelim\fP is not found in \fIstringp\fP. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR index "(3), " memchr "(3), " rindex "(3), " strchr (3), .BR strpbrk "(3), " strspn "(3), " strstr "(3), " strtok (3) diff --git a/man3/strsignal.3 b/man3/strsignal.3 index 3f66e91c02..0d102051b1 100644 --- a/man3/strsignal.3 +++ b/man3/strsignal.3 @@ -26,5 +26,5 @@ indexed by signal number. .SH "RETURN VALUE" The \fBstrsignal()\fP function returns the appropriate description string, or an unknown signal message if the signal number is invalid. -.SH "SEE ALSO" +.SH SEE ALSO .BR psignal "(3), " strerror (3) diff --git a/man3/strspn.3 b/man3/strspn.3 index 808c3cc966..56d2a95e92 100644 --- a/man3/strspn.3 +++ b/man3/strspn.3 @@ -34,6 +34,6 @@ the inital segment of \fIs\fP which are not in the string \fIreject\fP. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR index "(3), " memchr "(3), " rindex "(3), " strchr (3), .BR strpbrk "(3), " strsep "(3), " strstr "(3), " strtok (3) diff --git a/man3/strstr.3 b/man3/strstr.3 index f057b19b5d..e5c0fbf9ad 100644 --- a/man3/strstr.3 +++ b/man3/strstr.3 @@ -21,6 +21,6 @@ characters are not compared. .SH "RETURN VALUE" The \fBstrstr()\fP function returns a pointer to the beginning of the substring, or NULL if the substring is not found. -.SH "SEE ALSO" +.SH SEE ALSO .BR index "(3), " memchr "(3), " rindex "(3), " strchr (3), .BR strpbrk "(3), " strsep "(3), " strspn "(3), " strtok (3) diff --git a/man3/strtok.3 b/man3/strtok.3 index 8f2eaa2b39..4d316dfb79 100644 --- a/man3/strtok.3 +++ b/man3/strtok.3 @@ -31,6 +31,6 @@ The \fBstrtok()\fP function returns a pointer to the next token, or NULL if there are no more tokens. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR index "(3), " memchr "(3), " rindex "(3), " strchr (3), .BR strpbrk "(3), " strsep "(3), " strspn "(3), " strstr (3) diff --git a/man3/strtol.3 b/man3/strtol.3 index 0ecdcd91c2..970272ff56 100644 --- a/man3/strtol.3 +++ b/man3/strtol.3 @@ -50,7 +50,7 @@ returns LONG_MAX. In both cases, \fIerrno\fP is set to ERANGE. The given string was out of range; the value converted has been clamped. .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR atof "(3), " atoi "(3), " atol "(3), " strtod "(3), " strtoul (3) .SH BUGS Ignores the current locale. diff --git a/man3/strtoul.3 b/man3/strtoul.3 index 5ee1a0720a..5b1174a9f8 100644 --- a/man3/strtoul.3 +++ b/man3/strtoul.3 @@ -52,7 +52,7 @@ variable \fIerrno\fP to ERANGE. The given string was out of range; the value converted has been clamped. .SH "CONFORMING TO" SVID 3, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR atof "(3), " atoi "(3), " atol "(3), " strtod "(3), " strtol (3) .SH BUGS Ignores the current locale. diff --git a/man3/strxfrm.3 b/man3/strxfrm.3 index 8b903e7f79..b71839053f 100644 --- a/man3/strxfrm.3 +++ b/man3/strxfrm.3 @@ -33,6 +33,6 @@ SVID 3, BSD 4.3, ISO 9899 The Linux C Library currently only understands the \fI"C"\fP or \fI"POSIX"\fP locales in which \fBstrxfrm()\fP is equivalent to copying the string using \fBstrncpy()\fP. -.SH "SEE ALSO" +.SH SEE ALSO .BR bcmp "(3), " memcmp "(3), " strcasecmp "(3), " strcmp (3), .BR strcoll "(3), " setlocale (3) diff --git a/man3/swab.3 b/man3/swab.3 index 32b390756b..edd8b000e7 100644 --- a/man3/swab.3 +++ b/man3/swab.3 @@ -23,5 +23,5 @@ between machines that have different low/high byte ordering. The \fBswab()\fP function returns no value. .SH "CONFORMING TO" SVID 3, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR bstring (3) diff --git a/man3/sysconf.3 b/man3/sysconf.3 index af28bee615..bbb2e535fa 100644 --- a/man3/sysconf.3 +++ b/man3/sysconf.3 @@ -190,5 +190,5 @@ memory. .PP POSIX.2 is not yet an approved standard; the information in this manpage is subject to change. -.SH "SEE ALSO" +.SH SEE ALSO .BR bc "(1), " expr "(1), " locale "(1), " fpathconf "(3), " pathconf (3) diff --git a/man3/system.3 b/man3/system.3 index d902c773f6..deef3bd8e0 100644 --- a/man3/system.3 +++ b/man3/system.3 @@ -68,5 +68,5 @@ indication that the call failed; check .I errno to make sure. -.SH "SEE ALSO" +.SH SEE ALSO .BR sh "(1), " exec "(2), " signal (2) diff --git a/man3/tan.3 b/man3/tan.3 index a0d6594a70..8a9e068488 100644 --- a/man3/tan.3 +++ b/man3/tan.3 @@ -19,5 +19,5 @@ The \fBtan()\fP function returns the tangent of \fIx\fP, where \fIx\fP is given in radians. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR acos "(3), " asin "(3), " atan "(3), " atan2 "(3), " cos "(3), " sin (3) diff --git a/man3/tanh.3 b/man3/tanh.3 index 6991b8a8ce..61e07f1ab8 100644 --- a/man3/tanh.3 +++ b/man3/tanh.3 @@ -19,5 +19,5 @@ The \fBtanh()\fP function returns the hyperbolic tangent of \fIx\fP, which is defined mathematically as sinh(x) / cosh(x). .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR acosh "(3), " asinh "(3), " atanh "(3), " cosh "(3), " sinh (3) diff --git a/man3/telldir.3 b/man3/telldir.3 index 1379d15c95..78bba8f86e 100644 --- a/man3/telldir.3 +++ b/man3/telldir.3 @@ -19,13 +19,13 @@ The \fBtelldir()\fP function returns the current location associated with the directory stream \fIdir\fP. .SH "RETURN VALUE" The \fBtelldir()\fP function returns the current location in the directory -stream or \-1 if an error occurs. +stream or -1 if an error occurs. .SH "ERRORS" .TP .B EBADF Invalid directory stream descriptor \fIdir\fP. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR opendir "(3), " readdir "(3), " closedir "(3), " rewinddir (3), .BR seekdir "(3), " scandir (3) diff --git a/man3/tempnam.3 b/man3/tempnam.3 index 8dc0b55281..84a219b7f6 100644 --- a/man3/tempnam.3 +++ b/man3/tempnam.3 @@ -42,5 +42,5 @@ filename, or NULL if a unique filename cannot be generated. Unable to generate a unique filename. .SH "CONFORMING TO" SVID 3, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR mktemp "(3), " mkstemp "(3), " tmpnam "(3), " tmpfile (3) diff --git a/man3/tmpfile.3 b/man3/tmpfile.3 index 1cea8d63ee..2bacdb4c14 100644 --- a/man3/tmpfile.3 +++ b/man3/tmpfile.3 @@ -42,5 +42,5 @@ Too many files open in system. Read-only filesystem. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR mktemp "(3), " mkstemp "(3), " tmpnam "(3), " tempnam (3) diff --git a/man3/tmpnam.3 b/man3/tmpnam.3 index 61fcc3d424..5602557d0f 100644 --- a/man3/tmpnam.3 +++ b/man3/tmpnam.3 @@ -30,5 +30,5 @@ filename, or NULL if a unique name cannot be generated. Unable to generate a unique filename. .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR mktemp "(3), " mkstemp "(3), " tempnam "(3), " tmpfile (3) diff --git a/man3/tolower.3 b/man3/tolower.3 deleted file mode 100644 index 033f16e9e0..0000000000 --- a/man3/tolower.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/toupper.3 diff --git a/man3/tzset.3 b/man3/tzset.3 index ed95ef8ef2..bd8934d89d 100644 --- a/man3/tzset.3 +++ b/man3/tzset.3 @@ -101,6 +101,6 @@ relative to the system time conversion information directory .fi .SH "CONFORMING TO" SVID 3, POSIX, BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR date "(1), " gettimeofday "(2), " time "(2), " ctime (3), .BR getenv "(3), " tzfile (5) diff --git a/man3/usleep.3 b/man3/usleep.3 index f74cd7140c..8e7e10f71c 100644 --- a/man3/usleep.3 +++ b/man3/usleep.3 @@ -20,5 +20,5 @@ The \fBusleep()\fP function suspends execution of the calling process for system activity or by the time spent processing the call. .SH "CONFORMING TO" BSD 4.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR setitimer "(2), " getitimer "(2), " sleep "(3), " alarm "(3), " select (3) diff --git a/man3/vfprintf.3 b/man3/vfprintf.3 deleted file mode 100644 index 975530d90a..0000000000 --- a/man3/vfprintf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/printf.3 diff --git a/man3/vfscanf.3 b/man3/vfscanf.3 deleted file mode 100644 index 9fd424bb27..0000000000 --- a/man3/vfscanf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/scanf.3 diff --git a/man3/vprintf.3 b/man3/vprintf.3 deleted file mode 100644 index 975530d90a..0000000000 --- a/man3/vprintf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/printf.3 diff --git a/man3/vscanf.3 b/man3/vscanf.3 deleted file mode 100644 index 9fd424bb27..0000000000 --- a/man3/vscanf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/scanf.3 diff --git a/man3/vsprintf.3 b/man3/vsprintf.3 deleted file mode 100644 index 975530d90a..0000000000 --- a/man3/vsprintf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/printf.3 diff --git a/man3/vsscanf.3 b/man3/vsscanf.3 deleted file mode 100644 index 9fd424bb27..0000000000 --- a/man3/vsscanf.3 +++ /dev/null @@ -1 +0,0 @@ -.so man3/scanf.3 diff --git a/man3/wcstombs.3 b/man3/wcstombs.3 index 7892ea36ec..3f8f9c7805 100644 --- a/man3/wcstombs.3 +++ b/man3/wcstombs.3 @@ -19,9 +19,9 @@ The \fBwcstombs()\fP function converts a sequence of wide characters from the array \fIpwcs\fP into a sequence of multibyte characters and stores up to \fIn\fP bytes of multibyte characters in the array \fIs\fP. .SH "RETURN VALUE" -\fBwcstombs()\fP returns the number of bytes stored in \fIs\fP or \-1 if +\fBwcstombs()\fP returns the number of bytes stored in \fIs\fP or -1 if \fIs\fP contains an invalid wide character. .SH "CONFORMING TO" SVID 3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR mblen "(3), " mbtowc "(3), " mbstowcs "(3), " wctomb (3) diff --git a/man3/wctomb.3 b/man3/wctomb.3 index e7e9d0931b..f813d2eade 100644 --- a/man3/wctomb.3 +++ b/man3/wctomb.3 @@ -20,8 +20,8 @@ into a multibyte character and, if \fIs\fP is not NULL, stores the multibyte character representation in \fIs\fP. .SH "RETURN VALUE" \fBwctomb()\fP returns the number of bytes in the multibyte character -or \-1 if the wide character is not valid. +or -1 if the wide character is not valid. .SH "CONFORMING TO" SVID 3, ISO 9899 -.SH "SEE ALSO" +.SH SEE ALSO .BR mblen "(3), " mbstowcs "(3), " mbtowc "(3), " wcstombs (3) |