Allow --rate to be used with --numeric (#17).

docs/ACKNOWLEDGEMENTS.md

@@ -98,5 +98,6 @@ is acknowledged and greatly appreciated:
  * [jettero](https://codeberg.org/jettero) - reported double-free coredump when using "`--watchfd`" after 1.8.10 ([#96](https://codeberg.org/a-j-wood/pv/issues/96))
  * Hartmut Goebel - provided a full set of new German translations ([#98](https://codeberg.org/a-j-wood/pv/pulls/98))
  * Venky.N.Iyer - suggested "`--stats`" ([#49](https://codeberg.org/a-j-wood/pv/issues/49))
+ * Roland Kletzing - suggested "`--rate`" with "`--numeric`" ([#17](https://codeberg.org/a-j-wood/pv/issues/17))
 
 ---

docs/NEWS.md

@@ -1,6 +1,7 @@
 ### UNRELEASED
 
  * feature: new "`--stats`" option to show transfer stats at the end, like "`ping`" ([#49](https://codeberg.org/a-j-wood/pv/issues/49))
+ * feature: "`--rate`" can now be used with "`--numeric`" ([#17](https://codeberg.org/a-j-wood/pv/issues/17))
  * i18n: complete set of German translations supplied by Hartmut Goebel ([#98](https://codeberg.org/a-j-wood/pv/pulls/98))
  * fix: resume stopped pipelines when running in the background (part of [#56](https://codeberg.org/a-j-wood/pv/issues/56))
  * fix: write UTC timestamps in debugging mode to avoid lockups in signal handlers

docs/pv.1

@@ -214,7 +214,7 @@ is not required if
 is being used.
 .TP
 .B ""
-Note that if
+If
 .B \-\-numeric
 is in use, then adding
 .B \-\-bytes
@@ -226,12 +226,16 @@ is also in use as well as
 and
 .BR \-\-numeric ,
 then instead of bytes or a percentage, the number of lines
-so far is output.  And finally, if
+so far is output.  If
+.B \-\-rate
+is added, then the transfer rate is also output (if
+.B \-\-bytes
+is in use as well, the rate comes after the byte/line count).
+If
 .B \-\-timer
-is added to
-.BR \-\-numeric ,
-then each output line is prefixed with the elapsed time 
-so far, as a decimal number of seconds.
+is also added, then each output line is
+.I prefixed
+with the elapsed time so far, as a decimal number of seconds.
 .TP
 .B \-q, \-\-quiet
 No output.  Useful if the

docs/pv.1.md

@@ -158,14 +158,15 @@ that are explicitly switched on will be shown.
     **dialog**(1). Note that **-f** is not required if **-n** is being
     used.
 
-:   Note that if **\--numeric** is in use, then adding **\--bytes** will
-    cause the number of bytes processed so far to be output instead of a
+:   If **\--numeric** is in use, then adding **\--bytes** will cause the
+    number of bytes processed so far to be output instead of a
     percentage; if **\--line-mode** is also in use as well as
     **\--bytes** and **\--numeric**, then instead of bytes or a
-    percentage, the number of lines so far is output. And finally, if
-    **\--timer** is added to **\--numeric**, then each output line is
-    prefixed with the elapsed time so far, as a decimal number of
-    seconds.
+    percentage, the number of lines so far is output. If **\--rate** is
+    added, then the transfer rate is also output (if **\--bytes** is in
+    use as well, the rate comes after the byte/line count). If
+    **\--timer** is also added, then each output line is *prefixed* with
+    the elapsed time so far, as a decimal number of seconds.
 
 **-q, \--quiet**