#15543: reflow paragraphs.
authorR David Murray <rdmurray@bitdance.com>
Wed, 15 Aug 2012 15:05:36 +0000 (11:05 -0400)
committerR David Murray <rdmurray@bitdance.com>
Wed, 15 Aug 2012 15:05:36 +0000 (11:05 -0400)
Doc/library/functions.rst
Doc/library/importlib.rst
Doc/library/io.rst
Doc/library/zipfile.rst
Doc/whatsnew/2.3.rst
Doc/whatsnew/2.5.rst

index 6b80bd9b4a963a812455c2b94438f0a57c1ac487..da077623fa6cc414109e51567c11755d82cc64da 100644 (file)
@@ -878,9 +878,8 @@ are always available.  They are listed here in alphabetical order.
       single: universal newlines; open() built-in function
 
    *newline* controls how :term:`universal newlines` mode works (it only
-   applies to text mode).
-   It can be ``None``, ``''``, ``'\n'``, ``'\r'``, and ``'\r\n'``.  It
-   works as follows:
+   applies to text mode).  It can be ``None``, ``''``, ``'\n'``, ``'\r'``, and
+   ``'\r\n'``.  It works as follows:
 
    * When reading input from the stream, if *newline* is ``None``, universal
      newlines mode is enabled.  Lines in the input can end in ``'\n'``,
index 158e7b443c186f45b10f84f6e04ef3dd1d9a47e9..164906399ed1cb53113f9e6ea4fd13a3e7e69618 100644 (file)
@@ -196,10 +196,9 @@ are also provided to help in implementing the core ABCs.
 
         An abstract method to return the source of a module. It is returned as
         a text string using :term:`universal newlines`, translating all
-        recognized line separators into ``'\n'`` characters.
-        Returns ``None`` if no
-        source is available (e.g. a built-in module). Raises :exc:`ImportError`
-        if the loader cannot find the module specified.
+        recognized line separators into ``'\n'`` characters.  Returns ``None``
+        if no source is available (e.g. a built-in module). Raises
+        :exc:`ImportError` if the loader cannot find the module specified.
 
     .. method:: is_package(fullname)
 
index 8e6e601203cc7601fcf7abf3b23990bd6b46e4ed..b71bfd407ee5a270c0e71bab67191b5eec4072b5 100644 (file)
@@ -764,13 +764,13 @@ Text I/O
    ``''``, ``'\n'``, ``'\r'``, and ``'\r\n'``.  It works as follows:
 
    * When reading input from the stream, if *newline* is ``None``,
-     :term:`universal newlines` mode is enabled.  Lines in the input can end
-     in ``'\n'``,
-     ``'\r'``, or ``'\r\n'``, and these are translated into ``'\n'`` before
-     being returned to the caller.  If it is ``''``, universal newlines mode is
-     enabled, but line endings are returned to the caller untranslated.  If it
-     has any of the other legal values, input lines are only terminated by the
-     given string, and the line ending is returned to the caller untranslated.
+     :term:`universal newlines` mode is enabled.  Lines in the input can end in
+     ``'\n'``, ``'\r'``, or ``'\r\n'``, and these are translated into ``'\n'``
+     before being returned to the caller.  If it is ``''``, universal newlines
+     mode is enabled, but line endings are returned to the caller untranslated.
+     If it has any of the other legal values, input lines are only terminated
+     by the given string, and the line ending is returned to the caller
+     untranslated.
 
    * When writing output to the stream, if *newline* is ``None``, any ``'\n'``
      characters written are translated to the system default line separator,
index 4035a14d84225e9689b8e86cce36e20c26c4e1a2..48edf1fccabdaced2f82a53e7ccd682b9f54b113 100644 (file)
@@ -174,13 +174,13 @@ ZipFile Objects
 
 .. method:: ZipFile.open(name, mode='r', pwd=None)
 
-   Extract a member from the archive as a file-like object (ZipExtFile). *name* is
-   the name of the file in the archive, or a :class:`ZipInfo` object. The *mode*
-   parameter, if included, must be one of the following: ``'r'`` (the  default),
-   ``'U'``, or ``'rU'``. Choosing ``'U'`` or  ``'rU'`` will enable
-   :term:`universal newlines` support in the read-only object.
-   *pwd* is the password used for encrypted files.
-   Calling  :meth:`open` on a closed ZipFile will raise a  :exc:`RuntimeError`.
+   Extract a member from the archive as a file-like object (ZipExtFile). *name*
+   is the name of the file in the archive, or a :class:`ZipInfo` object. The
+   *mode* parameter, if included, must be one of the following: ``'r'`` (the
+   default), ``'U'``, or ``'rU'``. Choosing ``'U'`` or  ``'rU'`` will enable
+   :term:`universal newlines` support in the read-only object.  *pwd* is the
+   password used for encrypted files.  Calling  :meth:`open` on a closed
+   ZipFile will raise a  :exc:`RuntimeError`.
 
    .. note::
 
index f71422f51893a7f8efe72570a49d078eb71e4f75..f4c79e4157b331088965565eadb1e9a32044fce3 100644 (file)
@@ -379,13 +379,12 @@ mark the ends of lines in text files.  Unix uses the linefeed (ASCII character
 10), MacOS uses the carriage return (ASCII character 13), and Windows uses a
 two-character sequence of a carriage return plus a newline.
 
-Python's file objects can now support end of line conventions other than the one
-followed by the platform on which Python is running. Opening a file with the
-mode ``'U'`` or ``'rU'`` will open a file for reading in
-:term:`universal newlines` mode.
-All three line ending conventions will be translated to a ``'\n'`` in the
-strings returned by the various file methods such as :meth:`read` and
-:meth:`readline`.
+Python's file objects can now support end of line conventions other than the
+one followed by the platform on which Python is running. Opening a file with
+the mode ``'U'`` or ``'rU'`` will open a file for reading in :term:`universal
+newlines` mode.  All three line ending conventions will be translated to a
+``'\n'`` in the strings returned by the various file methods such as
+:meth:`read` and :meth:`readline`.
 
 Universal newline support is also used when importing modules and when executing
 a file with the :func:`execfile` function.  This means that Python modules can
index afe0f5e5efb91555c257457524f05ddb22214629..e059cd50a33d4531ceba87e348e092115fbc268f 100644 (file)
@@ -1343,12 +1343,12 @@ complete list of changes, or look through the SVN logs for all the details.
 
 * The :mod:`fileinput` module was made more flexible. Unicode filenames are now
   supported, and a *mode* parameter that defaults to ``"r"`` was added to the
-  :func:`input` function to allow opening files in binary or
-  :term:`universal newlines` mode.
-  Another new parameter, *openhook*, lets you use a function other than
-  :func:`open`  to open the input files.  Once you're iterating over  the set of
-  files, the :class:`FileInput` object's new :meth:`fileno` returns the file
-  descriptor for the currently opened file. (Contributed by Georg Brandl.)
+  :func:`input` function to allow opening files in binary or :term:`universal
+  newlines` mode.  Another new parameter, *openhook*, lets you use a function
+  other than :func:`open`  to open the input files.  Once you're iterating over
+  the set of files, the :class:`FileInput` object's new :meth:`fileno` returns
+  the file descriptor for the currently opened file. (Contributed by Georg
+  Brandl.)
 
 * In the :mod:`gc` module, the new :func:`get_count` function returns a 3-tuple
   containing the current collection counts for the three GC generations.  This is