diff options
Diffstat (limited to 'includes/theme.inc')
-rw-r--r-- | includes/theme.inc | 11 |
1 files changed, 9 insertions, 2 deletions
diff --git a/includes/theme.inc b/includes/theme.inc index f80757e6e..5ae0fea20 100644 --- a/includes/theme.inc +++ b/includes/theme.inc @@ -869,11 +869,17 @@ function drupal_find_base_themes($themes, $key, $used_keys = array()) { /** * Generates themed output. * - * All requests for themed output must go through this function. It examines - * the request and routes it to the appropriate + * All requests for themed output must go through this function (however, + * calling the theme() function directly is strongly discouraged - see next + * paragraph). It examines the request and routes it to the appropriate * @link themeable theme function or template @endlink, by checking the theme * registry. * + * Avoid calling this function directly. It is preferable to replace direct + * calls to the theme() function with calls to drupal_render() by passing a + * render array with a #theme key to drupal_render(), which in turn calls + * theme(). + * * @section sec_theme_hooks Theme Hooks * Most commonly, the first argument to this function is the name of the theme * hook. For instance, to theme a taxonomy term, the theme hook name is @@ -997,6 +1003,7 @@ function drupal_find_base_themes($themes, $key, $used_keys = array()) { * @return * An HTML string representing the themed output. * + * @see drupal_render() * @see themeable * @see hook_theme() * @see template_preprocess() |