From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Wed, 17 Sep 2025 16:35:37 +0000 (+0200)
Subject: [3.13] GH-139067: Add example for `argparse`'s `append` action (GH-131389) (#139069)
X-Git-Tag: v3.13.8~58
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=fa6dbb16419dacb57cb831b1fac5a32fef4f412d;p=thirdparty%2FPython%2Fcpython.git

[3.13] GH-139067: Add example for `argparse`'s `append` action (GH-131389) (#139069)

GH-139067: Add example for `argparse`'s `append` action (GH-131389)
(cherry picked from commit 101fd33065638c94f413447a7bcff09d54831a4a)

Co-authored-by: Moshe Kaplan <mosheekaplan@gmail.com>
---

diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst
index 11b3b2a7e9b2..3b9dde39814a 100644
--- a/Doc/library/argparse.rst
+++ b/Doc/library/argparse.rst
@@ -687,16 +687,16 @@ how the command-line arguments should be handled. The supplied actions are:
     >>> parser.parse_args('--foo --bar'.split())
     Namespace(foo=True, bar=False, baz=True)
 
-* ``'append'`` - This stores a list, and appends each argument value to the
-  list. It is useful to allow an option to be specified multiple times.
-  If the default value is non-empty, the default elements will be present
-  in the parsed value for the option, with any values from the
-  command line appended after those default values. Example usage::
+* ``'append'`` - This appends each argument value to a list.
+  It is useful for allowing an option to be specified multiple times.
+  If the default value is a non-empty list, the parsed value will start
+  with the default list's elements and any values from the command line
+  will be appended after those default values. Example usage::
 
     >>> parser = argparse.ArgumentParser()
-    >>> parser.add_argument('--foo', action='append')
+    >>> parser.add_argument('--foo', action='append', default=['0'])
     >>> parser.parse_args('--foo 1 --foo 2'.split())
-    Namespace(foo=['1', '2'])
+    Namespace(foo=['0', '1', '2'])
 
 * ``'append_const'`` - This stores a list, and appends the value specified by
   the const_ keyword argument to the list; note that the const_ keyword