diff options
author | Michael Reed <m.reed@mykolab.com> | 2015-05-11 17:30:18 -0400 |
---|---|---|
committer | Michael Reed <m.reed@mykolab.com> | 2015-05-13 18:16:51 -0400 |
commit | 0086c0a53b17d99bb336832f45899ee1fb6a67b7 (patch) | |
tree | ac5d38c5ce37ac984ae7e18ab70cc172c75c1929 /runtime/doc/manpages/it | |
parent | b0b30769951963bd439d45586a0c86bba445d6ee (diff) | |
download | rneovim-0086c0a53b17d99bb336832f45899ee1fb6a67b7.tar.gz rneovim-0086c0a53b17d99bb336832f45899ee1fb6a67b7.tar.bz2 rneovim-0086c0a53b17d99bb336832f45899ee1fb6a67b7.zip |
Man pages: Move to nvim namespace and out of `runtime/`
Also clean up man page references in `runtime/doc/Makefile` as it
doesn't deal with them anymore.
Diffstat (limited to 'runtime/doc/manpages/it')
-rw-r--r-- | runtime/doc/manpages/it/vim-it.1 | 484 | ||||
-rw-r--r-- | runtime/doc/manpages/it/vimtutor-it.1 | 58 | ||||
-rw-r--r-- | runtime/doc/manpages/it/xxd-it.1 | 402 |
3 files changed, 0 insertions, 944 deletions
diff --git a/runtime/doc/manpages/it/vim-it.1 b/runtime/doc/manpages/it/vim-it.1 deleted file mode 100644 index 1bee867e2a..0000000000 --- a/runtime/doc/manpages/it/vim-it.1 +++ /dev/null @@ -1,484 +0,0 @@ -.TH VIM 1 "22 febbraio 2002" -.SH NOME -vim \- VI Migliorato, un editor di testi per programmatori -.SH SINTASSI -.br -.B vim -[opzioni] [file ..] -.br -.B vim -[opzioni] \- -.br -.B vim -[opzioni] \-t tag -.br -.B vim -[opzioni] \-q [file_errori] -.SH DESCRIZIONE -.B Vim -Un editore di testi, compatibile con, e migliore di, Vi. -Può essere usato per editare qualsiasi file di testo. -Particolarmente utile per editare programmi. -.PP -Ci sono parecchi miglioramenti rispetto a Vi: undo multipli, -finestre e buffer multipli, evidenziazione sintattica, possibilità -di modificare la linea di comando, completamento nomi file, help -in linea, selezione testi in Modo Visual, etc.. -Vedere ":help vi_diff.txt" per un sommario delle differenze fra -.B Vim -e Vi. -.PP -Mentre usate -.B Vim -potete ricevere molto aiuto dal sistema di help online, col comando ":help". -Vedere qui sotto la sezione AIUTO ONLINE. -.PP -Quasi sempre -.B Vim -viene invocato, per modificare un file, col comando -.PP - vim nome_file -.PP -Più in generale -.B Vim -viene invocato con: -.PP - vim [opzioni] [lista_file] -.PP -Se lista_file non è presente, l'editor inizia aprendo un buffer vuoto. -Altrimenti, una e una sola delle quattro maniere indicate qui sotto può -essere usata per scegliere uno o più file da modificare. -.TP 12 -nome_file .. -Una lista di nomi di file. -Il primo di questi sarà il file corrente, e verrà letto nel buffer. -Il cursore sarà posizionato sulla prima linea del buffer. -Potete arrivare agli altri file col comando ":next". -Per editare un file il cui nome inizia per "\-" premettete "\-\-" alla -lista_file. -.TP -\- -Il file da editare è letto dallo "stdin" [di solito, ma non -necessariamente, il terminale \- NdT]. I comandi sono letti da "stderr", -che dovrebbe essere un terminale [tty]. -.TP -\-t {tag} -Il file da editare e la posizione iniziale del cursore dipendono da "tag", -una specie di "etichetta" a cui saltare. -{tag} viene cercata nel file "tags", ed il file ad essa associato diventa -quello corrente, ed il comando ad essa associato viene eseguito. -Di solito si usa per programmi C, nel qual caso {tag} potrebbe essere un -nome di funzione. -L'effetto è che il file contenente quella funzione diventa il file corrente -e il cursore è posizionato all'inizio della funzione. -Vedere ":help tag\-commands". -.TP -\-q [file_errori] -Inizia in Modo QuickFix [correzione veloce]. -Il file [file_errori] è letto e il primo errore è visualizzato. -Se [file_errori] non è indicato, il suo nome è ottenuto dal valore -dell'opzione 'errorfile' (che, se non specificata, vale "AztecC.Err" -per l'Amiga, "errors.err" su altri sistemi). -Si può saltare all'errore successivo col comando ":cn". -Vedere ":help quickfix". -.SH OPZIONI -Le opzioni possono essere in un ordine qualsiasi, prima o dopo i nomi di -file. Opzioni che non necessitano un argomento possono essere specificate -dietro a un solo "\-". -.TP 12 -+[numero] -Per il primo file il cursore sarà posizionato sulla linea "numero". -Se "numero" manca, il cursore sarà posizionato sull'ultima linea del file. -.TP -+/{espressione} -Per il primo file il cursore sarà posizionato alla -prima occorrenza di {espressione}. -Vedere ":help search\-pattern" per come specificare l'espressione. -.TP -+{comando} -.TP -\-c {comando} -{comando} sarà eseguito dopo che il -primo file è stato letto. -{comando} è interpretato come un comando Ex. -Se il {comando} contiene spazi deve essere incluso fra doppi apici -(o altro delimitatore, a seconda della shell che si sta usando). -Esempio: Vim "+set si" main.c -.br -Note: Si possono avere fino a 10 comandi "+" o "\-c". -.TP -\-S {file} -I comandi contenuti in {file} sono eseguiti dopo la lettura del primo file. -Equivalente a \-c "source {file}". -{file} non può avere un nome che inizia per '\-'. -Se {file} è omesso si usa "Session.vim" (funziona solo se \-S è l'ultimo -argomento specificato). -.TP -\-\-cmd {comando} -Come "\-c", ma il comando è eseguito PRIMA -di eseguire qualsiasi file vimrc. -Si possono usare fino a 10 di questi comandi, indipendentemente dai comandi -"\-c". -.TP -\-A -Se -.B Vim -è stato compilato con supporto Arabic per editare file con orientamento -destra-sinistra e tastiera con mappatura Araba, questa opzione inizia -.B Vim -in Modo Arabic, cioè impostando 'arabic'. -Altrimenti viene dato un messaggio di errore e -.B Vim -termina in modo anormale. -.TP -\-b -Modo Binary (binario). -Vengono impostate alcune opzioni che permettono di modificare un file -binario o un programma eseguibile. -.TP -\-d -Inizia in Modo Diff [differenze]. -Dovrebbero esserci come argomenti due o tre o quattro nomi di file. -.B Vim -aprirà tutti i file evidenziando le differenze fra gli stessi. -.TP -\-d {dispositivo} -Apre {dispositivo} per usarlo come terminale. -Solo per l'Amiga. -Esempio: -"\-d con:20/30/600/150". -.TP -\-D -Debugging. Vim si mette in Modo "debugging" a partire -dall'esecuzione del primo comando da uno script. -.TP -\-e -Eseguire -.B Vim -in Modo Ex, come se il programma eseguito sia "ex". -.TP -\-E -Eseguire -.B Vim -in Modo Ex migliorato, come se il programma eseguito sia "exim". -.TP -\-f -Direttamente [Foreground]. Per la versione GUI, -.B Vim -non crea [fork] una nuova finestra, indipendente dalla shell di invocazione. -Per l'Amiga, -.B Vim -non è fatto ripartire per aprire una nuova finestra. -Opzione da usare quando -.B Vim -è eseguito da un programma che attende la fine della -sessione di edit (ad es. mail). -Sull'Amiga i comandi ":sh" e ":!" non sono disponibili. -.TP -\-F -Se -.B Vim -è stato compilato con supporto FKMAP per editare file con orientamento -destra-sinistra e tastiera con mappatura Farsi, questa opzione inizia -.B Vim -in Modo Farsi, cioè impostando 'fkmap' e 'rightleft'. -Altrimenti viene dato un messaggio di errore e -.B Vim -termina in modo anormale. -.TP -\-g -Se -.B Vim -è stato compilato con supporto GUI, questa opzione chiede di usarla. -Se Vim è stato compilato senza supporto GUI viene dato un messaggio di errore e -.B Vim -termina in modo anormale. -.TP -\-h -Un po' di aiuto su opzioni e argomenti che si possono dare invocando Vim. -Subito dopo -.B Vim -esce. -.TP -\-H -Se -.B Vim -è stato compilato col supporto RIGHTLEFT per editare file con orientamento -destra-sinistra e tastiera con mappatura Ebraica, questa opzione inizia -.B Vim -in Modo Ebraico, cioè impostando 'hkmap' e 'rightleft'. -Altrimenti viene dato un messaggio di errore e -.B Vim -termina in modo anormale. -.TP -\-i {viminfo} -Se è abilitato l'uso di un file viminfo, questa opzione indica il nome -del file da usare invece di quello predefinito "~/.viminfo". -Si può anche evitare l'uso di un file .viminfo, dando come nome "NONE". -.TP -\-L -Equivalente a \-r. -.TP -\-l -Modo Lisp. -Imposta le opzioni 'lisp' e 'showmatch'. -.TP -\-m -Inibisce modifica file. -Annulla l'opzione 'write'. -È ancora possibile modificare un buffer [in memoria \- Ndt], ma non scriverlo. -.TP -\-M -Modifiche non permesse. Le opzioni 'modifiable' e 'write' sono annullate, -in modo da impedire sia modifiche che riscritture. Da notare che queste -opzioni possono essere abilitate in seguito, permettendo così modifiche. -.TP -\-n -Inibisce l'uso di un file di swap. -Il recupero dopo una caduta di macchina diventa impossibile. -Utile per editare un file su un supporto molto lento (ad es. floppy). -Il comando ":set uc=0" ha lo stesso effetto. -Per abilitare il recupero usare ":set uc=200". -.TP -\-nb -Diviene un Editor server per NetBeans. Vedere la documentazione per dettagli. -.TP -\-o[N] -Apri N finestre in orizzontale. -Se N manca, apri una finestra per ciascun file. -.TP -\-O[N] -Apri N finestre, in verticale. -Se N manca, apri una finestra per ciascun file. -.TP -\-R -Modo Read-only (Sola Lettura). -Imposta l'opzione 'readonly'. -Si può ancora modificare il buffer, ma siete protetti da una riscrittura -involontaria. -Se volete davvero riscrivere il file, aggiungete un punto esclamativo -al comando Ex, come in ":w!". -L'opzione \-R implica anche l'opzione \-n (vedere sotto). -L'opzione 'readonly' può essere annullata con ":set noro". -Vedere ":help 'readonly'". -.TP -\-r -Lista file di swap, assieme a dati utili per un recupero. -.TP -\-r {file} -Modo Recovery (ripristino). -Il file di swap è usato per recuperare una sessione di edit finita male. -Il file di swap è un file con lo stesso nome file del file di testo -editato, col suffisso ".swp". -Vedere ":help recovery". -.TP -\-s -Modo silenzioso. Solo quando invocato come "Ex" o quando l'opzione -"\-e" è stata data prima dell'opzione "\-s". -.TP -\-s {scriptin} -Lo script file {scriptin} è letto. -I caratteri nel file sono interpretati come se immessi da voi. -Lo stesso si può ottenere col comando ":source! {scriptin}". -Se la fine del file di input viene raggiunta prima che Vim termini, -l'ulteriore input viene preso dalla tastiera. -.TP -\-T {terminale} -Dice a -.B Vim -quale tipo di terminale state usando. -Utile solo se il terminale non viene riconosciuto correttamente da Vim. -Dovrebbe essere un terminale noto a -.B Vim -(internamente) o definito nel file termcap o terminfo. -.TP -\-u {vimrc} -Usa i comandi nel file {vimrc} per inizializzazioni. -Tutte le altre inizializzazioni non sono eseguite. -Usate questa opzione per editare qualche file di tipo speciale. -Può anche essere usato per non fare alcuna inizializzazione dando -come nome "NONE". -Vedere ":help initialization" da vim per ulteriori dettagli. -.TP -\-U {gvimrc} -Usa i comandi nel file {gvimrc} per inizializzazioni GUI. -Tutte le altre inizializzazioni GUI non sono eseguite. -Può anche essere usata per non fare alcuna inizializzazione GUI dando -come nome "NONE". -Vedere ":help gui-init" da vim per ulteriori dettagli. -.TP -\-V[N] -Verboso. Vim manda messaggi relativi agli script file che esegue -e quando legge o scrive un file viminfo. Il numero opzionale N è il valore -dell'opzione 'verbose'. -Il valore predefinito è 10. -.TP -\-w {scriptout} -Ogni carattere immesso viene registrato nel file {scriptout}, -finché non uscite da -.B Vim. -Utile se si vuole creare uno script file da usare con "vim \-s" o -":source!". -Se il file {scriptout} esiste, quel che immettete viene aggiunto in fondo. -.TP -\-W {scriptout} -Come \-w, ma uno script file esistente viene sovrascritto. -.TP -\-x -Uso di cifratura nella scrittura dei file. E' necessario immettere -una chiave di cifratura. -.TP -\-X -Non connetterti al server X. Vim parte più rapidamente, -ma il titolo della finestra e la clipboard non sono disponibili. -.TP -\-Z -Modo ristretto. Vim si comporta come se invocato con un nome -che inizia per "r". -.TP -\-\- -Specifica la fine delle opzioni. -Argomenti specificati dopo questo sono considerati nomi file. -Si può usare per editare un file il cui nome inizi per '-'. -.TP -\-\-echo\-wid -Solo con GUI GTK: Visualizza Window ID su "stdout". -.TP -\-\-help -Vim dà un messaggio ed esce, come con l'argomento "\-h". -.TP -\-\-literal -Considera i nomi passati come argomenti letterali, senza espandere -metacaratteri. Non necessario in Unix, la shell espande i metacaratteri. -.TP -\-\-noplugin -Non caricare plugin. Implicito se si specifica \-u NONE. -.TP -\-\-remote -Connettersi a un server Vim e chiedere di editare i file elencati come altri -argomenti. Se non si trova un server viene dato un messaggio e i file sono -editati nel Vim corrente. -.TP -\-\-remote\-expr {expr} -Connettersi a un server Vim, valutare ivi {expr} e stampare il risultato -su "stdout". -.TP -\-\-remote\-send {chiavi} -Connettersi a un server Vim e spedirgli {chiavi}. -.TP -\-\-remote\-silent -Come \-\-remote, ma senza avvisare se non si trova un server. -.TP -\-\-remote-wait -Come \-\-remote, ma Vim non termina finché i file non sono stati editati. -.TP -\-\-remote\-wait\-silent -Come \-\-remote\-wait, ma senza avvisare se non si trova un server. -.TP -\-\-serverlist -Lista i nomi di tutti i server Vim disponibili. -.TP -\-\-servername {nome} -Usa {nome} come nome server. Usato per il Vim corrente, a meno che sia -usato con l'argomento \-\-remote, nel qual caso indica il server a cui -connettersi. -.TP -\-\-socketid {id} -Solo con GUI GTK: Usa il meccanismo GtkPlug per eseguire gvim in un'altra -finestra. -.TP -\-\-version -Stampa la versione di Vim ed esci. -.SH AIUTO ONLINE -Battere ":help" in -.B Vim -per iniziare. -Battere ":help argomento" per ricevere aiuto su uno specifico argomento. -Per esempio: ":help ZZ" per ricevere aiuto sul comando "ZZ". -Usare <Tab> e CTRL\-D per completare gli argomenti -(":help cmdline\-completion"). -Ci sono "tag" nei file di help per saltare da un argomento a un altro -(simili a legami ipertestuali, vedere ":help"). -Tutti i file di documentazione possono essere navigati così. Ad es.: -":help syntax.txt". -.SH FILE -.TP 15 -/usr/local/lib/vim/doc/*.txt -I file di documentazione di -.B Vim -. -Usate ":help doc\-file\-list" per avere la lista completa. -.TP -/usr/local/lib/vim/doc/tags -Il file di tags usato per trovare informazioni nei file di documentazione. -.TP -/usr/local/lib/vim/syntax/syntax.vim -Inizializzazioni sintattiche a livello di sistema. -.TP -/usr/local/lib/vim/syntax/*.vim -File di colorazione sintattica per vari linguaggi. -.TP -/usr/local/lib/vim/vimrc -Inizializzazioni -.B Vim -a livello di sistema. -.TP -~/.vimrc -Le vostre personali inizializzazioni di -.B Vim -. -.TP -/usr/local/lib/vim/gvimrc -Inizializzazioni gvim a livello di sistema. -.TP -~/.gvimrc -Le vostre personali inizializzazioni di gvim. -.TP -/usr/local/lib/vim/optwin.vim -Script Vim usato dal comando ":options", un modo semplice -per visualizzare e impostare opzioni. -.TP -/usr/local/lib/vim/menu.vim -Inizializzazioni del menù gvim a livello di sistema. -.TP -/usr/local/lib/vim/bugreport.vim -Script Vim per generare una segnalazione di errore. Vedere ":help bugs". -.TP -/usr/local/lib/vim/filetype.vim -Script Vim per determinare il tipo di un file a partire dal suo nome. -Vedere ":help 'filetype'". -.TP -/usr/local/lib/vim/scripts.vim -Script Vim per determinare il tipo di un file a partire dal suo contenuto. -Vedere ":help 'filetype'". -.TP -/usr/local/lib/vim/print/*.ps -File usati per stampa PostScript. -.PP -Per informazioni aggiornate [in inglese \- NdT] vedere la home page di Vim: -.br -<URL:http://www.vim.org/> -.SH VEDERE ANCHE -vimtutor(1) -.SH AUTORE -Buona parte di -.B Vim -è stato scritto da Bram Moolenaar, con molto aiuto da altri. -Vedere ":help credits" in -.B Vim. -.br -.B Vim -è basato su Stevie, scritto da: Tim Thompson, -Tony Andrews e G.R. (Fred) Walter. -In verità, poco o nulla è rimasto del loro codice originale. -.SH BACHI -Probabili. -Vedere ":help todo" per una lista di problemi noti. -.PP -Si noti che un certo numero di comportamenti che possono essere considerati -errori da qualcuno, sono in effetti causati da una riproduzione fin troppo -fedele del comportamento di Vi. -Se ritenete che altre cose siano errori "perché Vi si comporta diversamente", -date prima un'occhiata al file vi_diff.txt -(o battere :help vi_diff.txt da Vim). -Date anche un'occhiata alle opzioni 'compatible' e 'cpoptions. diff --git a/runtime/doc/manpages/it/vimtutor-it.1 b/runtime/doc/manpages/it/vimtutor-it.1 deleted file mode 100644 index a33dcb00b0..0000000000 --- a/runtime/doc/manpages/it/vimtutor-it.1 +++ /dev/null @@ -1,58 +0,0 @@ -.TH VIMTUTOR 1 "2 aprile 2001" -.SH NOME -vimtutor \- Un breve corso per imparare Vim -.SH SINTASSI -.br -.B vimtutor [\-g] [lingua] -.SH DESCRIZIONE -.B Vimtutor -inizia il -.B Vim -tutor (una breve corso per imparare Vim). -Per prima cosa viene creata una copia del file di lavoro, che può così essere -modificato senza alterare il file usato come modello. -.PP -Il comando -.B Vimtutor -è utile a chi voglia imparare i primi comandi -.B Vim -. -.PP -L'argomento opzionale \-g inizia vimtutor usando gvim invece che vim, se la -versione GUI di vim è disponibile. oppure utilizza vim, se gvim non è -disponibile. -.PP -L'arogmento opzionale [lingua] è l'abbreviazione di due lettere del nome -di una lingua, per esempio "it" oppure "es". -se L'argomento [lingua] non viene specificato, si utilizza la lingua "locale" -del computer. -Se la versione in quella lingua del "tutor" è disponibile, sarà usata. -Altrimenti sarà usata la versione inglese. -.PP -.B Vim -è sempre iniziato in Modo compatibile con vi. -.SH FILE -.TP 15 -/usr/local/lib/vim/tutor/tutor[.language] -Il/I file di testo per -.B Vimtutor - -.TP 15 -/usr/local/lib/vim/tutor/tutor.vim -Lo script di Vim usato per copiare il file di testo -.B Vimtutor -. -.SH AUTORE -The -.B Vimtutor -è stato scritto in origine per Vi da Michael C. Pierce e Robert K. Ware, -Colorado School of Mines, usando idee fornite da Charles Smith, -Colorado State University. -E\-mail: bware@mines.colorado.edu. -.br -È stato modificato per -.B Vim -da Bram Moolenaar. -Per i nomi dei traduttori, vedere i file usati nelle rispettive lingue. -.SH VEDERE ANCHE -vim(1) diff --git a/runtime/doc/manpages/it/xxd-it.1 b/runtime/doc/manpages/it/xxd-it.1 deleted file mode 100644 index b6ccabd2e3..0000000000 --- a/runtime/doc/manpages/it/xxd-it.1 +++ /dev/null @@ -1,402 +0,0 @@ -.TH XXD 1 "Agosto 1996" "Pagina di manuale per xxd" -.\" -.\" 21 Maggio 1996 -.\" Autore della pagina di manuale: -.\" Tony Nugent <tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> -.\" Modificato da Bram Moolenaar <Bram@vim.org> -.SH NOME -.I xxd -\- Produce esadecimale da un file binario o viceversa. -.SH SINTASSI -.B xxd -\-h[elp] -.br -.B xxd -[opzioni] [input_file [output_file]] -.br -.B xxd -\-r[evert] [opzioni] [input_file [output_file]] -.SH DESCRIZIONE -.I xxd -crea un'immagine esadecimale di un dato file o dello "standard input". -Può anche ottenere da un'immagine esadecimale il file binario originale. -Come -.BR uuencode (1) -e -.BR uudecode (1) -permette di trasmettere dati binari in una rappresentazione ASCII "a prova -di email", ma ha anche il vantaggio di poter decodificare sullo "standard -output". Inoltre, può essere usato per effettuare delle modifiche (patch) -a file binari. -.SH OPZIONI -Se non si specifica un -.I input_file -il programma legge dallo "standard input". -Se -.I input_file -è specificato come il carattere -.RB \` \- ' -, l'input è letto dallo "standard input". -Se non si specifica un -.I output_file -(o si mette al suo posto il carattere -.RB \` \- ' -), i risultati sono inviati allo "standard output". -.PP -Si noti che la scansione dei caratteri è "pigra", e non controlla oltre -la prima lettera dell'opzione, a meno che l'opzione sia seguita da un -parametro. -Gli spazi fra una singola lettera di opzione e il corrispondente parametro -dopo di essa sono facoltativi. -I parametri delle opzioni possono essere specificati usando la notazione -decimale, esadecimale oppure ottale. -Pertanto -.BR \-c8 , -.BR "\-c 8" , -.B \-c 010 -e -.B \-cols 8 -sono notazioni equivalenti fra loro. -.PP -.TP -.IR \-a " | " \-autoskip -Richiesta di autoskip: Un singolo '*' rimpiazza linee di zeri binari. -Valore di default: off. -.TP -.IR \-b " | " \-bits -Richiesta di una immagine binaria (cifre binarie), invece che esadecimale. -Questa opzione scrive un byte come otto cifre "1" e "0" invece di usare i -numeri esadecimali. Ogni linea è preceduta da un indirizzo in esadecimale e -seguita da una decodifica ascii (o ebcdic). Le opzioni specificabili dalla -linea comando \-r, \-p, \-i non funzionano in questo modo. -.TP -.IR "\-c colonne " | " \-cols colonne" -.IR "\-c colonne " | " \-cols colonne" -In ogni linea sono formattate -.RI < colonne > -colonne. Valore di default 16 (\-i: 12, \-ps: 30, \-b: 6). -Valore massimo 256. -.TP -.IR \-E " | " \-EBCDIC -Cambia la codifica della colonna di destra da ASCII a EBCDIC. -Questo non modifica la rappresentazione esadecimale. Non ha senso -specificare questa opzione in combinazione con \-r, \-p o \-i. -.TP -.IR "\-g numero_byte " | " \-groupsize numero_byte" -Inserisci ogni -.RI < numero_byte > -byte di output (di due caratteri esadecimali o otto numeri binari ognuno) -uno spazio bianco. -Specificando -.I \-g 0 -i byte di output non sono separati da alcuno spazio. -.RI < numero_byte > ha come valore di default " 2 -in modalità normale [esadecimale] e \fI1\fP in modalità binaria. -Il raggruppamento non si applica agli stili "PostScript" e "include". -.TP -.IR \-h " | " \-help -stampa un sommario dei comandi disponibili ed esce. Non viene fatto -null'altro. -.TP -.IR \-i " | " \-include -L'output è nello stile dei file "include" in C. Viene preparata la -definizione completa di un "array" [vettore], dandogli il nome del -file di input), tranne che nel caso in cui xxd legga dallo "standard input". -.TP -.IR "\-l numero " | " \-len numero" -Il programma esce dopo aver scritto -.RI < numero > -byte. -.TP -.IR \-p " | " \-ps " | " \-postscript " | " \-plain -L'output è nello stile di un dump continuo sotto postscript. -Noto anche come stile esadecimale semplice [plain]. -.TP -.IR \-r " | " \-revert -ricostruzione: converte (o mette una patch) a partire dall'immagine -esadecimale, creando [o modificando] il file binario. -Se non diretto allo "standard output", xxd scrive nel suo file di output -in maniera continua, senza interruzioni. Usare la combinazione -.I \-r \-p -per leggere dump in stile esadecimale semplice [plain], senza l'informazione -di numero di linea e senza un particolare tracciato di colonna. Degli spazi -o delle linee vuote possono essere inserite a piacere [e vengono ignorate]. -.TP -.I \-seek distanza -Usato con l'opzione -.IR \-r : -(ricostruzione), -.RI < distanza > -viene aggiunta alla posizione nel file trovata nella immagine -esadecimale. -.TP -.I \-s [+][\-]seek -Inizia a -.RI < seek > -byte assoluti (o relativi) di distanza all'interno di input_file. -\fI+ \fRindica che il "seek" è relativo alla posizione corrente nel file -"standard input" (non significativa quando non si legge da "standard input"). -\fI\- \fRindica che il "seek" dovrebbe posizionarsi ad quel numero di -caratteri dalla fine dell'input (o se in combinazione con -\fI+ \fR: prime della posizione corrente nel file "standard input"). -Se non si specifica una opzione \-s, xxd inizia alla posizione -corrente all'interno del file. -.TP -.I \-u -usa lettere esadecimali maiuscole. Il valore di default è di usare -lettere minuscole. -.TP -.IR \-v " | " \-version -visualizza la stringa contenente la versione del programma. -.SH ATTENZIONE -.PP -.I xxd \-r -è capace di operare "magie" nell'utilizzare l'informazione "numero di linea". -Se sul file di output ci si può posizionare usando la "seek", il numero di -linea all'inizio di ogni riga esadecimale può essere non ordinato, delle -linee possono mancare delle linee, oppure esserci delle sovrapposizioni. -In simili casi xxd userà lseek(2) per raggiungere la posizione d'inizio. -Se il file di output non consente di usare "seek", sono permessi solo dei -"buchi", che saranno riempiti con zeri binari. -.PP -.I xxd \-r -non genera mai errori di specifica parametri. I parametri non riconosciuti -sono silenziosamente ignorati. -.PP -Nel modificare immagini esadecimali, tenete conto che -.I xxd \-r -salta il resto della linea, dopo aver letto abbastanza caratteri contenenti -dati esadecimali (vedere opzione \-c). Ciò implica pure che le modifiche alle -colonne di caratteri stampabili ascii (o ebcdic) sono sempre ignorate. -La ricostruzione da un file immagine esadecimale in stile semplice -(postscript) con xxd \-r \-p non dipende dal numero corretto di colonne. -IN questo caso, qualsiasi cosa assomigli a una coppia di cifre esadecimali -è interpretata [e utilizzata]. -.PP -Notare la differenza fra -.br -\fI% xxd \-i file\fR -.br -e -.br -\fI% xxd \-i \< file\fR -.PP -.I xxd \-s \+seek -può comportarsi in modo diverso da -.IR "xxd \-s seek" -, perché lseek(2) è usata per tornare indietro nel file di input. Il '+' -fa differenza se il file di input è lo "standard input", e se la posizione nel -file di "standard input" non è all'inizio del file quando xxd è eseguito, -con questo input. -I seguenti esempi possono contribuire a chiarire il concetto -(o ad oscurarlo!)... -.PP -Riavvolge lo "standard input" prima di leggere; necessario perché `cat' -ha già letto lo stesso file ["file"] fino alla fine dello "standard input". -.br -\fI% sh \-c 'cat > copia_normale; xxd \-s 0 > copia_esadecimale' < file -.PP -Stampa immagine esadecimale dalla posizione file 0x480 (=1024+128) in poi. -Il segno `+' vuol dire "rispetto alla posizione corrente", quindi il `128' -si aggiunge a 1k (1024) dove `dd' si era fermato. -.br -\fI% sh \-c 'dd of=normale bs=1k count=1; xxd \-s +128 > esadecimale' < file -.PP -Immagine esadecimale dalla posizione 0x100 ( = 1024\-768 ) del file in avanti. -.br -\fI% sh \-c 'dd of=normale bs=1k count=1; xxd \-s +\-768 > esadecimale' < file -.PP -Comunque, questo capita raramente, e l'uso del `+' non serve quasi mai. -L'autore preferisce monitorare il comportamento di xxd con strace(1) o -truss(1), quando si usa l'opzione \-s. -.SH ESEMPI -.PP -.br -Stampa tutto tranne le prime tre linee (0x30 byte esadecimali) di -.B file -\. -.br -\fI% xxd \-s 0x30 file -.PP -.br -Stampa 3 linee (0x30 byte esadecimali) alla fine di -.B file -\. -.br -\fI% xxd \-s \-0x30 file -.PP -.br -Stampa 120 byte come immagine esadecimale continua con 20 byte per linea. -.br -\fI% xxd \-l 120 \-ps \-c 20 xxd.1\fR - -.br -2e54482058584420312022417567757374203139 -.br -39362220224d616e75616c207061676520666f72 -.br -20787864220a2e5c220a2e5c222032317374204d -.br -617920313939360a2e5c22204d616e2070616765 -.br -20617574686f723a0a2e5c2220202020546f6e79 -.br -204e7567656e74203c746f6e79407363746e7567 -.br - -.br -Stampa i primi 120 byte della pagina di manuale vim.1 a 12 byte per linea. -.br -\fI% xxd \-l 120 \-c 12 xxd.1\fR - - -.br -0000000: 2e54 4820 5858 4420 3120 2241 .TH XXD 1 "A -.br -000000c: 7567 7573 7420 3139 3936 2220 ugust 1996" -.br -0000018: 224d 616e 7561 6c20 7061 6765 "Manual page -.br -0000024: 2066 6f72 2078 7864 220a 2e5c for xxd"..\ -.br -0000030: 220a 2e5c 2220 3231 7374 204d "..\" 21st M -.br -000003c: 6179 2031 3939 360a 2e5c 2220 ay 1996..\" -.br -0000048: 4d61 6e20 7061 6765 2061 7574 Man page aut -.br -0000054: 686f 723a 0a2e 5c22 2020 2020 hor:..\" -.br -0000060: 546f 6e79 204e 7567 656e 7420 Tony Nugent -.br -000006c: 3c74 6f6e 7940 7363 746e 7567 <tony@sctnug -.PP -.br -Visualizza la data dal file xxd.1 -.br -\fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR -.br -0000036: 3231 7374 204d 6179 2031 3939 36 21st May 1996 -.PP -.br -Copiare -.B input_file -su -.B output_file -premettendogli 100 byte a 0x00. -.br -\fI% xxd input_file | xxd \-r \-s 100 \> output_file\fR -.br - -.br -Modificare (patch) la data nel file xxd.1 -.br -\fI% echo '0000037: 3574 68' | xxd \-r \- xxd.1\fR -.br -\fI% xxd \-s 0x36 \-l 13 \-c 13 xxd.1\fR -.br -0000036: 3235 7468 204d 6179 2031 3939 36 25th May 1996 -.PP -.br -Creare un file di 65537 byte tutto a 0x00, -tranne che l'ultimo carattere che è una 'A' (esadecimale 0x41). -.br -\fI% echo '010000: 41' | xxd \-r \> file\fR -.PP -.br -Stampa una immagine esadecimale del file di cui sopra con opzione autoskip. -.br -\fI% xxd \-a \-c 12 file\fR -.br -0000000: 0000 0000 0000 0000 0000 0000 ............ -.br -* -.br -000fffc: 0000 0000 40 ....A -.PP -Crea un file di 1 byte che contiene il solo carattere 'A'. -Il numero dopo '\-r \-s' viene aggiunto a quello trovato nel file; -in pratica, i byte precedenti non sono stampati. -.br -\fI% echo '010000: 41' | xxd \-r \-s \-0x10000 \> file\fR -.PP -Usa xxd come filtro all'interno di un editor come -.B vim(1) -per ottenere una immagine esadecimale di una parte di file -delimitata dai marcatori `a' e `z'. -.br -\fI:'a,'z!xxd\fR -.PP -Usare xxd come filtro all'interno di un editor come -.B vim(1) -per ricostruire un pezzo di file binario da una immagine esadecimale -delimitata dai marcatori `a' e `z'. -.br -\fI:'a,'z!xxd \-r\fR -.PP -Usare xxd come filtro all'interno di un editor come -.B vim(1) -per ricostruire una sola linea di file binario da una immagine esadecimale, -Portare il cursore sopra la linea e battere: -.br -\fI!!xxd \-r\fR -.PP -Per leggere singoli caratteri da una linea seriale -.br -\fI% xxd \-c1 < /dev/term/b &\fR -.br -\fI% stty < /dev/term/b \-echo \-opost \-isig \-icanon min 1\fR -.br -\fI% echo \-n foo > /dev/term/b\fR -.PP -.SH CODICI DI RITORNO -Il programma può restituire questi codici di errore: -.TP -0 -nessun errore rilevato. -.TP -\-1 -operazione non supportata ( -.I xxd \-r \-i -non ancora possible). -.TP -1 -errore durante la scansione parametri. -.TP -2 -problemi con il file di input. -.TP -3 -problemi con il file di output. -.TP -4,5 -posizione "seek" specificata non raggiungibile all'interno del file. -.SH VEDERE ANCHE -uuencode(1), uudecode(1), patch(1) -.br -.SH AVVERTIMENTI -La stranezza dello strumento rispecchia la mente del suo creatore. -Usate a vostro rischio e pericolo. Copiate i file. Tracciate l'esecuzione. -Diventate un mago. -.br -.SH VERSIONE -Questa pagina di manuale documenta la versione 1.7 di xxd. -.SH AUTORE -.br -(c) 1990-1997 Juergen Weigert -.br -<jnweiger@informatik.uni\-erlangen.de> -.LP -Distribuite liberamente ed attribuitemi il credito, -.br -fate soldi e condivideteli con me -.br -perdete soldi e non venite a chiederli a me. -.PP -Pagina di manuale messa in piedi da Tony Nugent -.br -<tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au> -.br -Piccole modifiche di Bram Moolenaar. -Modificato da Juergen Weigert. -.PP |