diff options
Diffstat (limited to 'includes/common.inc')
| -rw-r--r-- | includes/common.inc | 22 |
1 files changed, 14 insertions, 8 deletions
diff --git a/includes/common.inc b/includes/common.inc index 3b4bf580c..34828e8ca 100644 --- a/includes/common.inc +++ b/includes/common.inc @@ -1426,7 +1426,6 @@ function filter_xss_admin($string) { * valid UTF-8. * * @see drupal_validate_utf8() - * @ingroup sanitization */ function filter_xss($string, $allowed_tags = array('a', 'em', 'strong', 'cite', 'blockquote', 'code', 'ul', 'ol', 'li', 'dl', 'dt', 'dd')) { // Only operate on valid UTF-8 strings. This is necessary to prevent cross @@ -5067,6 +5066,11 @@ function drupal_get_private_key() { * @param $value * An additional value to base the token on. * + * The generated token is based on the session ID of the current user. Normally, + * anonymous users do not have a session, so the generated token will be + * different on every page request. To generate a token for users without a + * session, manually start a session prior to calling this function. + * * @return string * A 43-character URL-safe token for validation, based on the user session ID, * the hash salt provided from drupal_get_hash_salt(), and the @@ -5946,14 +5950,16 @@ function drupal_render(&$elements) { /** * Renders children of an element and concatenates them. * - * This renders all children of an element using drupal_render() and then - * joins them together into a single string. - * - * @param $element + * @param array $element * The structured array whose children shall be rendered. - * @param $children_keys - * If the keys of the element's children are already known, they can be passed - * in to save another run of element_children(). + * @param array $children_keys + * (optional) If the keys of the element's children are already known, they + * can be passed in to save another run of element_children(). + * + * @return string + * The rendered HTML of all children of the element. + + * @see drupal_render() */ function drupal_render_children(&$element, $children_keys = NULL) { if ($children_keys === NULL) { |