diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst index e9a08984f77c3a..2eb0c360eb6b24 100644 --- a/Doc/library/argparse.rst +++ b/Doc/library/argparse.rst @@ -731,6 +731,9 @@ how the command-line arguments should be handled. The supplied actions are: .. versionadded:: 3.8 +Only actions that consume command-line arguments (such as ``'store'``, +``'append'`` or ``'extend'``) can be used with positional arguments. + You may also specify an arbitrary action by passing an Action subclass or other object that implements the same interface. The ``BooleanOptionalAction`` is available in ``argparse`` and adds support for boolean actions such as @@ -858,6 +861,8 @@ See also :ref:`specifying-ambiguous-arguments`. The supported values are: 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. +Actions that do not consume command-line arguments (such as +``'store_const'``) set ``nargs=0``. .. _const: