t() documentation cleanup [#350708]

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.

Comment	File	Size	Author
#1	350708_t_docs_formatting.1.d7.patch	3.02 KB	dww
#1	350708_t_docs_formatting.1.d6.patch	3.02 KB	dww
#1	350708_t_docs_backport.1.d5.patch	6.82 KB	dww

Comments

Comment #1

dww

we/he/they

commented 24 December 2008 at 00:13

Status:

Active

» Needs review

Status	File	Size
new	350708_t_docs_backport.1.d5.patch	6.82 KB
new	350708_t_docs_formatting.1.d6.patch	3.02 KB
new	350708_t_docs_formatting.1.d7.patch	3.02 KB

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