[Python-checkins] cpython: Issue #17177: Clarify some deprecations

[brett.cannon]

http://hg.python.org/cpython/rev/ded443c603f0
changeset:   84215:ded443c603f0
parent:      84208:626a8e49f2a9
user:        Brett Cannon <brett at python.org>
date:        Tue Jun 18 20:49:55 2013 -0400
summary:
  Issue #17177: Clarify some deprecations

files:
  Doc/library/imp.rst |  14 +++++++++++---
  1 files changed, 11 insertions(+), 3 deletions(-)


diff --git a/Doc/library/imp.rst b/Doc/library/imp.rst
--- a/Doc/library/imp.rst
+++ b/Doc/library/imp.rst
@@ -103,8 +103,10 @@
    using a :keyword:`try` ... :keyword:`finally` statement.
 
    .. deprecated:: 3.3
-      Unneeded as loaders should be used to load modules and
-      :func:`find_module` is deprecated.
+      If previously used in conjunction with :func:`imp.find_module` then
+      call ``load_module()`` on the returned loader. If you wish to load a
+      module from a specific file, then use one of the file-based loaders found
+      in :mod:`importlib.machinery`.
 
 
 .. function:: new_module(name)
@@ -233,7 +235,7 @@
    magic number, as returned by :func:`get_magic`.
 
    .. deprecated:: 3.4
-      You may use :attr:`sys.implementation.cache_tag` directly starting
+      Use :attr:`sys.implementation.cache_tag` directly starting
       in Python 3.3.
 
 
@@ -261,6 +263,8 @@
    the most part.  A global import lock is kept for some critical tasks,
    such as initializing the per-module locks.
 
+.. deprecated:: 3.4
+
 
 .. function:: acquire_lock()
 
@@ -279,6 +283,8 @@
    the most part.  A global import lock is kept for some critical tasks,
    such as initializing the per-module locks.
 
+.. deprecated:: 3.4
+
 
 .. function:: release_lock()
 
@@ -290,6 +296,8 @@
    the most part.  A global import lock is kept for some critical tasks,
    such as initializing the per-module locks.
 
+.. deprecated:: 3.4
+
 
 The following constants with integer values, defined in this module, are used
 to indicate the search result of :func:`find_module`.

-- 
Repository URL: http://hg.python.org/cpython