summaryrefslogtreecommitdiff
path: root/lib/libc/stdio
diff options
context:
space:
mode:
Diffstat (limited to 'lib/libc/stdio')
-rw-r--r--lib/libc/stdio/fopen.35
-rw-r--r--lib/libc/stdio/mktemp.36
-rw-r--r--lib/libc/stdio/printf.322
-rw-r--r--lib/libc/stdio/putc.35
-rw-r--r--lib/libc/stdio/putwc.35
-rw-r--r--lib/libc/stdio/scanf.36
-rw-r--r--lib/libc/stdio/stdio.325
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