In the deprecated functions I added an alert to review
specially a section of the subprocess documentation
that helps with the replacing of those functionss.
diff --git a/Doc/library/popen2.rst b/Doc/library/popen2.rst
index 2635175..84bde2b 100644
--- a/Doc/library/popen2.rst
+++ b/Doc/library/popen2.rst
@@ -9,7 +9,9 @@
 
 
 .. deprecated:: 2.6
-   This module is obsolete.  Use the :mod:`subprocess` module.
+   This module is obsolete.  Use the :mod:`subprocess` module.  Check 
+   specially the *Replacing Older Functions with the subprocess Module* 
+   section in that documentation page.
 
 This module allows you to spawn processes and connect to their
 input/output/error pipes and obtain their return codes under Unix and Windows.