Deprecate ArgumentParser(..., version=XXX, ...) as well as format_version() and print_version(). These should be replaced with .add_argument(..., action='version', ...).

1 files changed, 3 insertions, 3 deletions

diff --git a/doc/source/add_argument.rst b/doc/source/add_argument.rst
index e72df5b..374d742 100644
--- a/doc/source/add_argument.rst
+++ b/doc/source/add_argument.rst
@@ -85,12 +85,12 @@ action
     >>> parser.parse_args('--str --int'.split())
     Namespace(types=[<type 'str'>, <type 'int'>])
 
-* ``'version'`` - This expects a ``version=`` keyword argument in the :meth:`add_argument` call, and prints version information and exits when invoked. This can be used when the default :class:`ArgumentParser` version flags ``-v, --version`` are not appropriate for your program.
+* ``'version'`` - This expects a ``version=`` keyword argument in the :meth:`add_argument` call, and prints version information and exits when invoked.
 
     >>> import argparse
     >>> parser = argparse.ArgumentParser(prog='PROG')
-    >>> parser.add_argument('-V', action='version', version='%(prog)s 2.0')
-    >>> parser.parse_args(['-V'])
+    >>> parser.add_argument('-v', '--version', action='version', version='%(prog)s 2.0')
+    >>> parser.parse_args(['-v'])
     PROG 2.0
 
 You can also specify an arbitrary action by passing an object that implements the Action API.  The easiest way to do this is to extend ``argparse.Action``, supplying an appropriate ``__call__`` method.  The ``__call__`` method accepts four parameters: