manuales

Ricardo Mun~oz A. rmunoz en pjud.cl
Mar Oct 24 16:02:19 CLST 2006


Rodrigo Fuentealba wrote:

[...]

> Y ojalá tomes los comentarios del tipo PHPDocumentor, pues se ven
> lindos y más profesionales que ese asqueroso
>
> /* comentario de veinte millones de columnas que nadie lee hasta el 
> final */
>
> porque
>
> /*
> *  algo asi es mas facil de leer,
> *  porque te centra la vista en un
> *  solo lugar. ¿cierto?
> *
> *  @author Rodrigo Fuentealba
> */
>
> Eso es mi aporte de hoy. gracias y buenas noches.

te falto agregar que si se escriben los comentarios con el formato que 
indicaste, el
PHPDocumentor[1] mediante un simple comando genera "automagicamente" un mini
sitio con toda la documentacion del codigo. tal como por ejemplo aparece 
aca:

http://api.joomla.org/

muy facil y practico! ;)

[1] http://www.phpdoc.org/

-- 
Ricardo Mun~oz A.
Usuario Linux #182825 (counter.li.org)


Más información sobre la lista de distribución PHP