Issue #17462: Add a paragraph about advantages of argparse over optparse.
Patch by Anastasia Filatova.
diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst
index 409d688..25005ee 100644
--- a/Doc/library/argparse.rst
+++ b/Doc/library/argparse.rst
@@ -1913,6 +1913,16 @@
:mod:`optparse` had either been copy-pasted over or monkey-patched, it no
longer seemed practical to try to maintain the backwards compatibility.
+The :mod:`argparse` module improves on the standard library :mod:`optparse`
+module in a number of ways including:
+
+* Handling positional arguments.
+* Supporting sub-commands.
+* Allowing alternative option prefixes like ``+`` and ``/``.
+* Handling zero-or-more and one-or-more style arguments.
+* Producing more informative usage messages.
+* Providing a much simpler interface for custom ``type`` and ``action``.
+
A partial upgrade path from :mod:`optparse` to :mod:`argparse`:
* Replace all :meth:`optparse.OptionParser.add_option` calls with
diff --git a/Misc/ACKS b/Misc/ACKS
index a891869..ccfc18e 100644
--- a/Misc/ACKS
+++ b/Misc/ACKS
@@ -406,6 +406,7 @@
John Feuerstein
Carl Feynman
Vincent Fiack
+Anastasia Filatova
Tomer Filiba
Jeffrey Finkelstein
Russell Finn