En compañero de texto, ¿cómo hago comentarios de estilo javadoc como puedo hacer en eclipse?

Question

En eclipse, cuando quiero documentar una función (en java o javascript source) solo puedo escribir / **, luego presionar enter, y recibo un comentario como este

 /**
 *
 * Fluctuates all variables to more compatibly foo all the bars
 *
 * @PARAM {int} foo 
 */  

function flucvar (foo) {

}

Al pulsar Intro dentro del comentario, eclipse agrega automáticamente * al comienzo de cada línea.

Ahora solo estoy entrando en el ritmo de mi compañero de texto y me estoy perdiendo esta pequeña funcionalidad. ¿Existe un paquete o comando equivalente o algo que me permita generar comentarios similares en la relación de texto?

Answer 1

Necesitas crear dos fragmentos de código (los tengo en el paquete de Fuente).

Primero cree un fragmento de código para insertar comentarios de JavaDoc. El fragmento contiene lo siguiente:

/**
* 
* <*>

*/

Tengo el fragmento de Activación configurado en Desencadenador de pestaña , usando / ** como la cadena de activación. Cada vez que escribo / ** y presiono Tab, obtengo un bloque de comentarios JavaDoc. También puedes usar un atajo de teclado si lo deseas.

El segundo fragmento de código es para continuar con los comentarios de JavaDoc existentes. Los contenidos del fragmento son:

<*>

Tenga en cuenta que hay una línea vacía antes de la línea * $ 0 . Establezca Activación en Clave equivalente y la clave de activación en retorno . Establezca la cadena Scope Selector en comment.documentation .

Ahora, si su paquete de idioma admite el ámbito comment.documentation (como parece que lo hacen todos los paquetes incluidos), debería tener accesos directos de trabajo para los comentarios de JavaDoc.

Answer 2

Eché un vistazo al paquete Java de TextMate y no vi nada sobre la inserción de comentarios JavaDoc. Sin embargo, no debería ser tan difícil agregar una característica de este tipo a su paquete de Java. Probablemente sea un Fragmento, que puede leer en el Capítulo 7 del manual de TextMate (al que se puede acceder desde Ayuda - > Ayuda de TextMate ).

Answer 3

gracias por esa respuesta. Acabo de encontrar esta publicación en el sitio de macromates

http://blog.macromates.com/2006/customization-screencast/

Esto parece tener una publicación en la lista de correo / video que explica cómo hacerlo.