menu_set_active_trail doc lacks details

Attached patch adds details to doc for menu_set_active_trail()

If accepted, this should also probably be ported to D6.

Thanks.

+++ includes/menu.inc	30 Sep 2009 17:25:37 -0000
@@ -1772,7 +1772,25 @@
+ *   If $new_trail is supplied, the value is saved in a static variable and
+ *   returned. If $new_trail is not supplied, and there is a saved value from
+ *   a previous call, the saved value is returned. If $new_trail is not supplied
+ *   and there is no saved value, the path to the current page is calculated,
+ *   saved as the static value, and returned.

This seems to be a bit of a WTF but that is not the point of this patch.

Committed to CVS HEAD.

Still needs port to D6.

And I somewhat agree on the WTF, but I thought the function doc ought to at least document what the function actually, currently does... :)

Here's a D6 version. Identical to D7 version, as the functions work the same.

Thanks, committed to Drupal 6 too.