Commits

Anonymous committed 83955e4

Start the argparse entry.

Comments (0)

Files changed (1)

Doc/whatsnew/3.2.rst

 
 .. seealso::
 
-   :pep:`384` - PYC Repository Directories
+   :pep:`384` - Define a Stable ABI
       PEP written by Martin von Loewis.
 
+PEP 389: Argparse Command Line Parsing Module
+=============================================
+
+A new module for command line parsing, :mod:`argparse`, was introduced to
+overcome the limitations of :mod:`optparse` which did not provide support for
+positional arguments (not just option), subcommands, required options and other
+common patterns of specifying and validatig options.
+
+This module has already has wide-spread success in the community as a
+third-party module.  Being more fully featured than its predecessor,
+:mod:`argparse`, is now the preferred module for command-line processing.  The
+older module is still being kept available because of the substantial amount of
+legacy code that depends on it.
+
+.. XXX add examples that highlight the new features
+
+.. seealso::
+
+   :pep:`389` - New Command Line Parsing Module
+      PEP written by Steven Bethard.
+
 
 PEP 391:  Dictionary Based Configuration for Logging
 ====================================================
 use existing tools for making parallel calls. They save the effort needed to
 setup a pool of resources, launch the calls, create a results queue, add
 time-out handling, and limit the total number of threads, processes, or remote
-procedure calls.
+procedure calls. adfasdf
 
 Ideally, each application should share a single executor across multiple
 components so that process and thread limits can be centrally managed.  This
 
 .. seealso::
 
-   :pep:`3148` - PYC Repository Directories
+   :pep:`3148` - Futures -- Execute Computations Asynchronously
       PEP written by Brain Quinlan.
 
 
 PEP 3147:  PYC Repository Directories
 =====================================
 
-Python's scheme for caching bytecode in *.pyc* files did not work well in
+Python's scheme for caching bytecode in *.pyc* files did not wosrk well in
 environments with multiple python interpreters.  If one interpreter encountered
 a cached file created by another interpreter, it would recompile the source and
 overwrite the cached file, thus losing the benefits of caching.
 New, Improved, and Deprecated Modules
 =====================================
 
-* XXX mention :mod:`argparse`.
-
 * The :mod:`functools` module includes a new decorator for caching function
   calls.  :func:`functools.lru_cache` can save repeated queries to an external
   resource whenever the results are expected to be the same.
   :issue:`8814`.)
 
 * The :mod:`itertools` module has a new function, :func:`~itertools.accumulate`
-  modeled on APL's *scan* and on Numpy's *accumulate* function:
+  modeled on APL's *scan* operator and on Numpy's *accumulate* function:
 
   >>> list(accumulate(8, 2, 50))
   [8, 10, 60]
 * The :mod:`abc` module now supports :func:`~abc.abstractclassmethod` and
   :func:`~abc.abstractstaticmethod`.
 
+  These tools make it possible to define an :term:`Abstract Base Class` that
+  requires a particular :func:`classmethod` or :func:`staticmethod` to be
+  implemented.
+
   (Patch submitted by Daniel Urban; :issue:`5867`.)
 
 * The previously deprecated :func:`contextlib.nested` function has been removed
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.