Remove surplus empty lines and convert more files to new optional arg style.

diff --git a/Doc/library/abc.rst b/Doc/library/abc.rst
index 29d37f34c0f631ab4f9565ae1265f229b53ac7a9..aa1cc7871e3fa3ab719db419407434576c9b0a32 100644 (file)
--- a/Doc/library/abc.rst
+++ b/Doc/library/abc.rst
@@ -1,4 +1,3 @@
-
 :mod:`abc` --- Abstract Base Classes
 ====================================
 

diff --git a/Doc/library/allos.rst b/Doc/library/allos.rst
index 6c5837d0dab64d69355b329a86e8234dca08588f..f25c3b8751aae83a86dbe58374f9919f78a72460 100644 (file)
--- a/Doc/library/allos.rst
+++ b/Doc/library/allos.rst
@@ -1,4 +1,3 @@
-
 .. _allos:
 
 *********************************

diff --git a/Doc/library/archiving.rst b/Doc/library/archiving.rst
index 7d0df5f575a99c98aeb4b7dd3ce5b738fe07b74d..f2d08ada0cb690f86f653f1657decd654f7bd623 100644 (file)
--- a/Doc/library/archiving.rst
+++ b/Doc/library/archiving.rst
@@ -1,4 +1,3 @@
-
 .. _archiving:
 
 ******************************

diff --git a/Doc/library/array.rst b/Doc/library/array.rst
index 490050961973f65ee40026ef6ad4ac30911f55da..200277fe848c954209cee57ae0f36873f4c4ec35 100644 (file)
--- a/Doc/library/array.rst
+++ b/Doc/library/array.rst
@@ -1,4 +1,3 @@
-
 :mod:`array` --- Efficient arrays of numeric values
 ===================================================
 

diff --git a/Doc/library/asynchat.rst b/Doc/library/asynchat.rst
index 4adaecf32e1ffee01ff5fbfc079fd46a49393787..e511a05216075180499123bd3198d1be4f5b2e73 100644 (file)
--- a/Doc/library/asynchat.rst
+++ b/Doc/library/asynchat.rst
@@ -1,4 +1,3 @@
-
 :mod:`asynchat` --- Asynchronous socket command/response handler
 ================================================================
 

diff --git a/Doc/library/asyncore.rst b/Doc/library/asyncore.rst
index 267c58b9bce9b90744a28ebc972f46dc077e6223..60d4d0336c078543fe97befab09bd745779858ee 100644 (file)
--- a/Doc/library/asyncore.rst
+++ b/Doc/library/asyncore.rst
@@ -1,4 +1,3 @@
-
 :mod:`asyncore` --- Asynchronous socket handler
 ===============================================
 

diff --git a/Doc/library/atexit.rst b/Doc/library/atexit.rst
index 74712ee04fda4a75161c5dca389e9af1bb1afa55..db902187fb78c0efece3e1ba2ff60676111e9f4f 100644 (file)
--- a/Doc/library/atexit.rst
+++ b/Doc/library/atexit.rst
@@ -1,4 +1,3 @@
-
 :mod:`atexit` --- Exit handlers
 ===============================
 

diff --git a/Doc/library/audioop.rst b/Doc/library/audioop.rst
index fe6e86fc6c1b3b6fad37f7aa4c977fac5481d1e6..4af8536b86d56495668adc84a26cd63bcdf4723c 100644 (file)
--- a/Doc/library/audioop.rst
+++ b/Doc/library/audioop.rst
@@ -1,4 +1,3 @@
-
 :mod:`audioop` --- Manipulate raw audio data
 ============================================
 

diff --git a/Doc/library/base64.rst b/Doc/library/base64.rst
index 1e789537404faf84ccfc71a2cc8578817d93b3b0..62bf1d49f2413847802b9d61bbb0124a254c8af0 100644 (file)
--- a/Doc/library/base64.rst
+++ b/Doc/library/base64.rst
@@ -1,4 +1,3 @@
-
 :mod:`base64` --- RFC 3548: Base16, Base32, Base64 Data Encodings
 =================================================================
 

diff --git a/Doc/library/binascii.rst b/Doc/library/binascii.rst
index 8488743fff12b0f31c4b99f1083a438e18b51e7d..c42f81f717935aada2bed4fa37a850d75b8bc90a 100644 (file)
--- a/Doc/library/binascii.rst
+++ b/Doc/library/binascii.rst
@@ -1,4 +1,3 @@
-
 :mod:`binascii` --- Convert between binary and ASCII
 ====================================================
 

diff --git a/Doc/library/code.rst b/Doc/library/code.rst
index 4219e9e7d7b54683400c03a592c1633eb0d6421b..56214b9f7227bb7cadddc4e62ff5e12b5125cde5 100644 (file)
--- a/Doc/library/code.rst
+++ b/Doc/library/code.rst
@@ -1,4 +1,3 @@
-
 :mod:`code` --- Interpreter base classes
 ========================================
 
@@ -6,7 +5,6 @@
    :synopsis: Facilities to implement read-eval-print loops.
 
 
-
 The ``code`` module provides facilities to implement read-eval-print loops in
 Python.  Two classes and convenience functions are included which can be used to
 build applications which provide an interactive interpreter prompt.

diff --git a/Doc/library/codeop.rst b/Doc/library/codeop.rst
index fb2f3264a5727d67c5546c478ac7b604bdd7d428..9ae4176485359ca289d20338fc6b196dce1b9c48 100644 (file)
--- a/Doc/library/codeop.rst
+++ b/Doc/library/codeop.rst
@@ -1,4 +1,3 @@
-
 :mod:`codeop` --- Compile Python code
 =====================================
 

diff --git a/Doc/library/collections.rst b/Doc/library/collections.rst
index fca84bd48fabd15a1fc570ebeeaab7c1d2cf3948..9dcf3028105a7d4ff10efc047fbab33a7b8b4387 100644 (file)
--- a/Doc/library/collections.rst
+++ b/Doc/library/collections.rst
@@ -1,4 +1,3 @@
-
 :mod:`collections` --- Container datatypes
 ==========================================
 

diff --git a/Doc/library/compileall.rst b/Doc/library/compileall.rst
index 52f881b437f5838779633b28881e41a0d6e06b36..83e418d30c5161959d89644182e9cf3158a75a22 100644 (file)
--- a/Doc/library/compileall.rst
+++ b/Doc/library/compileall.rst
@@ -1,4 +1,3 @@
-
 :mod:`compileall` --- Byte-compile Python libraries
 ===================================================
 

diff --git a/Doc/library/contextlib.rst b/Doc/library/contextlib.rst
index e2ca6a1a8efd09eff6edf67b0e3984f7492761a8..d6ce9a763163a8898b8153b593ce50307e3c5a37 100644 (file)
--- a/Doc/library/contextlib.rst
+++ b/Doc/library/contextlib.rst
@@ -1,4 +1,3 @@
-
 :mod:`contextlib` --- Utilities for :keyword:`with`\ -statement contexts.
 =========================================================================
 

diff --git a/Doc/library/copy.rst b/Doc/library/copy.rst
index 554801f2e58a24d6a7c1565628f6782312471993..e6ad857a7324a75f380470d34950f2d338df72f9 100644 (file)
--- a/Doc/library/copy.rst
+++ b/Doc/library/copy.rst
@@ -1,4 +1,3 @@
-
 :mod:`copy` --- Shallow and deep copy operations
 ================================================
 

diff --git a/Doc/library/copyreg.rst b/Doc/library/copyreg.rst
index 60df3d0e896e5b74bb2e65d502a04ed025a9b0e6..f6dbaaf7457bb15cc5ce522bb0910b698ff332da 100644 (file)
--- a/Doc/library/copyreg.rst
+++ b/Doc/library/copyreg.rst
@@ -1,6 +1,5 @@
-
 :mod:`copyreg` --- Register :mod:`pickle` support functions
-============================================================
+===========================================================
 
 .. module:: copyreg
    :synopsis: Register pickle support functions.

diff --git a/Doc/library/crypt.rst b/Doc/library/crypt.rst
index b6c3d212421bc5e09b9d3e23109f467c925cfeff..0be571eb513fe7d650ea2d5efc3fd25750f22c0f 100644 (file)
--- a/Doc/library/crypt.rst
+++ b/Doc/library/crypt.rst
@@ -1,4 +1,3 @@
-
 :mod:`crypt` --- Function to check Unix passwords
 =================================================
 

diff --git a/Doc/library/crypto.rst b/Doc/library/crypto.rst
index dce5a01ac6de787e46a696593146db8b67280c4f..8650094c576b6eb706f62e4c42319ac001ad3262 100644 (file)
--- a/Doc/library/crypto.rst
+++ b/Doc/library/crypto.rst
@@ -1,4 +1,3 @@
-
 .. _crypto:
 
 **********************

diff --git a/Doc/library/csv.rst b/Doc/library/csv.rst
index 87ed3b69d77e047bb2b08bf653fe0ce7297d5c26..6bcee11c1d6ced2179ab84edeec1a182ab332758 100644 (file)
--- a/Doc/library/csv.rst
+++ b/Doc/library/csv.rst
@@ -1,4 +1,3 @@
-
 :mod:`csv` --- CSV File Reading and Writing
 ===========================================
 

diff --git a/Doc/library/ctypes.rst b/Doc/library/ctypes.rst
index e389a633315ee819e57a3d743541830652e6590e..ac2f2fd293216beee690a92a82f16d1d191fc3fe 100644 (file)
--- a/Doc/library/ctypes.rst
+++ b/Doc/library/ctypes.rst
@@ -1,6 +1,5 @@
-
-:mod:`ctypes` --- A foreign function library for Python.
-========================================================
+:mod:`ctypes` --- A foreign function library for Python
+=======================================================
 
 .. module:: ctypes
    :synopsis: A foreign function library for Python.

diff --git a/Doc/library/curses.ascii.rst b/Doc/library/curses.ascii.rst
index cf51f78ab029017cec1290a20c037e4200883bad..6bc1fb9ae3db3c46843b350e11009c52e583e1a0 100644 (file)
--- a/Doc/library/curses.ascii.rst
+++ b/Doc/library/curses.ascii.rst
@@ -1,4 +1,3 @@
-
 :mod:`curses.ascii` --- Utilities for ASCII characters
 ======================================================
 

diff --git a/Doc/library/curses.panel.rst b/Doc/library/curses.panel.rst
index 59e5b86f1912de8950d28bfc1035d965a7affd05..a3c8bda63c2c1dbcb119c33a75594a7bf0f42c82 100644 (file)
--- a/Doc/library/curses.panel.rst
+++ b/Doc/library/curses.panel.rst
@@ -1,6 +1,5 @@
-
-:mod:`curses.panel` --- A panel stack extension for curses.
-===========================================================
+:mod:`curses.panel` --- A panel stack extension for curses
+==========================================================
 
 .. module:: curses.panel
    :synopsis: A panel stack extension that adds depth to  curses windows.

diff --git a/Doc/library/curses.rst b/Doc/library/curses.rst
index b16d667f7697cd346a0beed5c42ebdaaec3cfdb8..03f8f8cb4a557967e731746dda6cf7cb06bcd283 100644 (file)
--- a/Doc/library/curses.rst
+++ b/Doc/library/curses.rst
@@ -1,9 +1,9 @@
-
 :mod:`curses` --- Terminal handling for character-cell displays
 ===============================================================
 
 .. module:: curses
-   :synopsis: An interface to the curses library, providing portable terminal handling.
+   :synopsis: An interface to the curses library, providing portable
+              terminal handling.
 .. sectionauthor:: Moshe Zadka <moshez@zadka.site.co.il>
 .. sectionauthor:: Eric Raymond <esr@thyrsus.com>
 

diff --git a/Doc/library/custominterp.rst b/Doc/library/custominterp.rst
index 2a9f0a44802232a4b4cbd2def92e9143e8875b3a..5eeced20a9a594734ad8d1ccf2de4eefcee2007d 100644 (file)
--- a/Doc/library/custominterp.rst
+++ b/Doc/library/custominterp.rst
@@ -1,4 +1,3 @@
-
 .. _custominterp:
 
 **************************

diff --git a/Doc/library/datatypes.rst b/Doc/library/datatypes.rst
index 99d062b190e3d8f44c284bb3237a273329b4002b..6b4a71a3ad62aa48519353dc8aadffa17940c2eb 100644 (file)
--- a/Doc/library/datatypes.rst
+++ b/Doc/library/datatypes.rst
@@ -1,4 +1,3 @@
-
 .. _datatypes:
 
 **********

diff --git a/Doc/library/decimal.rst b/Doc/library/decimal.rst
index a27fbf450d2be660cea5ef8d77a845b41ea85b46..d548c0d1e149997a870c4d0d4604fc7e8b392fa4 100644 (file)
--- a/Doc/library/decimal.rst
+++ b/Doc/library/decimal.rst
@@ -1,4 +1,3 @@
-
 :mod:`decimal` --- Decimal fixed point and floating point arithmetic
 ====================================================================
 

diff --git a/Doc/library/development.rst b/Doc/library/development.rst
index 8cd3d0cc991e62d40771e31935784873d7fcbf5d..c822e0844f37d71635be3485103d14838f19583d 100644 (file)
--- a/Doc/library/development.rst
+++ b/Doc/library/development.rst
@@ -1,4 +1,3 @@
-
 .. _development:
 
 *****************

diff --git a/Doc/library/dis.rst b/Doc/library/dis.rst
index c5a7ea8fc304b510029f75d7b3d40362a3b36ff8..8d4d95616225a5b5e13cf240c2c195d7a825aa61 100644 (file)
--- a/Doc/library/dis.rst
+++ b/Doc/library/dis.rst
@@ -1,4 +1,3 @@
-
 :mod:`dis` --- Disassembler for Python bytecode
 ===============================================
 
@@ -6,11 +5,11 @@
    :synopsis: Disassembler for Python bytecode.
 
 
-The :mod:`dis` module supports the analysis of Python :term:`bytecode` by disassembling
-it.  Since there is no Python assembler, this module defines the Python assembly
-language.  The Python bytecode which this module takes as an input is defined
-in the file  :file:`Include/opcode.h` and used by the compiler and the
-interpreter.
+The :mod:`dis` module supports the analysis of Python :term:`bytecode` by
+disassembling it.  Since there is no Python assembler, this module defines the
+Python assembly language.  The Python bytecode which this module takes as an
+input is defined in the file :file:`Include/opcode.h` and used by the compiler
+and the interpreter.
 
 Example: Given the function :func:`myfunc`::
 

diff --git a/Doc/library/distutils.rst b/Doc/library/distutils.rst
index 534faab4073a74a18512ef5d6dacc995741d917c..238b79dac2beb0ee2f2d1c2b7a737e517a6e42b2 100644 (file)
--- a/Doc/library/distutils.rst
+++ b/Doc/library/distutils.rst
@@ -1,10 +1,9 @@
-
 :mod:`distutils` --- Building and installing Python modules
 ===========================================================
 
 .. module:: distutils
-   :synopsis: Support for building and installing Python modules into an existing Python
-              installation.
+   :synopsis: Support for building and installing Python modules into an
+              existing Python installation.
 .. sectionauthor:: Fred L. Drake, Jr. <fdrake@acm.org>
 
 
@@ -19,12 +18,12 @@ This package is discussed in two separate chapters:
 .. seealso::
 
    :ref:`distutils-index`
-      The manual for developers and packagers of Python modules.  This describes how
-      to prepare :mod:`distutils`\ -based packages so that they may be easily
-      installed into an existing Python installation.
+      The manual for developers and packagers of Python modules.  This describes
+      how to prepare :mod:`distutils`\ -based packages so that they may be
+      easily installed into an existing Python installation.
 
    :ref:`install-index`
-      An "administrators" manual which includes information on installing modules into
-      an existing Python installation. You do not need to be a Python programmer to
-      read this manual.
+      An "administrators" manual which includes information on installing
+      modules into an existing Python installation.  You do not need to be a
+      Python programmer to read this manual.
 

diff --git a/Doc/library/errno.rst b/Doc/library/errno.rst
index daf9ff02d5d4d2d97de636d4b9da7ab78401cba5..d2163b62582c9711e023069d740d03dcd426333e 100644 (file)
--- a/Doc/library/errno.rst
+++ b/Doc/library/errno.rst
@@ -1,4 +1,3 @@
-
 :mod:`errno` --- Standard errno system symbols
 ==============================================
 

diff --git a/Doc/library/fcntl.rst b/Doc/library/fcntl.rst
index 0e6940709e4b2d7b81a56a02ced8aa36b31e38c4..a397afc1d8a78ef115d3363606a9acd25e2a9fcc 100644 (file)
--- a/Doc/library/fcntl.rst
+++ b/Doc/library/fcntl.rst
@@ -1,4 +1,3 @@
-
 :mod:`fcntl` --- The :func:`fcntl` and :func:`ioctl` system calls
 =================================================================
 
@@ -65,13 +64,13 @@ The module defines the following functions:
    so long as the buffer you pass is as least as long as what the operating system
    wants to put there, things should work.
 
-   If *mutate_flag* is true (the default), then the buffer is (in effect) passed to the
-   underlying :func:`ioctl` system call, the latter's return code is passed back to
-   the calling Python, and the buffer's new contents reflect the action of the
-   :func:`ioctl`.  This is a slight simplification, because if the supplied buffer
-   is less than 1024 bytes long it is first copied into a static buffer 1024 bytes
-   long which is then passed to :func:`ioctl` and copied back into the supplied
-   buffer.
+   If *mutate_flag* is true (the default), then the buffer is (in effect) passed
+   to the underlying :func:`ioctl` system call, the latter's return code is
+   passed back to the calling Python, and the buffer's new contents reflect the
+   action of the :func:`ioctl`.  This is a slight simplification, because if the
+   supplied buffer is less than 1024 bytes long it is first copied into a static
+   buffer 1024 bytes long which is then passed to :func:`ioctl` and copied back
+   into the supplied buffer.
 
    An example::
 

diff --git a/Doc/library/filecmp.rst b/Doc/library/filecmp.rst
index 11d74ba770c766837804478933067fde47c3a7f8..f57dcceff0ad6f5de5ef49e21989ab625388bbaa 100644 (file)
--- a/Doc/library/filecmp.rst
+++ b/Doc/library/filecmp.rst
@@ -1,4 +1,3 @@
-
 :mod:`filecmp` --- File and Directory Comparisons
 =================================================
 
@@ -14,7 +13,7 @@ see also the :mod:`difflib` module.
 The :mod:`filecmp` module defines the following functions:
 
 
-.. function:: cmp(f1, f2[, shallow])
+.. function:: cmp(f1, f2, shallow=True)
 
    Compare the files named *f1* and *f2*, returning ``True`` if they seem equal,
    ``False`` otherwise.
@@ -29,7 +28,7 @@ The :mod:`filecmp` module defines the following functions:
    portability and efficiency.
 
 
-.. function:: cmpfiles(dir1, dir2, common[, shallow])
+.. function:: cmpfiles(dir1, dir2, common, shallow=True)
 
    Compare the files in the two directories *dir1* and *dir2* whose names are
    given by *common*.
@@ -66,7 +65,7 @@ The :class:`dircmp` class
 :class:`dircmp` instances are built using this constructor:
 
 
-.. class:: dircmp(a, b[, ignore[, hide]])
+.. class:: dircmp(a, b, ignore=None, hide=None)
 
    Construct a new directory comparison object, to compare the directories *a* and
    *b*. *ignore* is a list of names to ignore, and defaults to ``['RCS', 'CVS',
@@ -159,5 +158,6 @@ The :class:`dircmp` class
 
    .. attribute:: subdirs
 
-      A dictionary mapping names in :attr:`common_dirs` to :class:`dircmp` objects.
+      A dictionary mapping names in :attr:`common_dirs` to :class:`dircmp`
+      objects.
 

diff --git a/Doc/library/fileformats.rst b/Doc/library/fileformats.rst
index dc2e2374452783ccf95bb33dd2e62784f5df6047..980d4f5ffb392b3fa136a716d918b921d23361a7 100644 (file)
--- a/Doc/library/fileformats.rst
+++ b/Doc/library/fileformats.rst
@@ -1,4 +1,3 @@
-
 .. _fileformats:
 
 ************

diff --git a/Doc/library/fileinput.rst b/Doc/library/fileinput.rst
index 76d5d6f0cd23a20fc0f352d9fa55cf9f3a6938c2..d98a198f5c7d2ac67077a65869a1eaad5207df96 100644 (file)
--- a/Doc/library/fileinput.rst
+++ b/Doc/library/fileinput.rst
@@ -47,7 +47,7 @@ provided by this module.
 The following function is the primary interface of this module:
 
 
-.. function:: input([files[, inplace[, backup[, mode[, openhook]]]]])
+.. function:: input(files=None, inplace=False, backup='', bufsize=0, mode='r', openhook=None)
 
    Create an instance of the :class:`FileInput` class.  The instance will be used
    as global state for the functions of this module, and is also returned to use
@@ -115,7 +115,7 @@ The class which implements the sequence behavior provided by the module is
 available for subclassing as well:
 
 
-.. class:: FileInput([files[, inplace[, backup[, mode[, openhook]]]]])
+.. class:: FileInput(files=None, inplace=False, backup='', bufsize=0, mode='r', openhook=None)
 
    Class :class:`FileInput` is the implementation; its methods :meth:`filename`,
    :meth:`fileno`, :meth:`lineno`, :meth:`filelineno`, :meth:`isfirstline`,

diff --git a/Doc/library/filesys.rst b/Doc/library/filesys.rst
index 41f77168ca86dbed6cf51db16646f01d0d694119..b341f5fd8eb54131c7ddfa39dbe922659354ac44 100644 (file)
--- a/Doc/library/filesys.rst
+++ b/Doc/library/filesys.rst
@@ -1,4 +1,3 @@
-
 .. _filesys:
 
 *************************

diff --git a/Doc/library/fnmatch.rst b/Doc/library/fnmatch.rst
index 1bb2cf2b108d4c1db0ac91b24d10ec5b4eeba04b..7561880b76f4071724ab2f03d4fc6da3f4fb402d 100644 (file)
--- a/Doc/library/fnmatch.rst
+++ b/Doc/library/fnmatch.rst
@@ -1,4 +1,3 @@
-
 :mod:`fnmatch` --- Unix filename pattern matching
 =================================================
 

diff --git a/Doc/library/formatter.rst b/Doc/library/formatter.rst
index c983ccc8387263fb18a9ed2c64b964088439aa7d..0a459a60cbfe0edf5ff35277c66b05c657ff4ab5 100644 (file)
--- a/Doc/library/formatter.rst
+++ b/Doc/library/formatter.rst
@@ -165,7 +165,7 @@ The following attributes are defined for formatter instance objects:
    :const:`AS_IS` values, is passed to the writer's :meth:`new_styles` method.
 
 
-.. method:: formatter.pop_style([n=1])
+.. method:: formatter.pop_style(n=1)
 
    Pop the last *n* style specifications passed to :meth:`push_style`.  A tuple
    representing the revised stack, including :const:`AS_IS` values, is passed to
@@ -177,7 +177,7 @@ The following attributes are defined for formatter instance objects:
    Set the spacing style for the writer.
 
 
-.. method:: formatter.assert_line_data([flag=1])
+.. method:: formatter.assert_line_data(flag=1)
 
    Inform the formatter that data has been added to the current paragraph
    out-of-band.  This should be used when the writer has been manipulated
@@ -194,7 +194,7 @@ Two implementations of formatter objects are provided by this module. Most
 applications may use one of these classes without modification or subclassing.
 
 
-.. class:: NullFormatter([writer])
+.. class:: NullFormatter(writer=None)
 
    A formatter which does nothing.  If *writer* is omitted, a :class:`NullWriter`
    instance is created.  No methods of the writer are called by
@@ -337,7 +337,7 @@ this module.  Most applications will need to derive new writer classes from the
    output.
 
 
-.. class:: DumbWriter([file[, maxcol=72]])
+.. class:: DumbWriter(file=None, maxcol=72)
 
    Simple writer class which writes output on the file object passed in as *file*
    or, if *file* is omitted, on standard output.  The output is simply word-wrapped

diff --git a/Doc/library/fpectl.rst b/Doc/library/fpectl.rst
index ef030f0034d37dd16308b94808f91e978b8fc6f4..fb15f6944506b451aec9cfaf4312c4a043991427 100644 (file)
--- a/Doc/library/fpectl.rst
+++ b/Doc/library/fpectl.rst
@@ -1,4 +1,3 @@
-
 :mod:`fpectl` --- Floating point exception control
 ==================================================