Index: includes/bootstrap.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/bootstrap.inc,v
retrieving revision 1.138
diff -u -p -r1.138 bootstrap.inc
--- includes/bootstrap.inc	10 Dec 2006 20:13:36 -0000	1.138
+++ includes/bootstrap.inc	11 Dec 2006 09:10:04 -0000
@@ -13,8 +13,22 @@ define('CACHE_DISABLED', 0);
 define('CACHE_NORMAL', 1);
 define('CACHE_AGGRESSIVE', 2);
 
+/**
+ * Indicates a notice-level watchdog event; these are normally notifications
+ * of normal system events that have occurred and can usually be safely ignored.
+ */
 define('WATCHDOG_NOTICE', 0);
+
+/**
+ * Indicates a warning-level watchdog event; this can be triggered by an error
+ * in a module that does not impact the overall functionality of the site. 
+ */
 define('WATCHDOG_WARNING', 1);
+
+/**
+ * Indicates an error-level watchdog event; could be indicative of an attempt
+ * to compromise the security of the site, or a serious system error.
+ */
 define('WATCHDOG_ERROR', 2);
 
 /**