[3.11] Add note to `sys.orig_argv` clarifying the difference from `sys.argv` (GH...

Add note to `sys.orig_argv` clarifying the difference from `sys.argv` (GH-114630)
(cherry picked from commit 1836f674c0d86ec3375189a550c8f4a52ff89ae8)

Co-authored-by: Bradley Reynolds <bradley.reynolds@darbia.dev>
Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>

diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst
index 2a1e6fb1a9cf2997d21b536d2c1e9abb98536e9e..e402d8b418b7b0b4d665d20b69c7f75e91eb8f91 100644 (file)
--- a/Doc/library/sys.rst
+++ b/Doc/library/sys.rst
@@ -1240,7 +1240,10 @@ always available.
    The list of the original command line arguments passed to the Python
    executable.
 
-   See also :data:`sys.argv`.
+   The elements of :data:`sys.orig_argv` are the arguments to the Python interpreter,
+   while the elements of :data:`sys.argv` are the arguments to the user's program.
+   Arguments consumed by the interpreter itself will be present in :data:`sys.orig_argv`
+   and missing from :data:`sys.argv`.
 
    .. versionadded:: 3.10