summaryrefslogtreecommitdiff
path: root/runtime/doc/vim-it.UTF-8.1
blob: f41691df9e78f726f312f4bbd09e256341b4d7a2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
.TH VIM 1 "22 febbraio 2002"
.SH NOME
vim \- VI Migliorato, un editor di testi per programmatori
.SH SINTASSI
.br
.B vim
[opzioni] [file ..]
.br
.B vim
[opzioni] \-
.br
.B vim
[opzioni] \-t tag
.br
.B vim
[opzioni] \-q [file_errori]
.PP
.br
.B ex
.br
.B view
.br
.B gvim
.B gview
.B evim
.B eview
.br
.B rvim
.B rview
.B rgvim
.B rgview
.SH DESCRIZIONE
.B 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.
.PP
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
.B Vim
e Vi.
.PP
Mentre usate
.B Vim
potete ricevere molto aiuto dal sistema di help online, col comando ":help".
Vedere qui sotto la sezione AIUTO ONLINE.
.PP
Quasi sempre
.B Vim
viene invocato, per modificare un file, col comando
.PP
	vim file
.PP
Più in generale
.B Vim
viene invocato con:
.PP
	vim [opzioni] [lista_file]
.PP
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.
.TP 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.
.TP
\-
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].
.TP
\-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".
.TP
\-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".
.PP
.B Vim
si comporta in modo diverso se invocato con nomi differenti (il programma
eseguibile "sottostante" può essere sempre lo stesso).
.TP 10
vim
Modalità "Normal", comportamento normale.
.TP
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".
.TP
view
Inizia in modalità "Sola Lettura".  Non potete modificare i file.
Si può invocare la modalità "Sola Lettura" anche con l'argomento "\-R".
.TP
gvim gview
La versione GUI [Graphical User Interface].
Apre una nuova finestra.
Si può invocare la modalità "GUI" anche con l'argomento "\-g".
.TP
evim eview
La versione GUI in modalità "Facile" (semplificata).
Apre una nuova finestra.
Si può invocare la modalità "Facile" anche con l'argomento "\-y".
.TP
rvim rview rgvim rgview
Come sopra, ma con restrizioni ai comandi.  Non si potrnno eseguire comandi
dello shell o sospendere
.B Vim.
Si può invocare la modalità "Ristretta" anche con l'argomento "\-Z".
.SH OPZIONI
Le opzioni possono essere in un ordine qualsiasi, prima o dopo i nomi di
file.  Opzioni che non necessitano un argomento possono essere raggruppate
dietro a un solo "\-".
.TP 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.
.TP
+/{espressione}
Per il primo file il cursore sarà posizionato alla
prima occorrenza di {espressione}.
Vedere ":help search-pattern" per come specificare l'espressione.
.TP
+{comando}
.TP
\-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
.br
Note: Si possono avere fino a 10 comandi "+" o "\-c".
.TP
\-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).
.TP
\-\-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".
.TP
\-A
Se
.B Vim
è stato compilato con supporto ARABIC per editare file con orientamento
destra-sinistra e tastiera con mappatura Araba, questa opzione inizia
.B Vim
in modalità "Arabic", cioè impostando 'arabic'.
Altrimenti viene dato un messaggio di errore e
.B Vim
termina in modo anormale.
.TP
\-b
Modalità "Binaria".
Vengono impostate alcune opzioni che permettono di modificare un file
binario o un programma eseguibile.
.TP
\-C
Compatibile.  Imposta l'opzione 'compatible'.
In questo modo
.B Vim
ha quasi lo stesso comportamento di Vi, anche in presenza di un file
di configurazione .vimrc [proprio di Vim \- NdT].
.TP
\-d
Inizia in modalità "Diff" [differenze].
Dovrebbero esserci come argomenti due o tre nomi di file.
.B Vim
aprirà tutti i file evidenziando le differenze fra gli stessi.
Funziona come vimdiff(1).
.TP
\-d {dispositivo}
Apre {dispositivo} per usarlo come terminale.
Solo per l'Amiga.
Esempio:
"\-d con:20/30/600/150".
.TP
\-D
Debugging.  Vim si mette in modalità "debugging" a partire
dall'esecuzione del primo comando da uno script.
.TP
\-e
Eseguire
.B Vim
in modalità "Ex", come se il programma eseguito sia "ex".
.TP
\-E
Eseguire
.B Vim
in modalità "Ex" migliorata, come se il programma eseguito sia "exim".
.TP
\-f
Direttamente [Foreground].  Per la versione GUI,
.B Vim
non crea [fork] una nuova finestra, indipendente dallo shell di invocazione.
Per l'Amiga,
.B Vim
non è fatto ripartire per aprire una nuova finestra.
Opzione da usare quando
.B 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.
.TP
\-\-nofork
Direttamente [Foreground].  Per la versione GUI,
.B Vim
non crea [fork] una nuova finestra, indipendente dallo shell di invocazione.
.TP
\-F
Se
.B Vim
è stato compilato con supporto FKMAP per editare file con orientamento
destra-sinistra e tastiera con mappatura Farsi, questa opzione inizia
.B Vim
in modalità "Farsi", cioè impostando 'fkmap' e 'rightleft'.
Altrimenti viene dato un messaggio di errore e
.B Vim
termina in modo anormale.
.TP
\-g
Se
.B 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
.B Vim
termina in modo anormale.
.TP
\-h
Un po' di aiuto su opzioni e argomenti che si possono dare invocando Vim.
Subito dopo
.B Vim
esce.
.TP
\-H
Se
.B Vim
è stato compilato col supporto RIGHTLEFT per editare file con orientamento
destra-sinistra e tastiera con mappatura Ebraica, questa opzione inizia
.B Vim
in modalità "Ebraica", cioè impostando 'hkmap' e 'rightleft'.
Altrimenti viene dato un messaggio di errore e
.B Vim
termina in modo anormale.
.TP
\-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".
.TP
\-L
Equivalente a \-r.
.TP
\-l
Modalità Lisp.
Imposta le opzini 'lisp' e 'showmatch'.
.TP
\-m
Inibisce modifica file.
Annulla l'opzione 'write'.
E' ancora possibile modificare un buffer [in memoria \- Ndt], ma non scriverlo.
.TP
\-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.
.TP
\-N
Modalità "Non-compatibile".  Annulla l'opzione 'compatible'.
Così
.B Vim
va un po' meglio, ma è meno compatibile con Vi, anche in assenza di un
file .vimrc.
.TP
\-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".
.TP
\-nb
Diviene un Editor server per NetBeans.  Vedere la documentazione per dettagli.
.TP
\-o[N]
Apri N finestre in orizzontale.
Se N manca, apri una finestra per ciascun file.
.TP
\-O[N]
Apri N finestre, in verticale.
Se N manca, apri una finestra per ciascun file.
.TP
\-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'".
.TP
\-r
Lista file di swap, assieme a dati utili per un recupero.
.TP
\-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".
.TP
\-s
Modalità silenziosa.  Solo quando invocato come "Ex" o quando l'opzione
"\-e" è stata data prima dell'opzione "\-s".
.TP
\-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.
.TP
\-T {terminale}
Dice a
.B Vim
quale tipo di terminale state usando.
Utile solo se il terminale non viene riconosciuto correttamente da Vim.
Dovrebbe essere un terminale noto a
.B Vim
(internamente) o definito nel file termcap o terminfo.
.TP
\-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.
.TP
\-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.
.TP
\-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.
.TP
\-v
Inizia
.B Vim
in modalità "Vi", come se il programma eseguibile fosse "vi".  Questo ha
effetto solo quando Vim viene invocato con il nome "ex".
.TP
\-w {scriptout}
Ogni carattere immesso viene registrato nel file {scriptout},
finché non uscite da
.B 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.
.TP
\-W {scriptout}
Come \-w, ma uno script file esistente viene sovrascritto.
.TP
\-x
Uso di cifratura nella scrittura dei file.  E' necessario immettere
una chiave di cifratura.
.TP
\-X
Non connetterti al server X.  Vim parte più rapidamente,
ma il titolo della finestra e la clipboard non sono disponibili.
.TP
\-y
Eseguire
.B Vim
in modalità "Facile" (semplificata), come se l'eseguibile invocato
sia "evim" o "eview".
Fa sì che
.B Vim
si comporti come un editor che usa solo il mouse e i caratteri.
.TP
\-Z
Modalità "Ristretta".  Vim si comporta come se invocato con un nome
che inizia per "r".
.TP
\-\-
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 '-'.
.TP
\-\-echo\-wid
Solo con GUI GTK: Visualizza Window ID su "stdout".
.TP
\-\-help
Vim dà un messaggio ed esce, come con l'argomento "-h".
.TP
\-\-literal
Considera i nomi passati come argomenti letterai, senza espandere
metacaratteri.  Non necessario in Unix, lo shell espande i metacaratteri.
.TP
\-\-noplugin
Non caricare plugin.  Implicito se si specifica \-u NONE.
.TP
\-\-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.
.TP
\-\-remote\-expr {expr}
Connettersi a un server Vim, valutare ivi {expr} e stampare il risultatoi
su "stdout".
.TP
\-\-remote\-send {chiavi}
Connettersi a un server Vim e spedirgli {chiavi}.
.TP
\-\-remote\-silent
Come \-\-remote, ma senza avvisare se non si trova un server.
.TP
\-\-remote-wait
Come \-\-remote, ma Vim non termina finché i file non sono stati editati.
.TP
\-\-remote\-wait\-silent
Come \-\-remote\-wait, ma senza avvisare se non si trova un server.
.TP
\-\-serverlist
Lista i nomi di tutti i server Vim disponibili.
.TP
\-\-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.
.TP
\-\-socketid {id}
Solo con GUI GTK: Usa il meccanismo GtkPlug per eseguire gvim in un'altra
finestra.
.TP
\-\-version
Stampa la versione di Vim ed esci.
.SH AIUTO ONLINE
Battere ":help" in
.B 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 saltare 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".
.SH FILE
.TP 15
/usr/local/lib/vim/doc/*.txt
I file di documentazione di
.B Vim
.
Usate ":help doc\-file\-list" per avere la lista completa.
.TP
/usr/local/lib/vim/doc/tags
Il file di tags usato per trovare informazioni nei file di documentazione.
.TP
/usr/local/lib/vim/syntax/syntax.vim
Inizializzazioni sintattiche a livello di sistema.
.TP
/usr/local/lib/vim/syntax/*.vim
File di colorazione sintattica per vari linguaggi.
.TP
/usr/local/lib/vim/vimrc
Inizializzazioni
.B Vim
a livello di sistema.
.TP
~/.vimrc
Le vostre personali inizializzazioni di
.B Vim
.
.TP
/usr/local/lib/vim/gvimrc
Inizializzazioni gvim a livello di sistema.
.TP
~/.gvimrc
Le vostre personali inizializzazioni di gvim.
.TP
/usr/local/lib/vim/optwin.vim
Script Vim usato dal comando ":options", un modo semplice
per visualizzare e impostare opzioni.
.TP
/usr/local/lib/vim/menu.vim
Inzializzazioni del menu gvim a livello di sistema.
.TP
/usr/local/lib/vim/bugreport.vim
Script Vim per generare una segnalazione di errore.  Vedere ":help bugs".
.TP
/usr/local/lib/vim/filetype.vim
Script Vim per determinare il tipo di un file a partire dal suo nome.
Vedere ":help 'filetype'".
.TP
/usr/local/lib/vim/scripts.vim
Script Vim per determinare il tipo di un file a partire dal suo contenuto.
Vedere ":help 'filetype'".
.TP
/usr/local/lib/vim/*.ps
File usati per stampa PostScript.
.PP
Per informazioni aggiornate [in inglese \- NdT] vedere la home page di Vim:
.br
<URL:http://www.vim.org/>
.SH VEDERE ANCHE
vimtutor(1)
.SH AUTORE
Buona parte di
.B Vim
è stato scritto da Bram Moolenaar, con molto aiuto da altri.
Vedere ":help credits" in
.B Vim.
.br
.B 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.
.SH BACHI
Probabili.
Vedere ":help todo" per una lista di problemi noti.
.PP
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.