Index: includes/bootstrap.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/bootstrap.inc,v
retrieving revision 1.399
diff -u -p -r1.399 bootstrap.inc
--- includes/bootstrap.inc	14 Jun 2010 13:24:32 -0000	1.399
+++ includes/bootstrap.inc	20 Jun 2010 13:17:34 -0000
@@ -1590,7 +1590,8 @@ function watchdog_exception($type, Excep
  * Log a system message.
  *
  * @param $type
- *   The category to which this message belongs.
+ *   The category to which this message belongs, can be any string but
+ *   general practice is to use the name of the module calling watchdog.
  * @param $message
  *   The message to store in the log. Keep $message translatable
  *   by not concatenating dynamic values into it! Variables in the
@@ -1602,7 +1603,8 @@ function watchdog_exception($type, Excep
  *   NULL if message is already translated or not possible to
  *   translate.
  * @param $severity
- *   The severity of the message, as per RFC 3164.
+ *   The severity of the message, as per RFC 3164. Possible contents are
+ *   WATCHDOG_ERROR, WATCHDOG_WARNING, etc.
  * @param $link
  *   A link to associate with the message.
  *