aboutsummaryrefslogtreecommitdiffstats
path: root/man3/stdin.3
diff options
context:
space:
mode:
Diffstat (limited to 'man3/stdin.3')
-rw-r--r--man3/stdin.312
1 files changed, 9 insertions, 3 deletions
diff --git a/man3/stdin.3 b/man3/stdin.3
index 6c10c3391b..a3c6fa2044 100644
--- a/man3/stdin.3
+++ b/man3/stdin.3
@@ -40,12 +40,16 @@ and
Each of these symbols is a
.BR stdio (3)
-macro of type pointer to FILE, and can be used with functions like
+macro of type pointer to
+.IR FILE ,
+and can be used with functions like
.BR fprintf (3)
or
.BR fread (3).
.sp
-Since FILEs are a buffering wrapper around Unix file descriptors, the
+Since
+.IR FILE s
+are a buffering wrapper around Unix file descriptors, the
same underlying files may also be accessed using the raw Unix file
interface, that is, the functions like
.BR read (2)
@@ -71,7 +75,9 @@ are defined with these values in
to one of these streams can change the file descriptor number
associated with the stream.)
.sp
-Note that mixing use of FILEs and raw file descriptors can produce
+Note that mixing use of
+.IR FILE s
+and raw file descriptors can produce
unexpected results and should generally be avoided.
(For the masochistic among you: POSIX.1, section 8.2.3, describes
in detail how this interaction is supposed to work.)