~ubuntu-branches/ubuntu/saucy/python2.7/saucy-proposed

« back to all changes in this revision

Viewing changes to Doc/howto/argparse.rst

Committer: Package Import Robot
Author(s): Matthias Klose
Date: 2013-05-15 19:15:16 UTC
mto: (36.1.23 sid)
mto: This revision was merged to the branch mainline in revision 87.
Revision ID: package-import@ubuntu.com-20130515191516-zmv6to904wemey7s

Tags: upstream-2.7.5

Import upstream version 2.7.5

files added:
Lib/ctypes/test/test_wintypes.py

files removed:
Doc/howto/advocacy.rst

Lib/test/testbz2_bigmem.bz2

files modified:
Doc/c-api/exceptions.rst

Doc/c-api/intro.rst

Doc/c-api/unicode.rst

Doc/distutils/apiref.rst

Doc/faq/design.rst

Doc/faq/extending.rst

Doc/faq/general.rst

Doc/faq/gui.rst

Doc/faq/library.rst

Doc/faq/programming.rst

Doc/faq/windows.rst

Doc/glossary.rst

Doc/howto/argparse.rst

Doc/howto/index.rst

Doc/howto/logging-cookbook.rst

Doc/howto/logging.rst

Doc/howto/sockets.rst

Doc/howto/urllib2.rst

Doc/install/index.rst

Doc/library/argparse.rst

Doc/library/codecs.rst

Doc/library/collections.rst

Doc/library/compileall.rst

Doc/library/datetime.rst

Doc/library/email.mime.rst

Doc/library/io.rst

Doc/library/itertools.rst

Doc/library/json.rst

Doc/library/locale.rst

Doc/library/logging.rst

Doc/library/multiprocessing.rst

Doc/library/numbers.rst

Doc/library/operator.rst

Doc/library/profile.rst

Doc/library/resource.rst

Doc/library/smtplib.rst

Doc/library/socket.rst

Doc/library/ssl.rst

Doc/library/stdtypes.rst

Doc/library/string.rst

Doc/library/subprocess.rst

Doc/library/sys.rst

Doc/library/time.rst

Doc/library/turtle.rst

Doc/library/unittest.rst

Doc/library/urllib.rst

Doc/library/urllib2.rst

Doc/library/warnings.rst

Doc/library/xml.etree.elementtree.rst

Doc/reference/datamodel.rst

Doc/reference/expressions.rst

Doc/reference/simple_stmts.rst

Doc/tools/sphinxext/susp-ignored.csv

Doc/tools/sphinxext/suspicious.py

Doc/tutorial/inputoutput.rst

Doc/tutorial/modules.rst

Doc/using/mac.rst

Doc/using/unix.rst

Include/object.h

Include/patchlevel.h

Lib/_abcoll.py

Lib/collections.py

Lib/ctypes/test/__init__.py

Lib/distutils/__init__.py

Lib/distutils/sysconfig.py

Lib/filecmp.py

Lib/gzip.py

Lib/idlelib/ColorDelegator.py

Lib/idlelib/EditorWindow.py

Lib/idlelib/MultiCall.py

Lib/idlelib/NEWS.txt

Lib/idlelib/PyShell.py

Lib/idlelib/aboutDialog.py

Lib/idlelib/help.txt

Lib/idlelib/idlever.py

Lib/idlelib/rpc.py

Lib/idlelib/run.py

Lib/inspect.py

Lib/logging/config.py

Lib/logging/handlers.py

Lib/mimetypes.py

Lib/multiprocessing/pool.py

Lib/multiprocessing/util.py

Lib/pickle.py

Lib/plistlib.py

Lib/pprint.py

Lib/pydoc_data/topics.py

Lib/site.py

Lib/smtplib.py

Lib/sre_parse.py

Lib/ssl.py

Lib/sysconfig.py

Lib/tarfile.py

Lib/test/pickletester.py

Lib/test/test_base64.py

Lib/test/test_bz2.py

Lib/test/test_collections.py

Lib/test/test_descr.py

Lib/test/test_gdb.py

Lib/test/test_gzip.py

Lib/test/test_inspect.py

Lib/test/test_io.py

Lib/test/test_kqueue.py

Lib/test/test_mimetypes.py

Lib/test/test_multiprocessing.py

Lib/test/test_plistlib.py

Lib/test/test_queue.py

Lib/test/test_re.py

Lib/test/test_support.py

Lib/test/test_tarfile.py

Lib/test/test_tcl.py

Lib/test/test_urllib2_localnet.py

Lib/test/test_winreg.py

Lib/test/test_zipfile.py

Lib/threading.py

Lib/unittest/case.py

Lib/webbrowser.py

Lib/zipfile.py

Makefile.pre.in

Misc/ACKS

Misc/NEWS

Misc/RPM/python-2.7.spec

Modules/Setup.dist

Modules/_ctypes/libffi/src/dlmalloc.c

Modules/_sqlite/cursor.c

Modules/_sqlite/util.c

Modules/_sqlite/util.h

Modules/_sre.c

Modules/_testcapimodule.c

Modules/cPickle.c

Modules/dbmmodule.c

Modules/getpath.c

Modules/operator.c

Modules/readline.c

Modules/selectmodule.c

Modules/signalmodule.c

Objects/typeobject.c

PCbuild/rt.bat

Python/compile.c

README

Tools/scripts/gprof2html.py

configure

configure.ac

setup.py

Show diffs side-by-side

added added

removed removed

Doc/howto/argparse.rst

.. note::

There's two other modules that fulfill the same task, namely

There are two other modules that fulfill the same task, namely

:mod:`getopt` (an equivalent for :c:func:`getopt` from the C

language) and the deprecated :mod:`optparse`.

Note also that :mod:`argparse` is based on :mod:`optparse`,

668

So far, we have been working with two methods of an

669

:class:`argparse.ArgumentParser` instance. Let's introduce a third one,

670

:meth:`add_mutually_exclusive_group`. It allows for us to specify options that

671

conflict with each other. Let's also change the rest of the program make the

672

new functionality makes more sense:

671

conflict with each other. Let's also change the rest of the program so that

672

the new functionality makes more sense:

673

we'll introduce the ``--quiet`` option,

674

which will be the opposite of the ``--verbose`` one::

675

Older »