Manuales para la línea de comandos

Man » Manual de emacs en línea - documentación en línea detallada para la página de manual de emacs

🌍
emacs - Editor Emacs del proyecto GNU

SINOPSIS

emacs [ indicadores de línea de comandos ] [ archivos ... ]

DESCRIPCIÓN

GNU Emacs es una versión de Emacs, escrita por el autor del Emacs original (PDP-10), Richard Stallman. La funcionalidad del usuario de GNU Emacs abarca todo lo que hacen otros editores, y es fácilmente extensible ya que sus comandos de edición están escritos en Lisp.

La documentación principal de GNU Emacs se encuentra en el Manual de GNU Emacs, que puede leer usando Info, ya sea desde Emacs o como un programa independiente. Consulte allí para obtener documentación completa y actualizada. Esta página de manual solo se actualiza cuando alguien se ofrece como voluntario para hacerlo.

Emacs tiene una amplia instalación de ayuda interactiva, pero esta instalación asume que sabe cómo manipular las ventanas y los búferes de Emacs. CTRL-h o F1 inicia la instalación de Ayuda. Ayuda Tutorial (CTRL-h t) inicia un tutorial interactivo para enseñar rápidamente a los principiantes los fundamentos de Emacs. Ayuda Apropos (CTRL-h a) le ayuda a encontrar un comando con un nombre que coincida con un patrón determinado, Ayuda Clave (CTRL-h k) describe una secuencia de teclas determinada y Ayuda Función (CTRL-h f) describe una función Lisp determinada.

Los numerosos paquetes especiales de GNU Emacs gestionan la lectura de correo (RMail) y el envío (Mail), la edición de esquemas (Outline), la compilación (Compile), la ejecución de subshells dentro de las ventanas de Emacs (Shell), la ejecución de un bucle de lectura-evaluación-impresión Lisp (Lisp-Interaction-Mode), la psicoterapia automatizada (Doctor) y mucho más.

Opciones de Emacs

Las siguientes opciones son de interés general:

archivo Editar archivo.

--file=archivo, --find-file=archivo, --visit=archivo

Es lo mismo que especificar el archivo directamente como un argumento.

+número Ir a la línea especificada por el número (no inserte un espacio entre el signo "+" y el número). Esto solo se aplica al siguiente archivo especificado.

+línea:columna

Ir a la línea y columna especificadas.

--chdir=directorio

Cambiar al directorio.

-q, --no-init-file

No cargar un archivo de inicialización.

-nl, --no-shared-memory

No utilizar memoria compartida.

--no-site-file

No cargar el archivo de inicio de sitio.

-nsl, --no-site-lisp

No agregar los directorios site-lisp a load-path.

--no-desktop

No cargar un escritorio guardado.

-Q, --quick

Similar a "-q --no-site-file --no-splash". Además, evitar procesar los recursos de X.

--no-splash

No mostrar una pantalla de inicio durante el inicio.

--debug-init

Habilitar el depurador de Emacs Lisp durante el procesamiento del archivo de inicialización del usuario ~/.emacs. Esto es útil para depurar problemas en el archivo de inicialización.

-u usuario, --user=usuario

Cargar el archivo de inicialización del usuario en lugar del suyo propio.

--init-directory=directorio

Iniciar emacs con user-emacs-directory establecido en el directorio.


-t archivo, --terminal=archivo
Utiliza el archivo especificado como terminal en lugar de usar stdin/stdout. Esto debe ser el primer argumento especificado en la línea de comandos.

--daemon[=nombre], --bg-daemon[=nombre]
Inicia Emacs como un daemon, habilitando el servidor de Emacs y desconectándose del terminal. Luego, puedes usar el comando [emacsclient](emacsclient(1)) para conectarte al servidor (con un nombre opcional).

--fg-daemon[=nombre]
Similar a "--bg-daemon", pero no se desconecta del terminal.

--version
Muestra la información de la versión de Emacs y sale.

--help  Muestra la ayuda y sale.

Las siguientes opciones están orientadas a Lisp (estas opciones se procesan en el orden en que se encuentran):

-f función, --funcall=función
Ejecuta la función Lisp `función`.

-l archivo, --load=archivo
Carga el código Lisp en el archivo `archivo`.

--eval=expresión, --execute=expresión
Evalúa la expresión Lisp `expresión`.

Las siguientes opciones son útiles cuando se ejecuta Emacs como un editor por lotes:

--batch Ejecuta en modo por lotes. El editor enviará mensajes a stderr. Debes usar las opciones -l y -f para especificar los archivos a ejecutar y las funciones a llamar.

--script archivo
Ejecuta `archivo` como un script de Emacs Lisp.

--insert=archivo
Inserta el contenido del archivo en el búfer actual.

--kill Sale de Emacs mientras está en modo por lotes.

-L directorio, --directory=directorio
Agrega `directorio` a la lista de directorios en los que Emacs busca archivos Lisp.

Usando Emacs con X

Emacs ha sido diseñado para funcionar bien con el sistema X Window. Si ejecutas Emacs desde dentro de las ventanas de X, creará su propia ventana X para mostrar. Probablemente querrás iniciar el editor como un proceso en segundo plano para que puedas seguir usando tu ventana original.

Emacs se puede iniciar con los siguientes modificadores de X:

--name=nombre
Especifica el nombre que se debe asignar a la ventana inicial de Emacs. Esto controla la búsqueda de recursos X, así como el título de la ventana.

--no-x-resources
No carga los recursos X.

-T nombre, --title=nombre
Especifica el título para la ventana X inicial.

-r, -rv, --reverse-video
Muestra la ventana de Emacs en video inverso.

-fn fuente, --font=fuente
Establece la fuente de la ventana de Emacs a la especificada por `fuente`. Encontrarás las diversas fuentes X en el directorio `/usr/lib/X11/fonts`. Ten en cuenta que Emacs solo aceptará fuentes de ancho fijo. Bajo las convenciones de nombres de fuentes X11 Release 4, cualquier fuente con el valor "m" o "c" en el undécimo campo del nombre de la fuente es una fuente de ancho fijo. Además, las fuentes cuyos nombres tienen la forma `ancho`x`alto` generalmente son de ancho fijo, al igual que la fuente `fixed`. Consulta `xlsfonts(1)` para obtener más información.

Cuando especifiques una fuente, asegúrate de poner un espacio entre el modificador y el nombre de la fuente.

--xrm=recursos
Establece recursos X adicionales.

--color, --color=modo
Anula el modo de color para terminales de caracteres; el modo predeterminado es "auto" y también puede ser "nunca", "auto", "siempre" o un nombre de modo como "ansi8".

-bw píxeles, --border-width=píxeles
Establece el ancho del borde de la ventana de Emacs al número de píxeles especificado por `píxeles`. El valor predeterminado es un píxel en cada lado de la ventana.

-ib pixels, --internal-border=pixels
Establece el ancho del borde interno de la ventana en el número de píxeles especificado por `pixels`. Por defecto, es de un píxel de relleno en cada lado de la ventana.

-g geometry, --geometry=geometry
Establece el ancho, la altura y la posición de la ventana de Emacs según lo especificado. La especificación de geometría está en el formato estándar de X; consulte X(7) para obtener más información. El ancho y la altura se especifican en caracteres; el valor predeterminado para los marcos de GUI es un ancho de 80 y una altura entre 35 y 40, según el sistema operativo y el administrador de ventanas. Consulte el manual de Emacs, sección "Opciones para el tamaño y la posición de la ventana", para obtener información sobre cómo los tamaños de ventana interactúan con la selección o deselección de la barra de herramientas, la barra de pestañas y la barra de menú.

-lsp pixels, --line-spacing=pixels
Espacio adicional para colocar entre las líneas.

-vb, --vertical-scroll-bars
Habilita las barras de desplazamiento verticales.

-fh, --fullheight
Hace que el primer marco tenga la altura de la pantalla.

-fs, --fullscreen
Hace que el primer marco esté en pantalla completa.

-fw, --fullwidth
Hace que el primer marco tenga el ancho de la pantalla.

-mm, --maximized
Maximiza el primer marco, como "-fw -fh".

-fg color, --foreground-color=color
En pantallas de color, establece el color del texto.

Use el comando M-x list-colors-display para obtener una lista de nombres de colores válidos.

-bg color, --background-color=color
En pantallas de color, establece el color del fondo de la ventana.

-bd color, --border-color=color
En pantallas de color, establece el color del borde de la ventana.

-cr color, --cursor-color=color
En pantallas de color, establece el color del cursor de texto de la ventana.

-ms color, --mouse-color=color
En pantallas de color, establece el color del cursor del mouse de la ventana.

-d displayname, --display=displayname
Crea la ventana de Emacs en la pantalla especificada por `displayname`. Debe ser la primera opción especificada en la línea de comandos.

-nbi, --no-bitmap-icon
No utilice la imagen de gnu para el icono de Emacs.

--iconic
Inicia Emacs en estado minimizado.

-nbc, --no-blinking-cursor
Desactiva el cursor parpadeante.

--parent-id=xid
Establece la ventana principal.

-nw, --no-window-system
Indica a Emacs que no cree un marco gráfico. Si utiliza este modificador al invocar Emacs desde una ventana xterm(1), la visualización se realiza en esa ventana.

-D, --basic-display
Esta opción deshabilita muchas funciones de visualización; úsela para depurar Emacs.

Puede establecer los valores predeterminados de X para sus ventanas de Emacs en su archivo `.Xresources` (consulte xrdb(1)). Utilice el siguiente formato:

    emacs.keyword:value

    donde `value` especifica el valor predeterminado de `keyword`. Emacs le permite establecer valores predeterminados para las siguientes palabras clave:

    background (class Background)
    Para pantallas de color, establece el color de fondo de la ventana.

    bitmapIcon (class BitmapIcon)
    Si el valor de `bitmapIcon` está establecido en `on`, la ventana se minimizará en el "sumidero de la cocina".

    borderColor (class BorderColor)
    Para pantallas de color, establece el color del borde de la ventana.

    borderWidth (class BorderWidth)
    Establece el ancho del borde de la ventana en píxeles.

    cursorColor (class Foreground)
    Para pantallas de color, establece el color del cursor de texto de la ventana.

cursorBlink (clase CursorBlink)

Especifica si se debe hacer que el cursor parpadee. El valor predeterminado es on. Use off o false para desactivar el parpadeo del cursor.

font (clase Font)

Establece la fuente de texto de la ventana.

foreground (clase Foreground)

Para pantallas a color, establece el color del texto de la ventana.

fullscreen (clase Fullscreen)

El tamaño de pantalla completa deseado. El valor puede ser uno de fullboth, maximized, fullwidth o fullheight, que corresponden a las opciones de línea de comandos "-fs", "-mm", "-fw" y "-fh", respectivamente. Tenga en cuenta que esto se aplica solo al primer cuadro.

geometry (clase Geometry)

Establece la geometría de la ventana de Emacs (como se describe arriba).

iconName (clase Title)

Establece el nombre del icono para el icono de la ventana de Emacs.

internalBorder (clase BorderWidth)

Establece el ancho del borde interno de la ventana en píxeles.

lineSpacing (clase LineSpacing)

Espacio adicional ("interlineado") entre líneas, en píxeles.

menuBar (clase MenuBar)

Proporciona barras de menú a los marcos si está en on; no proporciona barras de menú si está en off. Consulte el manual de Emacs, las secciones "Recursos de Lucid" y "Recursos de Motif", para obtener información sobre cómo controlar la apariencia de la barra de menú si tiene una.

minibuffer (clase Minibuffer)

Si no se especifica, no se crea un minibúfer en este marco. En su lugar, utilizará un marco de minibúfer separado.

paneFont (clase Font)

Nombre de la fuente para los títulos del panel del menú, en las versiones no toolkit de Emacs.

pointerColor (clase Foreground)

Para pantallas a color, establece el color del cursor del mouse de la ventana.

privateColormap (clase PrivateColormap)

Si está en on, utilice un mapa de colores privado, en caso de que la "visual predeterminada" de la clase PseudoColor y Emacs la estén utilizando.

reverseVideo (clase ReverseVideo)

Si el valor de reverseVideo está configurado en on, la ventana se mostrará en video inverso.

screenGamma (clase ScreenGamma)

Corrección gamma para los colores, equivalente al parámetro de marco "screen-gamma".

scrollBarWidth (clase ScrollBarWidth)

El ancho de la barra de desplazamiento en píxeles, equivalente al parámetro de marco "scroll-bar-width".

selectionFont (clase SelectionFont)

Nombre de la fuente para los elementos del menú emergente, en las versiones no toolkit de Emacs. (Para las versiones toolkit, consulte el manual de Emacs, las secciones "Recursos de Lucid" y "Recursos de Motif").

selectionTimeout (clase SelectionTimeout)

Número de milisegundos para esperar una respuesta de selección. Un valor de 0 significa esperar todo el tiempo necesario.

synchronous (clase Synchronous)

Ejecute Emacs en modo sincrónico si está en on. El modo sincrónico es útil para depurar problemas de X.

title (clase Title)

Establece el título de la ventana de Emacs.

toolBar (clase ToolBar)

Número de líneas para reservar para la barra de herramientas.

tabBar (clase TabBar)

Número de líneas para reservar para la barra de pestañas.

useXIM (clase UseXIM)

Desactiva el uso de métodos de entrada X (XIM) si es false u off.

verticalScrollBars (clase ScrollBars)

Proporciona barras de desplazamiento verticales a los marcos si está en on; suprime las barras de desplazamiento si está en off.

visualClass (clase VisualClass)

Especifique la "visual" que X debe utilizar. Esto le indica a X cómo manejar los colores. El valor debe comenzar con uno de TrueColor, PseudoColor, DirectColor, StaticColor, GrayScale y StaticGray, seguido de -depth, donde depth es el número de planos de color.


MANUALES

Puede solicitar copias impresas del Manual de GNU Emacs a la Free Software Foundation, que desarrolla software GNU. Consulte la tienda en línea en [https://shop.fsf.org/]. Es posible que su administrador local también tenga copias disponibles. Al igual que con todo el software y las publicaciones de la FSF, se permite que todos hagan y distribuyan copias del manual de Emacs. El código fuente Texinfo del manual también se incluye en la distribución del código fuente de Emacs.

ARCHIVOS

/usr/local/share/info: archivos para el navegador de documentación Info. El texto completo del manual de referencia de Emacs se incluye en una forma de árbol estructurada conveniente. Esto incluye el Manual de referencia de Emacs Lisp, útil para cualquier persona que desee escribir programas en el lenguaje de extensión Emacs Lisp, y la Introducción a la programación en Emacs Lisp.

/usr/local/share/emacs/$VERSION/lisp: archivos de código fuente Lisp y archivos compilados que definen la mayoría de los comandos de edición. Algunos se precargan; otros se cargan automáticamente desde este directorio cuando se utilizan.

/usr/local/libexec/emacs/$VERSION/$ARCH: varios programas que se utilizan con GNU Emacs.

/usr/local/share/emacs/$VERSION/etc: varios archivos de información.

/usr/local/share/emacs/$VERSION/etc/DOC.*: contiene las cadenas de documentación de los primitivos Lisp y las funciones Lisp precargadas de GNU Emacs. Se almacenan aquí para reducir el tamaño de Emacs propiamente dicho.

ERRORES

Existe una lista de correo, _, para informar sobre errores y correcciones de Emacs. Pero antes de informar sobre algo como un error, asegúrese de que realmente es un error y no una falta de comprensión o una característica deliberada. Le pedimos que lea la sección "Informar sobre errores" en el manual de Emacs para obtener consejos sobre cómo y cuándo informar sobre errores. Además, incluya el número de versión de Emacs que está utilizando en cada informe de errores que envíe. Los errores tienden a solucionarse si se pueden aislar, por lo que le conviene informarlos de manera que se puedan reproducir fácilmente.

No espere una respuesta personal a un informe de errores. El propósito de informar sobre errores es que se solucionen para todos en la próxima versión, si es posible. Para obtener asistencia personal, consulte el directorio de servicios en [https://www.fsf.org/resources/service/] para obtener una lista de personas que la ofrecen.

No envíe nada que no sean informes de errores a esta lista de correo. Para otras listas de Emacs, consulte [https://savannah.gnu.org/mail/?group=emacs].

SIN RESTRICCIONES

Emacs es gratuito; cualquiera puede redistribuir copias de Emacs a cualquiera bajo los términos establecidos en la GNU General Public License, una copia de la cual acompaña a cada copia de Emacs y que también aparece en el manual de referencia.

A veces, se pueden recibir copias de Emacs empaquetadas con distribuciones de sistemas Unix, pero nunca se incluyen en el alcance de ninguna licencia que cubra esos sistemas. Dicha inclusión viola los términos en los que se permite la distribución. De hecho, el propósito principal de la GNU General Public License es prohibir que cualquiera adjunte otras restricciones a la redistribución de Emacs.


Richard Stallman le anima a mejorar y extender Emacs, y le urge que contribuya con sus extensiones a la biblioteca GNU. Eventualmente, GNU (GNU's Not Unix) será un reemplazo completo de Unix. Todos podrán usar, copiar, estudiar y modificar el sistema GNU libremente.

VER TAMBIÉN

emacsclient(1), etags(1), X(7), xlsfonts(1), xterm(1), xrdb(1)

AUTORES

Emacs fue escrito por Richard Stallman y la Free Software Foundation. Para obtener créditos y agradecimientos detallados, consulte el manual de GNU Emacs.

Copyright 1995-2025 Free Software Foundation, Inc.

Se otorga permiso para realizar y distribuir copias textuales de este documento, siempre que se preserve el aviso de copyright y este aviso de permiso en todas las copias.

Se otorga permiso para copiar y distribuir versiones modificadas de este documento bajo las condiciones para la copia textual, siempre que toda la obra derivada resultante se distribuya bajo los términos de un aviso de permiso idéntico a este.

Se otorga permiso para copiar y distribuir traducciones de este documento a otro idioma, bajo las condiciones anteriores para las versiones modificadas, excepto que este aviso de permiso puede indicarse en una traducción aprobada por la Free Software Foundation.

NO HAY GARANTÍA, en la medida permitida por la ley.