[3.13] gh-133503: clarify compileall -s/-p docs (GH-134756) (#134996)

miss-islington · sharktide · picnixz · web-flow · commit 0446628697ca · 2025-06-01T08:27:26.000Z
gh-133503: clarify `compileall -s/-p` docs (GH-134756) (cherry picked from commit fe6f8a3) Co-authored-by: Rihaan Meher <meherrihaan@gmail.com> Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
diff --git a/Doc/library/compileall.rst b/Doc/library/compileall.rst
@@ -56,11 +56,18 @@ compile Python sources.
    executed.
 
 .. option:: -s strip_prefix
+
+   Remove the given prefix from paths recorded in the ``.pyc`` files.
+   Paths are made relative to the prefix.
+
+   This option can be used with ``-p`` but not with ``-d``.
+
 .. option:: -p prepend_prefix
 
-   Remove (``-s``) or append (``-p``) the given prefix of paths
-   recorded in the ``.pyc`` files.
-   Cannot be combined with ``-d``.
+   Prepend the given prefix to paths recorded in the ``.pyc`` files.
+   Use ``-p /`` to make the paths absolute.
+
+   This option can be used with ``-s`` but not with ``-d``.
 
 .. option:: -x regex
 
