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