Index: modules/simpletest/tests/taxonomy_test.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/simpletest/tests/taxonomy_test.module,v
retrieving revision 1.5
diff -u -r1.5 taxonomy_test.module
--- modules/simpletest/tests/taxonomy_test.module	30 May 2009 11:17:32 -0000	1.5
+++ modules/simpletest/tests/taxonomy_test.module	23 Jun 2009 15:04:17 -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) {
     $term->antonyms = taxonomy_test_get_antonyms($term->tid);
   }
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	23 Jun 2009 15:04:17 -0000
@@ -14,11 +14,14 @@
 /**
  * Act on taxonomy vocabularies when loaded.
  *
- * Modules implementing this hook can act on the vocabulary object returned by
- * taxonomy_vocabulary_load().
- *
- * @param $vocabulary
- *   A taxonomy vocabulary object.
+ * Modules implementing this hook can act on vocabulary objects before 
+ * they are returned by taxonomy_vocabulary_load_multiple() to functions such
+ * as taxonomy_vocabulary_load().
+ *
+ * @param $vocabularies
+ *   An array of taxonomy vocabulary objects, indexed by vid. Note that in 
+ *   PHP 5, objects are always references, so changes you make to vocabulary
+ *   objects will always be passed back to taxonomy_vocabulary_load_multiple().
  */
 function hook_taxonomy_vocabulary_load($vocabularies) {
   foreach ($vocabularies as $vocabulary) {
@@ -74,8 +77,9 @@
 /**
  * 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 term objects before 
+ * they are returned by taxonomy_term_load_multiple() to functions such
+ * as taxonomy_term_load().
  * For performance reasons, information to be added to term objects should be
  * loaded in a single query for all terms where possible.
  *
@@ -84,7 +88,9 @@
  * affect the way results are loaded from cache in subsequent calls.
  *
  * @param $terms
- *   An array of term objects, indexed by tid.
+ *   An array of taxonomy term objects, indexed by tid. Note that in PHP 5, 
+ *   objects are always references, so changes you make to term objects will 
+ *   always be passed back to taxonomy_term_load_multiple().
  */
 function hook_taxonomy_term_load($terms) {
   $result = db_query('SELECT tid, foo FROM {mytable} WHERE tid IN (:tids)', array(':tids' => array_keys($terms)));