argparse documentation updates (including updates to optparse and getopt documentation that were promised in the PEP)