open - Cómo deshabilitar el formato para JavaDoc en IntelliJ IDEA

intellij show function parameters

Question

Quiero usar el estilo de JavaDoc:

/**
 * Description.
 *
 * @param param1     parameter description
 * @param param2     parameter description
 * @return           return description.
 * @throws exception exception description.
 */

Cómo puede ver, quiero usar la alineación con la descripción correcta de los parámetros, devoluciones y excepciones.

Este estilo se utiliza en http://www.oracle.com/technetwork/articles/java/index-137868.html

Entonces, mi pregunta: ¿Cómo puedo configurar ese estilo en IDEA 2016.xx o cómo puedo deshabilitar el formato para javaDoc sin usar comentarios específicos //@formatter:off y //@formatter:on , si esto es posible?

Por supuesto, no es un problema grave y crítico, pero estoy interesado, porque es una mala situación cuando el desarrollador no puede configurar el estilo según la documentación oficial sin ningún comentario específico. Creo que estoy equivocado)

PD: He probado el formato en Archivo-> Configuración-> Editor-> Estilo de código-> Java-> JavaDoc , habilitar el formato JavaDoc en desactivado (y reproducir con todas las configuraciones en esta sección). Y mi alineación en JavaDoc se reinicia en Ctrl-Alt-L

¡Gracias por la retroalimentación!

Answer 1

¿La configuración de "Alinear descripciones de parámetros" no hace esto automáticamente?

Answer 2

Hay tres complementos para intellij que pueden ayudar:

• alineación automática
• tabificador
• Manipulación de cuerdas

Para mí, el último parece ser el más adecuado. Cuando formulo texto, selecciono la parte del texto que quiero formatear, haga clic derecho -> Manipulación de cadenas -> Alinear -> Alinear a columna. Aquí, tienes que experimentar un poco con la configuración. Esto funciona para mi.

Ver captura de pantalla: Agregué un espacio (el marcador azul en la imagen) como un delimitador; Seleccioné un comentario javadoc y usé la función mencionada anteriormente. Funciona.