Index: globals.php
===================================================================
RCS file: /cvs/drupal/contributions/docs/developer/globals.php,v
retrieving revision 1.9
diff -u -r1.9 globals.php
--- globals.php	10 Nov 2009 16:07:41 -0000	1.9
+++ globals.php	3 Mar 2010 01:13:23 -0000
@@ -80,7 +80,10 @@
 global $user;
 
 /**
- * An object containing the information for the active language.
+ * An object containing the information for the active interface language.
+ *
+ * It represents the language the user interface textual elements such as
+ * titles, labels or messages, are to be displayed in.
  *
  * Example values:
  *  - 'language' => 'en',
@@ -94,10 +97,35 @@
  *  - 'prefix' => '',
  *  - 'weight' => 0,
  *  - 'javascript' => ''
+ *
+ * @see LANGUAGE_TYPE_INTERFACE
+ * @see drupal_language_initialize()
  */
 global $language;
 
 /**
+ * An object containing the information for the active content language.
+ *
+ * It is used by the Field API as a default value when no language is specified
+ * to select the field translation to be displayed.
+ *
+ * @see LANGUAGE_TYPE_CONTENT
+ * @see drupal_language_initialize()
+ */
+global $language_content;
+
+/**
+ * An object containing the information for the active url language.
+ *
+ * It is used as a default value by url-related functions such as l() when no
+ * language is explicitly specified.
+ *
+ * @see LANGUAGE_TYPE_URL
+ * @see drupal_language_initialize()
+ */
+global $language_url;
+
+/**
  * Disabled caling hook_boot() and hook_exit() during the update process (update.php) since
  * the database is in a largely unknown state.
  *