t() documentation cleanup
dww - December 23, 2008 - 23:53
| Project: | Drupal |
| Version: | 7.x-dev |
| Component: | documentation |
| Category: | task |
| Priority: | normal |
| Assigned: | dww |
| Status: | closed |
Description
After an illuminating thread on the translators' list, we decided it'd be nice to backport some of the PHPDoc fixes from the t() function in D6 into D5. The docs were nicely fleshed out, even though the function itself changed very little. I'm working on a patch now, stay tuned.
#1
This is the entire D6 version of the PHPdoc comment, except I stripped out the D6-only changes:
- url() args in an example.
- the D6-only $langcode argument.
I also fixed a few lingering formatting problems from the D6 and HEAD version, included in the D5 patch, and attached here as separate patches for D6 and HEAD (the D6 patch applies to HEAD with fuzz, but it was easy to generate a clean patch). I don't think the usual "rule" about committing in HEAD and backporting applies to doc formatting patches, and the most important part is getting the content into the D5 version, so I'm leaving the version of this as 5.x-dev.
Thanks,
-Derek
#2
Committed to 5.x.
#3
#4
Committed to DRUPAL-6 and CVS HEAD. Thanks dww!
#5
No problem, thanks Drumm and Dries. Happy holidays! :)
#6
Automatically closed -- issue fixed for two weeks with no activity.