Provided by: vim-gui-common_9.1.0496-1ubuntu4_all bug

NOME

       vim - VI Migliorato, un editor di testi per programmatori

SINTASSI

       vim [opzioni] [file ..]
       vim [opzioni] -
       vim [opzioni] -t tag
       vim [opzioni] -q [file_errori]

       ex
       view
       gvim gview evim eview
       rvim rview rgvim rgview

DESCRIZIONE

       Vim Un editore di testi, compatibile con, e migliore di, Vi.  Può essere usato per editare
       qualsiasi file di testo.  Particolarmente utile per editare programmi.

       Ci sono parecchi miglioramenti rispetto a Vi: undo multipli, finestre e  buffer  multipli,
       evidenziazione  sintattica,  possibilità  di  modificare la riga di comando, completamento
       nomi  file,  help  in  linea,  selezione  testi  in  Modo  Visual,  etc..   Vedere  ":help
       vi_diff.txt" per un sommario delle differenze fra Vim e Vi.

       Mentre  si  usa  Vim  si  può 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 nome_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.

       nome_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.
                   Si può 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.  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", e
                   il file a essa  associato  diventa  quello  corrente,  e  il  comando  a  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 in Modo 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
       "soggiacente" può essere sempre lo stesso).

       vim       Modo Normal, comportamento predefinito.

       ex        Inizia  in  Modo "Ex".  Si può passare in Modo Normal col comando ":vi".  Si può
                 invocare il Modo "Ex" anche con l'argomento "-e".

       view      Inizia in Modo Read-only (Sola Lettura).  Non si possono modificare i file.   Si
                 può invocare il Modo Read-only anche con l'argomento "-R".

       gvim gview
                 La  versione  GUI  [Graphical User Interface].  Apre una nuova finestra.  Si può
                 invocare il Modo GUI anche con l'argomento "-g".

       evim eview
                 La versione GUI in Modo Easy (semplificata).  Apre una nuova finestra.   Si  può
                 invocare il Modo Easy anche con l'argomento "-y".

       rvim rview rgvim rgview
                 Come  sopra,  ma  con  restrizioni ai comandi.  Non si potranno eseguire comandi
                 della shell o sospendere  Vim.   Si  può  chiedere  la  stessa  cosa  anche  con
                 l'argomento "-Z".

OPZIONI

       Le  opzioni  possono  essere in un ordine qualsiasi, prima o dopo i nomi di file.  Opzioni
       che non hanno un argomento si possono specificare dietro a un solo "-".

       +[numero]   Nel primo file il cursore sarà posizionato sulla linea "numero".  Se  "numero"
                   manca, il cursore sarà posizionato sull'ultima linea del file.

       +/{espressione}
                   Nel   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 della 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, quest'opzione  inizia  Vim  in
                   Modo  Arabic, cioè impostando 'arabic'.  Altrimenti viene dato un messaggio di
                   errore e Vim termina in modo anormale.

       -b          Modo Binary (binario).  Vengono impostate alcune  opzioni  che  permettono  di
                   modificare un file binario o un file che contiene 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 .vimrc.

       -d          Inizia in Modo Diff [differenze].  Dovrebbero esserci come argomenti da due  o
                   otto nomi di file.  Vim aprirà tutti i file evidenziando le differenze fra gli
                   stessi.  Funziona come vimdiff(1).

       -d {dispositivo}, -dev {dispositivo}
                   Apre {dispositivo} per usarlo come terminale.  Solo per l'Amiga.  Esempio: "-d
                   con:20/30/600/150".

       -D          Debugging.   Vim  si  mette  in Modo "debugging" a partire dall'esecuzione del
                   primo comando da uno script.

       -e          Eseguire Vim in Modo Ex, come se il programma eseguito sia "ex".

       -E          Eseguire Vim in Modo Ex migliorato, come se il programma eseguito sia "exim".

       -f          Direttamente [Foreground].  Per la versione GUI, Vim non crea [fork] una nuova
                   finestra,  indipendente  dalla  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 (p.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 dalla shell di invocazione.

       -F          Se  Vim è stato compilato con supporto FKMAP per editare file con orientamento
                   destra-sinistra e tastiera con mappatura Farsi, quest'opzione  inizia  Vim  in
                   Modo  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, quest'opzione chiede di usarla.  Se
                   Vim  è  stato compilato senza supporto GUI viene dato un messaggio di errore e
                   Vim termina in modo anormale.

       --gui-dialog-file {nome}
                   Quando si usa la GUI, invece di  visualizzare  un  dialogo,  il  titolo  e  il
                   messaggio  del  dialogo sono scritti sul file {nome}.  Il file viene creato o,
                   se già esistente, viene esteso.  Quest'opzione serve solo in fase di test, per
                   evitare  di  restare  bloccati da un dialogo che non si riesce a visualizzare.
                   Se si sta lavorando senza la GUI l'argomento viene ignorato.

       --help, -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,  quest'opzione
                   inizia Vim in Modo Ebraico, 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, quest'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          Modo Lisp.  Imposta le opzioni 'lisp' e 'showmatch'.

       -m          Inibisce modifica file.   Inibisce  l'opzione  'write'.   È  ancora  possibile
                   modificare un buffer, ma non riscriverlo.

       -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          Modo "Non-compatibile".  Annulla l'opzione 'compatible'.  Così Vim si comporta
                   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
                   (p.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]       Apre N finestre in orizzontale.  Se N manca, apre  una  finestra  per  ciascun
                   file.

       -O[N]       Apre  N  finestre,  in  verticale.   Se N manca, apre una finestra per ciascun
                   file.

       -p[N]       Apre N pagine di linguette.  Quando N è omesso, apre una pagine  di  linguette
                   per ciascun file.

       -P {titolo-padre}
                   Solo   per   GUI  Win32:  Specifica  il  titolo  dell'applicazione-padre.   Se
                   possibile,  Vim  viene  eseguito  in  una  finestra   MDI   (Multiple-Document
                   Interface).  {titolo-padre} deve apparire nel titolo della applicazione-padre.
                   Accertatevi   che    sia    sufficientemente    esplicativo.     Notare    che
                   l'implementazione   è   ancora   rudimentale.    Non  funziona  per  tutte  le
                   applicazioni, e il menù non funziona.

       -R          Modo Read-only (Sola Lettura).  Imposta l'opzione 'readonly'.  Si  può  ancora
                   modificare  il  buffer, ma il file è protetto da una riscrittura involontaria.
                   Se  si  vuole  davvero  riscrivere  il  file,  occorre  aggiungere  un   punto
                   esclamativo  al  comando  Ex,  come  in  ":w!".   L'opzione  -R  implica anche
                   l'opzione -n (vedere sopra).  L'opzione 'readonly' può  essere  annullata  con
                   ":set noro".  Vedere ":help 'readonly'".

       -r          Lista file di swap, e informazioni su come usarli per ripristinare file.

       -r {file}   Modo  Recovery  (ripristino).   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          Modo  silenzioso.   Solo  quando  invocato come "Ex" o quando l'opzione "-e" è
                   stata data prima dell'opzione "-s".

       -s {script_in_input}
                   Lo  script  file  {script_in_input}  è  letto.   I  caratteri  nel  file  sono
                   interpretati  come  se  immessi  da  terminale.   Lo  stesso  risultato si può
                   ottenere col comando ":source! {script_in_input}".  Se la  fine  del  file  di
                   input  viene  raggiunta  prima  che Vim termini, l'ulteriore input verrà 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 (predefinito) o definito nei file termcap o terminfo.

       --not-a-term
                   Da usare per specifica a Vim che l'utente è consapevole che l'input e l'output
                   non  avvengono  con  un  terminale  vero  e proprio.  Ciò serve per evitare il
                   messaggio di avvertimento e il ritardo di  due  secondi  che  avverrebbero  in
                   assenza di questo argomento.

       --ttyfail   Quando stdin o stdout non sono un terminale (tty) esci subito da Vim.

       -u {vimrc}  Usa  i  comandi  nel  file  {vimrc}  per  inizializzazioni.   Tutte  le  altre
                   inizializzazioni non sono eseguite.  Usare quest'opzione per  editare  qualche
                   file  di  tipo  speciale.  Si possono anche omettere tutte le inizializzazioni
                   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.  Si possono anche  omettere  tutte  le
                   inizializzazioni  GUI  dando come nome "NONE".  Vedere ":help gui-init" da vim
                   per ulteriori dettagli.

       -V[N]       Verboso.  Vim manda messaggi relativi ai file di script che  esegue  e  quando
                   legge  o  scrive  un  file  viminfo.   Il  numero  opzionale  N  è  il  valore
                   dell'opzione 'verbose'.  Il valore predefinito è 10.

       -V[N]{nome_file}
                   Comw -V  imposta 'verbosefile' a {nome_file}.  Il risultato è che  i  messaggi
                   non  sono  visualizzati,  ma scritti sul file {nome_file}.  Il {nome_file} non
                   deve iniziare con un numero.

       --log {nome_file}
                   Se Vim è stato  compilato  con  le  funzionalità  eval  e  channel,  inizia  a
                   registrare  e  scrive le registrazioni a {nome_file}.  Ciò equivale a chiamare
                   ch_logfile({nome_file}, 'ao')  in  una  fase  molto  iniziale  dell'avvio  del
                   programma.

       -v          Inizia  Vim in Modo Vi, come se il programma eseguibile fosse "vi".  Questo ha
                   effetto solo quando Vim viene invocato con il nome "ex".

       -w{numero}  Imposta l'opzione 'window' a {numero}.

       -w {script_file}
                   Ogni carattere immesso viene registrato nel file {script_file}, finché non  si
                   esce da Vim.  Utile se si vuole creare uno script file da usare con "vim -s" o
                   ":source!".  Se il file {script_file} esiste, il testo immesso viene  aggiunto
                   in fondo.

       -W {script_file}
                   Come -w, ma uno script file esistente viene sovrascritto.

       -x          Uso  di  cifratura  nella  scrittura  dei  file.   Verrà chiesta una chiave di
                   cifratura.

       -X          Non connettersi al server X.  Vim parte più rapidamente, ma  il  titolo  della
                   finestra e la clipboard non sono usati.

       -y          Eseguire  Vim  in  Modo Easy (semplificato), 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          Modo  ristretto.   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
                   '-'.

       --clean     Richiede di non usare alcun file di personalizzazione (vimrc,  plugin,  etc.).
                   Utile per verificare se un problema persiste invocando Vim "originale".

       --echo-wid  Solo per GUI GTK: Visualizza ID di Window su stdout.

       --literal   Considera   i   nomi   passati   come  argomenti  letterali,  senza  espandere
                   metacaratteri.  Non ha effetto in Unix,  dove  la  shell  espande  comunque  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  {expr}  e stampare il risultato 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
                   Elenca 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  per  GUI  GTK:  Usa  meccanismo  GtkPlug  per  eseguire gvim in un'altra
                   finestra.

       --startuptime {nome_file}
                   Durante la fase iniziale, scrive messaggi di log al file {nome_file}.

       --version   Stampa la versione di Vim ed esce.

       --windowid {id}
                   Solo per GUI Win32: Chiede a gvim di provare a user l'ID di window  {id}  come
                   padre, in modo da venir eseguito all'interno della finestra specificata.

AIUTO ONLINE

       Battere  ":help" in Vim per iniziare.  Battere ":help argomento" per ricevere aiuto su uno
       specifico argomento.  Per esempio: ":help ZZ" per ricevere aiuto sul comando "ZZ".   Usare
       <Tab>  e  CTRL-D per completare gli argomenti (":help cmdline-completion").  Ci sono "tag"
       nei file di help per passare da un argomento a un altro  (simili  a  legami  ipertestuali,
       vedere  ":help").   Tutti  i file di documentazione possono essere navigati così.  Ad es.:
       ":help syntax.txt".

FILE

       /usr/local/share/vim/vim??/doc/*.txt
                      I file di documentazione di Vim Usare ":help doc-file-list"  per  avere  la
                      lista completa.
                      vim??  è il numero di versione corto, p.es., vim91 per indicare Vim 9.1

       /usr/local/share/vim/vim??/doc/tags
                      Il file di tags usato per trovare informazioni nei file di documentazione.

       /usr/local/share/vim/vim??/syntax/syntax.vim
                      Inizializzazioni sintattiche a livello di sistema.

       /usr/local/share/vim/vim??/syntax/*.vim
                      File di colorazione sintattica per vari linguaggi.

       /usr/local/share/vim/vimrc
                      Inizializzazioni Vim a livello di sistema.

       ~/.vimrc, ~/.vim/vimrc, $XDG_CONFIG_HOME/vim/vimrc
                      Inizializzazioni personali di Vim (viene utilizzata la prima trovata).

       /usr/local/share/vim/gvimrc
                      Inizializzazioni gvim a livello di sistema.

       ~/.gvimrc, ~/.vim/gvimrc, $XDG_CONFIG_HOME/vim/gvimrc
                      Inizializzazioni personali di gvim (viene utilizzata la prima trovata).

       /usr/local/share/vim/optwin.vim
                      Script  Vim usato dal comando ":options", maniera elegante per visualizzare
                      e impostare opzioni.

       /usr/local/share/vim/vim??/menu.vim
                      Inizializzazioni del menù gvim a livello di sistema.

       /usr/local/share/vim/vim??/bugreport.vim
                      Script Vim per generare una segnalazione di errore.  Vedere ":help bugs".

       /usr/local/share/vim/vim??/filetype.vim
                      Script Vim per determinare il tipo di un file dal suo nome.  Vedere  ":help
                      'filetype'".

       /usr/local/share/vim/vim??/scripts.vim
                      Script  Vim  per  determinare  il tipo di un file dal suo contenuto. Vedere
                      ":help 'filetype'".

       /usr/local/share/vim/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/>

VEDERE ANCHE

       vimtutor(1)

AUTORE

       Buona parte di Vim è stato scritto da Bram Moolenaar, con molto aiuto da parte  di  altri.
       Vedere ":help credits" in Vim.
       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.

BUG

       Probabilmente.  Vedere ":help todo" per una lista di problemi noti.

       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 si ritiene che altre cose siano errori "perché Vi si comporta diversamente",  si
       dia  prima  un'occhiata  al  file  vi_diff.txt  (o  si  immetta :help vi_diff.txt da Vim).
       Un'occhiata va data anche alle opzioni 'compatible' e 'cpoptions.

                                          4 giugno 2024                                    VIM(1)