From e7734b4a66f0d860698538cef13e6392ff8fdaf7 Mon Sep 17 00:00:00 2001 From: Pádraig Brady
Date: Fri, 1 Jul 2011 09:42:17 +0100 Subject: 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(-) (limited to 'doc/coreutils.texi') 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. -- cgit v1.2.3-70-g09d2