X-Git-Url: http://www.aleph1.co.uk/gitweb/?p=yaffs-website;a=blobdiff_plain;f=web%2Fcore%2Fmodules%2Flocale%2Flocale.module;fp=web%2Fcore%2Fmodules%2Flocale%2Flocale.module;h=8bc05fc75fa6bf0c95f2fc20bb0a2f2fc7eba1d1;hp=9e424484b80e96ef25cfdbda85dbb9ffe8af887c;hb=0bf8d09d2542548982e81a441b1f16e75873a04f;hpb=74df008bdbb3a11eeea356744f39b802369bda3c

diff --git a/web/core/modules/locale/locale.module b/web/core/modules/locale/locale.module
index 9e424484b..8bc05fc75 100644
--- a/web/core/modules/locale/locale.module
+++ b/web/core/modules/locale/locale.module
@@ -261,13 +261,13 @@ function locale_translatable_language_list() {
  *
  * The index is computed from the formula of this language.
  *
- * @param $count
+ * @param int $count
  *   Number to return plural for.
- * @param $langcode
- *   Optional language code to translate to a language other than
- *   what is used to display the page.
+ * @param string|null $langcode
+ *   (optional) Language code to translate to a language other than what is used
+ *   to display the page, or NULL for current language. Defaults to NULL.
  *
- * @return
+ * @return int
  *   The numeric index of the plural variant to use for this $langcode and
  *   $count combination or -1 if the language was not found or does not have a
  *   plural formula.
@@ -308,7 +308,6 @@ function locale_get_plural($count, $langcode = NULL) {
   return $plural_indexes[$langcode][$count];
 }
 
-
 /**
  * Implements hook_modules_installed().
  */
@@ -1113,9 +1112,6 @@ function _locale_strip_quotes($string) {
  * @param string $filepath
  *   File name to parse.
  *
- * @return array
- *   Array of string objects to update indexed by context and source.
- *
  * @throws Exception
  *   If a non-local file is attempted to be parsed.
  */
@@ -1217,10 +1213,11 @@ function _locale_parse_js_file($filepath) {
  * files are rebuilt (with locale_update_js_files()) the next time a
  * request is served in that language.
  *
- * @param $langcode
- *   The language code for which the file needs to be refreshed.
+ * @param string|null $langcode
+ *   (optional) The language code for which the file needs to be refreshed, or
+ *   NULL to refresh all languages. Defaults to NULL.
  *
- * @return
+ * @return array
  *   New content of the 'system.javascript_parsed' variable.
  */
 function _locale_invalidate_js($langcode = NULL) {
@@ -1245,8 +1242,9 @@ function _locale_invalidate_js($langcode = NULL) {
 /**
  * (Re-)Creates the JavaScript translation file for a language.
  *
- * @param $langcode
- *   The language, the translation file should be (re)created for.
+ * @param string|null $langcode
+ *   (optional) The language that the translation file should be (re)created
+ *   for, or NULL for the current language. Defaults to NULL.
  *
  * @return bool
  *   TRUE if translation file exists, FALSE otherwise.
@@ -1373,6 +1371,7 @@ function _locale_rebuild_js($langcode = NULL) {
       return TRUE;
   }
 }
+
 /**
  * Form element callback: After build changes to the language update table.
  *