#10423: clarify options vs args in argparse discussion of optparse
Patch by Sandro Tosi.
diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst
index bb7c88d..50a4533 100644
--- a/Doc/library/argparse.rst
+++ b/Doc/library/argparse.rst
@@ -1826,9 +1826,10 @@
* Replace all :meth:`optparse.OptionParser.add_option` calls with
:meth:`ArgumentParser.add_argument` calls.
-* Replace ``options, args = parser.parse_args()`` with ``args =
+* Replace ``(options, args) = parser.parse_args()`` with ``args =
parser.parse_args()`` and add additional :meth:`ArgumentParser.add_argument`
- calls for the positional arguments.
+ calls for the positional arguments. Keep in mind that what was previously
+ called ``options``, now in :mod:`argparse` context is called ``args``.
* Replace callback actions and the ``callback_*`` keyword arguments with
``type`` or ``action`` arguments.