#8735: better explain semantics of *values* argument for parse().

diff --git a/Doc/library/optparse.rst b/Doc/library/optparse.rst
index 37eab3768e1df947b3f856ab3ad2de10f781474b..37226c3846589e22a571286444d1ccc046c48f64 100644 (file)
--- a/Doc/library/optparse.rst
+++ b/Doc/library/optparse.rst
@@ -1234,8 +1234,9 @@ where the input parameters are
    the list of arguments to process (default: ``sys.argv[1:]``)
 
 ``values``
-   object to store option arguments in (default: a new instance of
-   :class:`optparse.Values`)
+   a :class:`optparse.Values` object to store option arguments in (default: a
+   new instance of :class:`Values`) -- if you give an existing object, the
+   option defaults will not be initialized on it
 
 and the return values are