#14034: merge argparse tutorial from 3.2.

Doc/howto/index.rst

@@ -27,4 +27,5 @@ Currently, the HOWTOs are:
    unicode.rst
    urllib2.rst
    webservers.rst
+   argparse.rst
 

Doc/library/argparse.rst

@@ -12,6 +12,12 @@
 
 --------------
 
+.. sidebar:: Tutorial
+
+   This page contains the API reference information. For a more gentle
+   introduction to Python command-line parsing, have a look at the
+   :ref:`argparse tutorial <argparse-tutorial>`.
+
 The :mod:`argparse` module makes it easy to write user-friendly command-line
 interfaces. The program defines what arguments it requires, and :mod:`argparse`
 will figure out how to parse those out of :data:`sys.argv`.  The :mod:`argparse`

Misc/NEWS

@@ -480,6 +480,11 @@ Build
   Based on patch from Hervé Coatanhay.
 
 - Issue #14321: Do not run pgen during the build if files are up to date.
+Documentation
+-------------
+
+- Issue #14034: added the argparse tutorial.
+
 
 - Issue #14324: Fix configure tests for cross builds.