Come together with the global Drupal community in Rotterdam, 28 Sept – 1 Oct 2026. Sessions, contribution, connection, and Early Bird savings until 8 June.http://api.drupal.org/api/function/l
If the possible keys for the $options parameter were turned into a bullet list, it would hugely improve readability.
| Comment | File | Size | Author |
|---|---|---|---|
| #1 | bulletize-options-param-keys-in-common.inc_.patch | 1.48 KB | meitar |
Comments
Comment #1
meitar commentedThis appears to be fixed in CVS HEAD already, and is live for Drupal 7. However, it's not for prior versions of Drupal, with the worst offender being Drupal 6 (in which the text just runs in a single long line).
Attached to this comment is a
diff -upatch to theincludes/common.incfile where this function is defined (from Drupal 6.2's official release) with the appropriate Doxygen changes made to make the$optionsparameter into a bulleted list (I hope).Not sure if this will get applied since it's already fixed in CVS HEAD, but Drupal 6 is the current version of Drupal and applying this patch would certainly help readability, as the original submitter notes above.
Comment #2
steven jones commentedPutting in the right issue queue. Will check the patch over in the morning unless someone else wants to?
Comment #3
steven jones commentedDuplicate of #258475: Make doxygen docs clearer for l()