Issue #2164597 by longwave, StephaneQ, emok: Doxygen @return tag missing for...

Issue #2164597 by longwave, StephaneQ, emok: Doxygen @return tag missing for drupal_render_children.

core/includes/common.inc

@@ -4000,14 +4000,16 @@ function drupal_render(&$elements, $is_recursive_call = FALSE) {
 /**
  * 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) {