diff options
| author | Ezio Melotti <ezio.melotti@gmail.com> | 2011-04-21 13:13:44 (GMT) |
|---|---|---|
| committer | Ezio Melotti <ezio.melotti@gmail.com> | 2011-04-21 13:13:44 (GMT) |
| commit | 5bba6c278580999edf1ef61eb1f1fe3388333fd3 (patch) | |
| tree | 8008c7da3aa07ac632eda18067d95981bd9f0839 /Doc/library/argparse.rst | |
| parent | c6f079d1b2f442fbbe111a8cbf2da685d23f0347 (diff) | |
| parent | 0ee9c1be76882604cce078791f8a92e126c7c164 (diff) | |
| download | cpython-5bba6c278580999edf1ef61eb1f1fe3388333fd3.zip cpython-5bba6c278580999edf1ef61eb1f1fe3388333fd3.tar.gz cpython-5bba6c278580999edf1ef61eb1f1fe3388333fd3.tar.bz2 | |
Merge with 3.2.
Diffstat (limited to 'Doc/library/argparse.rst')
| -rw-r--r-- | Doc/library/argparse.rst | 22 |
1 files changed, 11 insertions, 11 deletions
diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst index 744224e..cdca8a9 100644 --- a/Doc/library/argparse.rst +++ b/Doc/library/argparse.rst @@ -997,7 +997,7 @@ etc. are all supported. required ^^^^^^^^ -In general, the argparse module assumes that flags like ``-f`` and ``--bar`` +In general, the :mod:`argparse` module assumes that flags like ``-f`` and ``--bar`` indicate *optional* arguments, which can always be omitted at the command line. To make an option *required*, ``True`` can be specified for the ``required=`` keyword argument to :meth:`add_argument`:: @@ -1617,9 +1617,9 @@ Mutual exclusion .. method:: add_mutually_exclusive_group(required=False) - Create a mutually exclusive group. argparse will make sure that only one of - the arguments in the mutually exclusive group was present on the command - line:: + Create a mutually exclusive group. :mod:`argparse` will make sure that only + one of the arguments in the mutually exclusive group was present on the + command line:: >>> parser = argparse.ArgumentParser(prog='PROG') >>> group = parser.add_mutually_exclusive_group() @@ -1786,14 +1786,14 @@ Exiting methods Upgrading optparse code ----------------------- -Originally, the argparse module had attempted to maintain compatibility with -optparse. However, optparse was difficult to extend transparently, particularly -with the changes required to support the new ``nargs=`` specifiers and better -usage messages. When most everything in optparse had either been copy-pasted -over or monkey-patched, it no longer seemed practical to try to maintain the -backwards compatibility. +Originally, the mod:`argparse` module had attempted to maintain compatibility +with :mod:`optparse`. However, :mod:`optparse` was difficult to extend +transparently, particularly with the changes required to support the new +``nargs=`` specifiers and better usage messages. When most everything in +:mod:`optparse` had either been copy-pasted over or monkey-patched, it no +longer seemed practical to try to maintain the backwards compatibility. -A partial upgrade path from optparse to argparse: +A partial upgrade path from :mod:`optparse` to :mod:`argparse`: * Replace all ``add_option()`` calls with :meth:`ArgumentParser.add_argument` calls. |