From: Sandro Tosi <sandro.tosi@gmail.com>
Date: Wed, 4 Jan 2012 22:25:04 +0000 (+0100)
Subject: Issue #10772: add count and help argparse action; patch by Marc Sibson
X-Git-Tag: v3.2.3rc1~212
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=98492a50ea30d2dffd7e16054e3aeb35cb2fed8d;p=python

Issue #10772: add count and help argparse action; patch by Marc Sibson
---

diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst
index 12684dbb8b..28537e938c 100644
--- a/Doc/library/argparse.rst
+++ b/Doc/library/argparse.rst
@@ -705,6 +705,19 @@ how the command-line arguments should be handled. The supported actions are:
     >>> parser.parse_args('--str --int'.split())
     Namespace(types=[<class 'str'>, <class 'int'>])
 
+* ``'count'`` - This counts the number of times a keyword argument occurs. For
+  example, this is useful for increasing verbosity levels::
+
+    >>> parser = argparse.ArgumentParser()
+    >>> parser.add_argument('--verbose', '-v', action='count')
+    >>> parser.parse_args('-vvv'.split())
+    Namespace(verbose=3)
+
+* ``'help'`` - This prints a complete help message for all the options in the
+  current parser and then exits. By default a help action is automatically
+  added to the parser. See :class:`ArgumentParser` for details of how the
+  output is created.
+
 * ``'version'`` - This expects a ``version=`` keyword argument in the
   :meth:`~ArgumentParser.add_argument` call, and prints version information
   and exits when invoked.