drupal_register_shutdown_function doxygen is wrong

Sounds like a good plan, and indeed a good project for a novice doc contributor.

Inspiration for syntax and wording from drupal_get_form() and module_invoke().

Close!

a) Little-known English grammar point (even by native speakers): "which" in cases like "Wrapper for register_shutdown_function() which catches thrown exceptions" needs to be changed to "that".

b) Needs a blank line between the last @param and the @return:

+ * @param ...
+ *   Additional arguments to pass to the shutdown function.
  * @return

a) Interesting. Explanation on 'that' vs. 'which': http://www.worldwidewords.org/articles/which.htm

b) Fixed for this function. A quick regex on HEAD throws 309 of these.. new issue?

In the dark about the test failure, it seems to apply to HEAD without a problem.. anyone?

#5: 870584_2.patch queued for re-testing.

Yes, fixing all the missing newlines in Drupal core between @param and @return (and also after @return if there are @see etc.) would be a separate issue. Actually aspilicious started fixing these and webchick asked that we stop for now because the patches were getting in the way of more significant ones (trying to get D7 out of the door, etc.). See http://drupal.org/node/855184 for one example.

Anyway, all of that aside, this patch looks fine, thanks!

Committed to CVS HEAD. Thanks.