[CalendarServer-changes] [11383] CalendarServer/trunk/twext/python/log.py

[source_changes at macosforge.org]

Revision: 11383
          http://trac.calendarserver.org//changeset/11383
Author:   wsanchez at apple.com
Date:     2013-06-19 13:50:39 -0700 (Wed, 19 Jun 2013)
Log Message:
-----------
Document log levels.

Modified Paths:
--------------
    CalendarServer/trunk/twext/python/log.py

Modified: CalendarServer/trunk/twext/python/log.py
===================================================================
--- CalendarServer/trunk/twext/python/log.py	2013-06-19 19:19:40 UTC (rev 11382)
+++ CalendarServer/trunk/twext/python/log.py	2013-06-19 20:50:39 UTC (rev 11383)
@@ -102,7 +102,23 @@
 
 class LogLevel(Names):
     """
-    Constants denoting log levels.
+    Constants denoting log levels:
+
+     - C{debug}: Information of use to a developer of the software, not
+       generally of interest to someone running the software unless they are
+       attempting to diagnose a software issue.
+
+     - C{info}: Informational events: Routine information about the status of
+       an application, such as incoming connections, startup of a subsystem,
+       etc.
+
+     - C{warn}: Warnings events: Events that may require greater attention than
+       informational events but are a failure condition, such as authorization
+       failures, bad data from a network client, etc.
+
+     - C{error}: Error conditions: Events indicating a software failure, such
+       as unhandled exceptions, loss of connectivity to a back-end database,
+       etc.
     """
     debug = NamedConstant()
     info  = NamedConstant()
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/calendarserver-changes/attachments/20130619/e6bf91c1/attachment-0001.html>