From e7734b4a66f0d860698538cef13e6392ff8fdaf7 Mon Sep 17 00:00:00 2001 From: =?utf8?q?P=C3=A1draig=20Brady?= Date: Fri, 1 Jul 2011 09:42:17 +0100 Subject: [PATCH] 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. --- doc/coreutils.texi | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/doc/coreutils.texi b/doc/coreutils.texi index 4b0917d3f5..c59af2f47a 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. -- 2.47.2