diff --git a/core/modules/system/system.api.php b/core/modules/system/system.api.php
index 5d60011..42957a8 100644
--- a/core/modules/system/system.api.php
+++ b/core/modules/system/system.api.php
@@ -1936,18 +1936,23 @@ function hook_xmlrpc_alter(&$methods) {
  *   - request_uri: The Request URI for the page the event happened in.
  *   - referer: The page that referred the use to the page where the event occurred.
  *   - ip: The IP address where the request for the page came from.
- *   - timestamp: The UNIX timestamp of the date/time the event occurred
- *   - severity: One of the following values as defined in RFC 3164 http://www.faqs.org/rfcs/rfc3164.html
- *     WATCHDOG_EMERGENCY    Emergency: system is unusable
- *     WATCHDOG_ALERT    Alert: action must be taken immediately
- *     WATCHDOG_CRITICAL     Critical: critical conditions
- *     WATCHDOG_ERROR      Error: error conditions
- *     WATCHDOG_WARNING  Warning: warning conditions
- *     WATCHDOG_NOTICE   Notice: normal but significant condition
- *     WATCHDOG_INFO     Informational: informational messages
- *     WATCHDOG_DEBUG    Debug: debug-level messages
- *   - link: an optional link provided by the module that called the watchdog() function.
- *   - message: The text of the message to be logged.
+ *   - timestamp: The UNIX timestamp of the date/time the event occurred.
+ *   - severity: One of the following values as defined in RFC 3164 http://www.faqs.org/rfcs/rfc3164.html:
+ *     - WATCHDOG_EMERGENCY: Emergency, system is unusable.
+ *     - WATCHDOG_ALERT: Alert, action must be taken immediately.
+ *     - WATCHDOG_CRITICAL: Critical, critical conditions.
+ *     - WATCHDOG_ERROR: Error, error conditions.
+ *     - WATCHDOG_WARNING: Warning, warning conditions.
+ *     - WATCHDOG_NOTICE: Notice, normal but significant condition.
+ *     - WATCHDOG_INFO: Informational, informational messages.
+ *     - WATCHDOG_DEBUG: Debug, debug-level messages.
+ *   - link: An optional link provided by the module that called the watchdog() function.
+ *   - message: The text of the message to be logged. Variables in the message should 
+ *     be added by using placeholder strings alongside the variables argument to declare 
+ *     the value of the placeholders. See t() for documentation on how the message and variable
+ *     parameters interact.
+ *   - variables: An array of variables to be inserted into the message on display. Set to NULL 
+ *     if message is already translated or not possible to translate. Defaults to NULL.
  */
 function hook_watchdog(array $log_entry) {
   global $base_url, $language_interface;