[CalendarServer-changes] [11408] CalendarServer/branches/users/glyph/launchd-wrapper/twext/python/ log.py

[source_changes at macosforge.org]

Revision: 11408
          http://trac.calendarserver.org//changeset/11408
Author:   glyph at apple.com
Date:     2013-06-26 00:55:59 -0700 (Wed, 26 Jun 2013)
Log Message:
-----------
Document log levels.

Modified Paths:
--------------
    CalendarServer/branches/users/glyph/launchd-wrapper/twext/python/log.py

Modified: CalendarServer/branches/users/glyph/launchd-wrapper/twext/python/log.py
===================================================================
--- CalendarServer/branches/users/glyph/launchd-wrapper/twext/python/log.py	2013-06-26 07:55:31 UTC (rev 11407)
+++ CalendarServer/branches/users/glyph/launchd-wrapper/twext/python/log.py	2013-06-26 07:55:59 UTC (rev 11408)
@@ -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/20130626/e5364078/attachment-0001.html>