From: Bradley Reynolds <bradley.reynolds@darbia.dev>
Date: Wed, 31 Jan 2024 21:33:28 +0000 (-0600)
Subject: Add note to `sys.orig_argv` clarifying the difference from `sys.argv` (#114630)
X-Git-Tag: v3.13.0a4~231
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=1836f674c0d86ec3375189a550c8f4a52ff89ae8;p=thirdparty%2FPython%2Fcpython.git

Add note to `sys.orig_argv` clarifying the difference from `sys.argv` (#114630)

Co-authored-by: Ned Batchelder <ned@nedbatchelder.com>
---

diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst
index abf2c393a449..a97a369b77b8 100644
--- a/Doc/library/sys.rst
+++ b/Doc/library/sys.rst
@@ -1293,7 +1293,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