diff options
Diffstat (limited to 'lib/libc/stdio')
| -rw-r--r-- | lib/libc/stdio/fopen.3 | 5 | ||||
| -rw-r--r-- | lib/libc/stdio/mktemp.3 | 6 | ||||
| -rw-r--r-- | lib/libc/stdio/printf.3 | 22 | ||||
| -rw-r--r-- | lib/libc/stdio/putc.3 | 5 | ||||
| -rw-r--r-- | lib/libc/stdio/putwc.3 | 5 | ||||
| -rw-r--r-- | lib/libc/stdio/scanf.3 | 6 | ||||
| -rw-r--r-- | lib/libc/stdio/stdio.3 | 25 |
7 files changed, 40 insertions, 34 deletions
diff --git a/lib/libc/stdio/fopen.3 b/lib/libc/stdio/fopen.3 index dcb9bf88fb8..31bcd5cdb5b 100644 --- a/lib/libc/stdio/fopen.3 +++ b/lib/libc/stdio/fopen.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: fopen.3,v 1.17 2002/07/10 14:37:16 yamt Exp $ +.\" $NetBSD: fopen.3,v 1.18 2002/10/01 17:24:05 wiz Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -97,7 +97,8 @@ and has no effect; the ``b'' is ignored. The letter ``f'' in the mode string restricts fopen to regular files; if the file opened is not a regular file, .Fn fopen -will fail. This is a non +will fail. +This is a non .St -ansiC extension. .Pp diff --git a/lib/libc/stdio/mktemp.3 b/lib/libc/stdio/mktemp.3 index 400f29e26ec..b86e1d7b1ca 100644 --- a/lib/libc/stdio/mktemp.3 +++ b/lib/libc/stdio/mktemp.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: mktemp.3,v 1.16 2002/08/10 09:32:19 yamt Exp $ +.\" $NetBSD: mktemp.3,v 1.17 2002/10/01 17:24:05 wiz Exp $ .\" .\" Copyright (c) 1989, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -101,8 +101,8 @@ but it creates a mode 0700 directory instead and returns the path. Please note that the permissions of the file or directory being created are subject to the restrictions imposed by the .Xr umask 2 -system call. It may thus happen that the created file is unreadable and/or -unwritable. +system call. +It may thus happen that the created file is unreadable and/or unwritable. .Sh RETURN VALUES The .Fn mktemp diff --git a/lib/libc/stdio/printf.3 b/lib/libc/stdio/printf.3 index 567b41e7792..2b483d4b233 100644 --- a/lib/libc/stdio/printf.3 +++ b/lib/libc/stdio/printf.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: printf.3,v 1.26 2002/07/10 14:37:16 yamt Exp $ +.\" $NetBSD: printf.3,v 1.27 2002/10/01 17:24:06 wiz Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -286,14 +286,13 @@ overrides a space if both are used. 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. +flag has been given) to fill out the field width. .It An optional precision, in the form of a period .Sq Cm \&. -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 +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 .Cm d , .Cm i , .Cm o , @@ -460,8 +459,7 @@ A character that specifies the type of conversion to be applied. A field width or precision, or both, may be indicated by an asterisk .Ql * -instead of a -digit string. +instead of a digit string. In this case, an .Em int argument supplies the field width or precision. @@ -486,7 +484,8 @@ or unsigned hexadecimal .Pf ( Cm x and .Cm X ) -notation. The letters +notation. +The letters .Cm abcdef are used for .Cm x @@ -632,8 +631,9 @@ No argument is converted. .It Cm % A .Ql % -is written. No argument is converted. The complete conversion specification -is +is written. +No argument is converted. +The complete conversion specification is .Ql %% . .El .Pp diff --git a/lib/libc/stdio/putc.3 b/lib/libc/stdio/putc.3 index f3bfcd52f6a..212930121ec 100644 --- a/lib/libc/stdio/putc.3 +++ b/lib/libc/stdio/putc.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: putc.3,v 1.7 2002/02/07 07:00:26 ross Exp $ +.\" $NetBSD: putc.3,v 1.8 2002/10/01 17:24:06 wiz Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -77,7 +77,8 @@ to the output stream pointed to by .Fn putc acts essentially identically to .Fn fputc , -but is a macro that expands in-line. It may evaluate +but is a macro that expands in-line. +It may evaluate .Fa stream more than once, so arguments given to .Fn putc diff --git a/lib/libc/stdio/putwc.3 b/lib/libc/stdio/putwc.3 index 99577f9353a..e362dc01106 100644 --- a/lib/libc/stdio/putwc.3 +++ b/lib/libc/stdio/putwc.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: putwc.3,v 1.2 2002/02/07 07:00:26 ross Exp $ +.\" $NetBSD: putwc.3,v 1.3 2002/10/01 17:24:07 wiz Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -68,7 +68,8 @@ to the output stream pointed to by .Fn putwc acts essentially identically to .Fn fputwc , -but is a macro that expands in-line. It may evaluate +but is a macro that expands in-line. +It may evaluate .Fa stream more than once, so arguments given to .Fn putwc diff --git a/lib/libc/stdio/scanf.3 b/lib/libc/stdio/scanf.3 index f086f9ee82f..d2157a2ef00 100644 --- a/lib/libc/stdio/scanf.3 +++ b/lib/libc/stdio/scanf.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: scanf.3,v 1.14 2002/02/07 07:00:26 ross Exp $ +.\" $NetBSD: scanf.3,v 1.15 2002/10/01 17:24:07 wiz Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -399,8 +399,8 @@ conversion. The value .Dv 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, +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 .Xr getc 3 , diff --git a/lib/libc/stdio/stdio.3 b/lib/libc/stdio/stdio.3 index cc169283adf..c1af481e563 100644 --- a/lib/libc/stdio/stdio.3 +++ b/lib/libc/stdio/stdio.3 @@ -1,4 +1,4 @@ -.\" $NetBSD: stdio.3,v 1.14 2002/02/07 07:00:27 ross Exp $ +.\" $NetBSD: stdio.3,v 1.15 2002/10/01 17:24:08 wiz Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -55,22 +55,25 @@ interface. Input and output is mapped into logical data streams and the physical .Tn I/O -characteristics are concealed. The functions and macros are listed -below; more information is available from the individual man pages. +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 .Em opening -a file, which may involve creating a new file. Creating an -existing file causes its former contents to be discarded. +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 .Em file position indicator associated with the stream is positioned at the start of the file (byte -zero), unless the file is opened with append mode. If append mode +zero), unless the file is opened with append 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 +and positioning requests. +All input occurs as if the characters were read by successive calls to the .Xr fgetc 3 function; all output takes place as if all characters were @@ -89,12 +92,12 @@ 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 +at the start). +If the main function returns to its original caller, or the .Xr 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 +streams are flushed) before program termination. +Other methods of program termination, such as .Xr abort 3 do not bother about closing files properly. .Pp |
