Issue #17462: Add a paragraph about advantages of argparse over optparse.

Patch by Anastasia Filatova.