| blob | 1a8967fd90502d1ec7d5cde9db8c6f1075007f41 |
1 .TH VIM 1 "22 febbraio 2002"
2 .SH NOME
3 vim \- VI Migliorato, un editor di testi per programmatori
4 .SH SINTASSI
5 .br
6 .B vim
7 [opzioni] [file ..]
8 .br
9 .B vim
10 [opzioni] \-
11 .br
12 .B vim
13 [opzioni] \-t tag
14 .br
15 .B vim
16 [opzioni] \-q [file_errori]
17 .PP
18 .br
19 .B ex
20 .br
21 .B view
22 .br
23 .B gvim
24 .B gview
25 .B evim
26 .B eview
27 .br
28 .B rvim
29 .B rview
30 .B rgvim
31 .B rgview
32 .SH DESCRIZIONE
33 .B Vim
34 Un editore di testi, compatibile con, e migliore di, Vi.
35 Può essere usato per editare qualsiasi file di testo.
36 Particolarmente utile per editare programmi.
37 .PP
38 Ci sono parecchi miglioramenti rispetto a Vi: undo multipli,
39 finestre e buffer multipli, evidenziazione sintattica, possibilità
40 di modificare la linea di comando, completamento nomi file, help
41 in linea, selezione testi in modalità visuale, etc..
42 Vedere ":help vi_diff.txt" per un sommario delle differenze fra
43 .B Vim
44 e Vi.
45 .PP
46 Mentre usate
47 .B Vim
48 potete ricevere molto aiuto dal sistema di help online, col comando ":help".
49 Vedere qui sotto la sezione AIUTO ONLINE.
50 .PP
51 Quasi sempre
52 .B Vim
53 viene invocato, per modificare un file, col comando
54 .PP
55 vim file
56 .PP
57 Più in generale
58 .B Vim
59 viene invocato con:
60 .PP
61 vim [opzioni] [lista_file]
62 .PP
63 Se lista_file non è presente, l'editor inizia aprendo un buffer vuoto.
64 Altrimenti, una e una sola delle quattro maniere indicate qui sotto può
65 essere usata per scegliere uno o più file da modificare.
66 .TP 12
67 file ..
68 Una lista di nomi di file.
69 Il primo di questi sarà il file corrente, e verrà letto nel buffer.
70 Il cursore sarà posizionato sulla prima linea del buffer.
71 Potete arrivare agli altri file col comando ":next".
72 Per editare un file il cui nome inizia per "\-" premettete "\-\-" alla
73 lista_file.
74 .TP
75 \-
76 Il file da editare è letto dallo "stdin" [di solito, ma non
77 necessriamente, il terminale \- NdT]. I comandi sono letti da "stderr",
78 che dovrebbe essere un terminale [tty].
79 .TP
80 \-t {tag}
81 Il file da editare e la posizione iniziale del cursore dipendono da "tag",
82 una specie di "etichetta" a cui saltare.
83 {tag} viene cercata nel file tags, ed il file ad essa associato diventa
84 quello corrente, ed il comando ad essa associato viene eseguito.
85 Di solito si usa per programmi C, nel qual caso {tag} potrebbe essere un
86 nome di funzione.
87 L'effetto è che il file contenente quella funzione diventa il file corrente
88 e il cursore è posizionato all'inizio della funzione.
89 Vedere ":help tag-commands".
90 .TP
91 \-q [file_errori]
92 Inizia nella modalità quickFix [correzione veloce].
93 Il file [file_errori] è letto e il primo errore è visualizzato.
94 Se [file_errori] non è indicato, il suo nome è ottenuto dal valore
95 dell'opzione 'errorfile' (che, se non specificata, vale "AztecC.Err"
96 per l'Amiga, "errors.err" su altri sistemi).
97 Si può saltare all'errore successivo col comando ":cn".
98 Vedere ":help quickfix".
99 .PP
100 .B Vim
101 si comporta in modo diverso se invocato con nomi differenti (il programma
102 eseguibile "sottostante" può essere sempre lo stesso).
103 .TP 10
104 vim
105 Modalità "Normal", comportamento normale.
106 .TP
107 ex
108 Inizia in modalità "Ex".
109 Si può passare in modalità "Normal" col comandi ":vi".
110 Si può invocare la modalità "Ex" anche con l'argomento "\-e".
111 .TP
112 view
113 Inizia in modalità "Sola Lettura". Non potete modificare i file.
114 Si può invocare la modalità "Sola Lettura" anche con l'argomento "\-R".
115 .TP
116 gvim gview
117 La versione GUI [Graphical User Interface].
118 Apre una nuova finestra.
119 Si può invocare la modalità "GUI" anche con l'argomento "\-g".
120 .TP
121 evim eview
122 La versione GUI in modalità "Facile" (semplificata).
123 Apre una nuova finestra.
124 Si può invocare la modalità "Facile" anche con l'argomento "\-y".
125 .TP
126 rvim rview rgvim rgview
127 Come sopra, ma con restrizioni ai comandi. Non si potrnno eseguire comandi
128 dello shell o sospendere
129 .B Vim.
130 Si può invocare la modalità "Ristretta" anche con l'argomento "\-Z".
131 .SH OPZIONI
132 Le opzioni possono essere in un ordine qualsiasi, prima o dopo i nomi di
133 file. Opzioni che non necessitano un argomento possono essere raggruppate
134 dietro a un solo "\-".
135 .TP 12
136 +[numero]
137 Per il primo file il cursore sarà posizionato sulla linea "numero".
138 Se "numero" manca, il cursore sarà posizionato sull'ultima linea del file.
139 .TP
140 +/{espressione}
141 Per il primo file il cursore sarà posizionato alla
142 prima occorrenza di {espressione}.
143 Vedere ":help search-pattern" per come specificare l'espressione.
144 .TP
145 +{comando}
146 .TP
147 \-c {comando}
148 {comando} sarà eseguito dopo che il
149 primo file è stato letto.
150 {comando} è interpretato come un comando Ex.
151 Se il {comando} contiene spazi deve essere incluso fra doppi apici
152 (o altro delimitatore, a seconda dello shell che si sta usando).
153 Esempio: Vim "+set si" main.c
154 .br
155 Note: Si possono avere fino a 10 comandi "+" o "\-c".
156 .TP
157 \-S {file}
158 I comandi contenuti in {file} sono eseguiti dopo la lettura del primo file.
159 Equivalente a \-c "source {file}".
160 {file} non può avere un nome che inizia per '\-'.
161 Se {file} è omesso si usa "Session.vim" (funziona solo se \-S è l'ultimo
162 argomento specificato).
163 .TP
164 \-\-cmd {comando}
165 Come "\-c", ma il comando è eseguito PRIMA
166 di eseguire qualsiasi file vimrc.
167 Si possono usare fino a 10 di questi comandi, indipendentemente dai comandi
168 "\-c".
169 .TP
170 \-A
171 Se
172 .B Vim
173 è stato compilato con supporto ARABIC per editare file con orientamento
174 destra-sinistra e tastiera con mappatura Araba, questa opzione inizia
175 .B Vim
176 in modalità "Arabic", cioè impostando 'arabic'.
177 Altrimenti viene dato un messaggio di errore e
178 .B Vim
179 termina in modo anormale.
180 .TP
181 \-b
182 Modalità "Binaria".
183 Vengono impostate alcune opzioni che permettono di modificare un file
184 binario o un programma eseguibile.
185 .TP
186 \-C
187 Compatibile. Imposta l'opzione 'compatible'.
188 In questo modo
189 .B Vim
190 ha quasi lo stesso comportamento di Vi, anche in presenza di un file
191 di configurazione .vimrc [proprio di Vim \- NdT].
192 .TP
193 \-d
194 Inizia in modalità "Diff" [differenze].
195 Dovrebbero esserci come argomenti due o tre nomi di file.
196 .B Vim
197 aprirà tutti i file evidenziando le differenze fra gli stessi.
198 Funziona come vimdiff(1).
199 .TP
200 \-d {dispositivo}
201 Apre {dispositivo} per usarlo come terminale.
202 Solo per l'Amiga.
203 Esempio:
204 "\-d con:20/30/600/150".
205 .TP
206 \-D
207 Debugging. Vim si mette in modalità "debugging" a partire
208 dall'esecuzione del primo comando da uno script.
209 .TP
210 \-e
211 Eseguire
212 .B Vim
213 in modalità "Ex", come se il programma eseguito sia "ex".
214 .TP
215 \-E
216 Eseguire
217 .B Vim
218 in modalità "Ex" migliorata, come se il programma eseguito sia "exim".
219 .TP
220 \-f
221 Direttamente [Foreground]. Per la versione GUI,
222 .B Vim
223 non crea [fork] una nuova finestra, indipendente dallo shell di invocazione.
224 Per l'Amiga,
225 .B Vim
226 non è fatto ripartire per aprire una nuova finestra.
227 Opzione da usare quando
228 .B Vim
229 è eseguito da un programma che attende la fine della
230 sessione di edit (ad es. mail).
231 Sull'Amiga i comandi ":sh" e ":!" non sono disponibili.
232 .TP
233 \-\-nofork
234 Direttamente [Foreground]. Per la versione GUI,
235 .B Vim
236 non crea [fork] una nuova finestra, indipendente dallo shell di invocazione.
237 .TP
238 \-F
239 Se
240 .B Vim
241 è stato compilato con supporto FKMAP per editare file con orientamento
242 destra-sinistra e tastiera con mappatura Farsi, questa opzione inizia
243 .B Vim
244 in modalità "Farsi", cioè impostando 'fkmap' e 'rightleft'.
245 Altrimenti viene dato un messaggio di errore e
246 .B Vim
247 termina in modo anormale.
248 .TP
249 \-g
250 Se
251 .B Vim
252 è stato compilato con supporto GUI, questa opzione chiede di usarla.
253 Se Vim è stato compilato senza supporto GUI viene dato un messaggio di errore e
254 .B Vim
255 termina in modo anormale.
256 .TP
257 \-h
258 Un po' di aiuto su opzioni e argomenti che si possono dare invocando Vim.
259 Subito dopo
260 .B Vim
261 esce.
262 .TP
263 \-H
264 Se
265 .B Vim
266 è stato compilato col supporto RIGHTLEFT per editare file con orientamento
267 destra-sinistra e tastiera con mappatura Ebraica, questa opzione inizia
268 .B Vim
269 in modalità "Ebraica", cioè impostando 'hkmap' e 'rightleft'.
270 Altrimenti viene dato un messaggio di errore e
271 .B Vim
272 termina in modo anormale.
273 .TP
274 \-i {viminfo}
275 Se è abilitato l'uso di un file viminfo, questa opzione indica il nome
276 del file da usare invece di quello predefinito "~/.viminfo".
277 Si può anche evitare l'uso di un file .viminfo, dando come nome "NONE".
278 .TP
279 \-L
280 Equivalente a \-r.
281 .TP
282 \-l
283 Modalità Lisp.
284 Imposta le opzini 'lisp' e 'showmatch'.
285 .TP
286 \-m
287 Inibisce modifica file.
288 Annulla l'opzione 'write'.
289 E' ancora possibile modificare un buffer [in memoria \- Ndt], ma non scriverlo.
290 .TP
291 \-M
292 Modifiche non permesse. Le opzioni 'modifiable' e 'write' sono annullate,
293 in modo da impedire sia modifiche che riscritture. Da notare che queste
294 opzioni possono essere abilitate in seguito, permettendo così modifiche.
295 .TP
296 \-N
297 Modalità "Non-compatibile". Annulla l'opzione 'compatible'.
298 Così
299 .B Vim
300 va un po' meglio, ma è meno compatibile con Vi, anche in assenza di un
301 file .vimrc.
302 .TP
303 \-n
304 Inibisce l'uso di un file di swap.
305 Il recupero dopo una caduta di macchina diventa impossibile.
306 Utile per editare un file su un supporto molto lento (ad es. floppy).
307 Il comando ":set uc=0" ha lo stesso effetto.
308 Per abilitare il recupero usare ":set uc=200".
309 .TP
310 \-nb
311 Diviene un Editor server per NetBeans. Vedere la documentazione per dettagli.
312 .TP
313 \-o[N]
314 Apri N finestre in orizzontale.
315 Se N manca, apri una finestra per ciascun file.
316 .TP
317 \-O[N]
318 Apri N finestre, in verticale.
319 Se N manca, apri una finestra per ciascun file.
320 .TP
321 \-R
322 Modalità "Sola Lettura".
323 Imposta l'opzione 'readonly'.
324 Si può ancora modificare il buffer, ma siete protetti da una riscrittura
325 involontaria.
326 Se volete davvero riscrivere il file, aggiungete un punto esclamativo
327 al comando "Ex", come in ":w!".
328 L'opzione \-R implica anche l'opzione \-n (vedere sotto).
329 L'opzione 'readonly' può essere annullata con ":set noro".
330 Vedere ":help 'readonly'".
331 .TP
332 \-r
333 Lista file di swap, assieme a dati utili per un recupero.
334 .TP
335 \-r {file}
336 Modalità "Recovery".
337 Il file di swap è usato per recuperare una sessione di edit finita male.
338 Il file di swap è un file con lo stesso nome file del file di testo
339 editato, col suffisso ".swp".
340 Vedere ":help recovery".
341 .TP
342 \-s
343 Modalità silenziosa. Solo quando invocato come "Ex" o quando l'opzione
344 "\-e" è stata data prima dell'opzione "\-s".
345 .TP
346 \-s {scriptin}
347 Lo script file {scriptin} è letto.
348 I caratteri nel file sono interpretati come se immessi da voi.
349 Lo stesso si può ottenere col comando ":source! {scriptin}".
350 Se la fine del file di input viene raggiunta prima che Vim termini,
351 l'ulteriore input viene preso dalla tastiera.
352 .TP
353 \-T {terminale}
354 Dice a
355 .B Vim
356 quale tipo di terminale state usando.
357 Utile solo se il terminale non viene riconosciuto correttamente da Vim.
358 Dovrebbe essere un terminale noto a
359 .B Vim
360 (internamente) o definito nel file termcap o terminfo.
361 .TP
362 \-u {vimrc}
363 Usa i comandi nel file {vimrc} per inizializzazioni.
364 Tutte le altre inizializzazioni non sono eseguite.
365 Usate questa opzione per editare qualche file di tipo speciale.
366 Può anche essere usato per non fare alcuna inizializzazione dando
367 come nome "NONE".
368 Vedere ":help initialization" da vim per ulteriori dettagli.
369 .TP
370 \-U {gvimrc}
371 Usa i comandi nel file {gvimrc} per inizializzazioni GUI.
372 Tutte le altre inizializzazioni GUI non sono eseguite.
373 Può anche essere usata per non fare alcuna inizializzazione GUI dando
374 come nome "NONE".
375 Vedere ":help gui-init" da vim per ulteriori dettagli.
376 .TP
377 \-V[N]
378 Verboso. Vim manda messaggi relativi agli script file che esegue
379 e quando legge o scrive un file viminfo. Il numero opzionale N è il valore
380 dell'opzione 'verbose'.
381 Il valore predefinito è 10.
382 .TP
383 \-v
384 Inizia
385 .B Vim
386 in modalità "Vi", come se il programma eseguibile fosse "vi". Questo ha
387 effetto solo quando Vim viene invocato con il nome "ex".
388 .TP
389 \-w {scriptout}
390 Ogni carattere immesso viene registrato nel file {scriptout},
391 finché non uscite da
392 .B Vim.
393 Utile se si vuole creare uno script file da usare con "vim \-s" o
394 ":source!".
395 Se il file {scriptout} esiste, quel che immettete viene aggiunto in fondo.
396 .TP
397 \-W {scriptout}
398 Come \-w, ma uno script file esistente viene sovrascritto.
399 .TP
400 \-x
401 Uso di cifratura nella scrittura dei file. E' necessario immettere
402 una chiave di cifratura.
403 .TP
404 \-X
405 Non connetterti al server X. Vim parte più rapidamente,
406 ma il titolo della finestra e la clipboard non sono disponibili.
407 .TP
408 \-y
409 Eseguire
410 .B Vim
411 in modalità "Facile" (semplificata), come se l'eseguibile invocato
412 sia "evim" o "eview".
413 Fa sì che
414 .B Vim
415 si comporti come un editor che usa solo il mouse e i caratteri.
416 .TP
417 \-Z
418 Modalità "Ristretta". Vim si comporta come se invocato con un nome
419 che inizia per "r".
420 .TP
421 \-\-
422 Specifica la fine delle opzioni.
423 Argomenti specificati dopo questo sono considerati nomi file.
424 Si può usare per editare un file il cui nome inizi per '-'.
425 .TP
426 \-\-echo\-wid
427 Solo con GUI GTK: Visualizza Window ID su "stdout".
428 .TP
429 \-\-help
430 Vim dà un messaggio ed esce, come con l'argomento "-h".
431 .TP
432 \-\-literal
433 Considera i nomi passati come argomenti letterai, senza espandere
434 metacaratteri. Non necessario in Unix, lo shell espande i metacaratteri.
435 .TP
436 \-\-noplugin
437 Non caricare plugin. Implicito se si specifica \-u NONE.
438 .TP
439 \-\-remote
440 Connettersi a un server Vim e chiedere di editare i file elencati come altri
441 argomenti. Se non si trova un server viene dato un messaggio e i file sono
442 editati nel Vim corrente.
443 .TP
444 \-\-remote\-expr {expr}
445 Connettersi a un server Vim, valutare ivi {expr} e stampare il risultatoi
446 su "stdout".
447 .TP
448 \-\-remote\-send {chiavi}
449 Connettersi a un server Vim e spedirgli {chiavi}.
450 .TP
451 \-\-remote\-silent
452 Come \-\-remote, ma senza avvisare se non si trova un server.
453 .TP
454 \-\-remote-wait
455 Come \-\-remote, ma Vim non termina finché i file non sono stati editati.
456 .TP
457 \-\-remote\-wait\-silent
458 Come \-\-remote\-wait, ma senza avvisare se non si trova un server.
459 .TP
460 \-\-serverlist
461 Lista i nomi di tutti i server Vim disponibili.
462 .TP
463 \-\-servername {nome}
464 Usa {nome} come nome server. Usato per il Vim corrente, a meno che sia
465 usato con l'argomento \-\-remote, nel qual caso indica il server a cui
466 connettersi.
467 .TP
468 \-\-socketid {id}
469 Solo con GUI GTK: Usa il meccanismo GtkPlug per eseguire gvim in un'altra
470 finestra.
471 .TP
472 \-\-version
473 Stampa la versione di Vim ed esci.
474 .SH AIUTO ONLINE
475 Battere ":help" in
476 .B Vim
477 per iniziare.
478 Battere ":help argomento" per ricevere aiuto su uno specifico argomento.
479 Per esempio: ":help ZZ" per ricevere aiuto sul comando "ZZ".
480 Usare <Tab> e CTRL\-D per completare gli argomenti
481 (":help cmdline\-completion").
482 Ci sono "tag" nei file di help per saltare da un argomento a un altro
483 (simili a legami ipertestuali, vedere ":help").
484 Tutti i file di documentazione possono essere navigati così. Ad es.:
485 ":help syntax.txt".
486 .SH FILE
487 .TP 15
488 /usr/local/lib/vim/doc/*.txt
489 I file di documentazione di
490 .B Vim
491 .
492 Usate ":help doc\-file\-list" per avere la lista completa.
493 .TP
494 /usr/local/lib/vim/doc/tags
495 Il file di tags usato per trovare informazioni nei file di documentazione.
496 .TP
497 /usr/local/lib/vim/syntax/syntax.vim
498 Inizializzazioni sintattiche a livello di sistema.
499 .TP
500 /usr/local/lib/vim/syntax/*.vim
501 File di colorazione sintattica per vari linguaggi.
502 .TP
503 /usr/local/lib/vim/vimrc
504 Inizializzazioni
505 .B Vim
506 a livello di sistema.
507 .TP
508 ~/.vimrc
509 Le vostre personali inizializzazioni di
510 .B Vim
511 .
512 .TP
513 /usr/local/lib/vim/gvimrc
514 Inizializzazioni gvim a livello di sistema.
515 .TP
516 ~/.gvimrc
517 Le vostre personali inizializzazioni di gvim.
518 .TP
519 /usr/local/lib/vim/optwin.vim
520 Script Vim usato dal comando ":options", un modo semplice
521 per visualizzare e impostare opzioni.
522 .TP
523 /usr/local/lib/vim/menu.vim
524 Inzializzazioni del menu gvim a livello di sistema.
525 .TP
526 /usr/local/lib/vim/bugreport.vim
527 Script Vim per generare una segnalazione di errore. Vedere ":help bugs".
528 .TP
529 /usr/local/lib/vim/filetype.vim
530 Script Vim per determinare il tipo di un file a partire dal suo nome.
531 Vedere ":help 'filetype'".
532 .TP
533 /usr/local/lib/vim/scripts.vim
534 Script Vim per determinare il tipo di un file a partire dal suo contenuto.
535 Vedere ":help 'filetype'".
536 .TP
537 /usr/local/lib/vim/print/*.ps
538 File usati per stampa PostScript.
539 .PP
540 Per informazioni aggiornate [in inglese \- NdT] vedere la home page di Vim:
541 .br
542 <URL:http://www.vim.org/>
543 .SH VEDERE ANCHE
544 vimtutor(1)
545 .SH AUTORE
546 Buona parte di
547 .B Vim
548 è stato scritto da Bram Moolenaar, con molto aiuto da altri.
549 Vedere ":help credits" in
550 .B Vim.
551 .br
552 .B Vim
553 è basato su Stevie, scritto da: Tim Thompson,
554 Tony Andrews e G.R. (Fred) Walter.
555 In verità, poco o nulla è rimasto del loro codice originale.
556 .SH BACHI
557 Probabili.
558 Vedere ":help todo" per una lista di problemi noti.
559 .PP
560 Si noti che un certo numero di comportamenti che possono essere considerati
561 errori da qualcuno, sono in effetti causati da una riproduzione fin troppo
562 fedele del comportamento di Vi.
563 Se ritenete che altre cose siano errori "perché Vi si comporta diversamente",
564 date prima un'occhiata al file vi_diff.txt
565 (o battere :help vi_diff.txt da Vim).
566 Date anche un'occhiata alle opzioni 'compatible' e 'cpoptions.