summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPádraig Brady <P@draigBrady.com>2011-07-01 09:42:17 +0100
committerPádraig Brady <P@draigBrady.com>2011-07-01 22:47:54 +0100
commite7734b4a66f0d860698538cef13e6392ff8fdaf7 (patch)
tree2187b0933d2a69a1e251a7adad3d9f9948b9fcbc
parent0c87ba4693e871b7d668056674f160001f73b460 (diff)
downloadcoreutils-e7734b4a66f0d860698538cef13e6392ff8fdaf7.tar.xz
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.
-rw-r--r--doc/coreutils.texi7
1 files changed, 6 insertions, 1 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 4b0917d3f..c59af2f47 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.