[Python-checkins] r77973 - in python/trunk: Doc/library/logging.rst Misc/NEWS

Thu Feb 4 21:23:45 CET 2010

Author: vinay.sajip
Date: Thu Feb 4 21:23:45 2010
New Revision: 77973
Log:
Issue #7851: logging: clarification on logging configuration files.
Modified:
 python/trunk/Doc/library/logging.rst
 python/trunk/Misc/NEWS
Modified: python/trunk/Doc/library/logging.rst
==============================================================================

--- python/trunk/Doc/library/logging.rst	(original)
+++ python/trunk/Doc/library/logging.rst	Thu Feb 4 21:23:45 2010
@@ -422,6 +422,13 @@
 code approach, mainly separation of configuration and code and the ability of
 noncoders to easily modify the logging properties.
 
+Note that the class names referenced in config files need to be either relative
+to the logging module, or absolute values which can be resolved using normal
+import mechanisms. Thus, you could use either `handlers.WatchedFileHandler`
+(relative to the logging module) or `mypackage.mymodule.MyHandler` (for a
+class defined in package `mypackage` and module `mymodule`, where `mypackage`
+is available on the Python import path).
+
 .. _library-config:
 
 Configuring Logging for a Library
Modified: python/trunk/Misc/NEWS
==============================================================================
--- python/trunk/Misc/NEWS	(original)
+++ python/trunk/Misc/NEWS	Thu Feb 4 21:23:45 2010
@@ -55,6 +55,8 @@
 Library
 -------
 
+- Issue #7851: logging: clarification on logging configuration files.
+
 - Issue #4772: Raise a ValueError when an unknown Bluetooth protocol is
 specified, rather than fall through to AF_PACKET (in the `socket` module).
 Also, raise ValueError rather than TypeError when an unknown TIPC address
