From: Santi Hernandez <santi@santihdzs.com>
Date: Tue, 14 Apr 2026 16:24:16 +0000 (-0600)
Subject: gh-72406: Document argument ordering in argparse help output (#148534)
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=4286227308ee8dafc867062df4cad73af2a84696;p=thirdparty%2FPython%2Fcpython.git

gh-72406: Document argument ordering in argparse help output (#148534)

Co-authored-by: Savannah Ostrowski <savannah@python.org>
---

diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst
index 0091bf95f0ce..e37afd6d0b6d 100644
--- a/Doc/library/argparse.rst
+++ b/Doc/library/argparse.rst
@@ -2032,6 +2032,9 @@ Argument groups
    Note that any arguments not in your user-defined groups will end up back
    in the usual "positional arguments" and "optional arguments" sections.
 
+   Within each argument group, arguments are displayed in help output in the
+   order in which they are added.
+
    .. deprecated-removed:: 3.11 3.14
       Calling :meth:`add_argument_group` on an argument group now raises an
       exception. This nesting was never supported, often failed to work