summaryrefslogtreecommitdiff
path: root/Doc/library
diff options
context:
space:
mode:
authorTerry Jan Reedy <tjreedy@udel.edu>2016-06-22 22:46:34 -0400
committerTerry Jan Reedy <tjreedy@udel.edu>2016-06-22 22:46:34 -0400
commitdcb6c88a240fea82da8867d1de1022a4555f22b4 (patch)
tree69d79bbbeffa667cf5c77387a1ee1ae5df6c2e6f /Doc/library
parent06a1fcbb0035c664fefc53ddb8df65cc03a537b7 (diff)
downloadcpython-git-dcb6c88a240fea82da8867d1de1022a4555f22b4.tar.gz
Issue #27304: Source code links for sub-packages in the same file.
Patch by Yoni Lavi
Diffstat (limited to 'Doc/library')
-rw-r--r--Doc/library/dbm.rst10
-rw-r--r--Doc/library/importlib.rst14
-rw-r--r--Doc/library/json.rst8
3 files changed, 31 insertions, 1 deletions
diff --git a/Doc/library/dbm.rst b/Doc/library/dbm.rst
index 6f64196a8a..2a1db91427 100644
--- a/Doc/library/dbm.rst
+++ b/Doc/library/dbm.rst
@@ -128,6 +128,9 @@ The individual submodules are described in the following sections.
:platform: Unix
:synopsis: GNU's reinterpretation of dbm.
+**Source code:** :source:`Lib/dbm/gnu.py`
+
+--------------
This module is quite similar to the :mod:`dbm` module, but uses the GNU library
``gdbm`` instead to provide some additional functionality. Please note that the
@@ -237,6 +240,9 @@ supported.
:platform: Unix
:synopsis: The standard "database" interface, based on ndbm.
+**Source code:** :source:`Lib/dbm/ndbm.py`
+
+--------------
The :mod:`dbm.ndbm` module provides an interface to the Unix "(n)dbm" library.
Dbm objects behave like mappings (dictionaries), except that keys and values are
@@ -299,6 +305,8 @@ to locate the appropriate header file to simplify building this module.
.. module:: dbm.dumb
:synopsis: Portable implementation of the simple DBM interface.
+**Source code:** :source:`Lib/dbm/dumb.py`
+
.. index:: single: databases
.. note::
@@ -308,6 +316,8 @@ to locate the appropriate header file to simplify building this module.
module is not written for speed and is not nearly as heavily used as the other
database modules.
+--------------
+
The :mod:`dbm.dumb` module provides a persistent dictionary-like interface which
is written entirely in Python. Unlike other modules such as :mod:`dbm.gnu` no
external library is required. As with other persistent mappings, the keys and
diff --git a/Doc/library/importlib.rst b/Doc/library/importlib.rst
index 3302446b40..ff7cc91eb3 100644
--- a/Doc/library/importlib.rst
+++ b/Doc/library/importlib.rst
@@ -211,6 +211,11 @@ Functions
.. module:: importlib.abc
:synopsis: Abstract base classes related to import
+**Source code:** :source:`Lib/importlib/abc.py`
+
+--------------
+
+
The :mod:`importlib.abc` module contains all of the core abstract base classes
used by :keyword:`import`. Some subclasses of the core abstract base classes
are also provided to help in implementing the core ABCs.
@@ -700,6 +705,10 @@ ABC hierarchy::
.. module:: importlib.machinery
:synopsis: Importers and path hooks
+**Source code:** :source:`Lib/importlib/machinery.py`
+
+--------------
+
This module contains the various objects that help :keyword:`import`
find and load modules.
@@ -1082,6 +1091,11 @@ find and load modules.
.. module:: importlib.util
:synopsis: Utility code for importers
+
+**Source code:** :source:`Lib/importlib/util.py`
+
+--------------
+
This module contains the various objects that help in the construction of
an :term:`importer`.
diff --git a/Doc/library/json.rst b/Doc/library/json.rst
index 174e734115..1e34cf3bdf 100644
--- a/Doc/library/json.rst
+++ b/Doc/library/json.rst
@@ -629,13 +629,19 @@ when serializing instances of "exotic" numerical types such as
:class:`decimal.Decimal`.
.. highlight:: bash
-.. module:: json.tool
.. _json-commandline:
Command Line Interface
----------------------
+.. module:: json.tool
+ :synopsis: A command line to validate and pretty-print JSON.
+
+**Source code:** :source:`Lib/json/tool.py`
+
+--------------
+
The :mod:`json.tool` module provides a simple command line interface to validate
and pretty-print JSON objects.