[TYPO3-team-core-v5] JavaScript CGL Draft for Phoenix

Steffen Kamper info at sk-typo3.de
Mon Oct 4 22:25:38 CEST 2010


Hi Karsten,

Karsten Dambekalns schrieb:
> Hi.
> 
> On 04.10.2010, at 12:51, Steffen Kamper wrote:
>> @author should stay, same as php.
> 
> We think of dropping it. If needed, [scm] blame|praise can tell you in more detail. Plus @author gets out of sync anyway - or - if you add it for *every* change, it gets out of hand.
>

i think for class annotation this is good, and anyone writes the class 
should get the donation. If someone does heavy work on the class too he 
can add himself with author tag. on functions as i have seen in flow3 i 
think is overkill. Anyway this is my opinion (and we do this with php 
files anyway).

>> BTW - there is a script also rendering the php API with Ext-doc. i tried this once and it works by 90%. Did you tried this as well?
> 
> No, never tried that. I doubt it supports PHP namespaces :) And 90% is only so-so... Any pointers to that script, though?
> 

it's sometimes ago. it use the output of an existing phpdoc generator 
like phpdoc and wraps it in the Ext-doc JS. It was about 90% because my 
server had problems with too long filenames and also interpreted 
php.html as php file, anyway here is the try
http://dev.sk-typo3.de/doc/

I will search for the script to generate this one and post it here

vg Steffen


More information about the TYPO3-team-core-v5 mailing list