vim - Vi IMproved, un editor de texto para programadores
SINOPSIS
vim [opciones] [archivo ...]
vim [opciones] vim [opciones] -t etiqueta
vim [opciones] -q [archivo_de_errores]
ex
view
gvim gview evim eview
rvim rview rgvim rgview
DESCRIPCIÓN
Vim es un editor de texto que es compatible con Vi. Se puede utilizar para editar todo tipo de texto plano. Es especialmente útil para editar programas.
Hay muchas mejoras con respecto a Vi: múltiples niveles de deshacer, múltiples ventanas y búferes, resaltado de sintaxis, edición de línea de comandos, finalización de nombres de archivo, ayuda en línea, selección visual, etc. Consulte ":help vi_diff.txt" para obtener un resumen de las diferencias entre Vim y Vi.
Mientras se ejecuta Vim, se puede obtener mucha ayuda del sistema de ayuda en línea, con el comando ":help". Consulte la sección AYUDA EN LÍNEA a continuación.
Con mayor frecuencia, Vim se inicia para editar un solo archivo con el comando
vim archivo
En general, Vim se inicia con:
vim [opciones] [lista_de_archivos]
Si falta la lista de archivos, el editor se iniciará con un búfer vacío. De lo contrario, exactamente uno de los siguientes cuatro se puede utilizar para elegir uno o más archivos para editar.
archivo ... Una lista de nombres de archivo. El primero será el archivo actual y se leerá en el búfer. El cursor se colocará en la primera línea del búfer. Puede acceder a los otros archivos con el comando ":next". Para editar un archivo que comienza con un guion, preceda la lista de archivos con "--".
- El archivo que se va a editar se lee desde la entrada estándar. Los comandos se leen desde la salida de error estándar, que debe ser un terminal.
-t {etiqueta} El archivo que se va a editar y la posición inicial del cursor dependen de una "etiqueta", una especie de etiqueta de destino. {etiqueta} se busca en el archivo de etiquetas, el archivo asociado se convierte en el archivo actual y se ejecuta el comando asociado. En su mayoría, esto se utiliza para programas C, en cuyo caso {etiqueta} podría ser un nombre de función. El efecto es que el archivo que contiene esa función se convierte en el archivo actual y el cursor se coloca al principio de la función. Consulte ":help tag-commands".
-q [archivo_de_errores]
Comienza en el modo quickFix. El archivo [archivo_de_errores] se lee y se muestra el primer error. Si se omite [archivo_de_errores], el nombre del archivo se obtiene de la opción 'errorfile' (el valor predeterminado es "AztecC.Err" para Amiga, "errors.err" en otros sistemas). Se pueden saltar a otros errores con el comando ":cn". Consulte ":help quickfix".
Vim se comporta de manera diferente, según el nombre del comando (el ejecutable aún puede ser el mismo archivo).
vim La forma "normal", todo es predeterminado.
ex Inicia en el modo Ex. Vaya al modo normal con el comando ":vi". También se puede hacer con el argumento "-e".
view Comienza en modo de solo lectura. Estará protegido para no escribir en los archivos. También se puede hacer con el argumento "-R".
gvim gview
La versión GUI. Inicia una nueva ventana. También se puede hacer con el argumento "-g".
evim eview
La versión GUI en modo fácil. Inicia una nueva ventana. También se puede hacer con el argumento "-y".
rvim rview rgvim rgview
Similar a lo anterior, pero con restricciones. No será posible iniciar comandos de shell o suspender Vim. También se puede hacer con el argumento "-Z".
OPCIONES
Las opciones se pueden dar en cualquier orden, antes o después de los nombres de archivo. Las opciones sin un argumento se pueden combinar después de un solo guion.
+[num] Para el primer archivo, el cursor se colocará en la línea "num". Si "num" falta, el cursor se colocará en la última línea.
+/{pat} Para el primer archivo, el cursor se colocará en la línea con la primera aparición de {pat}. Consulte ":help search-pattern" para conocer los patrones de búsqueda disponibles.
+{command}
-c {command}
{command} se ejecutará después de que se haya leído el primer archivo. {command} se interpreta como un comando Ex. Si {command} contiene espacios, debe estar entre comillas dobles (esto depende de la shell que se utilice). Ejemplo: vim "+set si" main.c
Nota: Puede utilizar hasta 10 comandos "+" o "-c".
-A Si Vim se ha compilado con soporte ARABIC para editar archivos orientados de derecha a izquierda y mapeo de teclado árabe, esta opción inicia Vim en modo árabe, es decir, se establece 'arabic'. De lo contrario, se muestra un mensaje de error y Vim se aborta.
-b Modo binario. Se establecerán algunas opciones que permiten editar un archivo binario o ejecutable.
-C Compatible. Establece la opción 'compatible'. Esto hará que Vim se comporte en su mayoría como Vi, incluso si existe un archivo .vimrc.
-d Comienza en modo de comparación. Debe haber entre dos y ocho argumentos de nombre de archivo. Vim abrirá todos los archivos y mostrará las diferencias entre ellos. Funciona como vimdiff(1).
-d {device}, -dev {device}
Abre {device} para usarlo como terminal. Solo en Amiga. Ejemplo: "-d con:20/30/600/150".
-D Depuración. Entra en modo de depuración al ejecutar el primer comando de un script.
-e Inicia Vim en modo Ex, como si se llamara al ejecutable "ex".
-E Inicia Vim en modo Ex mejorado, como si se llamara al ejecutable "exim".
-f Para la versión GUI, Vim no se bifurcará ni se separará de la shell en la que se inició. En Amiga, Vim no se reinicia para abrir una nueva ventana. Esta opción debe utilizarse cuando Vim se ejecuta mediante un programa que esperará a que finalice la sesión de edición (por ejemplo, correo). En Amiga, los comandos ":sh" y ":!" no funcionarán.
-F Si Vim se ha compilado con soporte FKMAP para editar archivos orientados de derecha a izquierda y mapeo de teclado farsi, esta opción inicia Vim en modo farsi, es decir, se establecen 'fkmap' y 'rightleft'. De lo contrario, se muestra un mensaje de error y Vim se aborta.
Nota: El soporte para farsi se eliminó en el parche 8.1.0932.
-g Si Vim se ha compilado con soporte para la GUI, esta opción habilita la GUI. Si no se
compiló ningún soporte para la GUI, se muestra un mensaje de error y Vim se detiene.
-H Si Vim se ha compilado con soporte para RIGHTLEFT para editar archivos orientados de
derecha a izquierda y mapeo de teclado hebreo, esta opción inicia Vim en modo hebreo,
es decir, se establecen las opciones 'hkmap' y 'rightleft'. De lo contrario, se muestra un
mensaje de error y Vim se detiene.
-i {viminfo}
Especifica el nombre de archivo que se utilizará al leer o escribir el archivo viminfo, en lugar
del valor predeterminado "~/.viminfo". También se puede utilizar para omitir el uso del archivo
.viminfo, especificando el nombre "NONE".
-l Modo Lisp. Establece las opciones 'lisp' y 'showmatch'.
-L Igual que -r.
-m Se deshabilita la modificación de archivos. Restablece la opción 'write'. Todavía se
puede modificar el búfer, pero no es posible escribir un archivo.
-M No se permiten modificaciones. Las opciones 'modifiable' y 'write' se desactivarán,
de modo que no se permitan cambios y no se puedan escribir archivos. Tenga en cuenta que estas
opciones se pueden establecer para permitir la realización de modificaciones.
-n No se utilizará ningún archivo de intercambio. La recuperación después de un bloqueo
será imposible. Es útil si desea editar un archivo en un medio muy lento (por ejemplo, un
disquete). También se puede hacer con ":set uc=0". Se puede deshacer con ":set uc=200".
-N Modo sin compatibilidad. Restablece la opción 'compatible'. Esto hará que Vim se
comporte un poco mejor, pero sea menos compatible con Vi, incluso si no existe un archivo .vimrc.
-nb Conviértase en un servidor de editor para NetBeans. Consulte la documentación para obtener
más detalles.
-o[N] Abra N ventanas apiladas. Cuando se omite N, abra una ventana para cada archivo.
-O[N] Abra N ventanas una al lado de la otra. Cuando se omite N, abra una ventana para cada
archivo.
-p[N] Abra N páginas de pestañas. Cuando se omite N, abra una página de pestaña para cada
archivo.
-P {parent-title}
Solo para GUI de Win32: especifique el título de la aplicación principal. Cuando sea posible, Vim
se ejecutará en una ventana MDI dentro de la aplicación. {parent-title} debe aparecer en el título
de la ventana de la aplicación principal. Asegúrese de que sea lo suficientemente específico. Tenga
en cuenta que la implementación sigue siendo primitiva. No funcionará con todas las aplicaciones y
el menú no funcionará.
-r Enumere los archivos de intercambio, con información sobre cómo utilizarlos para la
recuperación.
-r {file} Modo de recuperación. Se utiliza el archivo de intercambio para recuperar una sesión de
edición interrumpida. El archivo de intercambio es un archivo con el mismo nombre que el archivo
de texto con el sufijo ".swp" adjunto. Consulte ":help recovery".
-R Modo de solo lectura. Se establecerá la opción 'readonly'. Todavía puede editar el
búfer, pero se evitará que sobrescriba accidentalmente un archivo. Si desea sobrescribir un archivo,
agregue un signo de exclamación al comando Ex, como en ":w!". La opción -R también implica la
opción -n (consulte arriba). La opción 'readonly' se puede restablecer con ":set noro". Consulte
":help 'readonly'".
-s Modo silencioso. Solo funciona cuando se inicia como "Ex" o cuando se ha dado la opción "-e" antes de la opción "-s".
-s {scriptin}
El archivo de script {scriptin} se lee. Los caracteres del archivo se interpretan como si los hubiera escrito. Lo mismo se puede hacer con el comando ":source! {scriptin}". Si se llega al final del archivo antes de que el editor salga, se leerán más caracteres desde el teclado.
-S {file} El archivo {file} se cargará después de que se haya leído el primer archivo. Esto es equivalente a -c "source {file}". {file} no puede comenzar con '-'. Si se omite {file}, se utiliza "Session.vim" (solo funciona cuando -S es el último argumento).
-T {terminal}
Indica a Vim el nombre del terminal que estás utilizando. Solo es necesario cuando el método automático no funciona. Debe ser un terminal conocido por Vim (integrado) o definido en el archivo termcap o terminfo.
-u {vimrc} Utiliza los comandos del archivo {vimrc} para las inicializaciones. Todas las demás inicializaciones se omiten. Úsalo para editar un tipo especial de archivos. También se puede utilizar para omitir todas las inicializaciones especificando el nombre "NONE". Consulta ":help initialization" dentro de vim para obtener más detalles.
-U {gvimrc} Utiliza los comandos del archivo {gvimrc} para las inicializaciones de la GUI. Todas las demás inicializaciones de la GUI se omiten. También se puede utilizar para omitir todas las inicializaciones de la GUI especificando el nombre "NONE". Consulta ":help gui-init" dentro de vim para obtener más detalles.
-v Inicia Vim en modo Vi, como si el ejecutable se llamara "vi". Esto solo tiene efecto cuando el ejecutable se llama "ex".
-V[N] Verboso. Muestra mensajes sobre qué archivos se están cargando y para leer y escribir un archivo viminfo. El número opcional N es el valor de 'verbose'. El valor predeterminado es 10.
-V[N]{filename}
Como -V y establece 'verbosefile' en {filename}. El resultado es que los mensajes no se muestran, sino que se escriben en el archivo {filename}. {filename} no debe comenzar con un dígito.
-w{number} Establece la opción 'window' en {number}.
-w {scriptout}
Todos los caracteres que escribas se graban en el archivo {scriptout}, hasta que salgas de Vim. Esto es útil si quieres crear un archivo de script para usarlo con "vim -s" o ":source!". Si el archivo {scriptout} existe, los caracteres se agregan.
-W {scriptout}
Como -w, pero un archivo existente se sobrescribe.
-x Si Vim ha sido compilado con soporte de encriptación, utiliza la encriptación al escribir archivos. Pedirá una clave de encriptación.
-X No se conecta al servidor X. Reduce el tiempo de inicio en un terminal, pero el título de la ventana y el portapapeles no se utilizarán.
-Y No se conecta al compositor Wayland.
-y Inicia Vim en modo fácil, como si el ejecutable se llamara "evim" o "eview". Hace que Vim se comporte como un editor de clic y escritura.
-Z Modo restringido. Funciona como si el ejecutable comenzara con "r".
-- Denota el final de las opciones. Los argumentos que siguen a esto se tratarán como un nombre de archivo.
Esto se puede utilizar para editar un nombre de archivo que comienza con "-".
--clean No utilice ninguna configuración personal (vimrc, complementos, etc.). Útil para ver si
un problema se reproduce con una configuración de Vim limpia.
--cmd {comando}
Similar a usar "-c", pero el comando se ejecuta justo antes de procesar cualquier archivo vimrc.
Puede utilizar hasta 10 de estos comandos, independientemente de los comandos "-c".
--echo-wid Solo para GUI GTK: Imprima el ID de la ventana en stdout.
--gui-dialog-file {nombre}
Cuando se utiliza la GUI, en lugar de mostrar un cuadro de diálogo, escriba el título y el mensaje del
cuadro de diálogo en el archivo {nombre}. El archivo se crea o se agrega. Solo es útil para pruebas,
para evitar que la prueba se atasque en un cuadro de diálogo que no se puede ver. Sin la GUI,
el argumento se ignora.
--help, -h, -?
Muestre algo de ayuda sobre los argumentos y opciones de la línea de comandos. Después de esto, Vim se cierra.
--literal Tome los argumentos de nombre de archivo literalmente, no expanda los comodines. Esto no tiene efecto en
Unix, donde el shell expande los comodines.
--log {nombre de archivo}
Si Vim se ha compilado con las funciones eval y channel, inicie el registro y escriba las entradas en {nombre de archivo}. Esto funciona como llamar a ch_logfile({nombre de archivo}, 'ao') muy temprano
durante el inicio.
--nofork Primer plano. Para la versión GUI, Vim no se bifurcará ni se separará de la shell en la que se inició.
--noplugin Omitir la carga de complementos. Implícito por -u NONE.
--not-a-term
Indica a Vim que el usuario sabe que la entrada y/o salida no están conectadas a una terminal. Esto evitará la advertencia y el retraso de dos segundos que ocurriría.
--remote Conéctese a un servidor Vim y haga que edite los archivos que se indican en el resto de los argumentos. Si no se encuentra ningún servidor, se muestra una advertencia y los archivos se editan en el Vim actual.
--remote-expr {expresión}
Conéctese a un servidor Vim, evalúe {expresión} en él e imprima el resultado en stdout.
--remote-send {teclas}
Conéctese a un servidor Vim y envíe {teclas} a él.
--remote-silent
Como --remote, pero sin la advertencia cuando no se encuentra ningún servidor.
--remote-wait
Como --remote, pero Vim no se cierra hasta que se hayan editado los archivos.
--remote-wait-silent
Como --remote-wait, pero sin la advertencia cuando no se encuentra ningún servidor.
--serverlist
Enumere los nombres de todos los servidores Vim que se pueden encontrar.
--servername {nombre}
Utilice {nombre} como nombre del servidor. Se utiliza para el Vim actual, a menos que se utilice con un argumento --remote, en cuyo caso es el nombre del servidor al que se va a conectar. Si se está utilizando el backend socketserver, si el nombre comienza con "/", "./" o "../", se toma como una ruta absoluta, relativa o relativa a la conexión.
--clientserver {backend}
Utilice {backend} como backend para la funcionalidad clientserver, ya sea "socket" o "x11"
respectivamente. Solo está disponible cuando se compila con ambas características socketserver y X11
presentes.
--socketid {id}
Solo para la GUI de GTK: utilice el mecanismo GtkPlug para ejecutar gVim en otra ventana.
--startuptime {file}
Durante el inicio, escriba mensajes de tiempo en el archivo {fname}.
--ttyfail Si stdin o stdout no son un terminal (tty), salga inmediatamente.
--version Imprima la información de la versión y salga.
--windowid {id}
Solo para la GUI de Win32: haga que gVim intente utilizar la ventana {id} como ventana principal, de modo que se ejecute dentro de esa ventana.
AYUDA EN LÍNEA
Escriba ":help" en Vim para empezar. Escriba ":help subject" para obtener ayuda sobre un tema específico. Por
ejemplo: ":help ZZ" para obtener ayuda sobre el comando "ZZ". Utilice
ARCHIVOS
/usr/local/share/vim/vim??/doc/*.txt
Los archivos de documentación de Vim. Utilice ":help doc-file-list" para obtener la lista completa. vim?? es la versión abreviada, como vim91 para Vim 9.1
/usr/local/share/vim/vim??/doc/tags
El archivo de etiquetas utilizado para encontrar información en los archivos de documentación.
/usr/local/share/vim/vim??/syntax/syntax.vim
Inicializaciones de sintaxis a nivel del sistema.
/usr/local/share/vim/vim??/syntax/*.vim
Archivos de sintaxis para varios lenguajes.
/usr/local/share/vim/vimrc
Inicializaciones de Vim a nivel del sistema.
~/.vimrc, ~/.vim/vimrc, $XDG_CONFIG_HOME/vim/vimrc
Sus inicializaciones personales de Vim (se utiliza el primero que se encuentre).
/usr/local/share/vim/gvimrc
Inicializaciones de gvim a nivel del sistema.
~/.gvimrc, ~/.vim/gvimrc, $XDG_CONFIG_HOME/vim/gvimrc
Sus inicializaciones personales de gVim (se utiliza el primero que se encuentre).
/usr/local/share/vim/vim??/optwin.vim
Script utilizado para el comando ":options", una forma práctica de ver y configurar opciones.
/usr/local/share/vim/vim??/menu.vim
Inicializaciones de menú a nivel del sistema para gVim.
/usr/local/share/vim/vim??/bugreport.vim
Script para generar un informe de errores. Consulte ":help bugs".
/usr/local/share/vim/vim??/filetype.vim
Script para detectar el tipo de un archivo por su nombre. Consulte ":help 'filetype'".
/usr/local/share/vim/vim??/scripts.vim
Script para detectar el tipo de un archivo por su contenido. Consulte ":help 'filetype'".
/usr/local/share/vim/vim??/print/*.ps
Archivos utilizados para la impresión PostScript.
Para obtener información reciente, consulte la página de inicio de VIM:
CONSULTE TAMBIÉN
vimtutor(1)
AUTOR
La mayor parte de Vim fue creada por Bram Moolenaar, con mucha ayuda de otros. Consulte ":help credits" en Vim. Vim se basa en Stevie, en el que trabajaron: Tim Thompson, Tony Andrews y G.R. (Fred) Walter. Aunque apenas queda código original.
ERRORES
Probablemente. Consulte ":help todo" para obtener una lista de problemas conocidos. Tenga en cuenta que algunas cosas que pueden considerarse errores por algunos, en realidad se deben a una reproducción fiel del comportamiento de Vi. Y si cree que otras cosas son errores "porque Vi lo hace de manera diferente", debe examinar más detenidamente el archivo vi_diff.txt (o escribir :help vi_diff.txt cuando esté en Vim). También consulte las opciones 'compatible' y 'cpoptions'.