From: Sandro Tosi <sandro.tosi@gmail.com>
Date: Tue, 3 Jan 2012 17:37:03 +0000 (+0100)
Subject: Issue #9349: add argparse.SUPPRESS to help doc
X-Git-Tag: v3.2.3rc1~220
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=ea320abcae63cadfbc5f57122822acff2bc27dd5;p=python

Issue #9349: add argparse.SUPPRESS to help doc
---

diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst
index 305a546d54..12684dbb8b 100644
--- a/Doc/library/argparse.rst
+++ b/Doc/library/argparse.rst
@@ -1051,6 +1051,17 @@ specifiers include the program name, ``%(prog)s`` and most keyword arguments to
    optional arguments:
     -h, --help  show this help message and exit
 
+:mod:`argparse` supports silencing the help entry for certain options, by
+setting the ``help`` value to ``argparse.SUPPRESS``::
+
+   >>> parser = argparse.ArgumentParser(prog='frobble')
+   >>> parser.add_argument('--foo', help=argparse.SUPPRESS)
+   >>> parser.print_help()
+   usage: frobble [-h]
+
+   optional arguments:
+     -h, --help  show this help message and exit
+
 
 metavar
 ^^^^^^^