Pádraig Brady wrote:
...
> I think I'll move the warning to count=
> as it's mostly an issue when that is specified.
Good idea.
>> @item of=@var{file}
>> @opindex of
>> @@ -8397,6 +8398,9 @@ may return early if a full block is not available.
>> When that happens, continue calling @code{read} to fill the remainder
>> of the block.
>> This flag can be used only with @code{iflag}.
>> +If the input is a pipe and argument @samp{count=} also is specified,
>> +then probably @samp{iflag=fullblock} should be used
>> +in order to prevent surprises caused by short reads.
>
> How about this instead?
Looks good. Thanks.
> diff --git a/doc/coreutils.texi b/doc/coreutils.texi
...
> @@ -8397,6 +8402,10 @@ may return early if a full block is not available.
> When that happens, continue calling @code{read} to fill the remainder
> of the block.
> This flag can be used only with @code{iflag}.
> +This flag is useful with pipes for example
> +as they may return short reads. I that case,
s/I/In/
...
