Issue #25161: Add full stops in documentation; patch by Takase Arihiro

diff --git a/Doc/c-api/code.rst b/Doc/c-api/code.rst
index 7d9b4b6c1d7e81cb06b1a5c3dce99bcb173839bb..041213843912dc73de1c68779a1fbd3d7c54c861 100644 (file)
--- a/Doc/c-api/code.rst
+++ b/Doc/c-api/code.rst
@@ -29,7 +29,7 @@ bound into a function.
 
 .. c:function:: int PyCode_Check(PyObject *co)
 
-   Return true if *co* is a :class:`code` object
+   Return true if *co* is a :class:`code` object.
 
 .. c:function:: int PyCode_GetNumFree(PyObject *co)
 

diff --git a/Doc/c-api/gen.rst b/Doc/c-api/gen.rst
index 33cd27a5aa6c44bf99a0630745000043d98da9c7..0c851a75efbe1dba04fefda992eff1338190c2c7 100644 (file)
--- a/Doc/c-api/gen.rst
+++ b/Doc/c-api/gen.rst
@@ -17,7 +17,7 @@ than explicitly calling :c:func:`PyGen_New`.
 
 .. c:var:: PyTypeObject PyGen_Type
 
-   The type object corresponding to generator objects
+   The type object corresponding to generator objects.
 
 
 .. c:function:: int PyGen_Check(ob)

diff --git a/Doc/c-api/veryhigh.rst b/Doc/c-api/veryhigh.rst
index 610766557741d4fe8db8121731069aaff9444177..9e54c1409d63bc1033e0e264a991bb71c322f579 100644 (file)
--- a/Doc/c-api/veryhigh.rst
+++ b/Doc/c-api/veryhigh.rst
@@ -168,7 +168,7 @@ the same library that the Python runtime is using.
 .. c:function:: struct _node* PyParser_SimpleParseFile(FILE *fp, const char *filename, int start)
 
    This is a simplified interface to :c:func:`PyParser_SimpleParseFileFlags` below,
-   leaving *flags* set to ``0``
+   leaving *flags* set to ``0``.
 
 
 .. c:function:: struct _node* PyParser_SimpleParseFileFlags(FILE *fp, const char *filename, int start, int flags)

diff --git a/Doc/distutils/apiref.rst b/Doc/distutils/apiref.rst
index 92803b17544491702940a9d4c5b40bef461216e6..c7d399f595dc19a1db491b85f53d8f924ff60bdd 100644 (file)
--- a/Doc/distutils/apiref.rst
+++ b/Doc/distutils/apiref.rst
@@ -926,7 +926,7 @@ timestamp dependency analysis.
 
    Walk two filename lists in parallel, testing if each source is newer than its
    corresponding target.  Return a pair of lists (*sources*, *targets*) where
-   source is newer than target, according to the semantics of :func:`newer`
+   source is newer than target, according to the semantics of :func:`newer`.
 
    .. % % equivalent to a listcomp...
 

diff --git a/Doc/library/2to3.rst b/Doc/library/2to3.rst
index bfa7ea3fb12faf5c7efbf0b6363f952ed7d0c178..7ebc208efe124ef3465741584becb22b86eda770 100644 (file)
--- a/Doc/library/2to3.rst
+++ b/Doc/library/2to3.rst
@@ -271,7 +271,7 @@ and off individually.  They are described here in more detail.
 
 .. 2to3fixer:: input
 
-   Converts ``input(prompt)`` to ``eval(input(prompt))``
+   Converts ``input(prompt)`` to ``eval(input(prompt))``.
 
 .. 2to3fixer:: intern
 

diff --git a/Doc/library/argparse.rst b/Doc/library/argparse.rst
index 9955646b671d5728762d982971002dd022af0577..181291fec019786a072238ed3d6eec02e2688e1e 100644 (file)
--- a/Doc/library/argparse.rst
+++ b/Doc/library/argparse.rst
@@ -1948,4 +1948,4 @@ A partial upgrade path from :mod:`optparse` to :mod:`argparse`:
   ``%(default)s`` and ``%(prog)s``.
 
 * Replace the OptionParser constructor ``version`` argument with a call to
-  ``parser.add_argument('--version', action='version', version='<the version>')``
+  ``parser.add_argument('--version', action='version', version='<the version>')``.

diff --git a/Doc/library/bdb.rst b/Doc/library/bdb.rst
index 82ef37e5670263ab85f3362da2456a8228f8a08e..6980353d7ad2500ca151d6772a2ff08839740ad2 100644 (file)
--- a/Doc/library/bdb.rst
+++ b/Doc/library/bdb.rst
@@ -223,7 +223,7 @@ The :mod:`bdb` module also defines two classes:
    .. method:: set_until(frame)
 
       Stop when the line with the line no greater than the current one is
-      reached or when returning from current frame
+      reached or when returning from current frame.
 
    .. method:: set_trace([frame])
 

diff --git a/Doc/library/cookie.rst b/Doc/library/cookie.rst
index 19786f7da22ba18ef1929d13d2b691afd6fa7f6b..8d6420681ca574dfeb0c4191c9c0350ee8f67e51 100644 (file)
--- a/Doc/library/cookie.rst
+++ b/Doc/library/cookie.rst
@@ -116,7 +116,7 @@ Cookie Objects
 
    Return an encoded value. *val* can be any type, but return value must be a
    string. This method does nothing in :class:`BaseCookie` --- it exists so it can
-   be overridden
+   be overridden.
 
    In general, it should be the case that :meth:`value_encode` and
    :meth:`value_decode` are inverses on the range of *value_decode*.

diff --git a/Doc/library/cookielib.rst b/Doc/library/cookielib.rst
index e559f829cfb5b4194db648958d5e967b8c4050fa..7829f53c111e9fac65f4fecba4c7c8463d6a3414 100644 (file)
--- a/Doc/library/cookielib.rst
+++ b/Doc/library/cookielib.rst
@@ -546,7 +546,7 @@ Netscape protocol strictness switches:
 
 .. attribute:: DefaultCookiePolicy.strict_ns_unverifiable
 
-   apply RFC 2965 rules on unverifiable transactions even to Netscape cookies
+   Apply RFC 2965 rules on unverifiable transactions even to Netscape cookies.
 
 
 .. attribute:: DefaultCookiePolicy.strict_ns_domain

diff --git a/Doc/library/decimal.rst b/Doc/library/decimal.rst
index 564d10c5f7d70a2176a6440e22fd2612545aaf29..a203fbd5567b264a4cfae6583da2e40b4cde8481 100644 (file)
--- a/Doc/library/decimal.rst
+++ b/Doc/library/decimal.rst
@@ -890,7 +890,7 @@ Decimal objects
 
       Engineering notation has an exponent which is a multiple of 3, so there
       are up to 3 digits left of the decimal place.  For example, converts
-      ``Decimal('123E+1')`` to ``Decimal('1.23E+3')``
+      ``Decimal('123E+1')`` to ``Decimal('1.23E+3')``.
 
    .. method:: to_integral([rounding[, context]])
 

diff --git a/Doc/library/exceptions.rst b/Doc/library/exceptions.rst
index 9291c1801676e5f4cf22ed5aea238be24bac5c1d..fe14656008177f99c54aa71a66962648f9c0e861 100644 (file)
--- a/Doc/library/exceptions.rst
+++ b/Doc/library/exceptions.rst
@@ -496,7 +496,7 @@ module for more information.
 
 .. exception:: SyntaxWarning
 
-   Base class for warnings about dubious syntax
+   Base class for warnings about dubious syntax.
 
 
 .. exception:: RuntimeWarning

diff --git a/Doc/library/fractions.rst b/Doc/library/fractions.rst
index 81b419ea36e482c2d42876939a288a38e840b1c8..00a7672e125b21b3cc492e34fa80e1cc4acb9002 100644 (file)
--- a/Doc/library/fractions.rst
+++ b/Doc/library/fractions.rst
@@ -89,7 +89,7 @@ another rational number, or from a string.
 
       This class method constructs a :class:`Fraction` representing the exact
       value of *flt*, which must be a :class:`float`. Beware that
-      ``Fraction.from_float(0.3)`` is not the same value as ``Fraction(3, 10)``
+      ``Fraction.from_float(0.3)`` is not the same value as ``Fraction(3, 10)``.
 
       .. note:: From Python 2.7 onwards, you can also construct a
          :class:`Fraction` instance directly from a :class:`float`.

diff --git a/Doc/library/json.rst b/Doc/library/json.rst
index 6db8f97cc0e03669bc9989d3f68155d05fa23e0c..b501d65c44a17c920234bdcd56b76d40b88aaf17 100644 (file)
--- a/Doc/library/json.rst
+++ b/Doc/library/json.rst
@@ -356,7 +356,7 @@ Encoders and Decoders
    .. method:: decode(s)
 
       Return the Python representation of *s* (a :class:`str` or
-      :class:`unicode` instance containing a JSON document)
+      :class:`unicode` instance containing a JSON document).
 
    .. method:: raw_decode(s)
 

diff --git a/Doc/library/locale.rst b/Doc/library/locale.rst
index 5590514c15eda1806d733a6f0a4497f2f9db9819..8fa1a1b5e5221d7b45ef7552840c83d7ac8e2adf 100644 (file)
--- a/Doc/library/locale.rst
+++ b/Doc/library/locale.rst
@@ -208,7 +208,7 @@ The :mod:`locale` module defines the following exception and functions:
 
    .. data:: RADIXCHAR
 
-      Get the radix character (decimal dot, decimal comma, etc.)
+      Get the radix character (decimal dot, decimal comma, etc.).
 
    .. data:: THOUSEP
 

diff --git a/Doc/library/modulefinder.rst b/Doc/library/modulefinder.rst
index 40bf60f1907f4aef215824a6c035dba75141436b..4acddd20659fea5bde5933dcca70535be2026110 100644 (file)
--- a/Doc/library/modulefinder.rst
+++ b/Doc/library/modulefinder.rst
@@ -55,7 +55,7 @@ report of the imported modules will be printed.
    .. attribute:: modules
 
       A dictionary mapping module names to modules. See
-      :ref:`modulefinder-example`
+      :ref:`modulefinder-example`.
 
 
 .. _modulefinder-example:

diff --git a/Doc/library/msvcrt.rst b/Doc/library/msvcrt.rst
index d7fd3fb770b223d553a7ec9a6cd02857dfb218aa..87b816679f3464b40e6bb307211ec4e8bbcef2db 100644 (file)
--- a/Doc/library/msvcrt.rst
+++ b/Doc/library/msvcrt.rst
@@ -19,7 +19,7 @@ documentation.
 The module implements both the normal and wide char variants of the console I/O
 api. The normal API deals only with ASCII characters and is of limited use
 for internationalized applications. The wide char API should be used where
-ever possible
+ever possible.
 
 .. _msvcrt-files:
 

diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst
index 109ffae12520e745d0e7f794147edde80e58caf6..2c765f551c1b5ceb590314d95d0f412a20988e8c 100644 (file)
--- a/Doc/library/multiprocessing.rst
+++ b/Doc/library/multiprocessing.rst
@@ -1705,7 +1705,7 @@ itself.  This means, for example, that one shared object can contain a second:
       raised by :meth:`_callmethod`.
 
       Note in particular that an exception will be raised if *methodname* has
-      not been *exposed*
+      not been *exposed*.
 
       An example of the usage of :meth:`_callmethod`:
 

diff --git a/Doc/library/platform.rst b/Doc/library/platform.rst
index cb7144a64adb88f6fdbbb8b2378b470e20ebeefd..28b6f08914e32e005b4b21f1d3e98bb7dd62713a 100644 (file)
--- a/Doc/library/platform.rst
+++ b/Doc/library/platform.rst
@@ -126,7 +126,7 @@ Cross Platform
 
 .. function:: python_version()
 
-   Returns the Python version as string ``'major.minor.patchlevel'``
+   Returns the Python version as string ``'major.minor.patchlevel'``.
 
    Note that unlike the Python ``sys.version``, the returned value will always
    include the patchlevel (it defaults to 0).

diff --git a/Doc/library/shutil.rst b/Doc/library/shutil.rst
index f350f5ea54463018bff20fcb9d7f2e4ee5c06ade..2bf9680e97110807c3b9e6440e3363df2ee5e040 100644 (file)
--- a/Doc/library/shutil.rst
+++ b/Doc/library/shutil.rst
@@ -291,7 +291,7 @@ provided.  They rely on the :mod:`zipfile` and :mod:`tarfile` modules.
 .. function:: get_archive_formats()
 
    Return a list of supported formats for archiving.
-   Each element of the returned sequence is a tuple ``(name, description)``
+   Each element of the returned sequence is a tuple ``(name, description)``.
 
    By default :mod:`shutil` provides these formats:
 

diff --git a/Doc/library/wsgiref.rst b/Doc/library/wsgiref.rst
index 0b0c7c2245efa70f5d9e59f211c47c419398377c..98989c34a0ef2753bab87ed4aa123db5d963a258 100644 (file)
--- a/Doc/library/wsgiref.rst
+++ b/Doc/library/wsgiref.rst
@@ -479,7 +479,7 @@ input, output, and error streams.
 
    Similar to :class:`BaseCGIHandler`, but designed for use with HTTP origin
    servers.  If you are writing an HTTP server implementation, you will probably
-   want to subclass this instead of :class:`BaseCGIHandler`
+   want to subclass this instead of :class:`BaseCGIHandler`.
 
    This class is a subclass of :class:`BaseHandler`.  It overrides the
    :meth:`__init__`, :meth:`get_stdin`, :meth:`get_stderr`, :meth:`add_cgi_vars`,

diff --git a/Doc/library/xml.dom.minidom.rst b/Doc/library/xml.dom.minidom.rst
index 5cde5e2d52e24dae9e356fe0e9300d13d1d6fba1..4e7cd5a6a5c056f8fcb6844c2e6409a3f5e4aca5 100644 (file)
--- a/Doc/library/xml.dom.minidom.rst
+++ b/Doc/library/xml.dom.minidom.rst
@@ -18,7 +18,7 @@
 Model interface, with an API similar to that in other languages.  It is intended
 to be simpler than the full DOM and also significantly smaller.  Users who are
 not already proficient with the DOM should consider using the
-:mod:`xml.etree.ElementTree` module for their XML processing instead
+:mod:`xml.etree.ElementTree` module for their XML processing instead.
 
 
 .. warning::

diff --git a/Doc/library/xml.dom.rst b/Doc/library/xml.dom.rst
index b496aa1713cdf966f924afb670a0aea3d5b7d8d0..6dba90035bb49c6656afd145ba83469cd9446e6b 100644 (file)
--- a/Doc/library/xml.dom.rst
+++ b/Doc/library/xml.dom.rst
@@ -321,7 +321,7 @@ All of the components of an XML document are subclasses of :class:`Node`.
 .. attribute:: Node.prefix
 
    The part of the :attr:`tagName` preceding the colon if there is one, else the
-   empty string.  The value is a string, or ``None``
+   empty string.  The value is a string, or ``None``.
 
 
 .. attribute:: Node.namespaceURI

diff --git a/Doc/library/xml.etree.elementtree.rst b/Doc/library/xml.etree.elementtree.rst
index 4f9b2a37cbdbb503ce971acf84fa8913bf98ed87..212a9e1e7a94e728f8e8287ddf98e9f3c9d09a1f 100644 (file)
--- a/Doc/library/xml.etree.elementtree.rst
+++ b/Doc/library/xml.etree.elementtree.rst
@@ -829,7 +829,7 @@ ElementTree Objects
 
       Creates and returns a tree iterator for the root element.  The iterator
       loops over all elements in this tree, in section order.  *tag* is the tag
-      to look for (default is to return all elements)
+      to look for (default is to return all elements).
 
 
    .. method:: iterfind(match)

diff --git a/Misc/ACKS b/Misc/ACKS
index 5a30dab80f1030f5528a9395df052d45894cc70e..32208f5aad1ee07b14f3a9201c9aa9a7e2f1a736 100644 (file)
--- a/Misc/ACKS
+++ b/Misc/ACKS
@@ -1341,6 +1341,7 @@ John Szakmeister
 Amir Szekely
 Arfrever Frehtes Taifersar Arahesis
 Hideaki Takahashi
+Takase Arihiro
 Indra Talip
 Neil Tallim
 Geoff Talvola