From 67e087dcae35fa9f74a6dced588629fcdf075182 Mon Sep 17 00:00:00 2001
From: nanahi <130121847+na-na-hi@users.noreply.github.com>
Date: Fri, 16 Aug 2024 23:55:05 -0400
Subject: [PATCH] DOCS/man/options.rst: add a note about the effective limit of
 --pitch

---
 DOCS/man/options.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 892398501a..acb0bae350 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -242,6 +242,11 @@ Playback Control
     affect playback speed. Playing with an altered pitch automatically inserts
     the ``scaletempo2`` audio filter.
 
+    Since pitch change is achieved by combining pitch-preserving speed change and
+    resampling, the range of pitch change is effectively limited by the
+    ``min-speed`` and ``max-speed`` parameters of ``scaletempo2``: for example,
+    a ``min-speed`` of 0.25 limits the highest pitch factor to 4 (1/0.25).
+
     In a standard 12-tone scale system, octaves are separated by a factor of 2
     whereas semitones are represented by a factor of 2^(1/12). This means
     pitches can easily be shifted up or down with a simple multiplier.