diff -r 6919a708b65c Doc/library/argparse.rst
--- a/Doc/library/argparse.rst	Fri Feb 11 15:01:46 2011 +0100
+++ b/Doc/library/argparse.rst	Fri Feb 11 19:41:27 2011 +0100
@@ -1766,9 +1766,10 @@
 * Replace all ``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.