diff --git a/includes/language.inc b/includes/language.inc
index 20909f5..4f2cab5 100644
--- a/includes/language.inc
+++ b/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 @@
 define('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
+ */
+
+/**
  * Return all the defined language types.
  *
  * @return
@@ -471,3 +490,7 @@ function language_fallback_get_candidates($type = LANGUAGE_TYPE_CONTENT) {
 
   return $fallback_candidates;
 }
+
+/**
+ * @} End of "languages-negotiation"
+ */