Index: includes/theme.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/theme.inc,v
retrieving revision 1.438
diff -u -p -r1.438 theme.inc
--- includes/theme.inc	12 Oct 2008 04:30:05 -0000	1.438
+++ includes/theme.inc	14 Oct 2008 22:01:44 -0000
@@ -703,7 +703,14 @@ function drupal_discover_template($paths
 }
 
 /**
- * Return the path to the currently selected theme.
+ * Return the path to the current themed element.
+ *
+ * It can point to the active theme or the module handling a themed implementation.
+ * For example, when invoked within the scope of a theming call it will depend
+ * on where the theming function is handled. If implemented from a module, it
+ * will point to the module. If implemented from the active theme, it will point
+ * to the active theme. When called outside the scope of a theming call, it will
+ * always point to the active theme.
  */
 function path_to_theme() {
   global $theme_path;