[api.drupal.org] Doxygen Comments Round 2!

This is round 2 of this older issue: #767204: API.drupal.org: Rework Doxygen comments so people can navigate the comments

We need to get the docblocks in line for inclusion in api.drupal.org. Many of the newer modules lack some important markup and have been skipped by api's parser, so let's add it.

rfay gives a good rundown of the documentation standards and docblock process here: http://drupal.org/node/767204#comment-2836190 though some of the links don't work.

We don't need a lot of editorial decisions at this point, mainly just good markup with @defgroup tags.

Here's a list of the modules that lack proper doxygen comments:

• contextual_links_example
• #2004114: entity_example: @defgroup doxygen for api.drupal.org
• #2004120: pager_example: @defgroup doxygen for api.drupal.org
• rdf_example
• #2004288: tablesort_example and tabledrag_example: @defgroup doxygen for api.drupal.org
• theming_example

The Process:

1. Check out the Examples project using git.
2. Pick a module from the list above.
3. Work on adding doxy formatting to it, especially @defgroup markers.
4. Create an issue with a name like 'Doxygen formatting for some_example'
5. Submit your patch on the issue you just created. (Be sure and set the status to 'needs review,' so the automated testing will happen.)
6. Add a comment to this issue, linking to your issue.

Thanks, folks. :-)