como colocarle la descripsion a los metodos.

[Hidek1]

Código PHP:

  class foo
{
    /**
     * Descripcion corta
     *
     * Descripcion larga
     *
     * @author hidek1
     * @package classes
     */
    public function bar
    {
        echo 'candy';
    }
} 
   

es un formato de comentado..
revisa esto
http://manual.phpdoc.org/HTMLSmartyC..._tags.pkg.html

saludos