Fix doxygen formatting and punctuation in documentation for drupal_parse_info_file()

Thanks for filing this. I still would prefer that all of the issues get fixed on the other issue, but let's wait and see.

Since #1049528: Change script example for drupal_parse_info_file() from .css to .js has been committed, this issue is now about the only remaining problem:

There seems to be more than just this wrong with this docblock -- some of the information is coming out at the end and some at the beginning of
http://api.drupal.org/api/drupal/includes--common.inc/function/drupal_pa...

It seems that the first @see directive causes the "end of doxygen"-block to be rendered, containing things like @param and @return. The content after the first @see is then spit out after that block, and all further directives are ignored (for example, the @see bartik.info is rendered as just "bartik"). This seems to contradict the Doxygen and comment coding conventions, which state that:

@see directives should always be placed on their own line, and generally at the bottom of the documentation header.

Anyway, patch attached that should fix the formatting issue on the api page.

Interesting. I'll file an API module issue on that one. Normally @see shouldn't cause all that to happen, at least I don't think it should.

The fix here is fine. Those lines should not have been @see anyway -- much better to have the explanation as given in the patch here. Thanks!

API module issue:
#1056632: @see context not stopping at paragraph break

Committed to CVS HEAD.