The docs for the parse_args() method describes the "options" argument; this should be the "values" argument to match the implementation.
I've changed the generated docs in Python's 2.5 maintenance branch, trunk, and the Python 3000 tree, but the warnings about the documentation being generated didn't include pointers to what it was generated from.
This bug can be closed, since the docs have been fixed in the Python source tree.