Llegar Emacs rellenar el apartado a jugar bien con javadoc-como los comentarios

Question

Estoy escribiendo una Emacs major modo de un APL dialecto que se usan en el trabajo.Me he metido básica de la fuente de cierre para el trabajo, y después de poner el comentario de inicio y comentario-inicio-pasar, comentar/descomentar la región y llenar el párrafo también trabajo.

Sin embargo, los comentarios de los bloques contienen a menudo javadoc comentarios del estilo y me quisiera llenar el párrafo para evitar que se peguen juntos líneas a partir de con estos comandos.

Si yo tengo este (\ en lugar de javadoc @):

# This is a comment that is long and should be wrapped.
# \arg Description of argument
# \ret Description of return value

M-q me da:

# This is a comment that is long and
# should be wrapped. \arg Description
# of argument \ret Description of
# return value

Pero yo quiero:

# This is a comment that is long and
# should be wrapped.
# \arg Description of argument
# \ret Description of return value

He intentado configurar el apartado de inicio y párrafo aparte para los valores adecuados, pero de relleno del párrafo aún no funciona en el interior de un bloque de comentario.Si puedo quitar los marcadores de comentario, M-q funciona como yo quiero a, por lo que la regexp yo uso para el párrafo de inicio parece que funciona.

¿Tengo que escribir un relleno personalizada-apartado de mi especialidad modo?cc-modo tiene uno que se encarga de casos como este, pero es realmente complejo, me gustaría evitar, si es posible.

Answer 1

El problema era que el párrafo de inicio regexp tiene que coincidir con la línea completa para el trabajo, incluyendo el real carácter de comentario.El siguiente elisp trabaja para el ejemplo que me dio:

(setq paragraph-start "^\\s-*\\#\\s-*\\\\\\(arg\\|ret\\).*$")

Aquí una página que tiene un ejemplo regexp para php de modo que hace esto:http://barelyenough.org/blog/2006/10/nicer-phpdoc-comments/

Answer 2

Hay otros modos que tienen menos complejas funciones que se usan para fill-paragraph-function.La navegación a través de mi instalación, se ve como la de ada-modo y el modo son buenos ejemplos.

Answer 3

Lo que yo hago en estos casos es abrir una línea en blanco entre párrafo y las líneas de argumento líneas, a continuación, utilizar M-q para envolver el párrafo líneas, luego de matar a la línea en blanco entre ellos.No es ideal, pero funciona y es bastante fácil de grabar en una macro si usted necesita para que se repita.