Index: includes/theme.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/theme.inc,v
retrieving revision 1.415.2.24
diff -u -r1.415.2.24 theme.inc
--- includes/theme.inc	18 Jun 2009 12:04:04 -0000	1.415.2.24
+++ includes/theme.inc	23 Oct 2009 16:52:07 -0000
@@ -180,10 +180,22 @@
 }
 
 /**
- * Retrieve the stored theme registry. If the theme registry is already
- * in memory it will be returned; otherwise it will attempt to load the
- * registry from cache. If this fails, it will construct the registry and
- * cache it.
+ * Retrieves and/or sets the stored theme registry.
+ *
+ * Most modules do not need direct access to the theme registry -- they
+ * should use theme() or drupal_get_form() to generate themed output.
+ * These functions use the theme registry to determine the right sequence of
+ * preprocessing functions, theme functions, and theme include files to invoke.
+ *
+ * If you do need to call theme_get_registry() for some reason, you should call
+ * theme_init() first to initialize the theme registry.
+ *
+ * @param $registry
+ *   If supplied, replaces the in-memory theme registry value.
+ *
+ * @return
+ *   The value of the theme registry that was stored by this or a previous
+ *   call to this function.
  */
 function theme_get_registry($registry = NULL) {
   static $theme_registry = NULL;