diff --git a/docs/pv.1 b/docs/pv.1
index 632ea9b..cca58d9 100644
--- a/docs/pv.1
+++ b/docs/pv.1
@@ -558,6 +558,15 @@ pv \-\-watchfd 1234
 .EE
 .in
 .PP
+Rate-limiting the transfer between two processes in a pipeline, with no
+display:
+.PP
+.in +4
+.EX
+producer | pv \-\-quiet \-\-rate\-limit 1M | consumer
+.EE
+.in
+.PP
 Sending logs to a processing script, showing the most recent line as part of
 the progress display:
 .PP
diff --git a/docs/pv.1.md b/docs/pv.1.md
index fe8cf03..a9378e6 100644
--- a/docs/pv.1.md
+++ b/docs/pv.1.md
@@ -554,6 +554,11 @@ process 1234:
 
     pv --watchfd 1234
 
+Rate-limiting the transfer between two processes in a pipeline, with no
+display:
+
+    producer | pv --quiet --rate-limit 1M | consumer
+
 Sending logs to a processing script, showing the most recent line as
 part of the progress display: