bpo-21063: Improve module synopsis for distutils (GH-17363) (#17381)

(cherry picked from commit f8a6316778faff3991144c3aec4fa92d7b30a72b)

Co-authored-by: Sanchit Khurana <54467174+GeniusLearner@users.noreply.github.com>

diff --git a/Doc/distutils/apiref.rst b/Doc/distutils/apiref.rst
index 8efeffb6376e136dec18baed66e7be9ec9df3818..5ae84e04165f5a7835d2e54e0792f66bf7d6d032 100644 (file)
--- a/Doc/distutils/apiref.rst
+++ b/Doc/distutils/apiref.rst
@@ -1530,7 +1530,7 @@ Python's own build procedures.
 =================================================
 
 .. module:: distutils.text_file
-   :synopsis: provides the TextFile class, a simple interface to text files
+   :synopsis: Provides the TextFile class, a simple interface to text files
 
 
 This module provides the :class:`TextFile` class, which gives an interface  to
@@ -1669,7 +1669,7 @@ lines, and joining lines with backslashes.
 ===================================================
 
 .. module:: distutils.version
-   :synopsis: implements classes that represent module version numbers.
+   :synopsis: Implements classes that represent module version numbers.
 
 
 .. % todo
@@ -1684,7 +1684,7 @@ lines, and joining lines with backslashes.
 ===================================================================
 
 .. module:: distutils.cmd
-   :synopsis: This module provides the abstract base class Command. This class
+   :synopsis: Provides the abstract base class :class:`~distutils.cmd.Command`. This class
               is subclassed by the modules in the distutils.command subpackage.
 
 
@@ -1777,7 +1777,7 @@ Subclasses of :class:`Command` must define the following methods.
 ==========================================================
 
 .. module:: distutils.command
-   :synopsis: This subpackage contains one module for each standard Distutils command.
+   :synopsis: Contains one module for each standard Distutils command.
 
 
 .. % \subsubsection{Individual Distutils commands}
@@ -2021,7 +2021,7 @@ This is described in more detail in :pep:`301`.
 ===================================================================
 
 .. module:: distutils.command.check
-   :synopsis: Check the metadata of a package
+   :synopsis: Check the meta-data of a package
 
 
 The ``check`` command performs some tests on the meta-data of a package.

diff --git a/Doc/library/2to3.rst b/Doc/library/2to3.rst
index fa4b0a9645531c4792d0116a226cd9ea13b8f83a..c3ff3e607e7978121403ed05e0a910e6c0f0d597 100644 (file)
--- a/Doc/library/2to3.rst
+++ b/Doc/library/2to3.rst
@@ -456,7 +456,7 @@ and off individually.  They are described here in more detail.
 -------------------------------
 
 .. module:: lib2to3
-   :synopsis: the 2to3 library
+   :synopsis: The 2to3 library
 
 .. moduleauthor:: Guido van Rossum
 .. moduleauthor:: Collin Winter

diff --git a/Doc/library/linecache.rst b/Doc/library/linecache.rst
index 34fcac57c072d53fce643238d12406e10c6b1ce1..8387de436a7bb91c13389593cf00f6154d079003 100644 (file)
--- a/Doc/library/linecache.rst
+++ b/Doc/library/linecache.rst
@@ -2,7 +2,7 @@
 ================================================
 
 .. module:: linecache
-   :synopsis: This module provides random access to individual lines from text files.
+   :synopsis: Provides random access to individual lines from text files.
 
 .. sectionauthor:: Moshe Zadka <moshez@zadka.site.co.il>
 

diff --git a/Doc/library/statistics.rst b/Doc/library/statistics.rst
index 26bb592b23812b8d36447d72820122ff1f18556d..081fafd45dda4222f60186f91ae6ee49db8680c1 100644 (file)
--- a/Doc/library/statistics.rst
+++ b/Doc/library/statistics.rst
@@ -2,7 +2,7 @@
 =======================================================
 
 .. module:: statistics
-   :synopsis: mathematical statistics functions
+   :synopsis: Mathematical statistics functions
 
 .. moduleauthor:: Steven D'Aprano <steve+python@pearwood.info>
 .. sectionauthor:: Steven D'Aprano <steve+python@pearwood.info>

diff --git a/Doc/library/zipimport.rst b/Doc/library/zipimport.rst
index eaae2bb04b74822a0de2ef85706cb819426ea76a..fddbb50bce9ab51f44d54b760f2139f38f43b6c8 100644 (file)
--- a/Doc/library/zipimport.rst
+++ b/Doc/library/zipimport.rst
@@ -2,7 +2,7 @@
 =====================================================
 
 .. module:: zipimport
-   :synopsis: support for importing Python modules from ZIP archives.
+   :synopsis: Support for importing Python modules from ZIP archives.
 
 .. moduleauthor:: Just van Rossum <just@letterror.com>