insertar - ¿Cómo puedo generar comentarios de Javadoc en Eclipse?

javadoc eclipse tutorial

Question

Posible duplicado:
Generador de plantillas Javadoc

¿Hay alguna forma de generar comentarios de Javadoc en Eclipse? Si es así, ¿qué es?

Answer 1

¿Quieres decir menú Proyecto -> Generar Javadoc?

Answer 2

En un lugar donde desee javadoc, escriba /** <NEWLINE> y creará la plantilla.

Answer 3

JAutoDoc :

un complemento Eclipse para agregar automáticamente Javadoc y encabezados de archivo a su código fuente. Opcionalmente, genera comentarios iniciales a partir del nombre del elemento utilizando templates Velocity para Javadoc y encabezados de archivo ...

Answer 4

Shift-Alt-J es un atajo de teclado útil en Eclipse para crear plantillas de comentarios de Javadoc.

Invocar el acceso directo en una declaración de clase, método o campo creará una plantilla Javadoc:

public int doAction(int i) {
    return i;
}

Al presionar Shift-Alt-J en la declaración del método se obtiene:

/**
 * @param i
 * @return
 */
public int doAction(int i) {
    return i;
}

Answer 5

Para mí, el enfoque /**<NEWLINE> o Shift - Alt - J (o ⌘ - Alt - J en una Mac) funciona mejor.

No me gusta ver los comentarios de Javadoc en el código fuente que se han generado automáticamente y no se han actualizado con contenido real. En lo que a mí respecta, tales javadocs no son más que un desperdicio de espacio en la pantalla.

IMO, es mucho mejor generar los esqueletos de comentarios de Javadoc uno por uno cuando esté a punto de completar los detalles.