From: Pádraig Brady <P@draigBrady.com>
Date: Fri, 1 Jul 2011 08:42:17 +0000 (+0100)
Subject: doc: detail the effect of disabling input buffering with stdbuf
X-Git-Tag: v8.13~91
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=e7734b4a66f0d860698538cef13e6392ff8fdaf7;p=platform%2Fupstream%2Fcoreutils.git

doc: detail the effect of disabling input buffering with stdbuf

* docs/coreutils.texi (stdbuf invocation): Expand on the different
reasons for disabling buffering on input and output.
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 4b0917d..c59af2f 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -15448,8 +15448,13 @@ This option is invalid with standard input.
 
 @item 0
 Disable buffering of the selected stream.
-In this mode data is output immediately and only the
+In this mode, data is output immediately and only the
 amount of data requested is read from input.
+Note the difference in function for input and output.
+Disabling buffering for input will not influence the responsiveness
+or blocking behavior of the stream input functions.
+For example @code{fread} will still block until @code{EOF} or error,
+even if the underlying @code{read} returns less data than requested.
 
 @item @var{size}
 Specify the size of the buffer to use in fully buffered mode.