Index: modules/simpletest/tests/taxonomy_test.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/simpletest/tests/taxonomy_test.module,v
retrieving revision 1.6
diff -u -r1.6 taxonomy_test.module
--- modules/simpletest/tests/taxonomy_test.module	3 Aug 2009 20:19:29 -0000	1.6
+++ modules/simpletest/tests/taxonomy_test.module	5 Nov 2009 19:57:07 -0000
@@ -9,7 +9,7 @@
 /**
  * Implement hook_taxonomy_term_load().
  */
-function taxonomy_test_taxonomy_term_load(&$terms) {
+function taxonomy_test_taxonomy_term_load($terms) {
   foreach ($terms as $term) {
     $antonym = taxonomy_test_get_antonym($term->tid);
     if ($antonym) {
Index: modules/taxonomy/taxonomy.api.php
===================================================================
RCS file: /cvs/drupal/drupal/modules/taxonomy/taxonomy.api.php,v
retrieving revision 1.7
diff -u -r1.7 taxonomy.api.php
--- modules/taxonomy/taxonomy.api.php	30 Mar 2009 05:18:49 -0000	1.7
+++ modules/taxonomy/taxonomy.api.php	5 Nov 2009 19:57:07 -0000
@@ -14,11 +14,11 @@
 /**
  * Act on taxonomy vocabularies when loaded.
  *
- * Modules implementing this hook can act on the vocabulary object returned by
- * taxonomy_vocabulary_load().
+ * Modules implementing this hook can act on the vocabulary objects before they
+ * are returned by taxonomy_vocabulary_load_multiple().
  *
  * @param $vocabulary
- *   A taxonomy vocabulary object.
+ *   An array of taxonomy vocabulary objects.
  */
 function hook_taxonomy_vocabulary_load($vocabularies) {
   foreach ($vocabularies as $vocabulary) {
@@ -30,7 +30,7 @@
  * Act on taxonomy vocabularies when inserted.
  *
  * Modules implementing this hook can act on the vocabulary object when saved
- *  to the database.
+ * to the database.
  *
  * @param $vocabulary
  *   A taxonomy vocabulary object.
@@ -44,12 +44,12 @@
 /**
  * Act on taxonomy vocabularies when updated.
  *
- * Modules implementing this hook can act on the term object when updated.
+ * Modules implementing this hook can act on the vocabulary object when updated.
  *
- * @param $term
- *   A taxonomy term object, passed by reference.
+ * @param $vocabulary
+ *   A taxonomy vocabulary object.
  */
-function hook_taxonomy_vocabulary_update($term) {
+function hook_taxonomy_vocabulary_update($vocabulary) {
   $status = $vocabulary->synonyms ? TRUE : FALSE;
   if ($vocabulary->synonyms) {
     variable_set('taxonomy_' . $vocabulary->vid . '_synonyms', $status);
@@ -74,14 +74,15 @@
 /**
  * Act on taxonomy terms when loaded.
  *
- * Modules implementing this hook can act on the term object returned by
- * taxonomy_term_load().
+ * Modules implementing this hook can act on the term objects returned by
+ * taxonomy_term_load_multiple().
+ *
  * For performance reasons, information to be added to term objects should be
  * loaded in a single query for all terms where possible.
  *
  * Since terms are stored and retrieved from cache during a page request, avoid
- * altering properties provided by the {taxonomy_term_data} table, since this may
- * affect the way results are loaded from cache in subsequent calls.
+ * altering properties provided by the {taxonomy_term_data} table, since this
+ * may affect the way results are loaded from cache in subsequent calls.
  *
  * @param $terms
  *   An array of term objects, indexed by tid.