vim [opzioni] [file ..]
vim [opzioni] -
vim [opzioni] -t tag
vim [opzioni] -q [file_errori]
ex
view
gvim gview evim eview
rvim rview rgvim rgview
Ci sono parecchi miglioramenti rispetto a Vi: undo multipli, finestre e buffer multipli, evidenziazione sintattica, possibilit� di modificare la linea di comando, completamento nomi file, help in linea, selezione testi in modalit� visuale, etc.. Vedere ":help vi_diff.txt" per un sommario delle differenze fra Vim e Vi.
Mentre usate Vim potete ricevere molto aiuto dal sistema di help online, col comando ":help". Vedere qui sotto la sezione AIUTO ONLINE.
Quasi sempre Vim viene invocato, per modificare un file, col comando
vim file
Pi� in generale Vim viene invocato con:
vim [opzioni] [lista_file]
Se lista_file non � presente, l'editor inizia aprendo un buffer vuoto. Altrimenti, una e una sola delle quattro maniere indicate qui sotto pu� essere usata per scegliere uno o pi� file da modificare.
12 file .. Una lista di nomi di file. Il primo di questi sar� il file corrente, e verr� letto nel buffer. Il cursore sar� posizionato sulla prima linea del buffer. Potete arrivare agli altri file col comando ":next". Per editare un file il cui nome inizia per "-" premettete "--" alla lista_file.
- Il file da editare � letto dallo "stdin" [di solito, ma non necessriamente, il terminale - NdT]. I comandi sono letti da "stderr", che dovrebbe essere un terminale [tty].
-t {tag} Il file da editare e la posizione iniziale del cursore dipendono da "tag", una specie di "etichetta" a cui saltare. {tag} viene cercata nel file tags, ed il file ad essa associato diventa quello corrente, ed il comando ad essa associato viene eseguito. Di solito si usa per programmi C, nel qual caso {tag} potrebbe essere un nome di funzione. L'effetto � che il file contenente quella funzione diventa il file corrente e il cursore � posizionato all'inizio della funzione. Vedere ":help tag-commands".
-q [file_errori] Inizia nella modalit� quickFix [correzione veloce]. Il file [file_errori] � letto e il primo errore � visualizzato. Se [file_errori] non � indicato, il suo nome � ottenuto dal valore dell'opzione 'errorfile' (che, se non specificata, vale "AztecC.Err" per l'Amiga, "errors.err" su altri sistemi). Si pu� saltare all'errore successivo col comando ":cn". Vedere ":help quickfix".
Vim si comporta in modo diverso se invocato con nomi differenti (il programma eseguibile "sottostante" pu� essere sempre lo stesso).
10 vim Modalit� "Normal", comportamento normale.
ex Inizia in modalit� "Ex". Si pu� passare in modalit� "Normal" col comandi ":vi". Si pu� invocare la modalit� "Ex" anche con l'argomento "-e".
view Inizia in modalit� "Sola Lettura". Non potete modificare i file. Si pu� invocare la modalit� "Sola Lettura" anche con l'argomento "-R".
gvim gview La versione GUI [Graphical User Interface]. Apre una nuova finestra. Si pu� invocare la modalit� "GUI" anche con l'argomento "-g".
evim eview La versione GUI in modalit� "Facile" (semplificata). Apre una nuova finestra. Si pu� invocare la modalit� "Facile" anche con l'argomento "-y".
rvim rview rgvim rgview Come sopra, ma con restrizioni ai comandi. Non si potrnno eseguire comandi dello shell o sospendere Vim. Si pu� invocare la modalit� "Ristretta" anche con l'argomento "-Z".
12 +[numero] Per il primo file il cursore sar� posizionato sulla linea "numero". Se "numero" manca, il cursore sar� posizionato sull'ultima linea del file.
+/{espressione} Per il primo file il cursore sar� posizionato alla prima occorrenza di {espressione}. Vedere ":help search-pattern" per come specificare l'espressione.
+{comando}
-c {comando} {comando} sar� eseguito dopo che il primo file � stato letto. {comando} � interpretato come un comando Ex. Se il {comando} contiene spazi deve essere incluso fra doppi apici (o altro delimitatore, a seconda dello shell che si sta usando). Esempio: Vim "+set si" main.c
Note: Si possono avere fino a 10 comandi "+" o "-c".
-S {file} I comandi contenuti in {file} sono eseguiti dopo la lettura del primo file. Equivalente a -c "source {file}". {file} non pu� avere un nome che inizia per '-'. Se {file} � omesso si usa "Session.vim" (funziona solo se -S � l'ultimo argomento specificato).
--cmd {comando} Come "-c", ma il comando � eseguito PRIMA di eseguire qualsiasi file vimrc. Si possono usare fino a 10 di questi comandi, indipendentemente dai comandi "-c".
-A Se Vim � stato compilato con supporto ARABIC per editare file con orientamento destra-sinistra e tastiera con mappatura Araba, questa opzione inizia Vim in modalit� "Arabic", cio� impostando 'arabic'. Altrimenti viene dato un messaggio di errore e Vim termina in modo anormale.
-b Modalit� "Binaria". Vengono impostate alcune opzioni che permettono di modificare un file binario o un programma eseguibile.
-C Compatibile. Imposta l'opzione 'compatible'. In questo modo Vim ha quasi lo stesso comportamento di Vi, anche in presenza di un file di configurazione .vimrc [proprio di Vim - NdT].
-d Inizia in modalit� "Diff" [differenze]. Dovrebbero esserci come argomenti due o tre nomi di file. Vim aprir� tutti i file evidenziando le differenze fra gli stessi. Funziona come vimdiff(1).
-d {dispositivo} Apre {dispositivo} per usarlo come terminale. Solo per l'Amiga. Esempio: "-d con:20/30/600/150".
-D Debugging. Vim si mette in modalit� "debugging" a partire dall'esecuzione del primo comando da uno script.
-e Eseguire Vim in modalit� "Ex", come se il programma eseguito sia "ex".
-E Eseguire Vim in modalit� "Ex" migliorata, come se il programma eseguito sia "exim".
-f Direttamente [Foreground]. Per la versione GUI, Vim non crea [fork] una nuova finestra, indipendente dallo shell di invocazione. Per l'Amiga, Vim non � fatto ripartire per aprire una nuova finestra. Opzione da usare quando Vim � eseguito da un programma che attende la fine della sessione di edit (ad es. mail). Sull'Amiga i comandi ":sh" e ":!" non sono disponibili.
--nofork Direttamente [Foreground]. Per la versione GUI, Vim non crea [fork] una nuova finestra, indipendente dallo shell di invocazione.
-F Se Vim � stato compilato con supporto FKMAP per editare file con orientamento destra-sinistra e tastiera con mappatura Farsi, questa opzione inizia Vim in modalit� "Farsi", cio� impostando 'fkmap' e 'rightleft'. Altrimenti viene dato un messaggio di errore e Vim termina in modo anormale.
-g Se Vim � stato compilato con supporto GUI, questa opzione chiede di usarla. Se Vim � stato compilato senza supporto GUI viene dato un messaggio di errore e Vim termina in modo anormale.
-h Un po' di aiuto su opzioni e argomenti che si possono dare invocando Vim. Subito dopo Vim esce.
-H Se Vim � stato compilato col supporto RIGHTLEFT per editare file con orientamento destra-sinistra e tastiera con mappatura Ebraica, questa opzione inizia Vim in modalit� "Ebraica", cio� impostando 'hkmap' e 'rightleft'. Altrimenti viene dato un messaggio di errore e Vim termina in modo anormale.
-i {viminfo} Se � abilitato l'uso di un file viminfo, questa opzione indica il nome del file da usare invece di quello predefinito "~/.viminfo". Si pu� anche evitare l'uso di un file .viminfo, dando come nome "NONE".
-L Equivalente a -r.
-l Modalit� Lisp. Imposta le opzini 'lisp' e 'showmatch'.
-m Inibisce modifica file. Annulla l'opzione 'write'. E' ancora possibile modificare un buffer [in memoria - Ndt], ma non scriverlo.
-M Modifiche non permesse. Le opzioni 'modifiable' e 'write' sono annullate, in modo da impedire sia modifiche che riscritture. Da notare che queste opzioni possono essere abilitate in seguito, permettendo cos� modifiche.
-N Modalit� "Non-compatibile". Annulla l'opzione 'compatible'. Cos� Vim va un po' meglio, ma � meno compatibile con Vi, anche in assenza di un file .vimrc.
-n Inibisce l'uso di un file di swap. Il recupero dopo una caduta di macchina diventa impossibile. Utile per editare un file su un supporto molto lento (ad es. floppy). Il comando ":set uc=0" ha lo stesso effetto. Per abilitare il recupero usare ":set uc=200".
-nb Diviene un Editor server per NetBeans. Vedere la documentazione per dettagli.
-o[N] Apri N finestre in orizzontale. Se N manca, apri una finestra per ciascun file.
-O[N] Apri N finestre, in verticale. Se N manca, apri una finestra per ciascun file.
-R Modalit� "Sola Lettura". Imposta l'opzione 'readonly'. Si pu� ancora modificare il buffer, ma siete protetti da una riscrittura involontaria. Se volete davvero riscrivere il file, aggiungete un punto esclamativo al comando "Ex", come in ":w!". L'opzione -R implica anche l'opzione -n (vedere sotto). L'opzione 'readonly' pu� essere annullata con ":set noro". Vedere ":help 'readonly'".
-r Lista file di swap, assieme a dati utili per un recupero.
-r {file} Modalit� "Recovery". Il file di swap � usato per recuperare una sessione di edit finita male. Il file di swap � un file con lo stesso nome file del file di testo editato, col suffisso ".swp". Vedere ":help recovery".
-s Modalit� silenziosa. Solo quando invocato come "Ex" o quando l'opzione "-e" � stata data prima dell'opzione "-s".
-s {scriptin} Lo script file {scriptin} � letto. I caratteri nel file sono interpretati come se immessi da voi. Lo stesso si pu� ottenere col comando ":source! {scriptin}". Se la fine del file di input viene raggiunta prima che Vim termini, l'ulteriore input viene preso dalla tastiera.
-T {terminale} Dice a Vim quale tipo di terminale state usando. Utile solo se il terminale non viene riconosciuto correttamente da Vim. Dovrebbe essere un terminale noto a Vim (internamente) o definito nel file termcap o terminfo.
-u {vimrc} Usa i comandi nel file {vimrc} per inizializzazioni. Tutte le altre inizializzazioni non sono eseguite. Usate questa opzione per editare qualche file di tipo speciale. Pu� anche essere usato per non fare alcuna inizializzazione dando come nome "NONE". Vedere ":help initialization" da vim per ulteriori dettagli.
-U {gvimrc} Usa i comandi nel file {gvimrc} per inizializzazioni GUI. Tutte le altre inizializzazioni GUI non sono eseguite. Pu� anche essere usata per non fare alcuna inizializzazione GUI dando come nome "NONE". Vedere ":help gui-init" da vim per ulteriori dettagli.
-V[N] Verboso. Vim manda messaggi relativi agli script file che esegue e quando legge o scrive un file viminfo. Il numero opzionale N � il valore dell'opzione 'verbose'. Il valore predefinito � 10.
-v Inizia Vim in modalit� "Vi", come se il programma eseguibile fosse "vi". Questo ha effetto solo quando Vim viene invocato con il nome "ex".
-w {scriptout} Ogni carattere immesso viene registrato nel file {scriptout}, finch� non uscite da Vim. Utile se si vuole creare uno script file da usare con "vim -s" o ":source!". Se il file {scriptout} esiste, quel che immettete viene aggiunto in fondo.
-W {scriptout} Come -w, ma uno script file esistente viene sovrascritto.
-x Uso di cifratura nella scrittura dei file. E' necessario immettere una chiave di cifratura.
-X Non connetterti al server X. Vim parte pi� rapidamente, ma il titolo della finestra e la clipboard non sono disponibili.
-y Eseguire Vim in modalit� "Facile" (semplificata), come se l'eseguibile invocato sia "evim" o "eview". Fa s� che Vim si comporti come un editor che usa solo il mouse e i caratteri.
-Z Modalit� "Ristretta". Vim si comporta come se invocato con un nome che inizia per "r".
-- Specifica la fine delle opzioni. Argomenti specificati dopo questo sono considerati nomi file. Si pu� usare per editare un file il cui nome inizi per '-'.
--echo-wid Solo con GUI GTK: Visualizza Window ID su "stdout".
--help Vim d� un messaggio ed esce, come con l'argomento "-h".
--literal Considera i nomi passati come argomenti letterai, senza espandere metacaratteri. Non necessario in Unix, lo shell espande i metacaratteri.
--noplugin Non caricare plugin. Implicito se si specifica -u NONE.
--remote Connettersi a un server Vim e chiedere di editare i file elencati come altri argomenti. Se non si trova un server viene dato un messaggio e i file sono editati nel Vim corrente.
--remote-expr {expr} Connettersi a un server Vim, valutare ivi {expr} e stampare il risultatoi su "stdout".
--remote-send {chiavi} Connettersi a un server Vim e spedirgli {chiavi}.
--remote-silent Come --remote, ma senza avvisare se non si trova un server.
--remote-wait Come --remote, ma Vim non termina finch� i file non sono stati editati.
--remote-wait-silent Come --remote-wait, ma senza avvisare se non si trova un server.
--serverlist Lista i nomi di tutti i server Vim disponibili.
--servername {nome} Usa {nome} come nome server. Usato per il Vim corrente, a meno che sia usato con l'argomento --remote, nel qual caso indica il server a cui connettersi.
--socketid {id} Solo con GUI GTK: Usa il meccanismo GtkPlug per eseguire gvim in un'altra finestra.
--version Stampa la versione di Vim ed esci.
15 /usr/local/lib/vim/doc/*.txt I file di documentazione di Vim . Usate ":help doc-file-list" per avere la lista completa.
/usr/local/lib/vim/doc/tags Il file di tags usato per trovare informazioni nei file di documentazione.
/usr/local/lib/vim/syntax/syntax.vim Inizializzazioni sintattiche a livello di sistema.
/usr/local/lib/vim/syntax/*.vim File di colorazione sintattica per vari linguaggi.
/usr/local/lib/vim/vimrc Inizializzazioni Vim a livello di sistema.
~/.vimrc Le vostre personali inizializzazioni di Vim .
/usr/local/lib/vim/gvimrc Inizializzazioni gvim a livello di sistema.
~/.gvimrc Le vostre personali inizializzazioni di gvim.
/usr/local/lib/vim/optwin.vim Script Vim usato dal comando ":options", un modo semplice per visualizzare e impostare opzioni.
/usr/local/lib/vim/menu.vim Inzializzazioni del menu gvim a livello di sistema.
/usr/local/lib/vim/bugreport.vim Script Vim per generare una segnalazione di errore. Vedere ":help bugs".
/usr/local/lib/vim/filetype.vim Script Vim per determinare il tipo di un file a partire dal suo nome. Vedere ":help 'filetype'".
/usr/local/lib/vim/scripts.vim Script Vim per determinare il tipo di un file a partire dal suo contenuto. Vedere ":help 'filetype'".
/usr/local/lib/vim/print/*.ps File usati per stampa PostScript.
Per informazioni aggiornate [in inglese - NdT] vedere la home page di Vim:
<URL:http://www.vim.org/>
Vim � basato su Stevie, scritto da: Tim Thompson, Tony Andrews e G.R. (Fred) Walter. In verit�, poco o nulla � rimasto del loro codice originale.
Si noti che un certo numero di comportamenti che possono essere considerati errori da qualcuno, sono in effetti causati da una riproduzione fin troppo fedele del comportamento di Vi. Se ritenete che altre cose siano errori "perch� Vi si comporta diversamente", date prima un'occhiata al file vi_diff.txt (o battere :help vi_diff.txt da Vim). Date anche un'occhiata alle opzioni 'compatible' e 'cpoptions.