Turn section references into proper cross-references.
diff --git a/Doc/library/os.rst b/Doc/library/os.rst
index 8b716b2..df32a43 100644
--- a/Doc/library/os.rst
+++ b/Doc/library/os.rst
@@ -363,8 +363,7 @@
.. deprecated:: 2.6
This function is obsolete. Use the :mod:`subprocess` module. Check
- specially the *Replacing Older Functions with the subprocess Module*
- section in that documentation page.
+ especially the :ref:`subprocess-replacements` section.
.. versionchanged:: 2.0
This function worked unreliably under Windows in earlier versions of Python.
@@ -413,9 +412,8 @@
child_stdout)``.
.. deprecated:: 2.6
- All of the :func:`popen\*` functions are obsolete. Use the :mod:`subprocess`
- module. Check specially the *Replacing Older Functions with the
- subprocess Module* section in that documentation page.
+ This function is obsolete. Use the :mod:`subprocess` module. Check
+ especially the :ref:`subprocess-replacements` section.
Availability: Macintosh, Unix, Windows.
@@ -428,9 +426,8 @@
child_stdout, child_stderr)``.
.. deprecated:: 2.6
- All of the :func:`popen\*` functions are obsolete. Use the :mod:`subprocess`
- module. Check specially the *Replacing Older Functions with the
- subprocess Module* section in that documentation page.
+ This function is obsolete. Use the :mod:`subprocess` module. Check
+ especially the :ref:`subprocess-replacements` section.
Availability: Macintosh, Unix, Windows.
@@ -443,9 +440,8 @@
child_stdout_and_stderr)``.
.. deprecated:: 2.6
- All of the :func:`popen\*` functions are obsolete. Use the :mod:`subprocess`
- module. Check specially the *Replacing Older Functions with the
- subprocess Module* section in that documentation page.
+ This function is obsolete. Use the :mod:`subprocess` module. Check
+ especially the :ref:`subprocess-replacements` section.
Availability: Macintosh, Unix, Windows.
@@ -1848,8 +1844,8 @@
The :mod:`subprocess` module provides more powerful facilities for spawning new
processes and retrieving their results; using that module is preferable to using
- this function. Check specially the *Replacing Older Functions with the
- subprocess Module* section in that documentation page.
+ this function. Use the :mod:`subprocess` module. Check especially the
+ :ref:`subprocess-replacements` section.
.. function:: times()
diff --git a/Doc/library/popen2.rst b/Doc/library/popen2.rst
index 84bde2b..af2e251 100644
--- a/Doc/library/popen2.rst
+++ b/Doc/library/popen2.rst
@@ -10,8 +10,7 @@
.. deprecated:: 2.6
This module is obsolete. Use the :mod:`subprocess` module. Check
- specially the *Replacing Older Functions with the subprocess Module*
- section in that documentation page.
+ especially the :ref:`subprocess-replacements` section.
This module allows you to spawn processes and connect to their
input/output/error pipes and obtain their return codes under Unix and Windows.
diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst
index c1be5ab..73a5cc5 100644
--- a/Doc/library/subprocess.rst
+++ b/Doc/library/subprocess.rst
@@ -273,6 +273,8 @@
``N`` (Unix only).
+.. _subprocess-replacements:
+
Replacing Older Functions with the subprocess Module
----------------------------------------------------