Fix documentation of menu_tree_output

Thanks! Needs to be fixed in 8.x first, then backported to 7.x. (Or more likely the same patch can be used for both, since the functions appear to be identical).

Updated code as per comments.

Thanks... but:

- * Returns a rendered menu tree.
+ * Returns a structured array to be rendered by drupal_render().

We lost the information here about what the function does, which is to set up to render a menu tree. This statement is what a lot of functions do (return a render array), not specific to what this function does (do that for a menu tree).

And really, the @return already talks about the structure of the returned value. So ... Maybe the first line should say something more like:

Creates an output structure for rendering a menu tree.

or something similar?

Thanks!

Committed 29b519c and pushed to 8.x. Thanks!

Committed the same patch (with a little fuzz) also to 7.x. Thanks!