[Java] Agregar descripción o comentarios a una función

Siempre es bueno describir y comentar lo que haces. Ya sea para otros desarrolladores o para tu futuro yo.

En eclipse basta con escribir /** y dar [Enter] antes del nombre de tu funcion. Esto creará los comentarios de la misma, por ejemplo:

     /** Aqui va la descripción      * @author Martin Roldán Araujo DTI      * @param param1, Éste es el parámetro 1      * @return true, si param1 existe; false en caso contrario.      *      */     public boolean mifuncion(String param1){ ...}