From 8e255c67bc52634ce8f445be1a81fc84d0a8e722 Mon Sep 17 00:00:00 2001
From: webchick <webchick@24967.no-reply.drupal.org>
Date: Mon, 17 Oct 2011 09:22:46 -0700
Subject: [PATCH] Issue #1234848 by mr.baileys, xjm: Fixed language_list() doc
is missing return value.
---
includes/bootstrap.inc | 13 +++++++++++--
1 file changed, 11 insertions(+), 2 deletions(-)
diff --git a/includes/bootstrap.inc b/includes/bootstrap.inc
index 950587071325..a7257c7c450d 100644
--- a/includes/bootstrap.inc
+++ b/includes/bootstrap.inc
@@ -2580,9 +2580,18 @@ function language_types() {
}
/**
- * Get a list of languages set up indexed by the specified key
+ * Returns a list of installed languages, indexed by the specified key.
*
- * @param $field The field to index the list with.
+ * @param $field
+ * (optional) The field to index the list with.
+ *
+ * @return
+ * An associative array, keyed on the values of $field.
+ * - If $field is 'weight' or 'enabled', the array is nested, with the outer
+ * array's values each being associative arrays with language codes as
+ * keys and language objects as values.
+ * - For all other values of $field, the array is only one level deep, and
+ * the array's values are language objects.
*/
function language_list($field = 'language') {
$languages = &drupal_static(__FUNCTION__);
--
GitLab