Indagar sobre las múltiples funciones de Emacs es una tarea inevitable. Ya sea para explorar y descubrir comandos útiles, o tras un tiempo alejados del editor durante el que nuestros músculos olvidan hasta los atajos de teclado más cotidianos.

Por suerte Emacs cuenta con mucha documentación incorporada y si aprendemos a preguntarle, nos responderá todas nuestras dudas sin necesidad de salir a buscar respuestas en la web.

Un problema de la información disponible online es que está centrada por lo general en los atajos de teclado que vienen por defecto en Emacs (o en los paquetes de terceros que instalemos), y entonces se vuelven inaplicables las sentencias del tipo “para salir de Emacs se usa C-x C-c”. Yo promuevo el uso del nombre de las funciones para dar ayuda, pero en cualquier caso, es mejor preguntarle a nuestra versión local de Emacs todo lo que necesitemos saber, puesto que conoce nuestros atajos de teclado al dedillo.

A continuación se listan algunas opciones para obtener ayuda.

Info

Contamos con un conjunto de manuales muy detallados escritos en TeXinfo (el formato de documentación oficial de GNU, que usa un mismo archivo fuente para producir distintos formatos de salida como HTML, Info, PDF, XML, etc.).

Mediante la función info accedemos a un índice con todos los manuales TeXinfo instalados en nuestro sistema, incluido el propio manual de Emacs pero también los de muchos paquetes extras. Están construidos como hipertexto, navegable con las teclas citadas debajo.

Info admite el uso de bookmarks (más sobre esto en otro posteo…).

Apropos

Es un comando que responde preguntas como “¿cuáles son los comandos para trabajar con archivos?”. La manera de hacerlo es usar un patrón de búsqueda que puede ser una palabra, una lista de palabras o una expresión regular. Es útil cuando no estamos seguros de lo que estamos buscando. Permite buscar variables y comandos, y tiene soporte para realizar las búsquedas con expresiones regulares.

Por ejemplo, nos sirve para buscar funciones relacionadas con archivos (buscaríamos: file) o rectángulos (rectangle). El resultado se muestra en un buffer: las funciones que incluyen file o rectangle en el nombre, su atajo de teclado y una breve descripción. Se puede navegar hasta el nombre de los comandos o variables listados y con RET abrir un nuevo buffer con más información.

Cuando se especifica más de una palabra como patrón de búsqueda, para que haya coincidencia debe haber dos o más de esas palabras en el nombre. Por ejemplo si buscamos sobre operaciones sobre copiar o cortar oraciones podríamos buscar así: C-h a sentence kill yank insert.

Para mayor flexibilidad se pueden usar expresiones regulares. En general, son expresiones de búsqueda que contienen los siguientes caracteres: ^$*+?.[. Funciones que terminen con “guión y región”: -region$, o con “guión y rectángulo”: -rectangle$.

Hay varias funciones más en la familia de apropos. Las podemos buscar con C-h a apropos.

Describe

Disponemos de ayuda para todas las funciones, a la cual accedemos mediante el nombre de la función o con su atajo de teclado. También tenemos una descripción de los modos activos en el buffer, con el que podemos ver un listado de las funciones disponibles y sus atajos de teclado. Finalmente, si conocemos un prefijo está disponible una ayuda que indica todas las funciones que comparten ese inicio de atajo de teclado.