[Python-checkins] cpython (merge 3.2 -> default): Issue #13605: merge with 3.2

[sandro.tosi]

http://hg.python.org/cpython/rev/6b4cec0719a3
changeset:   74528:6b4cec0719a3
parent:      74525:053fbceaf789
parent:      74527:6f3d55f5a31e
user:        Sandro Tosi <sandro.tosi at gmail.com>
date:        Thu Jan 19 22:00:21 2012 +0100
summary:
  Issue #13605: merge with 3.2

files:
  Doc/library/argparse.rst |  11 +++++++++++
  1 files changed, 11 insertions(+), 0 deletions(-)


diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst
--- a/Doc/library/argparse.rst
+++ b/Doc/library/argparse.rst
@@ -859,6 +859,17 @@
      usage: PROG [-h] foo [foo ...]
      PROG: error: too few arguments
 
+* ``argparse.REMAINDER``.  All the remaining command-line arguments
+  are gathered into a lits. This is commonly useful for command line
+  utilities that dispatch to other command line utilities.
+
+     >>> parser = argparse.ArgumentParser(prog='PROG')
+     >>> parser.add_argument('--foo')
+     >>> parser.add_argument('command')
+     >>> parser.add_argument('args', nargs=argparse.REMAINDER)
+     >>> print parser.parse_args('--foo B XX YY ZZ'.split())
+     Namespace(args=['YY', 'ZZ'], command='XX', foo='B')
+
 If the ``nargs`` keyword argument is not provided, the number of arguments consumed
 is determined by the action_.  Generally this means a single command-line argument
 will be consumed and a single item (not a list) will be produced.

-- 
Repository URL: http://hg.python.org/cpython