*** empty log message ***
[midnight-commander.git] / doc / it / mc.1.in
blobe11e89f6dd875932075eec774398289fdff2ec37
1 .\" Tradotto dal 15 agosto 2002 da
2 .\"     Marco Ciampa <ciampix@libero.it>
3 .\" Chi vuole contribuire si aggiunga il nome qui sotto.
4 .\"
5 .TH mc 1 "30 Ottobre 1998"
6 .\"SKIP_SECTION"
7 .SH "NOME"
8 mc \- interfaccia visuale per sistemi tipo Unix.
9 .\"SKIP_SECTION"
10 .SH "USO"
11 .B mc
12 [\-abcCdfhPstuUVx?] [\-l log] [dir1 [dir2]] [-v file]
13 .\"NODE "DESCRIPTION"
14 .SH "DESCRIZIONE"
15 .LP
16 Il Midnight Commander è un file manager per sistemi operativi di tipo Unix.  
17 .\".\"DONT_SPLIT"
18 .\"NODE "OPTIONS"
19 .SH "OPZIONI"
20 .TP
21 .I "\-a"
22 Disabilita l'uso dei caratteri grafici per il disegno delle linee.
23 .TP
24 .I "\-b"
25 Forza la visualizzazione in bianco e nero.
26 .TP
27 .I "\-c"
28 Forza la modalità colore, prego vedere la sezione 
29 .\"LINK2"
30 Colori
31 .\"Colors"
32 per informazioni aggiuntive.
33 .TP
34 .I "\-C arg"
35 Usato per specificare un set di colori differente a riga di comando.
36 Il formato di arg è documentato nella sezione
37 .\"LINK2"
38 Colori
39 .\"Colors"
40 \&.
41 .TP
42 .I "\-d"
43 Disabilita il supporto mouse.
44 .TP
45 .I "\-f"
46 Mostra i percorsi di ricerca compilati per i file del Midnight Commander.
47 .TP
48 .I "\-k"
49 Reimposta i softkeys ai valori predefiniti dal database termcap/terminfo.
50 Utile solo su terminali HP quando non vanno i tasti funzione.
51 .TP
52 .I "-l file" 
53 Salva il dialogo ftpfs con il server in file.
54 .TP
55 .I "\-P"
56 All'uscita, il Midnight Commander stampa l'ultima directory in uso.
57 Questa funzione non è fatta per un uso diretto, ma dovrebbe essere 
58 utilizzata da una speciale funzione shell che imposti automaticamente 
59 l'ultima directory corrente della shell come l'ultima directory in cui
60 stava il Midnight Commander (grazie a Torben Fjerdingstad e Sergey per
61 il contributo di questa funzione e per il codice che la implementa).
62 Prelevate i file
63 .B @prefix@/lib/mc/bin/mc.sh
64 (utenti bash e zsh) e rispettivamente
65 .B @prefix@/lib/mc/bin/mc.csh
66 (utenti tcsh) per avere questa funzione definita.
67 .TP
68 .I "\-s"
69 Abilita il modo terminale lento, in questa modalità il programma
70 non disegna le linee e disabilita la modalità prolissa.
71 .TP
72 .I "\-t"
73 Usata solo se il codice è stato compilato con Slang e terminfo: fa
74 in modo che il Midnight Commander usi il valore della variabile
75 .B TERMCAP
76 per le informazioni sul terminale invece delle informazioni di sistema
77 sul database terminali.
78 .TP
79 .I "\-u"
80 Disabilita l'uso della shell concorrente (ha senso solo se il
81 Midnight Commander è stato compilato con il supporto per la shell
82 concorrente).
83 .TP
84 .I "\-U"
85 Abilita l'uso della shell concorrente (ha senso solo se il
86 Midnight Commander è stato compilato con il supporto per la shell
87 concorrente impostato come una caratteristica opzionale).
88 .TP
89 .I "\-v file"
90 Lancia il visualizzatore interno per il file specificato.
91 .TP
92 .I "\-V"
93 Mostra la versione del programma.
94 .TP
95 .I "\-x"
96 Forza la modalità xterm. Usata quando è in funzione su terminali
97 abilitati-xterm (due modalità video e in grado di spedire sequenze
98 mouse di escape).
99 .PP
100 Se specificato, il primo percorso è la directory mostrata nel
101 pannello selezionato; il secondo è la directory mostrata nell'altro
102 pannello.
104 .\"NODE "Overview"
105 .SH "Panoramica"
106 Lo schermo del Midnight Commander è diviso in quattro parti.
107 Quasi tutto lo spazio è occupato dai due pannelli directory.
108 Per default, la seconda linea dal fondo è la riga di comando, 
109 mentre quella in basso mostra le etichette dei tasti funzione.
110 La riga più in alto è la
111 .\"LINK2"
112 riga dei menu.
113 .\"Menu Bar"
114 La barra dei menu può essere invisibile, ma compare se clicchi la
115 riga più in alto con il mouse o se premi il tasto F9.
117 Il Midnight Commander fornisce la vista di due directory 
118 contemporaneamente. Uno dei due pannelli è quello corrente (la barra
119 di selezione è presente solo in questo). Quasi tutte le operazioni
120 hanno lougo nel pannello corrente. Alcune azioni come Rinomina e 
121 Copia usano la directory del pannello non selezionato come valore
122 predefinito di destinazione (ma si richiede sempre una conferma prima).
123 Per informazioni aggiuntive, vedere le sezioni sui 
124 .\"LINK2"
125 Pannelli Directory,
126 .\"Directory Panels"
128 .\"LINK2"
129 Menu Sinistro e Destro
130 .\"Left and Right Menus"
132 .\"LINK2"
133 Menu File.
134 .\"File Menu"
136 E' possibile eseguire comandi di sistema dal Midnight Commander 
137 semplicemente battendoli. Ogni cosa scritta apparirà sulla linea di 
138 comando e quando si preme l'invio il Midnight Commander eseguirà la
139 riga di comando appena battuta; leggere le sezioni
140 .\"LINK2"
141 Shell a Riga di Comando
142 .\"Shell Command Line"
144 .\"LINK2"
145 Tasti di Ingresso
146 .\"Input Line Keys"
147 per saperne di più sulla riga di comando.
149 .\"NODE "Mouse Support"
150 .SH "Supporto Mouse"
151 Il Midnight Commander è fornito di supporto mouse. Esso viene
152 attivato ogniqualvolta lo si esegue in un terminale
153 .B xterm(1)
154 (funziona anche se si fa una connessione telnet o rlogin con
155 un'altra macchina da un xterm) o se sta funzionando su una console Linux
156 e si ha il mouse server
157 .B gpm
158 in funzione.
160 Quando si fa click con il tasto sinistro in un file nel pannello
161 directory, il file viene selezionato; se si fa click con il tasto destro
162 il file viene marcato (o smarcato, a seconda dello stato precedente).
164 Se il file è un programma eseguibile, il doppio click su di esso lo eseguirà 
165 altrimenti se il
166 .\"LINK2"
167 file estensioni
168 .\"Extension File Edit"
169 ha un programma specifico per quell'estensione del file, il suddetto programma
170 verrà eseguito.
172 E' anche possibile eseguire i comandi assegnati ai tasti funzione 
173 cliccando sulle etichette dei tasti.
175 Se un tasto del mouse viene premuto sulla linea in cima al pannello directory
176 il pannello sfoglia di una pagina in alto. Allo stesso modo, un click sulla 
177 riga in basso provocherà un cambio di pagina in basso. Questo metodo dei bordi
178 funziona anche nel
179 .\"LINK2"
180 Visualizzatore dell'Aiuto
181 .\"Contents"
182 e nal 
183 .\"LINK2"
184 Albero Directory.
185 .\"Directory Tree"
187 L'auto ripetizione predefinita per il mouse è di 400 millisecondi. Questa
188 può essere cambiata in valori differenti modificando il file
189 .\"LINK2"
190 \&~/.mc/ini
191 .\"Save Setup"
192 e cambiando il parametro
193 .I mouse_repeat_rate
196 Se il Commander sta funzionando con il supporto mouse, si può saltarlo
197 ed ottenere il funzionamento del mouse normale (taglia e incolla di testo)
198 tenendo premuto il tasto Maiuscolo.
199 .SH ""
200 .\"NODE "Keys"
201 .SH "Tasti"
202 Alcuni comandi nel Midnight Commander presuppongono l'uso dei tasti
203 .I Control
204 (talvolta chiamato CTRL o CTL) e  
205 .I Meta
206 (talvolta chiamato ALT o anche Compose). In questo manuale si utilizzeranno
207 le seguenti abbreviazioni:
209 C-<chr> significa premere il tasto control mentre si batte il carattere
210 <chr>. Perciò C-f sarà: premi e tieni premuto il tasto Control e premi f.
212 M-<chr> significa premere il tasto Meta o Alt mentre si batte <chr>. Se
213 non c'è un tasto Meta o Alt, premere ESC, rilasciarlo, poi premere il
214 carattere <chr>. 
216 Tutte le linee di ingresso nel Midnight Commander usano un'approssimazione
217 dei tasti del GNU Emacs.
219 Ci sono molte sezioni che parlano dei tasti. Le seguenti sono le 
220 principali.
222 La sezione
223 .\"LINK2"
224 Menu File
225 .\"File Menu"
226 documenta le abbreviazioni di tasti per i comandi che appaiono nel
227 menu File. Questa sezione include i tasti funzione. Molti di questi comandi
228 lavorano sui file selezionati o sui marcati.
230 La sezione
231 .\"LINK2"
232 Pannelli Directory
233 .\"Directory Panels"
234 documenta i tasti che selezionano o marcano i file come obiettivo
235 per una seguente azione (l'azione normalmente deriva dal menu file).
237 La sezione
238 .\"LINK2"
239 Shell a Riga di Comando
240 .\"Shell Command Line"
241 elenca i tasti utilizzati per immettere e modificare linee di comando.
242 Molti di questi copiano nomi di file o altro dal pannello directory
243 alla riga di comando (per evitare troppo lavoro di battitura) o per
244 accedere allo storico comandi.
247 .\"LINK2"
248 Tasti Linea di Ingresso
249 .\"Input Line Keys"
250 sono usati per modificare le linee di ingresso. Cioè sia la linea di comando
251 che le linee di ingresso nelle finestre di interrogazione.
253 .\"NODE "  Miscellaneous Keys"
254 .SH "  Tasti Vari"
255 Qua ci sono alcuni tasti che non sono classificabili in nessuna delle
256 altre categorie:
258 .B Invio.
259 Se c'è del testo nella linea di comando (quella in fondo ai pannelli),
260 allora quel comando viene eseguito. Se non c'è testo nella linea di
261 comando allora se la barra di selezione è sopra una directory il
262 Midnight Commander esegue un
263 .B chdir(2)
264 alla directory selezionata e ricarica le informazioni sul pannello;
265 se la selezione è un file eseguibile allora esso viene eseguito.
266 Per ultimo, se l'estensione del file selezionato corrisponde ad una
267 delle estensioni presenti nel
268 .\"LINK2"
269 file estensioni,
270 .\"Extension File Edit"
271 il comando corrispondente viene eseguito.
273 .B C-l.
274 Ridisegna tutto nel Midnight Commander.
276 .B C-x c.
277 Esegue il comando
278 .\"LINK2"
279 Chmod
280 .\"Chmod"
281 su un file o su un gruppo di file marcati.
283 .B C-x o.
284 Esegue il comando
285 .\"LINK2"
286 Chown
287 .\"Chown"
288 sul file corrente o sui file marcati.
290 .B C-x l.
291 Crea un collegamento.
293 .B C-x s.
294 Crea un collegamento simbolico .
296 .B C-x i.
297 Imposta la modalità della visualizzazione dell'altro pannello a informazioni.
299 .B C-x q.
300 Imposta la modalità della visualizzazione dell'altro pannello a vista rapida.
302 .B C-x !.
303 Esegue il comando
304 .\"LINK2"
305 Pannellizza comando
306 .\"External panelize"
309 .B C-x h
310 Esegue il comando
311 .\"LINK2"
312 aggiungi directory alla lista directory favorite
313 .\"Hotlist"
316 .B M-!,
317 Esegue il comando Vista filtrata, descritto in
318 .\"LINK2"
319 Vista filtrata.
320 .\"Internal File Viewer"
322 .B M-?,
323 Esegui il comando
324 .\"LINK2"
325 Trova file
326 .\"Find File"
329 .B M-c,
330 Mostra la finestra
331 .\"LINK2"
332 cambia dir veloce
333 .\"Quick cd"
336 .B C-o,
337 Quando il programma viene eseguito in una console Linux o SCO o in un xterm,
338 mostrerà il risultato del comando precedente. Eseguito in console Linux, il
339 Midnight Commander usa un programma esterno (cons.saver) per gestire il
340 salvataggio e recupero delle informazioni sullo schermo.
342 Se è stato compilato il supporto alla subsell, è possibile premere C-o
343 in ogni momento per tornare alla schermata principale del Midnight Commander;
344 per tornare all'applicazione basta premere C-o. Se si ha un'applicazione
345 sospesa usando questo trucco, non si sarà in grado di eseguire altri
346 programmi dal Midnight Commander finchè non si terminerà l'applicazione
347 sospesa.
349 .\"NODE "  Directory Panels"
350 .SH "  Pannelli Directory"
351 Questa sezione elenca i tasti che operano sui pannelli directory. 
352 Se si desidera sapere come cambiare la visualizzazione dei pannelli,
353 date un'occhiata alla sezione su
354 .\"LINK2"
355 Menu Sinistro e Destro.
356 .\"Left and Right Menus"
358 .B Tab, C-i.
359 Cambia il pannello corrente. L'altro pannello diventa il nuovo pannello 
360 corrente mentre il pannello corrente diventa l'altro pannello.
361 La barra di selezione si sposta dal vecchio pannello al nuovo corrente.
363 .B Insert, C-t.
364 Per marcare i file si può usare il tasto di Inserimento (la sequenza
365 teminfo kich1) o la sequenza C-t (Control-t). Per smarcare i file
366 basta marcare un file già marcato.
368 .B M-g, M-h (o M-r), M-j.
369 Usato per selezionare rispettivamente il file superiore, il file centrale o 
370 quello inferiore in un pannello.
372 .B C-s, M-s.
373 Inizia una ricerca nel nella directory. Quando la ricerca è attiva
374 i dati immessi dall'utente vengono aggiunti alla stringa di ricerca
375 invece della riga di comando. Se l'opzione
376 .I "Mostra mini-stato"
377 è abilitata, la stringa di ricerca viene mostrata nella riga di
378 mini-stato. Scrivendo, la barra di selezione si muove al prossimo
379 file che comincia con le lettere battute. Il tasti
380 .I "backspace"
382 .I canc 
383 possono essere utilizzati per correggere errori di battitura. Se viene premuto
384 nuovamente, viene ricercata la corrispondenza seguente.
386 .B M-t
387 Cambia il modo di visualizzazione corrente per mostrare la modalità
388 successiva. In questo modo è possibile cambiare velocemente da listati
389 lunghi a listati normali a listati definiti dall'utente.
391 .B C-\\\\ (control-barra retroversa).
392 Mostra le
393 .\"LINK2"
394 directory favorite
395 .\"Hotlist"
396 e va alla directory selezionata.
398 .B + \ (più).
399 Viene utilizzato per selezionare (marcare) un gruppo di file. Il Midnight 
400 Commander richiederà un'espressione regolare per descrivere il gruppo.
401 Quando i 
402 .I modelli della shell
403 sono abilitati, le espressioni regolari sono molto simili alle espressioni
404 regolari in una shell (* significa zero o più caratteri e ? un carattere). Se
406 .I modelli della shell 
407 sono disabilitati, la marcatura dei file viene fatta con le normali espressioni
408 regolari (vedere (1)).
410 Se l'espressione comincia o finisce con una barra (/), allora selezionerà
411 directory invece che file.
413 .B \\\\ (barra retroversa).
414 Usare il tasto "\\" per deselezionare un gruppo di file. Questo è l'opposto
415 del tasto più.
417 .B freccia-su, C-p.
418 Sposta la barra di selezione alla voce precedente nel pannello.
420 .B freccia-giùy, C-n.
421 Sposta barra di selezione alla voce successiva nel pannello.
423 .B home, a1, M-<.
424 Sposta la barra di selezione alla prima voce nel pannello.
426 .B fine, c1, M->.
427 Sposta la barra di selezione all'ultima voce nel pannello.
429 .B pagina-giù, C-v.
430 Sposta la barra di selezione di una pagina in basso.
432 .B pagina-su, M-v.
433 Sposta la barra di selezione di una pagina in alto.
435 .B M-o,
436 If the other panel is a listing panel and you are standing on a
437 directory in the current panel, then the other panel contents are set
438 to the contents of the currently selected directory (like Emacs' dired
439 C-o key) otherwise the other panel contents are set to the parent dir
440 of the current dir.
442 .B C-PageUp, C-PageDown
443 Only when ran on the Linux console: does a chdir to ".." and to the
444 currently selected directory respectively.
446 .B M-y
447 Moves to the previous directory in the history, equivalent 
448 to depressing the '<' with the mouse.
450 .B M-u
451 Moves to the next directory in the history, equivalent 
452 to depressing the '>' with the mouse.
454 .B M-S-h, M-H
455 Displays the directory history, equivalent to depressing the 'v' with
456 the mouse.
458 .\"NODE "  Shell a Riga di Comando"
459 .SH "  Shell a riga di comando"
460 Questa sezione elenca i tasti utili ad evitare troppe battiture
461 nell'immissione dei comandi.
463 .B M-Invio.
464 Copia nella riga di comando il nome del file attualmente selezionato.
466 .B C-Invio.
467 Come M-Invio, ma funziona solo dalla console Linux.
469 .B M-Tab.
470 Esegue automaticamente il 
471 .\"LINK2"
472 completamento
473 .\"Completion"
474 del nome del file, variabile, nome utente e nome host.
476 .B C-x t, C-x C-t.
477 Copia i file marcati (o se non vi sono file marcati, il file selezionato)
478 del pannello corrente (C-x t) o dell'altro pannello (C-x C-t) sulla
479 riga di comando.
481 .B C-x p, C-x C-p.
482 La prima sequenza di tasti copia il percorso corrente sulla riga di comando
483 e la seconda copia il percorso del pannello non selezionato sulla riga
484 di comando.
486 .B C-q.
487 Il comando di inserimento letterale serve per inserire caratteri che 
488 sarebbero altrimenti interpretati dal Midnight Commander (come il simbolo '+')
490 .B M-p, M-n.
491 Use these keys to browse through the command history. M-p takes you
492 to the last entry, M-n takes you to the next one.
494 .B M-h.
495 Displays the history for the current input line. 
497 .\"NODE "  General Movement Keys"
498 .SH "  Tasti Generali di Movimento"
499 Il visualizzatore dell'aiuto, il visualizzato dei file e l'albero directory
500 usano un codice comune per gestire il movimento. Per questa ragione essi
501 accettano esattamente gli stessi tasti. Ogniuno di questi però accetta anche
502 altri tasti indipendenti.
504 Altre parti del Midnight Commander usano alcuni degli stessi tasti di
505 movimento, perciò questa sezione può applicarsi anche a quelle sezioni.
507 .B Su, C-p.
508 Si sposta di una linea indietro.
510 .B Giu, C-n.
511 Si sposta di una linea avanti.
513 .B Pagina Su, M-v.
514 Si sposta di una pagina in alto.
516 .B Pagina Giu, C-v.
517 Si sposta di una pagina in basso.
519 .B Home, A1.
520 Si sposta all'inizio.
522 .B Fine, C1.
523 Si sposta alla fine.
525 Il visualizzatore dell'aiuto accetta i seguenti tasti in aggiunta a quelli
526 menzionati sopra:
528 .B b, C-b, C-h, Backspace, Canc.
529 Si sposta di una pagina in alto.
531 .B Barra spaziatrice.
532 Si sposta di una pagina in basso.
534 .B u, d.
535 Si sposta di mezza pagina in alto o in basso.
537 .B g, G.
538 Si sposta all'inizio o alla fine.
540 .\"NODE "  Input Line Keys"
541 .SH "  Tasti di Riga di Ingresso"
542 I tasti di riga di ingresso (sono usati
543 per la
544 .\"LINK2"
545 riga di comando
546 .\"Shell Command Line"
547 e per i dialoghi di richiesta dati nel programma) accettano
548 questi tasti:
550 .B C-a
551 sposta il cursore all'inizio della linea.
553 .B C-e
554 sposta il cursore alla fine della linea
556 .B C-b, move-left
557 sposta il cursore di una posizione a sinistra.
559 .B C-f, move-right
560 sposta il cursore di una posizione a destra.
562 .B M-f
563 sposta il cursore di una parola in avanti.
565 .B M-b
566 sposta il cursore di una parola indietro.
568 .B C-h, backspace
569 cancella il carattere precedente.
571 .B C-d, Delete
572 cancella il carattere nel punto (sopra il cursore).
574 .B C-@
575 imposta il marcatore per tagliare.
577 .B C-w
578 copia il testo tra il cursore e il marcatore in un kill buffer 
579 e rimuove il testo dalla linea di ingresso.
581 .B M-w
582 copia il testo tra il cursore ed il marcatore in un kill buffer.
584 .B C-y
585 inserisce il contenuto del kill buffer.
587 .B C-k
588 elimina il testo dal cursore alla fine della linea.
590 .B M-p, M-n
591 Usa questi tasti per navigare attraverso lo storico dei comandi. M-p 
592 posiziona sull'ultima voce, M-n posiziona sulla seguente.
594 .B M-C-h, M-Backspace
595 cancella una parola indietro.
597 .B M-Tab
598 fa del nomefile, comando, variabile, nomeutente e nomehost il
599 .\"LINK2"
600 completamento
601 .\"Completion"
602 automatico.
604 .SH ""
605 .\"NODE "Menu Bar"
606 .SH "Barra dei Menu"
607 La barra dei menu compare premendo F9 o cliccando con il mouse sopra la riga
608 superiore dello schermo. La barra menu possiede cinque menu: "Sinistra", "File",
609 "Comando", "Opzioni" e "Destra".
612 .\"LINK2"
613 Menu Sinistra e Destra
614 .\"Left and Right Menus"
615 permettono di modificare l'apparenza dei pannelli directory di sinistra
616 e di destra.
619 .\"LINK2"
620 Menu File
621 .\"File Menu"
622 elenca le azioni che possono essere condotte sui file correntemente selezionati 
623 o marcati.
626 .\"LINK2"
627 Menu Comando 
628 .\"Command Menu"
629 elenca le azioni più generali e non ha relazione con il file correntemente
630 selezionati o marcati.
633 .\"LINK2"
634 Menu Opzioni
635 .\"Options Menu"
636 elenca le azioni che permettono di personalizzare il Midnight Commander.
638 .\"NODE "  Left and Right Menus"
639 .SH "  Menu Sinistra e Destra"
640 L'apparenza dei pannelli directory è modificabile tramite i menu
641 .B "Sinistra"
643 .B "Destra"
646 .\"NODE ""    Listing Mode..."
647 .SH "    Modalità Lista..."
648 La modalità lista serve a mostrare un elenco di file; ci sono quattro
649 modalità elenco disponibili:
650 .B Completa,
651 .B Breve,
652 .B Lunga
654 .B Definita dall'utente.
655 La modalità completa mostra il nome del file, l'ampiezza del file e
656 la data di modifica.
658 La modalità breve mostra solo il nome del file in due colonne
659 (perciò mostrando il doppio del numero dei file che nelle altre
660 modalità). La modalità lunga è simile a quella del comando 
661 .B "ls -l"
662 \&. La modalità lunga usa tutta l'ampiezza dello schermo.
664 Se si sceglie il formato definibile dall'utente, è necessario specificare 
665 il formato della vista.
667 Il formato definibile dall'utente deve cominciare con una specifica 
668 dell'ampiezza del pannello. Questa può essere "half" o "full", che descrive
669 un pannello di mezza grandezza o completa rispettivamente.
671 Dopo l'ampiezza del pannello, è possibile specificare la modalità a
672 due colonne aggiungendo il numero "2" alla stringa di formato.
674 Dopodichè si aggiunge il nome dei campi con una specifica di ampiezza
675 opzionale. Questi sono i campi disponibile per la visualizzazione:
677 .B name,
678 mostra il nome del file.
680 .B size,
681 mostra l'ampiezza del file.
683 .B bsize,
684 è una forma alternativa del formato
685 .B size
686 \&. Mostra l'ampiezza del file e per le directory mostra solo 
687 SUB-DIR o UP--DIR.
689 .B type,
690 mostra un campo di un carattere. Questo carattere è simile a quello
691 mostrato dal comando ls con la flag -F -
692 .B *
693 per i file eseguibili,
694 .B /
695 per le directory,
696 .B @
697 per i collegamenti,
698 .B =
699 per i socket,
700 .B -
701 per i dispositivi a carattere,
702 .B +
703 per i dispositivi a blocchi,
704 .B |
705 per le pipe,
706 .B ~
707 per i collegamenti simbolici a directory e 
708 .B !
709 per i collegamenti simbolici stallati (che non puntano a niente).
711 .B mtime,
712 la data dell'ultima modifica al file.
714 .B atime,
715 la data dell'ultimo accesso al file.
717 .B ctime,
718 la data della creazione del file.
720 .B perm,
721 una stringa che rappresenta i bit dei permessi del file.
723 .B mode,
724 un valore ottale con i permessi correnti del file.
726 .B nlink,
727 il numero dei collegamenti al file.
729 .B ngid,
730 il GID (numerico).
732 .B nuid,
733 l'UID (numerico).
735 .B owner,
736 il proprietario del file.
738 .B group,
739 il gruppo del file.
741 .B inode,
742 l'inode del file.
744 Puoi usare ache questi campi per sistemare la visualizzazione:
746 .B space,
747 uno spazio nel formato visualizzazione.
749 .B mark,
750 Un asterico se il file è marcato, uno spazio se non lo è.
752 .B |,
753 Questo carattere viene utilizzato per aggiungere una linea verticale
754 al formato di visualizzazione.
756 Per forzare un campo ad un'ampiezza fissa (una specifica di ampiezza)
757 basta semplicemente aggiungere un ':' ed il numero dei caratteri che
758 si vuole che il campo abbia; e se il numero è seguito dal simbolo '+',
759 allora la specifica definisce l'ampiezza minima e se il programma
760 trova che serve più spazio sullo schermo, espanderà il campo.
762 Per esempio la modalità 
763 .B Completa
764 corrisponde a questo formato:
766 half type,name,|,size,|,mtime
768 E quella
769 .B Lunga
770 corrisponde a questo formato:
772 full perm,space,nlink,space,owner,space,group,space,size,space,
773 mtime,space,name
775 Questa è una modalità interessante:
777 half name,|,size:7,|,type,mode:3
779 I pannelli possono anche essere impostati alle modalità seguenti:
781 .B "Informazioni"
782 La modalità informazioni mostra alcuni dati relativi al file correntemente selezionato
783 e se possibile informazioni circa il file system corrente.
785 .B "Albero" 
786 La vista ad albero è abbastanza simile al comando
787 .\"LINK2"
788 albero directory
789 .\"Directory Tree"
790 \&. Vedere la sezione corrispondente per maggiori informazioni.
791 .TP 
792 .B "Vista rapida"
793 In questa modalità il pannello si imposta come un
794 .\"LINK2"
795 visualizzatore
796 .\"Internal File Viewer"
797 ridotto che mostra i contenuti del file correntemente selezionato;
798 se si seleziona il pannello (con il tasto tab o con il mouse), si ha
799 accesso ai normali comandi del visualizzatore.
801 .\"NODE "    Sort Order..."
802 .SH "    Ordina per..."
803 Gli otto possibili ordinamenti sono per nome, per estensione, per data 
804 di modifica, per data di accesso, per data di modifica informazioni di
805 inode, per ampiezza, per inode e non ordinato. Nella finestra di dialogo 
806 di ordinamento è possibile scegliere il tipo di ordinamento ed è anche 
807 possibile specificare se si desidera l'ordinamento inverso selezionando 
808 la voce inverso.
810 Normalmente le directory sono ordinare prima dei file ma quest'impostazione
811 può essere modificata dal
812 .\"LINK2"
813 Menu Opzioni
814 .\"Options Menu"
815 (oztione  
816 .B "mescola tutti i file"
819 .\"NODE "    Filter..."
820 .SH "    Filtro..."
821 Il comando di filtro permette di specificare un modello (per esempio
822 .B "*.tar.gz"
823 ) che il file deve corrispondere per essere visualizzato. Malgrado
824 il modello del filtro, le directory e i collegamenti a directory
825 vengono sempre visualizzati sul pannello directory.
827 .\"NODE "    Reread"
828 .SH "    Ricarica"
829 Il comando ricarica l'elenco dei file nella directory. E' utile
830 se un'altro processo ha creato o rimosso dei file. Se 
831 si ha pannellizzato dei nomi di file in un pannello, questo ricaricherà
832 il contenuto della directory e rimuoverà le informazioni pannellizzate
833 (vedere sezione 
834 .\"LINK2"
835 Pannellizza comando
836 .\"External panelize"
837 per ulteriori informazioni).
839 .\"NODE "  File Menu"
840 .SH "  Menu File"
841 Il Midnight Commander usa i tasti F1 - F10 come tasti veloci 
842 per i comandi che appaiono nel menu file. Le sequenze di escape
843 per i tasti funzione sono capacità terminfo da kf1 a kf10. Su terminali
844 senza supporto per i tasti funzione, è possibile ottenere la stessa
845 funzionalità premendo il tasto ESC e un numero da 1 a 9 più lo 0 
846 (corrispondentemente ai tasti da F1 a F9 e F10 rispettivamente).
848 Il file menu comprende i comandi seguenti (tasti veloci tra parentesi):
850 .B Aiuto (F1)
852 Invoca il visualizzatore incorporato di ipertesti per l'aiuto. 
853 All'interno del
854 .\"LINK2"
855 visualizzatore aiuto,
856 .\"Contents"
857 è possibile usare il tasto tab per selezionare il successivo collegamento
858 e il tasto invio per seguirlo. I tasti Barra spaziatrice e Backspace vengono
859 utilizzati per muoversi avanti e indietro nella pagina di aiuto. Premere F1
860 nuovamente per ottenere la lista completa dei tasti accettati.
862 .B Menu (F2)
864 Invoca il
865 .\"LINK2"
866 menu utente.
867 .\"Menu File Edit"
868 Il menu utente fornisce un modo semplice per dare agli utenti un menu ed
869 aggiungere nuove funzionalità al Midnight Commander.
871 .B Visualizza (F3, Maiusc-F3)
873 Visualizza il file correntemente selezionato. Nell'ipostazione predefinita
874 viene invocato il  
875 .\"LINK2"
876 Visualizzatore Interno di File
877 .\"Internal File Viewer"
878 ma se l'opzione "Usa Visualizzatore interno" è deselezionata, verrà invocato
879 un visualizzatore esterno specificato dalla variabile ambiente
880 .B PAGER 
881 \&. Se 
882 .B PAGER
883 non è definita, verrà invocato il comando "view". Se si usa invece il comando
884 Maiusc-F3, il visualizzatore verrà invocato senza nessun tipo di formattazione
885 o preprocessamento sul file.
887 .B Vista Filtrata (M-!)
889 Questo tasto richiede all'utente un comando ed i suoi argomenti (l'argomento
890 predefinito è il nome del file correntemente selezionato), il risultato di tale
891 comando viene mostrato nel visualizzatore di file interno.
893 .B Cambia (F4)
895 Invoca l'editor 
896 .B vi 
897 o l'editor specificato nella variabile d'ambiente 
898 .B EDITOR
899 oppure l'
900 .\"LINK2"
901 Editor di File Interno
902 .\"Internal File Editor"
903 se l'opzione, "Usa Editor interno" è stata impostata.
905 .B Copia (F5)
907 Mostra una finestra di dialogo con destinazione predefinita alla
908 directory del pannello non selezionato, che copia il file selezionato (o
909 i file marcati, se c'e n'è almeno uno) sulla directory specificata dall'utente
910 nella finestra di dialogo. Durante il processo è possibile
911 premere C-c o ESC per abortire l'operazione. Per maggiori dettagli
912 sulla maschera sorgente (che sarà normalmente * o ^\\(.*\\)$ a seconda
913 dell'impostazione di 'modelli della shell') o sui caratteri jolly sulla destinazione
914 vedere
915 .\"LINK2"
916 Maschera copia/rinomina.
917 .\"Mask Copy/Rename"
919 In alcuni sistemi è possibile eseguire la copia in background cliccando
920 sul bottone background (o premendo M-b nella finestra di dialogo). Il
921 comando 
922 .\"LINK2"
923 Processi in background
924 .\"Background jobs"
925 è utile per controllarne l'andamento.
927 .B Collegamento (C-x l)
929 Crea un collegamento fisico (hard link) al file corrente.
931 .B Collegamento Simbolico (C-x s)
933 Crea un collegamento simbolico al file corrente. Per chi non sapesse
934 cosa sono i collegamenti: creare un collegamento ad un file è come
935 copiare il file ma sia il nome sorgente che destinazione rappresentano
936 la stessa immagine fisica del file. Per esempio, se si modifica uno dei
937 due file, tutti i cambiamenti appariranno su tutti i file. Alcuni li
938 chiamano anche alias o scorciatoie (o link come in originale inglese).
940 Un collegamento fisico appare come un file reale. Dopo che sia stato 
941 creato non c'è modo di distinguere quale sia il collegamento e quale sia 
942 l'originale. Se si cancella uno dei due l'altro rimarrà intatto. E' molto
943 difficile notare che i file rappresentano la stessa immagine. Usate i
944 collegamenti fisici quando non volete proprio saperlo.
946 Un collegamento simbolico è un riferimento al nome del file originale.
947 Se il file originale viene cancellato, il collegamento è inutile.
948 E' facile distinguere i collegamenti simbolici dall'immagine stessa.
949 Se il file è un collegamento simbolico a qualcosa, il Midnight Commander
950 mostra un simbolo "@" davanti al nome del file (eccetto se punta ad una
951 directory, nel qualcaso mostrerà una tilde  (~)).
952 Il file originale sul quale punta il collegamento simbolico viene mostrato
953 sulla riga di mini-stato se
954 .I "Mostra Mini-stato"
955 è abilitata. Usare i collegamenti simbolici se si vuole evitare la confusione
956 che creano i collegamenti fisici.
958 .B Rinomina/Sposta (F6)
960 Mostra una finestra di dialogo con destinazione predefinita alla
961 directory del pannello non selezionato, che sposta il file selezionato (o
962 i file marcati, se c'e n'è almeno uno) sulla directory specificata dall'utente
963 nella finestra di dialogo. Durante il processo è possibile
964 premere C-c o ESC per abortire l'operazione. Per maggiori dettagli vedere la
965 sezione precedente Copia, dato che il comando è molto simile.
967 In alcuni sistemi è possibile eseguire la copia in background cliccando
968 sul bottone background (o premendo M-b nella finestra di dialogo). Il
969 comando 
970 .\"LINK2"
971 Processi in background
972 .\"Background jobs"
973 è utile per controllarne l'andamento.
975 .B Crea Directory (F7)
977 Mostra una finestra di dialogo che crea la directory specificata.
979 .B Elimina (F8)
981 Cancella il file correntemente selezionato o i file marcati nel 
982 pannello corrente. Durante il processo è possibile premere C-c 
983 o ESC per abortire l'operazione.
985 .B Cambia Dir veloce (M-c)
986 Usare il comando
987 .\"LINK2"
988 Cambia Dir veloce
989 .\"Quick cd"
990 se si vuole cambiare directory corrente e si ha la riga di comando occupata.
992 .B Seleziona gruppo (+)
994 Viene utilizzato per selezionare (marcare) un gruppo di file. Il
995 Midnight Commander richiedera un'espressione regolare per descrivere il
996 gruppo; se l'opzione
997 .I modelli della shell
998 è abilitata, l'espressione regolare è simile al file globbing nella shell
999 (* significa zero o più caratteri e ? significa un carattere). Se l'opzione
1000 .I modelli della shell
1001 è disabilitata, allora la selezione dei file viene eseguita con le normali
1002 espressioni regolari (vedere ed (1)).
1004 Per selezionare directory invece di file, l'espressione deve cominciare
1005 o finire con una '/'.
1007 .B De-seleziona gruppo (\\\\)
1009 Usata per deselezionare un gruppo di file. E' l'opposto di del comando
1010 .I "Seleziona gruppo"
1013 .B Uscita (F10, Maiusc-F10)
1015 Termina l'esecuzione del Midnight Commander. Maiusc-F10 viene usata se
1016 si esce e si sta usando lo shell wrapper. Maiusc-F10 in tal caso non
1017 vi porterà all'ultima directory utilizzata dal Midnight Commander ma
1018 vi lascerà nella directory dalla quale avete fatto partire il Midnight
1019 Commander.
1021 .\"NODE "    Quick cd"
1022 .SH "    Cambia dir veloce"
1023 Questo comando è utile se si ha la riga di comando piena e si vuole
1024 eseguire
1025 .\"LINK2"
1027 .\"The cd internal command"
1028 per cambiare directory senza dover cancellare e riscrivere la riga di comando.
1029 Questo comando fa uscire una piccola finestra di dialogo che richiede 
1030 l'immissione degli stessi argomenti che si darebbero al comando 
1031 .B cd 
1032 a riga di comando. Questo ha le stesse caratteristiche già presenti nel
1033 comando
1034 .\"LINK2"
1035 comando interno cd.
1036 .\"The cd internal command"
1038 .SH "  Command Menu"
1039 Il comando
1040 .\"LINK2"
1041 Albero directory
1042 .\"Directory Tree"
1043 mostra un disegno ad albero delle directory.
1045 Il comando
1046 .\"LINK2"
1047 Trova file
1048 .\"Find File"
1049 permette di cercare un file specifico. Il comando "Scambia pannelli"
1050 scambia il contenuto dei due pannelli directory.
1052 Il comando "Attiva/disattiva pannelli" mostra il risultato dell'ultimo
1053 comando shell. Quest'ultimo funziona solo su xterm e sulle console Linux e
1054 SCO.
1056 Il comando Confronta directory (C-x d) confronta il contenuto dei
1057 pannelli directory uno con l'altro. E' poi possibile usare il comando Copia (F5)
1058 per rendere i pannelli identici. Ci sono tre metodi di confronto. Il metodo
1059 veloce confronta solo l'ampiezza e la data del file. Il metodo completo
1060 fa un confronto byte-per-byte. Il metodo completo non è disponibile se la
1061 macchina non supporta la chiamata di sistema mmap(2). Il metodo solo
1062 dimensione confronta solo l'ampiezza dei file e non controlla il contenuto ne 
1063 la data del file.
1065 Il comando Storico comandi mostra un'elenco dei comandi battuti. Il comando
1066 selezionato viene copiato sulla riga di comando. Allo storico comandi vi si 
1067 può accedere premendo M-p o M-n. 
1069 Il comando
1070 .\"LINK2"
1071 Directory favorite (C-\\)
1072 .\"Hotlist"
1073 permette un cambio più veloce dalla directory corrente ad una di quelle usate 
1074 più spesso.
1076 Il comando
1077 .\"LINK2"
1078 Pannellizza comando
1079 .\"External panelize"
1080 permette di eseguire un coamndo esterno e di mettere il risultato nel pannello
1081 corrente.
1083 Il comando
1084 .\"LINK2"
1085 Modifica file estensioni
1086 .\"Extension File Edit"
1087 permette di specificare i programmi che devono essere eseguiti quando
1088 si prova ad eseguire, visualizzare, modificare e un mucchio di altre
1089 cose, file con una specifica estensione (la fine del nome del file).
1090 Il comando
1091 .\"LINK2"
1092 Modifica file menu
1093 .\"Menu File Edit"
1094 serve a modificare il menu utente (che appare premendo F2).
1096 .\"NODE "    Directory Tree"
1097 .SH "    Albero Directory"
1098 Il comando albero directory mostra una rappresentazione ad albero delle
1099 directory. Selezionando una directory dalla rappresentazione il 
1100 Midnight Commander cambierà a quella directory.
1102 Ci sono due modi di invocare l'albero. Il vero comando di albero directory
1103 è accessibile dal menu Comandi. L'altro modo è di selezionare la vista ad
1104 albero dai menu Sinistra o Destra.
1106 Per evitare i lunghi ritardi il Midnight Commander crea la rappresentazione ad 
1107 albero scansionando solo una piccola porzione di tutte le directory.
1108 Se manca la directory che si vuole visualizzare, spostarsi sulla sua directory 
1109 genitrice e premere C-r (o F2).
1111 E' possibile utilizzare i tasti seguenti:
1113 Sono accettati i
1114 .\"LINK2"
1115 Tasti Generali di movimento 
1116 .\"General Movement Keys"
1119 .B Invio.
1120 Nell'albero directory, esce dall'albero della directory e lo cambia
1121 alla directory corrente nel pannello selezionato. Nella vista ad albero,
1122 cambia a questa directory nell'altro pannello e rimane nella modalità
1123 vista ad albero in quello corrente.
1125 .B C-r, F2 (Ricarica).
1126 Ricarica la directory. Usare questo comando quando la rappresentazione ad
1127 albero non è aggiornata: mancano directory o mostra alcune sottodirectory
1128 che non esistono più.
1130 .B F3 (Scorda).
1131 Cancella questa directory dalla rappresentazione ad albero. Usare questo
1132 comando per eliminare la confusione dal'albero. Se si vuole nuovamente
1133 visualizzare l'albero completo premere F2 nella sua directory genitrice.
1135 .B F4 (Statico/Dynamico).
1136 Cambia tra modo di navigazione dinamico (predefinito) e statico.
1138 Nella navigazione statica si usano i tasti Su e Giu per 
1139 selezionare la directory. Tutte le directory conosciute vengono mostrate.
1141 Nella navigazione dinamica si usano i tasti Su e Giu per selezionare
1142 una directory sorella, il tasto Sinistra sposta sulla directory genitrice
1143 e il tasto Destra sposta sulla directory figlia. Solo i parenti, sorelle
1144 e figlie, vengono mostrate; le altre sono tralasciate. La rappresentazione
1145 ad albero cambia dinamicamente come la si attraversa.
1147 .B F5 (Copia).
1148 Copia la directory.
1150 .B F6 (RinSpo).
1151 Sposta la directory.
1153 .B F7 (CreDir).
1154 Crea una nuova directory sotto questa directory.
1156 .B F8 (CancDir).
1157 Cancella questa directory dal file system.
1159 .B C-s, M-s.
1160 Cerca la prossima directory che corrisponde alla stringa di ricerca.
1161 Se tale directory non esiste, questi tasti faranno scendere di una riga
1162 (il cursore).
1164 .B C-h, Backspace.
1165 Cancella l'ultimo carattere nella stringa di ricerca.
1167 .B Qualsiasi altro carattere.
1168 Aggiunge un carattere alla stringa di ricerca e sposta alla nuova directory
1169 che comincia con questi caratteri (il cursore). Nella vista ad albero
1170 si deve prima attivare la ricerca premendo C-s. La stringa di ricerca è
1171 visibile nella riga di mini stato.
1173 Le azioni seguenti sono disponibili solo nell'albero directory.
1174 Non sono supportate nella vista ad albero.
1176 .B F1 (Aiuto).
1177 Invoca il visualizzatore dell'aiuto e mostra questa sezione.
1179 .B Esc, F10.
1180 Esce dalla rappresentazione ad albero. Non cambia directory.
1182 Il mouse è supportato. Un doppio click si comporta come premere Invio.
1183 Vedere anche la sezione
1184 .\"LINK2"
1185 supporto mouse
1186 .\"Mouse Support"
1189 .\"NODE "    Find File"
1190 .SH "    Trova File"
1191 Il comando Trova file domanda prima la directory di inizio per la
1192 ricerca ed il nome del file da cercare. Premendo il tasto albero
1193 puoi selezionare la directory di partenza dall'
1194 .\"LINK2"
1195 albero directory
1196 .\"Directory Tree"
1197  . 
1199 Il campo contenuo accetta espressioni regolari simili a egrep(1). That
1200 means you have to escape characters with a special meaning to egrep with "\\", 
1201 e.g. if you search for "strcmp (" you will have to input "strcmp \\(" 
1202 (without the double quotes).
1204 Per far partire la ricerca premere il tasto Ok.
1205 E' possibile bloccare la ricerca con il tasto Sospende e farla riprendere
1206 con il tasto Continua.
1208 E' possibile navigare l'elenco file con i tasti freccia Su e Giu.
1209 Il tasto Chdir cambierà la directory corrente a quella del file selezionato.
1210 Il tasto Ripete chiederà nuovamente i parametri per una nuova ricerca.
1211 Il tasto Uscita esce dal comando Trova. Il tasto Pannellizza
1212 metterà i file trovati sul pannello di directory corrente cosicchè si
1213 possa svolgere ulteriori operazioni su di essi (visualizzazione, copia, 
1214 spostamento, e così via). Dopo la pannellizzazione è possibile premere C-r
1215 per ripristinare la vista normale dei file.
1217 E' possibile avere una lista di directory che il comando Trova File dovrebbe
1218 saltare durante la ricerca (per esempio, si può evitare di fare ricerche su
1219 un CDROM o su una directory NFS montata attraverso un collegamento lento).
1221 Le directory che devono essere saltate devono essere impostate nella variabile
1222 .B find_ignore_dirs 
1223 nella sezione
1224 .B Misc 
1225 del file ~/.mc/ini.
1227 Le directory devono essere separate da una virgola, come nell'esempio:
1230 [Misc]
1231 find_ignore_dirs=/cdrom:/nfs/wuarchive:/afs
1234 Si può prendere in considerazione l'uso del comando
1235 .\"LINK2"
1236 Pannellizza comando
1237 .\"External panelize"
1238 per operazioni particolari. Il comando Trova file serve solo per 
1239 ricerche semplici mentre usando Pannellizza comando si può fare 
1240 ricerche complesse come si vuole.
1242 .\"NODE "    External panelize"
1243 .SH "    Pannellizza comando"
1244 Il Pannellizza comando permette di eseguire un programma esterno, e
1245 mettere il risultato del programma nel pannello corrente.
1247 Per esempio, se si vuole manipolare in uno dei pannelli tutti i collegamenti
1248 simbolici nella directory corrente, basta usare Pannellizza comando per
1249 eseguire il seguente:
1252 find . -type l -print
1254 Al completamento del comando, il contenuto del pannello non sarà più
1255 il listato della directory ma tutti i file che rappresentano
1256 collegamenti simbolici.
1258 Volendo pannellizzare tutti i file che sono stati scaricati dal
1259 proprio server ftp preferito, si può usare questo comando awk per
1260 estrarre il nome del file dal file di log del traferimento:
1263 awk '$9 ~! /incoming/ { print $9 }' < /usr/adm/xferlog
1266 Se si desidera si può salvare i comandi di pannellizzazione usati più 
1267 spesso con uno nome più descrittivo, in maniera da richiamarli più velocemente.
1268 Per fare ciò basta battere il comando sulla riga di ingresso e premere il tasto
1269 Aggiungi nuovo. Poi si deve dare un nome al quale associare il comando che si
1270 desidera salvare. La prossima volta sarà possibile scegliere quel comando 
1271 dall'elenco e non servirà ribatterlo nuovamente.
1273 .\"NODE "    Hotlist"
1274 .SH "    Directory Favorite"
1275 Il comando Directory favorite mostra le etichette delle directory nell'elenco
1276 delle favorite. Il The Midnight Commander andrà alla directory corrispondente
1277 all'etichetta selezionata. Dalla finestra delle favorite si possono rimuovere
1278 etichette/directory già create ed aggiungerne di nuove. Per aggiungere 
1279 velocemente nuove directory basta usare il comando Aggiungi alle favorite 
1280 (C-x h), che aggiunge la directory corrente alla lista delle favorite,
1281 richiedendo l'etichetta per identificarla.
1283 Questo rende più veloce il cd verso directory usate spesso. Considera l'uso della
1284 variabile CDPATH come descritto in
1285 .\"LINK2"
1286 comando cd interno 
1287 .\"The cd internal command"
1290 .\"NODE "    Extension File Edit"
1291 .SH "    Modifica File Estensioni"
1292 Questo comando invocherà l'editor sul file ~/.mc/bindings. Il fomato di questo
1293 file è il seguente (il formato è cambiato dalla versione 3.0):
1295 Tutte le righe che iniziano per # vengono ignorate.
1297 Le righe che cominciano dalla prima colonna devono avere il seguente formato:
1299 .I parolachiave/descrizioneNL,
1300 i.e. qualsiasi cosa dopo
1301 .I parolachiave/
1302 fino al fine riga è 
1303 .I descrizione
1305 parolachiave può essere: 
1307 .I shell
1309 (allora descrizione è qualsiasi estensione (no caratteri jolly), cioè corrisponde a tutti i file 
1310 *descrizione . Esempio: .tar corrisponde a *.tar)
1312 .I regex
1314 (descrizione è un'espressione regolare)
1316 .I type
1318 (file corrisponde se `file %f` corrisponde all'espressione regolare descrizione
1319 (nome del file: a partire da `file %f` viene rimosso))
1321 .I default
1323 (corrisponde a qualsiasi file indipendentemente da descrizione)
1325 Le altre linee devono cominciare con uno spazio o una tabulazione e devono essere nel formato:
1327 .I parolachiave=comandoNL
1328 (senza spazi intorno a =), dove
1329 .I parolachiave
1330 deve essere: 
1332 .I Open
1333 (se l'utente preme Invio o fa doppio click), 
1334 .I View
1335 (F3), 
1336 .I Edit
1337 (F4), 
1338 .I Drop
1339 (l'utente scarica alcuni file su di esso) o qualsiasi altro nome definito
1340 dall'utente (questi saranno elencati nella finestra menu dipendente 
1341 dall'estensione). 
1342 .I Icon
1343 il nome è riservato per usi futuri da mc.
1345 .I command
1346 è qualsiasi comando shell di una riga, con la semplice
1347 .\"LINK2"
1348 sostituzione macro.
1349 .\"Macro Substitution"
1351 Gli obiettivi sono valutati dalla cima al fondo (l'ordine perciò è 
1352 importante). Se alcune azioni mancano, la ricerca continua come se 
1353 l'obiettivo non corrispondesse (cioè se un file corrisponde alla prima e
1354 alla seconda voce e manca la voce View in cima, premendo F3 verrà
1355 usata l'azione View della seconda voce. Normalmente dovrebbero
1356 corrispondere tutte le azioni.
1358 .\"NODE "    Background jobs"
1359 .SH "    Processi in Background"
1360 Questo comando permette di controllare lo stato di ogni processo
1361 in background del Midnight Commander (in background possono essere
1362 eseguite solo operazioni di copia e rinomina). Da qui si può bloccare, 
1363 far ripartire e uccidere un lavoro in background.
1365 .\"NODE "    Menu File Edit"
1366 .SH "    Modifica file Menu"
1367 Il menu utente è un menu di comandi utili che possono essere 
1368 personalizzati dall'utente. Quando si accede al menu utente, viene 
1369 utilizzato, se esiste, il file .mc.menu dalla directory corrente,
1370 ma solo se è di proprietà dell'utente o di root e se non è scrivibile
1371 a tutti. Se tale file non viene trovato, mc alla stessa maniera 
1372 prova con ~/.mc/menu altrimenti usa il menu di sistema
1373 @prefix@/lib/mc/mc.menu.
1375 Il formato del file menu è molto semplice. Le righe che cominciano
1376 con qualsiasi cosa che non sia uno spazio o una tabulazione sono
1377 considerate voci per il menu (per fare in modo di usarle anche come
1378 scelta rapida, il primo carattere deve essere una lettera). Tutte le
1379 righe che cominciano con uno spazio o un tab sono i comandi che verranno
1380 eseguiti quando la voce viene selezionata.
1382 Quando un'opzione viene selezionata tutte le linee di comando dell'opzione
1383 vengono copiate in un file temporaneo nella directory temporanea (normalmente
1384 /usr/tmp) e poi il file viene eseguito. Ciò permette all'utente di mettere
1385 normali costrutti shell nei menu. Prima dell'esecuzione del codice del menu
1386 ha luogo una semplice sostituzione di macro. Per ulteriori informazioni vedere
1387 .\"LINK2"
1388 sostituzioni macro.
1389 .\"Macro Substitution"
1391 Ecco un esempio di un file mc.menu:
1394 A       Mostra un dump del file correntemente selezionato
1395         od -c %f
1397 B       Modifica un rapporto bachi e lo spedisce a root
1398         vi /tmp/mail.$$
1399         mail -s "Midnight Commander bug" root < /tmp/mail.$$
1401 M       Legge la posta
1402         emacs -f rmail
1404 N       Legge le news 
1405         emacs -f gnus
1407 H       Chiama il visualizzatore ipertestuale info
1408         info
1410 J       Copia la directory corrente nell'altro pannello ricorsivamente
1411         tar cf - . | (cd %D && tar xvpf -)
1413 K       Crea un rilascio della directory corrente
1414         echo -n "Nome del file di distribuzione: "
1415         read tar
1416         ln -s %d `dirname %d`/$tar 
1417         cd ..
1418         tar cvhf ${tar}.tar $tar
1420 = f *.tar.gz | f *.tgz & t n
1421 X       Estrae il contenuto di un file tar compresso
1422         tar xzvf %f
1425 .B Condizioni predefinite
1427 Ogni voce di menu può essere preceduta da una condizione. La condizione
1428 deve cominciare nella prima colonna con un carattere '='. Se la condizione
1429 è vera, la voce di menu sarà la voce predefinita.
1432 Sintassi condizione:    = <sotto-cond>
1433   oppure:               = <sotto-cond> | <sotto-cond> ...
1434   oppure:               = <sotto-cond> & <sotto-cond> ... 
1436 Sotto-condizione è una delle seguenti:
1438   y <modello>           sintassi della corrispondenza modello file corrente?
1439                         solo per modifica menu.
1440   f <modello>           corrispondenza modello file corrente?
1441   F <modello>           corrispondenza modello altro file?
1442   d <modello>           corrispondenza modello directory corrente?
1443   D <modello>           corrispondenza modello altra directory?
1444   t <tipo>              file corrente di tipo?
1445   T <tipo>              altro file di tipo?
1446   x <nomefile>          nomefile è eseguibile?
1447   ! <sotto-cond>        nega il risultato di una sotto-condizione
1451 Modello è un normale modello della shell o un'espressione regolare,
1452 a seconda dell'opzione modelli della shell. E' possibile scavalcare
1453 il valore globale dell'opzione modelli della shell scrivendo 
1454 "shell_patterns=x" sulla prima riga del file menu (dove "x" è 0 o 1).
1457 Tipo è uno o più dei seguenti caratteri:
1459   n     non directory
1460   r     file regolare 
1461   d     directory
1462   l     collegamento
1463   c     carattere speciale
1464   b     blocco speciale
1465   f     fifo (pipe)
1466   s     socket
1467   x     eseguibile
1468   t     marcato
1471 Per esempio 'rlf' significa file regolare, collegamento o fifo. Il
1472 tipo 't' è particolare perché agisce sul pannello invece che sul file.
1473 La condizione '=t t' è vera se ci sono file marcati nel pannello corrente
1474 e falsa se non ce ne sono.
1476 Se la condizione comincia con '=?' invece che '=' una traccia di debug
1477 sarà mostrata ogniqualvolta viene calcolato il valore della condizione.
1479 Le condizioni sono calcolate da sinistra a destra. Ciò significa che
1481         = f *.tar.gz | f *.tgz & t n
1483 viene calcolata come
1485         ( (f *.tar.gz) | (f *.tgz) ) & (t n)
1488 Ecco un esempio dell'uso delle condizioni:
1491 = f *.tar.gz | f *.tgz & t n
1492 L       Elenca il contenuti di un archivio compresso tar
1493         gzip -cd %f | tar xvf -
1496 .B Condizioni Addizione
1498 Se la condizione comincia con '+' (o '+?') invece che '=' (o '=?') è
1499 una condizione addizione. Se la condizione è vera la voce di menu sarà
1500 inclusa nel menu. Se la condizione è falsa la voce di menu non sarà 
1501 inclusa nel menu.
1503 You can combine default and addition conditions by starting condition
1504 with '+=' or '=+' (or '+=?' or '=+?' if you want debug trace). If you
1505 want to use two different conditions, one for adding and another for
1506 defaulting, you can precede a menu entry with two condition lines, one
1507 starting with '+' and another starting with '='.
1509 Comments are started with '#'. The additional comment lines must start
1510 with '#', space or tab.
1512 .SH "  Options Menu"
1513 The Midnight Commander has some options that may be toggled on and
1514 off in several dialogs which are accessible from this menu. Options 
1515 are enabled if they have an asterisk or "x" in front of them. 
1518 .\"LINK2"
1519 Configuration
1520 .\"Configuration"
1521 command pops up a dialog from which you can change most of settings of
1522 the Midnight Commander.
1525 .\"LINK2"
1526 Display bits
1527 .\"Display bits"
1528 command pops up a dialog from which you may select which characters is your
1529 terminal able to display.
1532 .\"LINK2"
1533 Confirmation
1534 .\"Confirmation"
1535 command pops up a dialog from which you specify which actions you want to
1536 confirm.
1539 .\"LINK2"
1540 Learn keys
1541 .\"Learn keys"
1542 command pops up a dialog from which you test some keys which are not working
1543 on some terminals and you may fix them.
1546 .\"LINK2"
1547 Virtual FS
1548 .\"Virtual FS"
1549 command pops up a dialog from which you specify some VFS related options.
1552 .\"LINK2"
1553 Layout
1554 .\"Layout"
1555 command pops up a dialog from which you specify a bunch of options how mc
1556 looks like on the screen.
1559 .\"LINK2"
1560 Save setup
1561 .\"Save Setup"
1562 command saves the current settings of the Left, Right and Options
1563 menus. A small number of other settings is saved, too.
1565 .SH "    Configuration"
1566 The options in this dialog are divided into three groups:
1567 Panel Options, Pause after run and Other Options.
1569 .B Panel Options
1571 .I Show Backup Files.
1572 If enabled, the Midnight Commander will show files ending with a tilde.
1573 Otherwise, they won't be shown (like GNU's ls option -B).
1575 .I Show Hidden Files.
1576 If enabled, the Midnight Commander will show all files that start with
1577 a dot (like ls -a).
1579 .I Mark moves down.
1580 If enabled, the selection bar will move down when you mark a file (with
1581 either C-t or the Insert key).
1583 .I Drop down menus.
1584 When this option is enabled, the pull down menus will be activated as
1585 soon as you press the 
1586 .B F9
1587 key.  Otherwise, you will only get the menu title, and you will have
1588 to activate the menu either with the arrow keys or with the hotkeys.
1589 It is recommended if you are using hotkeys.
1591 .I Mix all files.
1592 If this option is enabled, all files and directories are shown mixed
1593 together.  If the option is off, directories (and links to directories)
1594 are shown at the beginning of the listing, and other files below.
1596 .I Fast directory reload.
1597 If this option is enabled, the Midnight Commander will use a trick to
1598 determine if the directory contents have changed.  The trick is to reload
1599 the directory only if the i-node of the directory has changed; this means
1600 that reloads only happen when files are created or deleted.  If what
1601 changes is the i-node for a file in the directory (file size changes,
1602 mode or owner changes, etc) the display is not updated.  In these cases,
1603 if you have the option on, you have to rescan the directory manually
1604 (with C-r).
1606 .B Pause after run
1608 After executing your commands, the Midnight Commander can pause, so
1609 that you can examine the output of the command.  There are three
1610 possible settings for this variable:
1612 .I Never
1613 Means that you do not want to see the output of your command.  If you
1614 are using the Linux or SCO console or an xterm, you will be able to see the
1615 output of the command by typing C-o.
1617 .I "On dumb terminals"
1618 You will get the pause message on terminals that are not capable of
1619 showing the output of the last command executed (any terminal that is
1620 not an xterm or the Linux console).
1622 .I Always
1623 The program will pause after executing all of your commands.
1625 .B Other Options
1627 .I Verbose operation.
1628 This toggles whether the file Copy, Rename and Delete operations are
1629 verbose (i.e., display a dialog box for each operation). If you have a
1630 slow terminal, you may wish to disable the verbose operation. It is
1631 automatically turned off if the speed of your terminal is less than
1632 9600 bps.
1634 .I Compute totals.
1635 If this option is enabled, the Midnight
1636 Commander computes total byte sizes and total number of files
1637 prior to any Copy, Rename and Delete operations. This will
1638 provide you with a more accurate progress bar at the expense
1639 of some speed. This option has no effect, if 
1640 .I Verbose operation
1641 is disabled.
1643 .I Shell Patterns.
1644 By default the Select, Unselect and Filter commands will use shell-like
1645 regular expressions. The following conversions are performed to achieve
1646 this: the '*' is replaced by '.*' (zero or more characters); the '?'
1647 is replaced by '.' (exactly one character) and '.' by the literal
1648 dot. If the option is disabled, then the regular expressions are the
1649 ones described in ed(1).
1651 .I Auto Save Setup.
1652 If this option is enabled, when you exit the Midnight Commander the
1653 configurable options of the Midnight Commander are saved in the
1654 ~/.mc/ini file.
1656 .I Auto menus.
1657 If this option is enabled, the user menu will be invoked at startup.
1658 Useful for building menus for non-unixers.
1660 .I Use internal editor.
1661 If this option is enabled, the built-in file editor is used to edit
1662 files. If the option is disabled, the editor specified in the
1663 .B EDITOR
1664 environment variable is used.
1665 If no editor is specified, 
1666 .B vi
1667 is used.  See the section on the
1668 .\"LINK2"
1669 internal file editor.
1670 .\"Internal File Editor"
1672 .I Use internal viewer.
1673 If this option is enabled, the built-in file viewer is used to view
1674 files. If the option is disabled, the pager specified in the
1675 .B PAGER
1676 environment variable is used.
1677 If no pager is specified, the 
1678 .B view
1679 command is used.  See the section on the
1680 .\"LINK2"
1681 internal file viewer.
1682 .\"Internal File Viewer"
1684 .I Complete: show all.
1685 By default the Midnight Commander
1686 pops up all possible 
1687 .\"LINK2"
1688 completions
1689 .\"Completion"
1690 if the completion is
1691 ambiguous if you press 
1692 .B M-Tab
1693 for the second time, for the
1694 first time it just completes as much as possible and in
1695 the case of ambiguity beeps. If you want to see all the
1696 possible completions already after the first
1697 .B M-Tab
1698 pressing, enable this option.
1700 .I Rotating dash.
1701 If this option is enabled, the 
1702 Midnight Commander shows a rotating dash in the upper right corner
1703 as a work in progress indicator.
1705 .I Lynx-like motion.
1706 If this option is enabled, 
1707 you may use the arrows keys to automatically chdir if the
1708 current selection is a subdirectory and the shell command
1709 line is empty. By default, this setting is off.
1711 .I Advanced chown.
1712 If this option is enabled, the 
1713 .\"LINK2"
1714 Advanced Chown
1715 .\"Advanced Chown"
1716 command will be invoked if you run the 
1717 .\"LINK2"
1718 Chmod
1719 .\"Chmod"
1720 or 
1721 .\"LINK2"
1722 Chown
1723 .\"Chown"
1724 command.
1726 .I Cd follows links.
1727 This option, if set, causes the Midnight Commander to follow the
1728 logical chain of directories when changing current directory
1729 either in the panels, or using the cd command. This is the default
1730 behavior of bash. When unset, the Midnight Commander follows the
1731 real directory structure, so cd .. if you've entered that directory
1732 through a link will move you to the current directory's real parent
1733 and not to the directory where the link was present.
1735 .I Safe delete.
1736 If this option is enabled, deleting files 
1737 unintentionally will get more difficult. The default
1738 selection in the confirmation dialog changes from the "Yes"
1739 to the "No" button and deletion of non empty directories has to be 
1740 confirmed by entering the word 
1741 .I yes
1742 \&. 
1743 By default this option is disabled.
1745 .SH "    Display bits"
1746 This is used to configure the range of visible characters on the
1747 screen.  This setting may be 7-bits if your terminal/curses supports
1748 only seven output bits, ISO-8859-1 displays all the characters in the
1749 ISO-8859-1 map and full 8 bits is for those terminals that can display
1750 full 8 bit characters.
1752 .SH "    Confirmation"
1753 In this menu you configure the confirmation options for file deletion,
1754 overwriting, execution by pressing enter and quitting the program.
1756 .SH "    Learn keys"
1757 This dialog allows you to test and redefine functional keys, cursor
1758 arrows and some other keys to make them work properly on your terminal.
1759 They often don't, since many terminal databases are incomplete or broken.
1761 You can move around with the Tab key and with the vi moving keys ('h'
1762 left, 'j' down, 'k' up and 'l' right).  Once you press any cursor movement
1763 key and it is recognized, you can use that key as well.
1765 You can test keys just by pressing each of them.  When you press a
1766 key and it is recognized properly, OK should appear next to the name
1767 of that key.  Once a key is marked OK it starts working as usually,
1768 e.g. F1 pressed the first time will just check that the F1 key works,
1769 but after that it will show help.  The same applies to the arrow keys.
1770 The Tab key should be working always.
1772 If some keys do not work properly then you won't see OK appear after
1773 pressing that key.  Then you may want to redefine it.  Do it by pressing
1774 the button with the name of that key (either by the mouse or by Enter
1775 or Space after selecting the button with Tab or arrows).  Then a message
1776 box will appear asking you to press that key.  Do it and wait until the
1777 message box disappears.  If you want to abort, just press Escape once
1778 and wait.
1780 When you finish with all the keys, you can Save them.  The definitions
1781 for the keys you have redefined will be written into the [terminal:TERM]
1782 section of your ~/.mc/ini file (where TERM is the name of your current
1783 terminal).  The definitions of the keys that were already working properly
1784 are not saved.
1786 .SH "    Virtual FS"
1787 This option gives you control over the settings of the 
1788 .\"LINK2"
1789 Virtual File System 
1790 .\"Virtual File System"
1791 information cache.  
1793 The Midnight Commander keeps in memory the information
1794 related to some of the virtual file systems to speed up
1795 the access to the files in the file system (for example,
1796 directory listings fetched from ftp servers). 
1798 Moreover in order to access the contents of compressed files 
1799 (for example, compressed tar files) the Midnight Commander 
1800 has to create a temporary uncompressed file on your disk.
1802 Since both the information in memory and the temporary files on
1803 disk take up resources, you may want to tune the parameters of 
1804 the cached information to decrease your resource usage or to maximize
1805 the speed of access to frequently used file systems.
1807 The Tar file system is quite clever about how it handles
1808 tar files: it just loads the directory entries and when it
1809 needs to use the information contained in the tar file, it
1810 goes and grab it.
1812 In the wild, tar files are usually kept compressed (plain
1813 tar files are species in extinction), and because of the
1814 nature of those files (the directory entries for the tar
1815 files is not there waiting for us to be loaded), the tar
1816 file system has to uncompress the file
1817 on the disk in a temporary location and then access the
1818 uncompressed file as a regular tar file.
1820 Now, since we all love to browse files and tar files all
1821 over the disk, it's common that you will leave a tar file
1822 and the re-enter it later. Since uncompression is slow,
1823 the Midnight Commander will cache the information in
1824 memory for a limited amount of time, after you hit the
1825 timeout, all of the resources associated with the
1826 file system will be freed. The default timeout is set to
1827 one minute.
1829 The 
1830 .\"LINK2"
1831 FTP File System
1832 .\"FTP File System"
1833 keeps the directory listing it fetches from a ftp server
1834 in a cache.  The cache
1835 expire time is configurable with the 
1836 .I ftpfs directory cache timeout
1837 option.  
1838 A low value for this
1839 option may slow down every operation on the ftp file System
1840 because every operation is accompanied by a query of the
1841 ftp server. 
1843 Moreover you can define a proxy host for doing ftp transfers 
1844 and configure the Midnight Commander to always use the proxy host. 
1846 the section on
1847 .\"LINK2"
1848 FTP File System
1849 .\"FTP File System"
1850 for more information.
1852 .SH "    Layout"
1853 The layout dialog gives you a possibility to change the general layout
1854 of screen. You can specify whether the menubar, the command prompt,
1855 the hintbar and the function keybar are visible. On the Linux or SCO console
1856 you can specify how many lines are shown in the output window.
1858 The rest of the screen area is used for the two directory panels. You
1859 can specify whether the area is split to the panels in vertical or
1860 horizontal direction. The split can be equal or you can specify an
1861 unequal split.
1863 By default all contents of the directory panels are displayed with 
1864 the same color, but you can specify whether 
1865 .I permissions 
1866 and 
1867 .I file types
1868 are highlighted with special 
1869 .\"LINK2"
1870 Colors.
1871 .\"Colors"
1872 If permission highlighting is enabled, the parts of the 
1873 .I perm
1875 .I mode
1876 .\"LINK2"
1877 display fields
1878 .\"Listing Mode..."
1879 which are valid for the user running Midnight Commander
1880 are highlighted with the color defined with the
1881 .I selected
1882 keyword. If file type highlighting is enabled, files are colored according
1883 to their file type (e.g. directory, core file, executable, ...). 
1885 If the 
1886 .I Show Mini-Status
1887 option is enabled, one line of status
1888 information about the currently selected item is showed at the bottom 
1889 of the panels.
1891 .SH "    Save Setup"
1892 At startup the Midnight Commander will try to load initialization
1893 information from the ~/.mc/ini file. If this file doesn't exist,
1894 it will load the information from the system-wide configuration file,
1895 located in @prefix@/lib/mc/mc.ini. If the system-wide configuration
1896 file doesn't exist, MC uses the default settings.
1899 .I Save Setup
1900 command creates the ~/.mc/ini file by saving the current settings
1901 of the
1902 .\"LINK2"
1903 Left, Right
1904 .\"Left and Right Menus"
1906 .\"LINK2"
1907 Options
1908 .\"Options Menu"
1909 menus.
1911 If you activate the
1912 .I auto save setup
1913 option, MC will always save the current settings when exiting.
1915 There also exist settings which can't be changed from the menus. To
1916 change these settings you have to edit the setup file with your
1917 favorite editor. See the section on
1918 .\"LINK2"
1919 Special Settings
1920 .\"Special Settings"
1921 for more information.
1923 .SH ""
1924 .SH "Executing operating system commands"
1925 You may execute commands by typing them directly in the Midnight
1926 Commander's input line, or by selecting the program you want to
1927 execute with the selection bar in one of the panels and hitting Enter.
1929 If you press Enter over a file that is not executable, the Midnight
1930 Commander checks the extension of the selected file against the
1931 extensions in the
1932 .\"LINK2"
1933 Extensions File.
1934 .\"Extension File Edit"
1935 If a match is found then the code associated with that extension is
1936 executed. A very simple
1937 .\"LINK2"
1938 macro expansion
1939 .\"Macro Substitution"
1940 takes place before executing the command.
1942 .SH "  The cd internal command"
1943 The 
1944 .I cd
1945 command is interpreted by the Midnight Commander, it is not passed to
1946 the command shell for execution.  Thus it may not handle all of the
1947 nice macro expansion and substitution that your shell does, although it
1948 does some of them:
1950 .I Tilde substitution
1951 The (~) will be substituted with your home directory, if you append a
1952 username after the tilde, then it will be substituted with the login
1953 directory of the the specified user.
1955 For example, ~guest is the home directory for the user guest, while
1956 ~/guest is the directory guest in your home directory.
1958 .I Previous directory
1959 You can jump to the directory you were previously by using the special
1960 directory name '-' like this:
1961 .B cd -
1963 .I CDPATH directories
1964 If the directory specified to the 
1965 .B cd 
1966 command is not in the current directory, then The Midnight Commander
1967 uses the value in the environment variable 
1968 .B CDPATH
1969 to search for the directory in any of the named directories.
1971 For example you could set your
1972 .B CDPATH
1973 variable to ~/src:/usr/src, allowing you to change your directory to
1974 any of the directories inside the ~/src and /usr/src directories, from
1975 any place in the file system by using it's relative name (for example
1976 cd linux could take you to /usr/src/linux).
1978 .SH "  Macro Substitution"
1980 When accessing a
1981 .\"LINK2"
1982 user menu, 
1983 .\"Menu File Edit"
1984 or executing an
1985 .\"LINK2"
1986 extension dependent command,
1987 .\"Extension File Edit"
1988 or running a command from the command line input,
1989 a simple macro substitution takes place.
1991 The macros are:
1993 .I "%i"
1995 The indent of blank space, equal the cursor column
1996 position. For edit menu only.
1998 .I "%y"
2000 The syntax type of current file. For edit menu only.
2002 .I "%k"
2004 The block file name.
2006 .I "%e"
2008 The error file name.
2010 .I "%m"
2012 The current menu name.
2014 .I "%f"
2016 .I "%p"
2018 The current file name.
2020 .I "%x"
2022 The extension of current file name.
2024 .I "%b"
2026 The current file name without extension.
2028 .I "%d"
2030 The current directory name.
2032 .I "%F"
2034 The current file in the unselected panel.
2036 .I "%D"
2038 The directory name of the unselected panel.
2040 .I "%t"
2042 The currently tagged files.
2044 .I "%T"
2046 The tagged files in the unselected panel.
2048 .I "%u"
2050 .I "%U"
2052 Similar to the %t and %T macros, but in addition the files are
2053 untagged. You can use this macro only once per menu file entry or
2054 extension file entry, because next time there will be no tagged
2055 files.
2057 .I "%s"
2059 .I "%S"
2061 The selected files: The tagged files if there are any. Otherwise the
2062 current file.
2064 .I "%cd"
2066 This is a special macro that is used to change the current directory
2067 to the directory specified in front of it.  This is used primarily as
2068 an interface to the
2069 .\"LINK2"
2070 Virtual File System.
2071 .\"Virtual File System"
2073 .I "%view"
2075 This macro is used to invoke the internal viewer.  This macro can be
2076 used alone, or with arguments.  If you pass any arguments to this
2077 macro, they should be enclosed in brackets.
2079 The arguments are: 
2080 .I ascii
2081 to force the viewer into ascii mode;
2082 .I hex
2083 to force the viewer into hex mode;
2084 .I nroff
2085 to tell the viewer that it should interpret the bold and underline
2086 sequences of nroff; 
2087 .I unformatted
2088 to tell the viewer to not interpret nroff commands for making the text
2089 bold or underlined.
2091 .I "%%"
2093 The % character
2095 .I "%{some text}"
2097 Prompt for the substitution. An input box is shown and the text inside
2098 the braces is used as a prompt. The macro is substituted by the text
2099 typed by the user. The user can press ESC or F10 to cancel. This macro
2100 doesn't work on the command line yet.
2102 .I "%var{ENV:default}"
2104 If environment variable
2105 .I ENV
2106 is unset, the 
2107 .I default
2108 is substituted.  Otherwise, the value of
2109 .I ENV
2110 is substituted.
2112 .SH "  The subshell support"
2113 The subshell support is a compile time option, that works with the
2114 shells: bash, tcsh and zsh.  
2116 When the subshell code is activated the Midnight Commander will
2117 spawn a concurrent copy of your shell (the one defined in the 
2118 .B SHELL
2119 variable and if it is not defined, then the one in the /etc/passwd
2120 file) and run it in a pseudo terminal, instead of invoking a new shell
2121 each time you execute a command, the command will be passed to the
2122 subshell as if you had typed it.  This also allows you to change the
2123 environment variables, use shell functions and define aliases that are
2124 valid until you quit the Midnight Commander.
2126 If you are using 
2127 .B bash
2128 you can specify startup
2129 commands for the subshell in your ~/.mc/bashrc file and
2130 special keyboard maps in the ~/.mc/inputrc file.
2131 .B tcsh 
2132 users may specify startup commands in the ~/.mc/tcshrc file.
2134 When the subshell code is used, you can suspend applications at any
2135 time with the sequence C-o and jump back to the Midnight Commander, if
2136 you interrupt an application, you will not be able to run other
2137 external commands until you quit the application you interrupted.
2139 An extra added feature of using the subshell is that the prompt
2140 displayed by the Midnight Commander is the same prompt that you are
2141 currently using in your shell.
2144 .\"LINK2"
2145 OPTIONS
2146 .\"OPTIONS"
2147 section has more information on how you can control the subshell code.
2149 .SH "Chmod"
2150 The Chmod window is used to change the attribute bits in a group of
2151 files and directories.  It can be invoked with the C-x c key combination.
2153 The Chmod window has two parts -
2154 .I Permissions
2155 and 
2156 .I File
2158 In the File section are displayed the name of the file or directory
2159 and its permissions in octal form, as well as its owner and group.
2161 In the Permissions section there is a set of check buttons which
2162 correspond to the file attribute bits.  As you change the attribute
2163 bits, you can see the octal value change in the File section.
2165 To move between the widgets (buttons and check buttons) use the
2166 .I arrow keys
2167 or the
2168 .I Tab
2169 key.  To change the state of the check buttons or to select a button
2171 .I Space.
2172 You can also use the hotkeys on the buttons to quickly activate them.
2173 Hotkeys are shown as highlighted letters on the buttons.
2175 To set the attribute bits, use the Enter key.
2177 When working with a group of files or directories, you just click on
2178 the bits you want to set or clear.  Once you have selected the bits
2179 you want to change, you select one of the action buttons (Set marked
2180 or Clear marked).
2182 Finally, to set the attributes exactly to those specified, you can use
2184 .B [Set all]
2185 button, which will act on all the tagged files.
2187 .B [Marked all]
2188 set only marked attributes to all selected files
2190 .B [Set marked]
2191 set marked bits in attributes of all selected files
2193 .B [Clean marked]
2194 clear marked bits in attributes of all selected files
2196 .B [Set]
2197 set the attributes of one file
2199 .B [Cancel]
2200 cancel the Chmod command
2202 .SH "Chown"
2203 The Chown command is used to change the owner/group of a file. The hot
2204 key for this command is C-x o.
2206 .SH "Advanced Chown"
2207 The Advanced Chown command is the 
2208 .\"LINK2"
2209 Chmod
2210 .\"Chmod"
2211 and 
2212 .\"LINK2"
2213 Chown
2214 .\"Chown"
2215 command combined into one window. You can change the permissions and 
2216 owner/group of files at once.
2218 .SH "File Operations"
2219 When you copy, move or delete files the Midnight Commander shows the
2220 file operations dialog. It shows the files currently being operated on
2221 and there are at most three progress bars. The file bar tells how big
2222 part of the current file has been copied so far. The count bar tells
2223 how many of tagged files have been handled so far. The bytes bar tells
2224 how big part of total size of the tagged files has been handled so
2225 far. If the verbose option is off the file and bytes bars are not
2226 shown.
2228 There are two buttons at the bottom of the dialog. Pressing the Skip
2229 button will skip the rest of the current file. Pressing the Abort
2230 button will abort the whole operation, the rest of the files are
2231 skipped.
2233 There are three other dialogs which you can run into during the file
2234 operations.
2236 The error dialog informs about error conditions and has three
2237 choices. Normally you select either the Skip button to skip the file
2238 or the Abort button to abort the operation altogether. You can also
2239 select the Retry button if you fixed the problem from another
2240 terminal.
2242 The replace dialog is shown when you attempt to copy or move a file on
2243 the top of an existing file. The dialog shows the dates and sizes of
2244 the both files. Press the Yes button to overwrite the file, the No
2245 button to skip the file, the alL button to overwrite all the files,
2246 the nonE button to never overwrite and the Update button to overwrite
2247 if the source file is newer than the target file. You can abort the
2248 whole operation by pressing the Abort button.
2250 The recursive delete dialog is shown when you try to delete a
2251 directory which is not empty. Press the Yes button to delete the
2252 directory recursively, the No button to skip the directory, the alL
2253 button to delete all the directories and the nonE button to skip all
2254 the non-empty directories. You can abort the whole operation by
2255 pressing the Abort button. If you selected the Yes or alL button you
2256 will be asked for a confirmation. Type "yes" only if you are really
2257 sure you want to do the recursive delete.
2259 If you have tagged files and perform an operation on them only the
2260 files on which the operation succeeded are untagged. Failed and
2261 skipped files are left tagged.
2263 .SH "Mask Copy/Rename"
2264 The copy/move operations lets you translate the names of files in an easy
2265 way. To do it, you have to specify the correct source mask and usually in
2266 the trailing part of the destination specify some wildcards.
2267 All the files matching the source mask are copied/renamed according to
2268 the target mask. If there are tagged files, only the tagged files
2269 matching the source mask are renamed.
2271 There are other option which you can set: 
2273 Follow links tells whether make the symlinks and hardlinks in the source 
2274 directory (recursively in subdirectories) new links in the target 
2275 directory or whether would you like to copy their content.
2277 Dive into subdirs tells what to do if in the target
2278 directory exists a directory with the same name as the
2279 file/directory being copied. The default action is to copy
2280 it's content into that directory, by enabling this 
2281 you can copy the source directory into that directory. 
2282 Perhaps an example will help:
2284 You want to copy content of a directory foo to /bla/foo,
2285 which is an already existing directory. Normally (when
2286 Dive is not set), mc would copy it exactly into /bla/foo. 
2287 By enabling this option you will copy the content into /bla/foo/foo,
2288 because the directory already exists.
2290 Preserve attributes tells whether to preserve the original files' 
2291 permissions, timestamps and if you are root whether to preserve 
2292 the original files' UID and GID. If this option is not set the current 
2293 value of the umask will be respected.
2295 .B "Use shell patterns on"
2297 When the shell patterns option is on you can use the '*' and '?'
2298 wildcards in the source mask. They work like they do in the shell. In
2299 the target mask only the '*' and '\\<digit>' wildcards are allowed. The
2300 first '*' wildcard in the target mask corresponds to the first
2301 wildcard group in the source mask, the second '*' corresponds to the
2302 second group and so on. The '\\1' wildcard corresponds to the first
2303 wildcard group in the source mask, the '\\2' wildcard corresponds to
2304 the second group and so on all the way up to '\\9'. The '\\0' wildcard
2305 is the whole filename of the source file.
2307 Two examples:
2309 If the source mask is "*.tar.gz", the destination is "/bla/*.tgz" and the
2310 file to be copied is "foo.tar.gz", the copy will be "foo.tgz" in "/bla".
2312 Let's suppose you want to swap basename and extension so that "file.c"
2313 will become "c.file" and so on. The source mask for this is "*.*" and
2314 the destination is "\\2.\\1".
2316 .B "Use shell patterns off"
2318 When the shell patterns option is off the MC doesn't do automatic
2319 grouping anymore. You must use '\\(...\\)' expressions in the source
2320 mask to specify meaning for the wildcards in the target mask. This is
2321 more flexible but also requires more typing. Otherwise target masks
2322 are similar to the situation when the shell patterns option is on.
2324 Two examples:
2326 If the source mask is "^\\(.*\\)\\.tar\\.gz$", the destination is
2327 "/bla/*.tgz" and the file to be copied is "foo.tar.gz", the copy
2328 will be "/bla/foo.tgz".
2330 Let's suppose you want to swap basename and extension so that "file.c"
2331 will become "c.file" and so on. The source mask for this is
2332 "^\\(.*\\)\\.\\(.*\\)$" and the destination is "\\2.\\1".
2334 .B "Case Conversions"
2336 You can also change the case of the filenames.  If you use '\\u'
2337 or '\\l' in the target mask, the next character will be converted to
2338 uppercase or lowercase correspondingly.
2340 If you use '\\U' or '\\L' in the target mask, the next characters will
2341 be converted to uppercase or lowercase correspondingly up to the
2342 next '\\E' or next '\\U', '\\L' or the end of the file name.
2344 The '\\u' and '\\l' are stronger than '\\U' and '\\L'.
2346 For example, if the source mask is '*' (shell patterns on) or '^\\(.*\\)$'
2347 (shell patterns off) and the target mask is '\\L\\u*' the file names
2348 will be converted to have initial upper case and otherwise lower case.
2350 You can also use '\\' as a quote character. For example, '\\\\' is 
2351 a backslash and '\\*' is an asterisk.
2353 .SH "Internal File Viewer"
2354 The internal file viewer provides two display modes: ASCII and hex.
2355 To toggle between modes, use the F4 key.  If you have the GNU gzip
2356 program installed, it will be used to automatically decompress the
2357 files on demand.
2359 The viewer will try to use the best method provided by your system or
2360 the file type to display the information.  The internal file viewer
2361 will interpret some string sequences to set the bold and underline
2362 attributes, thus making a pretty display of your files.  
2364 When in hex mode, the search function accepts text in quotes and
2365 constant numbers.  Text in quotes is matched exactly after removing
2366 the quotes.  Each number matches one byte.  You can mix quoted text
2367 with constants like this:
2370 "String" -1 0xBB 012 "more text"
2373 Note that 012 is an octal number.  -1 is converted to 0xFF.
2375 Some internal details about the viewer: On systems that provide the
2376 mmap(2) system call, the program maps the file instead of loading it;
2377 if the system does not provide the mmap(2) system call or the file
2378 matches an action that requires a filter, then the viewer will use
2379 it's growing buffers, thus loading only those parts of the file that
2380 you actually access (this includes compressed files).
2382 Here is a listing of the actions associated with each key that the
2383 Midnight Commander handles in the internal file viewer.
2385 .B F1
2386 Invoke the builtin hypertext help viewer.
2388 .B F2
2389 Toggle the wrap mode.
2391 .B F4
2392 Toggle the hex mode.
2394 .B F5
2395 Goto line.  This will prompt you for a line number and will display
2396 that line.
2398 .B F6, /. 
2399 Regular expression search.
2401 .B ?,
2402 Reverse regular expression search.
2404 .B F7
2405 Normal search / hex mode search.
2407 .B C-s, F17, n.
2408 Start normal search if there was no previous search expression else
2409 find next match.
2411 .B C-r.
2412 Start reverse search if there was no previous search expression else
2413 find next match.
2415 .B F8
2416 Toggle Raw/Parsed mode: This will show the file as found on disk or if
2417 a processing filter has been specified in the mc.ext file, then the
2418 output from the filter. Current mode is always the other than written
2419 on the button label, since on the button is the mode which you enter
2420 by that key.
2422 .B F9
2423 Toggle the format/unformat mode: when format mode is on the viewer
2424 will interpret some string sequences to show bold and underline with
2425 different colors. Also, on button label is the other mode than current.
2427 .B F10, Esc.
2428 Exit the internal file viewer.
2430 .B next-page, space, C-v.
2431 Scroll one page forward.
2433 .B prev-page, M-v, C-b, backspace.
2434 Scroll one page backward.
2436 .B down-key
2437 Scroll one line forward.
2439 .B up-key
2440 Scroll one line backward.
2442 .B C-l
2443 Refresh the screen.
2445 .B C-o
2446 Switch to the subshell and show the command screen.
2448 .B !
2449 Like C-o, but run a new shell if the subshell is not running.
2451 .B "[n] m"
2452 Set the mark n.
2454 .B "[n] r"
2455 Jump to the mark n.
2457 .B C-f
2458 Jump to the next file.
2460 .B C-b 
2461 Jump to the previous file.
2463 .B M-r 
2464 Toggle the ruler.
2466 It's possible to instruct the file viewer how to display a file, look
2467 at the 
2468 .\"LINK2"
2469 Extension File Edit section
2470 .\"Extension File Edit"
2471 .SH "Internal File Editor"
2472 The internal file editor provides most of the features of
2473 common full screen editors. It is invoked using 
2474 .B F4
2475 provided
2476 the 
2477 .I use_internal_edit
2478 option is set in the initialization file. It has an extendable file size
2479 limit of sixteen megabytes and edits binary files flawlessly.
2481 The features it presently supports are: Block
2482 copy, move, delete, cut, paste; 
2483 .I "key for key undo"; 
2484 pull-down
2485 menus; file insertion; macro definition; regular expression
2486 search and replace (and our own scanf-printf search and
2487 replace); shift-arrow MSW-MAC text highlighting (for the
2488 linux console only); insert-overwrite toggle; and an option
2489 to pipe text blocks through shell commands like indent.
2491 The editor is very easy to use and requires no tutoring.
2492 To see what keys do what, just consult the appropriate
2493 pull-down menu. Other keys are: Shift movement
2494 keys do text highlighting. 
2495 .B Ctrl-Ins
2496 copies to the file
2497 .B cooledit.clip and 
2498 .B Shift-Ins
2499 pastes from cooledit.clip.
2500 .B Shift-Del 
2501 cuts to 
2502 .B cooledit.clip, 
2503 and 
2504 .B Ctrl-Del
2505 deletes highlighted text. The completion key also does a Return
2506 with an automatic indent. Mouse highlighting also works, and you
2507 can override the mouse as usual by holding down the shift key
2508 while dragging the mouse to let normal terminal mouse highlighting
2509 work.
2511 To define a macro, press 
2512 .B Ctrl-R
2513 and then type out the key
2514 strokes you want to be executed. Press 
2515 .B Ctrl-R
2516 again when finished. You can then assign the macro to any key you
2517 like by pressing that key. The macro is executed when you press
2518 .B Ctrl-A and then the assigned key. The macro is also executed if
2519 you press Meta, Ctrl, or Esc and the assigned key, provided that the
2520 key is not used for any other function. Once defined, the macro
2521 commands go into the file 
2522 .B .mc/cedit/cooledit.macros
2523 in your home directory. You can delete a macro by deleting the
2524 appropriate line in this file.
2526 .B F19
2527 will format the currently highlighted block (plain text or
2528 .B C
2530 .B C++
2531 code or another). This is controlled by the
2532 file
2533 .B @prefix@/lib/mc/edit.indent.rc
2534 which is copied to
2535 .B .mc/cedit/edit.indent.rc
2536 in your home directory the first time you use it.
2538 You can use scanf search and replace to search and replace
2539 a C format string. First take a look at the 
2540 .B sscanf
2541 and 
2542 .B sprintf
2543 man pages to see what a format string
2544 is and how it works. An example is as follows: Suppose you want
2545 to replace all occurrences of say, an open bracket, three
2546 comma separated numbers, and a close bracket, with the
2547 word 
2548 .I apples, 
2549 the third number, the word 
2550 .I oranges
2551 and then the second number, I would fill in the Replace dialog
2552 box as follows:
2555  Enter search string
2556 (%d,%d,%d)
2557  Enter replace string
2558 apples %d oranges %d
2559  Enter replacement argument order
2563 The last line specifies that the third and then the second
2564 number are to be used in place of the first and second.
2566 It is advisable to use this feature with Prompt on replace on, because
2567 a match is thought to be found whenever the number of arguments found
2568 matches the number given, which is not always a real match. Scanf also
2569 treats whitespace as being elastic.  Note that the scanf format % is
2570 very useful for scanning strings, and whitespace.
2572 The editor also displays non-us characters (160+). When editing
2573 binary files, you should set 
2574 .B display bits
2575 to 7 bits in the options menu to keep the spacing clean.
2577 .SH "Completion"
2578 Let the Midnight Commander type for you.
2580 Attempt to perform completion on the text before current position. MC
2581 attempts completion treating the text as variable (if the text begins with
2582 .B $
2583 ), username (if the text begins with 
2584 .B ~
2585 ), hostname (if the text
2586 begins with 
2587 .B @
2588 ) or command (if you are on the command line in the
2589 position where you might type a command, possible completions then include
2590 shell reserved words and shell builtin commands as well) in turn. If none
2591 of these produces a match, filename completion is attempted.
2593 Filename, username, variable and hostname completion works on all input
2594 lines, command completion is command line specific.
2595 If the completion is ambiguous (there are more different possibilities),
2596 MC beeps and the following action depends on the setting of the
2597 .I Complete: show all
2598 option in the
2599 .\"LINK2"
2600 Configuration
2601 .\"Configuration"
2602 dialog. If it is enabled, a list of all
2603 possibilities pops up next to the current position and you can select with
2604 the arrow keys and
2605 .B Enter
2606 the correct entry. You can also type the first letters in which the
2607 possibilities differ to move to a subset of all possibilities and complete
2608 as much as possible. If you press
2609 .B M-Tab
2610 again, only the subset will be shown in the listbox, otherwise the first
2611 item which matches all the previous characters will be highlighted. As soon
2612 as there is no ambiguity, dialog disappears, but you can hide it by
2613 canceling keys 
2614 .B Esc,
2615 .B F10
2616 and left and right arrow keys. If
2617 .\"LINK2"
2618 Complete: show all
2619 .\"Configuration"
2620 is disabled, the dialog pops up only if you press
2621 .B M-Tab
2622 for the second time, for the first time MC just beeps.
2624 .SH "Virtual File System"
2625 The Midnight Commander is provided with a code layer to access the
2626 file system; this code layer is known as the virtual file system
2627 switch.  The virtual file system switch allows the Midnight Commander
2628 to manipulate files not located on the Unix file system.
2630 Currently the Midnight Commander is packaged with some Virtual File
2631 Systems (VFS): the local file system, used for accessing the regular
2632 Unix file system; the ftpfs, used to manipulate files on remote
2633 systems with the FTP protocol; the tarfs, used to manipulate tar and
2634 compressed tar files; the undelfs, used to recover deleted files on
2635 ext2 file systems (the default file system for Linux systems), fish
2636 (for manipulating files over shell connections such as rsh and ssh) and
2637 finally the mcfs (Midnight Commander file system), a network based
2638 file system.  If the code was compiled with smbfs support, you can
2639 manipulate files on remote systems with the SMB (CIFS) protocol.
2641 The VFS switch code will interpret all of the path names used and will
2642 forward them to the correct file system, the formats used for each one
2643 of the file systems is described later in their own section.
2645 .SH "  FTP File System"
2646 The ftpfs allows you to manipulate files on remote machines, to
2647 actually use it, you may try to use the panel command FTP link
2648 (accessible from the menubar) or you may directly change your current
2649 directory to it using the cd command to a path name that looks like this:
2651 .I /#ftp:[!][user[:pass]@]machine[:port][remote-dir]
2654 .I user, port
2656 .I remote-dir
2657 elements are optional.  If you specify the
2658 .I user
2659 element, then the Midnight Commander will try to logon on the remote
2660 machine as that user, otherwise it will use your login name.  The
2661 optional 
2662 .I pass
2663 element, if present is the password used for the connection.  This is not
2664 recommended (nor keeping the password in your hotlist, unless you set the
2665 appropriate permissions there, and even then it may not be entirely safe).
2667 Examples:
2670     /#ftp:ftp.nuclecu.unam.mx/linux/local
2671     /#ftp:tsx-11.mit.edu/pub/linux/packages
2672     /#ftp:!behind.firewall.edu/pub
2673     /#ftp:guest@remote-host.com:40/pub
2674     /#ftp:miguel:xxx@server/pub
2677 To connect to sites behind a firewall, you will need to use the prefix
2678 ftp://! (i.e., with a bang character after the double slash) to make
2679 the Midnight Commander use a proxy host for doing the ftp transfer.
2680 You can define the proxy host in the
2681 .\"LINK2"
2682 Virtual File System
2683 .\"Virtual FS"
2684 dialog box.  
2686 Another option to set is the 
2687 .I Always use ftp proxy
2688 option in the 
2689 .\"LINK2"
2690 Virtual File System
2691 .\"Virtual FS"
2692 dialog box.  This will configure the program
2693 to always use the proxy host.  If this variable is set, the program
2694 will do two things: consult the @prefix@/lib/mc/mc.no_proxy file for
2695 lines containing host names that are local (if the host name starts
2696 with a dot, it is assumed to be a domain) and to assume that any
2697 hostnames without dots in their names are directly accessible.
2699 If you are using the ftpfs code with a filtering packet router that
2700 does not allow you to use the regular mode of opening files, you may
2701 want to force the program to use the passive-open mode.  To use this,
2702 set the ftpfs_use_passive_connections option in the initialization file.
2704 The Midnight Commander keeps the directory listing in a cache.  The cache
2705 expire time is configurable in the
2706 .\"LINK2"
2707 Virtual File System 
2708 .\"Virtual FS"
2709 dialog box.  This has the funny behavior that even if you make changes to a
2710 directory, they will not be reflected in the directory listing until you
2711 force a cache reload with the C-r key.  This is a feature (when you think
2712 it's a bug, think about manipulating files on the other side of the Atlantic
2713 with ftpfs).
2715 .SH "  Tar File System"
2716 The tar file system provides you with read-only access to your tar
2717 files and compressed tar files by using the chdir command.  To change
2718 your directory to a tar file, you change your current directory to the
2719 tar file by using the following syntax:
2721 .I /filename.tar#utar/[dir-inside-tar]
2723 The mc.ext file already provides a shortcut for tar files, this means
2724 that usually you just point to a tar file and press return to enter
2725 into the tar file, see the 
2726 .\"LINK2"
2727 Extension File Edit 
2728 .\"Extension File Edit"
2729 section for details on how this is done.
2731 Examples:
2734     mc-3.0.tar.gz#utar/mc-3.0/vfs
2735     /ftp/GCC/gcc-2.7.0.tar#utar
2738 The latter specifies the full path of the tar archive.
2739 .SH "  FIle transfer over SHell filesystem"
2741 The fish file system is a network based file system that allows you to
2742 manipulate the files in a remote machine as if they were local. To use
2743 this, the other side has to either run fish server, or has to have
2744 bash-compatible shell.
2746 To connect to a remote machine, you just need to chdir
2747 into a special directory which name is in the following
2748 format:
2751 /#sh:[user@]machine[:options]/[remote-dir]
2753 The 
2754 .I user, 
2755 .I options
2756 and 
2757 .I remote-dir
2758 elements are optional. If
2759 you specify the 
2760 .I user
2761 element then the Midnight Commander
2762 will try to logon on the remote machine as that user,
2763 otherwise it will use your login name.
2765 The 
2766 .I options
2767 are 'C' - use compression and 'rsh' use rsh instead
2768 of ssh. If the 
2769 .I remote-dir
2770 element is present, your current directory on the remote machine will
2771 be set to this one.
2773 Examples:
2776     /#sh:onlyrsh.mx:r/linux/local
2777     /#sh:joe@want.compression.edu:C/private
2778     /#sh:joe@noncompressed.ssh.edu/private
2781 .SH "  Network File System"
2782 The Midnight Commander file system is a network base file system that
2783 allows you to manipulate the files in a remote machine as if they
2784 were local.  To use this, the remote machine must be running the
2785 mcserv(8) server program.
2787 To connect to a remote machine, you just need to chdir into a special
2788 directory which name is in the following format:
2790 .I /#mc:[user@]machine[:port][remote-dir]
2793 .I user, port
2795 .I remote-dir
2796 elements are optional.  If you specify the 
2797 .I user
2798 element then the Midnight Commander will try to logon on the remote
2799 machine as that user, otherwise it will use your login name.
2801 The 
2802 .I port
2803 element is used when the remote machine running on a special port
2804 (see the mcserv(8) manual page for more information about ports);
2805 finally, if the
2806 .I remote-dir
2807 element is present, your current directory on the remote machine will
2808 be set to this one.
2810 Examples:
2813     /#mc:ftp.nuclecu.unam.mx/linux/local
2814     /#mc:joe@foo.edu:11321/private
2817 .SH "  Undelete File System"
2818 On Linux systems, if you asked configure to use the ext2fs undelete
2819 facilities, you will have the undelete file system available.
2820 Recovery of deleted files is only available on ext2 file systems.  The
2821 undelete file system is just an interface to the ext2fs library to:
2822 retrieve all of the deleted files names on an ext2fs and provides and
2823 to extract the selected files into a regular partition.
2825 To use this file system, you have to chdir into the special file name
2826 formed by the "/#undel" prefix and the file name where the actual
2827 file system resides.
2829 For example, to recover deleted files on the second partition of the
2830 first SCSI disk on Linux, you would use the following path name:
2833     /#undel:sda2
2836 It may take a while for the undelfs to load the required information
2837 before you start browsing files there. 
2839 .SH "  SMB File System"
2840 The smbfs allows you to manipulate files on remote machines with SMB
2841 (or CIFS) protocol.  These include Windows for Workgroups, 
2842 Windows 9x, Windows NT, Windows 2000, OS/2 and Samba.
2843 To actually use it, you may try 
2844 to use the panel command "SMB link..."
2845 (accessible from the menubar) or you may directly change your current
2846 directory to it using the cd command to a path name that looks like this:
2848 .I /#smb:machine[/service][/remote-dir]
2851 .I service
2853 .I remote-dir
2854 elements are optional.
2856 .I username, domain
2858 .I password 
2859 can be specified in input dialog.
2861 Examples:
2864     /#smb:machine/Share
2865     /#smb:other_machine
2868 .SH "Colors"
2869 The Midnight Commander will try to detect if your terminal supports
2870 color using the terminal database and your terminal name.  Sometimes
2871 it gets confused, so you may force color mode or disable color mode
2872 using the -c and -b flag respectively.  
2874 If the program is compiled with the Slang screen manager instead of
2875 ncurses, it will also check the variable 
2876 .B COLORTERM,
2877 if it is set, it has the same effect as the -c flag.
2879 You may specify terminals that always force color mode
2880 by adding the 
2881 .I color_terminals
2882 variable to the Colors
2883 section of the initialization file. This will prevent the
2884 Midnight Commander from trying to detect if your terminal
2885 supports color. Example:
2887 [Colors]
2888 color_terminals=linux,xterm
2891 color_terminals=terminal-name1,terminal-name2...
2894 The program can be compiled with both ncurses and slang, ncurses does
2895 not provide a way to force color mode: ncurses uses just the
2896 information in the terminal database.
2898 The Midnight Commander provides a way to change the default colors.
2899 Currently the colors are configured using the environment variable
2900 .B MC_COLOR_TABLE 
2901 or the Colors section in the initialization file.
2903 In the Colors section, the default color map is loaded from the 
2904 .I base_color 
2905 variable.  You can specify an alternate color map for a terminal by
2906 using the terminal name as the key in this section.  Example:
2909 [Colors]
2910 base_color=
2911 xterm=menu=magenta:marked=,magenta:markselect=,red
2914 The format for the color definition is:
2917   <keyword>=<foregroundcolor>,<backgroundcolor>:<keyword>= ...
2920 The colors are optional, and the keywords are: normal,
2921 selected, marked, markselect, errors, input, reverse, gauge;
2922 Menu colors are: menu, menusel, menuhot, menuhotsel;  Dialog colors
2923 are: dnormal, dfocus, dhotnormal, dhotfocus;  Help colors
2924 are: helpnormal, helpitalic, helpbold, helplink, helpslink;  
2925 Viewer color is: viewunderline; Special highlighting colors are: 
2926 executable, directory, link, device, special, core; Editor colors
2927 are: editnormal, editbold, editmarked.
2929 .I input 
2930 determines the color of input lines used in query dialogs.
2932 .I gauge 
2933 determines the color of the filled part of the progress bar
2934 (gauge), which shows how many percent of files were copied
2935 etc. in a graphical way.
2937 The dialog boxes use the following colors:
2938 .I dnormal 
2939 is used for the normal text,
2940 .I dfocus
2941 is the color used for the currently selected component,
2942 .I dhotnormal
2943 is the color used to differentiate the hotkey color in normal
2944 components, whereas the
2945 .I dhotfocus
2946 color is used for the highlighted color in the currently selected
2947 component.
2949 Menus use the same scheme but uses the menu, menusel, menuhot and
2950 menuhotsel tags instead.
2952 Help uses the following colors:
2953 .I helpnormal
2954 is used for normal text,
2955 .I helpitalic
2956 is used for text which is emphasized in italic in the manual page,
2957 .I helpbold
2958 is used for text which is emphasized in bold in the manual page,
2959 .I helplink
2960 is used for not selected hyperlinks and
2961 .I helpslink
2962 is used for selected hyperlink.
2964 Special highlight colors determine how files are displayed 
2965 when file highlighting is enabled (see the section on
2966 .\"LINK2"
2967 Layout).
2968 .\"Layout
2969 .I directory
2970 is used for directories or symbolic links to directories; 
2971 .I executable
2972 for executable files;
2973 .I link
2974 is used for symbolic links which are neither stalled nor linked
2975 to a directory; 
2976 .I stalledlink
2977 is used for stalled symbolic links; 
2978 .I device
2979 - character and block devices; 
2980 .I special
2981 is used for special files, such as pipes and sockets; 
2982 .I core
2983 is for core files.
2985 The possible colors are: black, gray, red, brightred, green,
2986 brightgreen, brown, yellow, blue, brightblue, magenta, brightmagenta,
2987 cyan, brightcyan, lightgray and white. And there is a special keyword
2988 for transparent background. It is 'default'. The 'default' can only be
2989 used for background color. Example:
2991 [Colors]
2992 base_color=normal=white,default:marked=magenta,default
2995 .SH "Special Settings"
2996 Most of the settings of the Midnight Commander can be changed from the
2997 menus. However, there are a small number of settings which can only be
2998 changed by editing the setup file.
3000 These variables may be set in your ~/.mc/ini file:
3002 .I clear_before_exec.
3004 By default the Midnight Commander clears the screen before executing a
3005 command. If you would prefer to see the output of the command at the
3006 bottom of the screen, edit your ~/.mc/ini file and change the value of
3007 the field clear_before_exec to 0.
3009 .I confirm_view_dir.
3011 If you press F3 on a directory, normally MC enters that directory. If
3012 this flag is set to 1, then MC will ask for confirmation before
3013 changing the directory if you have files tagged.
3015 .I ftpfs_retry_seconds.
3017 This value is the number of seconds the Midnight Commander will wait
3018 before attempting to reconnect to an ftp server that has denied the login.
3019 If the value is zero, the login will no be retried.
3021 .I ftpfs_use_passive_connections.
3023 This option is off by default.  This makes the ftpfs code use the
3024 passive open mode for transferring files.  This is used by people that
3025 are behind a filtering packet router.  This option just works if you
3026 are not using an ftp proxy.
3028 .I max_dirt_limit.
3030 Specifies how many screen updates can be skipped at most in the internal
3031 file viewer.  Normally this value is not significant, because the code
3032 automatically adjusts the number of updates to skip according to the rate
3033 of incoming keystrokes.  However, on very slow machines or terminals
3034 with a fast keyboard auto repeat, a big value can make screen updates
3035 too jumpy.
3037 It seems that setting max_dirt_limit to 10 causes the best behavior,
3038 and that is the default value.
3040 .I mouse_move_pages.
3042 Controls whenever scrolling with the mouse is done by pages or line by
3043 line on the panels.
3045 .I mouse_move_pages_viewer.
3047 Controls if scrolling with the mouse is done by pages or line by line
3048 on the internal file viewer.
3050 .I old_esc_mode
3052 By default the Midnight Commander treats the ESC key as a key prefix
3053 (old_esc_mode=0), if you set this option (old_esc_mode=1), then the
3054 ESC key will act as a prefix key for one second, and if no extra keys
3055 have arrived, then the ESC key is interpreted as a cancel key (ESC
3056 ESC).
3059 .I only_leading_plus_minus
3061 set special treatment for '+', '-', '*' in command line (select,
3062 unselect, reverse selection) only if command line is empty. No need to
3063 quote this characters in the middle of the command line. But we can not
3064 change selection when command line is not empty.
3065 .I panel_scroll_pages
3067 If set (the default), panel will scroll by half the display when the
3068 cursor reaches the end or the beginning of the panel, otherwise it
3069 will just scroll a file at a time.
3071 .I preserve_uidgid
3073 If this option is set (the default), when logged in as root the
3074 default will be to preserve the UID and the GID of files.  Some users
3075 prefer to disable this option, so that's why it's configurable.
3077 .I show_output_starts_shell
3079 This variable only works if you are not using the subshell support.
3080 When you use the C-o keystroke to go back to the user screen, if this
3081 one is set, you will get a fresh shell.  Otherwise, pressing any key
3082 will bring you back to the Midnight Commander.
3084 .I torben_fj_mode
3086 If this flag is set, then the home and end keys will work slightly
3087 different on the panels, instead of moving the selection to the first
3088 and last files in the panels, they will act as follows:
3090 The home key will: Go up to the middle line, if below it; else go to
3091 the top line unless it is already on the top line, in this case it
3092 will go to the first file in the panel.
3094 The end key has a similar behavior: Go down to the middle line, if
3095 over it; else go to the bottom line unless you already are at the
3096 bottom line, in such case it will move the selection to the last file
3097 name in the panel.
3099 .I use_file_to_guess_type
3101 If this variable is on (the default) it will spawn the file command to
3102 match the file types listed on the
3103 .\"LINK2"
3104 mc.ext file.
3105 .\"Extension File Edit"
3107 .I xterm_mode
3109 If this variable is on (default is off) when you browse the file
3110 system on a Tree panel, it will automatically reload the other panel
3111 with the contents of the selected directory.
3113 .SH "Terminal databases"
3114 The Midnight Commander provides a way to fix your system terminal
3115 database without requiring root privileges.  The Midnight Commander
3116 searches in the system initialization file (the mc.lib file located in
3117 the Midnight Commander library directory) and in the ~/.mc/ini file
3118 for the section "terminal:your-terminal-name" and then for the section
3119 "terminal:general", each line of the section contains a key symbol
3120 that you want to define, followed by an equal sign and the definition
3121 for the key.  You can use the special \\e form to represent the escape
3122 character and the ^x to represent the control-x character.
3124 The possible key symbols are:
3127 f0 to f20     Function keys f0-f20
3128 bs            backspace
3129 home          home key
3130 end           end key
3131 up            up arrow key
3132 down          down arrow key
3133 left          left arrow key
3134 right         right arrow key
3135 pgdn          page down key
3136 pgup          page up key
3137 insert        the insert character
3138 delete        the delete character
3139 complete      to do completion
3142 For example, to define the key insert to be the Escape + [ + O + p, you
3143 set this in the ini file:
3146 insert=\\e[Op
3149 The 
3150 .I complete
3151 key symbol represents the escape sequences used to invoke the
3152 completion process, this is invoked with M-tab, but you can define
3153 other keys to do the same work (on those keyboard with tons of nice
3154 and unused keys everywhere).
3156 .SH ""
3157 .SH "FILES"
3159 The program will retrieve all of its information relative to the
3160 MC_LIBDIR environment variable, if this variable is not set, then it will
3161 fall back to the @prefix@/lib/mc directory.
3163 @prefix@/lib/mc/mc.hlp
3165 The help file for the program.
3167 @prefix@/lib/mc/mc.ext
3169 The default system-wide extensions file.
3171 ~/.mc/bindings
3173 User's own extension, view configuration and edit configuration
3174 file.  They override the contents of the system wide files if present.
3176 @prefix@/lib/mc/mc.ini
3178 The default system-wide setup for the Midnight Commander, used only if
3179 the user doesn't have his own ~/.mc/ini file.
3181 @prefix@/lib/mc/mc.lib
3183 Global settings for the Midnight Commander.  Settings in this file
3184 affect all users, whether they have ~/.mc/ini or not.  Currently, only
3185 .\"LINK2"
3186 terminal settings
3187 .\"Terminal databases"
3188 are loaded from mc.lib.
3190 ~/.mc/ini
3192 User's own setup. If this file is present then the setup is loaded
3193 from here instead of the system-wide startup file.
3195 @prefix@/lib/mc/mc.hint
3197 This file contains the hints (cookies) displayed by the program.
3199 @prefix@/lib/mc/mc.menu
3201 This file contains the default system-wide applications menu.
3203 ~/.mc/menu
3205 User's own application menu. If this file is present it is used
3206 instead of the system-wide applications menu.
3208 ~/.mc/Tree
3210 The directory list for the directory tree and tree view features.
3212 \&./.mc.menu
3214 Local user-defined menu. If this file
3215 is present it is used instead of the home or system-wide
3216 applications menu.
3218 .\"SKIP_SECTION"
3219 .SH "LICENZA"
3220 Questo programma è distribuito sotto i termini della Licenza Generale
3221 GNU come pubblicata dalla Free Software Foundation. Vedere l'aiuto integrato
3222 per i dettagli sulla licenza e sulla mancanza di garanzie.
3223 .\"NODE "AVAILABILITY"
3224 .SH "REPERIBILITA'"
3225 L'ultima versione di questo programma si trova su
3226 ftp://ftp.gnome.org/mirror/gnome.org/stable/sources/mc/ e sui
3227 mirror elencati sul sito GNOME http://www.gnome.org/.
3228 .\"NODE "SEE ALSO"
3229 .SH "VEDERE ANCHE"
3230 ed(1), gpm(1), mcserv(8), terminfo(1), view(1), sh(1), bash(1),
3231 tcsh(1), zsh(1).
3234 La pagina Web del The Midnight Commander:
3235         http://www.gnome.org/mc/
3238 .\"NODE "AUTHORS"
3239 .SH "AUTORI"
3240 Miguel de Icaza (miguel@ximian.com), Janne Kukonlehto
3241 (jtklehto@paju.oulu.fi), Radek Doulik (rodo@ucw.cz), Fred
3242 Leeflang (fredl@nebula.ow.org), Dugan Porter (dugan@b011.eunet.es),
3243 Jakub Jelinek (jj@sunsite.mff.cuni.cz), Ching Hui
3244 (mr854307@cs.nthu.edu.tw), Andrej Borsenkow (borsenkow.msk@sni.de),
3245 Norbert Warmuth (nwarmuth@privat.circular.de), 
3246 Mauricio Plaza (mok@roxanne.nuclecu.unam.mx), Paul Sheer
3247 (psheer@icon.co.za), Pavel Machek (pavel@ucw.cz) e Pavel Roskin
3248 (proski@gnu.org) sono gli sviluppatori di questo pacchetto.
3249 Alessandro Rubini (rubini@ipvvis.unipv.it) ha dato un notevole
3250 contribuito nella correzione e nel miglioramento del supporto del
3251 mouse nel programma, John Davis (davis@space.mit.edu) ha reso
3252 disponibile la sua libreria S-lang sotto la licenza GPL e ha risposto
3253 alle mie domande su di essa; le seguenti persone hanno contribuito
3254 al codice e in molte correzioni (in ordine alfabetico):
3256 Adam Tla/lka (atlka@sunrise.pg.gda.pl),
3257 alex@bcs.zp.ua (Alex I. Tkachenko), Antonio Palama,
3258 DOS port (palama@posso.dm.unipi.it), Erwin van Eijk
3259 (wabbit@corner.iaf.nl), Gerd Knorr (kraxel@cs.tu-berlin.de),
3260 Jean-Daniel Luiset (luiset@cih.hcuge.ch), Jon Stevens
3261 (root@dolphin.csudh.edu), Juan Francisco Grigera, port su piattaforma Win32
3262 (j-grigera@usa.net), Juan Jose Ciarlante (jjciarla@raiz.uncu.edu.ar),
3263 Ilya Rybkin (rybkin@rouge.phys.lsu.edu), Marcelo Roccasalva
3264 (mfroccas@raiz.uncu.edu.ar), Massimo Fontanelli (MC8737@mclink.it),
3265 Sergey Ya. Korshunoff (root@seyko.msk.su), Thomas Pundt
3266 (pundtt@math.uni-muenster.de), Timur Bakeyev
3267 (timur@goff.comtat.kazan.su), Tomasz Cholewo
3268 (tjchol01@mecca.spd.louisville.edu), Torben Fjerdingstad
3269 (torben.fjerdingstad@uni-c.dk), Vadim Sinolitis (vvs@nsrd.npi.msu.su)
3270 and Wim Osterholt (wim@djo.wtm.tudelft.nl).
3272 .\"NODE "BUGS"
3273 .SH "BACHI"
3274 Vedere il file TODO nella distribuzione per informazioni su
3275 quello che rimane ancora da fare.
3277 Se si vuole fare un rapporto di un problema nel programma, prego spedire
3278 un messaggio di post a questo indirizzo: mc-devel@gnome.org.
3280 Nel rapporto è necessario fornire una descrizione dettagliata del baco, 
3281 la versione del programma (mc -v mostra quest'informazione), il sistema 
3282 operativo su cui si sta facendo girare il programma e, se il programma 
3283 va in crash, è gradita una traccia dello stack.