summaryrefslogtreecommitdiffstats
path: root/Doc/library/logging.rst
diff options
context:
space:
mode:
authorVinay Sajip <vinay_sajip@yahoo.co.uk>2011-10-21 06:33:42 (GMT)
committerVinay Sajip <vinay_sajip@yahoo.co.uk>2011-10-21 06:33:42 (GMT)
commit04d5bc00a219860c69ea17eaa633d3ab9917409f (patch)
tree951bae5de7e88f2963ac9156f5836f10aa7d2f62 /Doc/library/logging.rst
parentac65d96777f1619c2910de82093e4f6f24dedd2f (diff)
downloadcpython-04d5bc00a219860c69ea17eaa633d3ab9917409f.zip
cpython-04d5bc00a219860c69ea17eaa633d3ab9917409f.tar.gz
cpython-04d5bc00a219860c69ea17eaa633d3ab9917409f.tar.bz2
Closes #13235: Added deprecation for warn() methods and function in logging.
Diffstat (limited to 'Doc/library/logging.rst')
-rw-r--r--Doc/library/logging.rst11
1 files changed, 9 insertions, 2 deletions
diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index 68cfa6e..4998949 100644
--- a/Doc/library/logging.rst
+++ b/Doc/library/logging.rst
@@ -189,6 +189,9 @@ instantiated directly, but always through the module-level function
Logs a message with level :const:`WARNING` on this logger. The arguments are
interpreted as for :meth:`debug`.
+ .. note:: There is an obsolete method `warn()` which is functionally
+ identical to `warning()`. As `warn()` is deprecated, please do not use
+ it - use `warning()` instead.
.. method:: Logger.error(msg, *args, **kwargs)
@@ -880,8 +883,12 @@ functions.
.. function:: warning(msg, *args, **kwargs)
- Logs a message with level :const:`WARNING` on the root logger. The arguments are
- interpreted as for :func:`debug`.
+ Logs a message with level :const:`WARNING` on the root logger. The arguments
+ are interpreted as for :func:`debug`.
+
+ .. note:: There is an obsolete function `warn()` which is functionally
+ identical to `warning()`. As `warn()` is deprecated, please do not use
+ it - use `warning()` instead.
.. function:: error(msg, *args, **kwargs)