diff --git a/core/includes/language.inc b/core/includes/language.inc
index 76c4318..dbe465d 100644
--- a/core/includes/language.inc
+++ b/core/includes/language.inc
@@ -2,7 +2,13 @@
 
 /**
  * @file
- * Multiple language handling functionality.
+ * Language Negotiation API
+ *
+ * This file manages the negotiation of languages for users visiting your Drupal
+ * site.  The API is used by the locale module as the primary core
+ * implementation as well as any contrib modules.
+ *
+ * @see http://drupal.org/node/1497272
  */
 
 /**
@@ -11,6 +17,19 @@
 const LANGUAGE_NEGOTIATION_DEFAULT = 'language-default';
 
 /**
+ * @defgroup languages-negotiation Language Negotiation API
+ * functionality
+ * @{
+ * Functions for language negotiation.
+ *
+ * These functions manage the negotiation of languages for users visiting your
+ * Drupal site.  The API is used by the locale module as the primary core
+ * implementation as well as any contrib modules.
+ *
+ * @see http://drupal.org/node/1497272
+ */
+
+/**
  * Chooses a language for the given type based on language negotiation settings.
  *
  * @param $type
@@ -431,3 +450,7 @@ function language_fallback_get_candidates($type = LANGUAGE_TYPE_CONTENT) {
 
   return $fallback_candidates;
 }
+
+/**
+ * @} End of "languages-negotiation"
+ */