From: Hai Shi <shihai1992@gmail.com>
Date: Fri, 6 May 2022 03:32:35 +0000 (+0800)
Subject: update argparse's doc of append action. (#92344)
X-Git-Tag: v3.11.0b1~25
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=301351c6a227249770fdf498054e6bbce1c3ee3c;p=thirdparty%2FPython%2Fcpython.git

update argparse's doc of append action. (#92344)
---

diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst
index 5d269cc4eac4..b5a2b794c238 100644
--- a/Doc/library/argparse.rst
+++ b/Doc/library/argparse.rst
@@ -846,8 +846,10 @@ how the command-line arguments should be handled. The supplied actions are:
     Namespace(foo=True, bar=False, baz=True)
 
 * ``'append'`` - This stores a list, and appends each argument value to the
-  list.  This is useful to allow an option to be specified multiple times.
-  Example usage::
+  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::
 
     >>> parser = argparse.ArgumentParser()
     >>> parser.add_argument('--foo', action='append')