From c2d5d31832de35b48a0e487f90b9a58abeb3a8ea Mon Sep 17 00:00:00 2001 From: Aaron Campbell Date: Tue, 18 Apr 2000 03:01:36 +0000 Subject: Repairs, mostly removing hard sentence breaks. --- lib/libc/stdio/stdio.3 | 29 +++++++++++++++++------------ 1 file changed, 17 insertions(+), 12 deletions(-) (limited to 'lib/libc/stdio/stdio.3') diff --git a/lib/libc/stdio/stdio.3 b/lib/libc/stdio/stdio.3 index b49d87d61e5..401a7f7c04a 100644 --- a/lib/libc/stdio/stdio.3 +++ b/lib/libc/stdio/stdio.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: stdio.3,v 1.11 2000/04/15 02:15:24 aaron Exp $ +.\" $OpenBSD: stdio.3,v 1.12 2000/04/18 03:01:35 aaron Exp $ .\" .\" Copyright (c) 1990, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -51,22 +51,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 +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 at 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 @@ -85,15 +88,17 @@ object is indeterminate (garbage) after a file is closed. .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 may not close files properly and hence -buffered output may be lost. In particular, +streams are flushed) before program termination. +Other methods of program termination may not close files properly and hence +buffered output may be lost. +In particular, .Xr _exit 2 -does not flush stdio files. Neither does an exit due to a signal. +does not flush stdio files. +Neither does an exit due to a signal. Buffers are flushed by .Xr abort 3 as required by POSIX, although previous implementations did not. -- cgit v1.2.3