At the beginning of http://docs.python.org/dev/library/getopt.html the line

"A more convenient, flexible, and powerful alternative is the optparse module."

routes the user to optparse. Since optparse is deprecated in favor of argparse, this line is no more up-to-date.

The best is to remove this line completely, since there already is a note routing to argparse.