This is sort of an ongoing task to keep the Doxygen-style comments up to date and cross-referenced for api.module. Actually applying all of these changes will disrupt several patches that are currently being worked on, so I'll be maintaining a merge directive here. Bazaar's awesome enough to keep track of most of the changes, so that even though I had first started this a month ago, I only had to resolve two minor conflicts to generate this updated patch.

Once there are fewer patches in the way and we are closer to a release, I'll commit these changes and close the task.

CommentFileSizeAuthor
doxygen.patch288.48 KBIsland Usurper
Support from Acquia helps fund testing for Drupal Acquia logo

Comments

cha0s’s picture

cha0s CreditAttribution: cha0s commented

Sweet deal. It shouldn't break too bad in the future unless comments are changed, in which case it should so we can update it. :)

rszrama’s picture

rszrama CreditAttribution: rszrama commented

So using // to comment functions is no longer acceptable? I would've sworn it was in the doc standards here on d.o, but I don't see it there now. :-/

Island Usurper’s picture

Island Usurper CreditAttribution: Island Usurper commented
Status: Needs review » Fixed

Went ahead and committed this when I updated CVS this time. I don't think any conflicts with other patches will be too hard to resolve since all of the changes are to comments. Let's just make sure we keep up on the standards for any new functions.

Status: Fixed » Closed (fixed)

Automatically closed -- issue fixed for 2 weeks with no activity.