Turn section references into proper cross-references.

3 files changed, 12 insertions, 15 deletions

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 @@ These functions create new file objects. (See also :func:`open`.)
 
    .. 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 @@ functions, see :ref:`popen2-flow-control`.
    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 @@ functions, see :ref:`popen2-flow-control`.
    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 @@ functions, see :ref:`popen2-flow-control`.
    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 @@ written in Python, such as a mail server's external command delivery program.
 
    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 @@ The following attributes are also available:
    ``N`` (Unix only).
 
 
+.. _subprocess-replacements:
+
 Replacing Older Functions with the subprocess Module
 ----------------------------------------------------