tipos - uso de comentarios en java

¿Cómo deshabilitar el asterisco automático(insertar estrellas) en Eclipse al agregar un comentario de varias líneas?

Question

Al agregar un comentario de varias líneas en Eclipse y formatearlo (Ctrl + Shift + F), coloca automáticamente un asterisco (*) al comienzo de cada nueva línea dentro del bloque de comentarios.

/*
* this is my comment
*/

¿Cuál es la razón de este comportamiento?

¿Cómo puedo desactivarlo?

Answer 1

Con eclipse 4.2.1 usé la función de desactivación / activación del formateador, asegúrese de no tener el formateador en la etiqueta en la misma línea que la etiqueta de comentarios, de lo contrario, la pesadilla de las estrellas volverá.

// @formatter:off
/*
Eclipse your * are messing up my comments big time and If I used you
more often I''d put a patch together to add back in the "Add Leading Star" option
*/
// @formatter:on

Las funciones de encendido / apagado deben estar activadas en las preferencias de Eclipse: Java> Estilo de código> Formateador. Haga clic en el botón "Editar", "Desactivar / Activar etiquetas", marque "Activar Desactivar / Activar etiquetas".

Desde

¿Cómo desactivar el formateador de código Eclipse para ciertas secciones de código Java?

También. Cambio las etiquetas a // off // on para facilitar su uso

Una publicación similar es ¿Cómo desactivo ''*'' en comentarios de varias líneas en Eclipse?

Answer 2

En Eclipse 4.2 y versiones posteriores, la solución es: Ventana -> Preferencias -> Java -> Estilo de código -> Formateador ->

$ profileName -> Edit ... ( ) -> comments -> * un-check [] Habilita el formato de comentarios de bloque .

Tenga en cuenta que el autor solicitó comentarios en bloque ( /* ) y no comentarios en Javadoc ( /** ).

Para eliminar el encabezado * de los comentarios de Javadoc, desmarque [] Habilitar el formato de comentarios de Javadoc

(*) Si $ profileName -> Edit ... no funciona, cree una nueva plantilla usando "New ...".

Answer 3

Es el formato javadoc estándar. Las opciones de formato en eclipse están al hacer clic con el botón derecho en su proyecto-> propiedades-> Estilo de código Java-> Formateador-> Editar-> pestaña Comentarios, pero no veo una opción para deshabilitar este comportamiento en particular.

Answer 4

Por favor no hagas eso.

Esa ha sido la forma estándar de escribir comentarios en bloque desde los primeros días del lenguaje de programación C. Romper las convenciones como esta hace que sea más difícil para otros (incluyendo herramientas automatizadas) leer su código.

Si necesita comentar / descomponer rápidamente el código Java, puede probar Ctrl+/ shortcut. Utilizará comentarios de una sola línea ( // ) para comentar la línea actual, o cualquier número de líneas de código marcadas.

Answer 5

Vaya a Tools/Options/Editor/Formatting y seleccione Language = Java , Category = Comments y desmarque Add Leading Star .