[dev] [commits] Horde branch master updated. d3e2e4c1681c359640e12e111d28c15ef5553b07

Jan Schneider jan at horde.org
Tue Jan 25 12:43:30 UTC 2011


Zitat von Michael M Slusarz <slusarz at horde.org>:

> Quoting Jan Schneider <jan at horde.org>:
>
>> Zitat von Michael M Slusarz <slusarz at horde.org>:
>>
>>> commit a6f13d21735279811c4b7595a387c949c6c4bda9
>>> Author: Michael M Slusarz <slusarz at curecanti.org>
>>> Date:   Mon Jan 24 17:08:37 2011 -0700
>>>
>>>   phpdoc
>>>
>>> framework/Core/lib/Horde/Registry.php |   28 ++++++++++++++--------------
>>> 1 files changed, 14 insertions(+), 14 deletions(-)
>>>
>>> http://git.horde.org/horde-git/-/commit/a6f13d21735279811c4b7595a387c949c6c4bda9
>>
>> Please use the list-style formatting of parameter options. This  
>> renders much nicer in generated phpdoc than <pre>-formatted  
>> parameters.
>
> It does?  I was not aware of that.
>
> However the list-style is terribly ugly to read in the code itself  
> (which is what I always use). I am not a big fan of trying to squish  
> documentation into 20 character columns.

I guess it's a matter of taste. I find it easier to read than the  
pre-formatting. You can still use the full with of the docblock with  
the list though, if that helps.

Jan.

-- 
Do you need professional PHP or Horde consulting?
http://horde.org/consulting/



More information about the dev mailing list