aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--man3/stdin.331
1 files changed, 17 insertions, 14 deletions
diff --git a/man3/stdin.3 b/man3/stdin.3
index e60c595b8d..6c3524c337 100644
--- a/man3/stdin.3
+++ b/man3/stdin.3
@@ -6,7 +6,7 @@
.\"
.\" 2007-12-08, mtk, Converted from mdoc to man macros
.\"
-.TH STDIN 3 2007-12-28 "Linux" "Linux Programmer's Manual"
+.TH STDIN 3 2008-07-14 "Linux" "Linux Programmer's Manual"
.SH NAME
stdin, stdout, stderr \- standard I/O streams
.SH SYNOPSIS
@@ -106,11 +106,22 @@ and
The standard streams are closed by a call to
.BR exit (3)
and by normal program termination.
-.SH CONSIDERATIONS
+.SH "CONFORMING TO"
+The
+.IR stdin ,
+.IR stdout ,
+and
+.I stderr
+macros conform to C89
+and this standard also stipulates that these three
+streams shall be open at program startup.
+.SH NOTES
The stream
-stderr is unbuffered.
+.I stderr
+is unbuffered.
The stream
-stdout is line-buffered when it points to a terminal.
+.I stdout
+is line-buffered when it points to a terminal.
Partial lines will not
appear until
.BR fflush (3)
@@ -126,7 +137,8 @@ or
.BR setvbuf (3)
call.
Note that in case
-stdin is associated with a terminal, there may also be input buffering
+.I stdin
+is associated with a terminal, there may also be input buffering
in the terminal driver, entirely unrelated to stdio buffering.
(Indeed, normally terminal input is line buffered in the kernel.)
This kernel input handling can be modified using calls like
@@ -135,15 +147,6 @@ see also
.BR stty (1),
and
.BR termios (3).
-.SH "CONFORMING TO"
-The
-.IR stdin ,
-.IR stdout ,
-and
-.I stderr
-macros conform to C89
-and this standard also stipulates that these three
-streams shall be open at program startup.
.SH SEE ALSO
.BR sh (1),
.BR csh (1),