Make doxygen docs clearer for url(), and other minor doc fixes in common.inc
gpk - July 2, 2008 - 08:13
| Project: | Drupal |
| Version: | 6.x-dev |
| Component: | documentation |
| Category: | bug report |
| Priority: | minor |
| Assigned: | Unassigned |
| Status: | closed |
Description
Similar to #258475: Make doxygen docs clearer for l(). Go to http://api.drupal.org/api/function/url/7 to see the problem.
Also clarified a couple of other comments in common.inc and changed a couple of /* */ style comments to // style.
| Attachment | Size |
|---|---|
| doxygen_url.patch | 5.03 KB |
#1
Further tidied a couple of the comments (very minor).
#2
Oh, I see that "C style comments (/* */)" are fine (http://drupal.org/coding-standards). Oh well, those 2 lines weren't perfect in any case ;)
#3
Committed to CVS HEAD. Thanks.
#4
Forgot to say - would be useful for D6 also IMO. Applies with offset. RTBC I guess?
#5
as far as i know things dont get backported unless its major security fix or something.
#6
@5: true (obviously!) that new features don't get backported, but most bugs and documentation fixes do get backported if applicable (e.g. the documentation for l(), as linked above in the original post) and committed if the community/relevant committer decide it also needs to be fixed in that version. :-D
#7
OK, committed to 6.x for easier reading of API docs through the remaining D6 lifetime.
#8
Automatically closed -- issue fixed for two weeks with no activity.