Adjust the text relating to splice() in relation to the intermediate pipe development.

docs/pv.1

@@ -285,16 +285,16 @@ from or to a pipe than regular \fBread\fR(2) and \fBwrite\fR(2), but means
 that the transfer buffer may not be used.
 This prevents \*(lq\fB\-\-buffer\-percent\fR\*(rq and
 \*(lq\fB\-\-last\-written\fR\*(rq from working, cannot work with
-\*(lq\fB\-\-sparse\fR\*(rq or \*(lq\fB\-\-discard\fR\*(rq, and makes
-\*(lq\fB\-\-buffer\-size\fR\*(rq redundant, so using any of those options
-automatically switches on \*(lq\fB\-\-no\-splice\fR\*(rq.
+\*(lq\fB\-\-sparse\fR\*(rq, and makes \*(lq\fB\-\-buffer\-size\fR\*(rq
+redundant, so using any of those options automatically switches on
+\*(lq\fB\-\-no\-splice\fR\*(rq.
 Switching on this option results in a small loss of transfer efficiency.
 It has no effect on systems where \fBsplice\fR(2) is unavailable.
 .TP
 .BI \-J\  BYTES \fR,\ \fB\-\-pipe\-buffer\-size\  BYTES
-Attempt to set the size of the output pipe buffer to \fIBYTES\fR bytes.
-This will only have an effect if the output is a pipe, and will silently do
-nothing if the requested size cannot be achieved.
+Attempt to set the size of the output pipe buffer, and the intermediate
+input pipe buffer if one is needed, to \fIBYTES\fR bytes.
+This will silently do nothing if the requested size cannot be achieved.
 If this option is not specified, and both the output and the first input are
 pipes, then the output pipe buffer size will automatically be increased to
 match the input pipe buffer, if it was smaller.
@@ -369,9 +369,6 @@ This can be useful if you have a pipeline which generates data (your
 input) quickly but you don't know the size, and you wish to pass it to some
 slower process, once all of the input has been generated and you know its
 size, so you can see its progress.
-Note that when doing this with relatively small amounts of data,
-\*(lq\fB\-\-no-splice\fR\*(rq may be preferable so that pipe buffering
-doesn't affect the progress display.
 .\"
 .\"
 .SS "Alternative operating modes"
@@ -754,7 +751,7 @@ the progress display:
 .PP
 .in +4
 .EX
-pv \-\-format '%a %p : %L' big.log | processing-script
+pv \-\-no\-splice \-\-format '%a %p : %L' big.log | processing-script
 .EE
 .in
 .PP

docs/pv.1.md

@@ -294,20 +294,21 @@ are explicitly switched on will be shown.
     data from or to a pipe than regular **read**(2) and **write**(2),
     but means that the transfer buffer may not be used. This prevents
     "**\--buffer-percent**" and "**\--last-written**" from working,
-    cannot work with "**\--sparse**" or "**\--discard**", and makes
-    "**\--buffer-size**" redundant, so using any of those options
-    automatically switches on "**\--no-splice**". Switching on this
-    option results in a small loss of transfer efficiency. It has no
-    effect on systems where **splice**(2) is unavailable.
+    cannot work with "**\--sparse**", and makes "**\--buffer-size**"
+    redundant, so using any of those options automatically switches on
+    "**\--no-splice**". Switching on this option results in a small loss
+    of transfer efficiency. It has no effect on systems where
+    **splice**(2) is unavailable.
 
 **-J BYTES, \--pipe-buffer-size BYTES**
 
-:   Attempt to set the size of the output pipe buffer to *BYTES* bytes.
-    This will only have an effect if the output is a pipe, and will
-    silently do nothing if the requested size cannot be achieved. If
-    this option is not specified, and both the output and the first
-    input are pipes, then the output pipe buffer size will automatically
-    be increased to match the input pipe buffer, if it was smaller.
+:   Attempt to set the size of the output pipe buffer, and the
+    intermediate input pipe buffer if one is needed, to *BYTES* bytes.
+    This will silently do nothing if the requested size cannot be
+    achieved. If this option is not specified, and both the output and
+    the first input are pipes, then the output pipe buffer size will
+    automatically be increased to match the input pipe buffer, if it was
+    smaller.
 
 **-E, \--skip-errors**
 
@@ -383,10 +384,7 @@ are explicitly switched on will be shown.
     This can be useful if you have a pipeline which generates data (your
     input) quickly but you don\'t know the size, and you wish to pass it
     to some slower process, once all of the input has been generated and
-    you know its size, so you can see its progress. Note that when doing
-    this with relatively small amounts of data, "**\--no-splice**" may
-    be preferable so that pipe buffering doesn\'t affect the progress
-    display.
+    you know its size, so you can see its progress.
 
 ## Alternative operating modes
 
@@ -722,7 +720,7 @@ display:
 Sending logs to a processing script, showing the most recent line as
 part of the progress display:
 
-    pv --format '%a %p : %L' big.log | processing-script
+    pv --no-splice --format '%a %p : %L' big.log | processing-script
 
 Showing progress as lines of JSON data: