NOME¶

diffuse - strumento grafico per l'unione e il confronto di file

SINOSSI¶

DESCRIZIONE¶

Diffuse è uno strumento grafico per l'unione e il confronto di file di testo. Diffuse è in grado di confrontare uno a fianco all'altro un qualsiasi numero di file e fornisce all'utente la possibilità di correggere manualmente la corrispondenza fra le righe e di modificare i file. Diffuse è anche in grado di recuperare le revisioni dei file dai repository Bazaar, CVS, Darcs, Git, Mercurial, Monotone, RCS, Subversion e SVK per confrontarle e unirle.

OPZIONI¶

Opzioni di aiuto¶

Se viene specificata una opzione di aiuto, questa deve essere l'unico argomento inserito nella linea di comando. Diffuse uscirà subito dopo aver visualizzato le informazioni. -h, -?, --help -v, --version

Opzioni di configurazione¶

Se viene specificata una opzione di configurazione, questa deve essere il primo argomento indicato nella riga di comando. --no-rcfile --rcfile file

Opzioni generali¶

-c, --commit rev -D, --close-if-same -e, --encoding codec -L, --label etichetta -m, --modified -r, --revision rev -s, --separate -t, --tab --line linea --null-file

Opzioni di visualizzazione¶

Le opzioni di visualizzazione indicate come argomenti della linea di comando hanno la precedenza sui valori salvati delle preferenze. -b, --ignore-space-change -B, --ignore-blank-lines -E, --ignore-end-of-line -i, --ignore-case -w, --ignore-all-space

CONFRONTARE I FILE¶

Usare le voci del menu File → Nuova unione a 2 file e File → Nuova unione a 3 file per creare ulteriori schede di confronto tra file di testo. I nomi dei file e le revisioni possono essere indicati sia come argomenti della linea di comando di Diffuse sia nei campi della finestra di apertura file. Diffuse visualizza i file uno a fianco all'altro inserendo degli spazi per allineare le righe di testo simili. Le differenze sono evidenziate con diversi colori di sfondo.

Sommario del confronto¶

Nel margine destro della finestra è visibile un sommario del confronto dei file. Il sommario mostra dove sono stati inseriti degli spazi per allineare le righe di testo corrispondenti ed evidenzia le differenze usando i colori. Le modifiche manuali sono evidenziate in verde. Un cursore blu identifica la regione che si sta visualizzando. La regione visualizzata può essere cambiata facendo clic in un qualsiasi punto del sommario.

Selezionare¶

Le righe di testo possono essere selezionate utilizzando il mouse o la tastiera. Selezionare le righe di testo facendovi clic sopra con il puntatore del mouse. Fare clic e trascinare il puntatore per selezionare più righe. Mantenendo premuto Maiusc quando si fa clic la selezione corrente verrà estesa. Selezionare le righe con la tastiera premendo i tasti Pag_Su, Pag_Giù o le frecce. Tenere premuto Maiusc mentre si usano questi tasti per estendere la selezione. Spostare la selezione in un file adiacente utilizzando i tasti delle frecce sinistra e destra.

Far corrispondere le righe¶

Il puntatore del mouse o la tastiera possono essere usati per allineare manualmente le righe di testo con i file adiacenti. Per allineare le righe di testo usando il puntatore del mouse, selezionare una riga di testo con il pulsante sinistro del mouse, fare clic con il tasto destro del mouse su una riga di testo del file adiacente e scegliere Allinea con la selezione. Per allineare le righe di testo con la tastiera, spostare la selezione con i tasti freccia, premere la barra spaziatrice per selezionare la riga corrente di testo, spostare la selezione con i tasti freccia a una riga di testo nel file adiacente e premere di nuovo la barra spaziatrice per indicare la riga di destinazione del testo. Premere il tasto Esc in qualsiasi momento per annullare l'operazione. Usare la voce di menu Isola per evitare che le righe selezionate vengano fatte corrispondere a una qualsiasi riga dei file adiacenti.

Modificare¶

Premere il tasto Invio o fare doppio clic nell'area di testo per avviare la modalità di modifica del testo. Il cursore cambierà e nella barra di stato verrà visualizzato il numero della colonna in cui il cursore è posizionato. Nella modalità di modifica testo, il testo può essere selezionato con il puntatore del mouse facendo clic e trascinando. La selezione corrente può essere estesa tenendo premuto il tasto Maiusc e muovendo il cursore facendo clic con il puntatore del mouse o premendo uno qualsiasi tra i tasti freccia, home, fine, Pg_Su o Pg_Giù. Le parole possono essere selezionate individualmente con un doppio clic sopra di esse con il puntatore del mouse. L'intera riga può essere selezionata con un triplo clic su di essa con il puntatore del mouse. Modificare il testo digitando sulla tastiera. Le righe modificate verranno evidenziate in verde. Usare le voci di menu Annulla e Ripeti per annullare e ripetere le operazioni effettuate. Premere il tasto Esc o fare clic nell'area di testo di un altro file con il pulsante sinistro del mouse per abbandonare la modalità di modifica del testo.

Unire¶

Usare i pulsanti delle differenze o le relative voci del menu per spostarsi tra i blocchi di differenze all'interno del file. Diffuse sposterà la selezione al gruppo di righe più vicino con differenze o modifiche. Usare i pulsanti di unione o le relative voci di menu per copiare blocchi di testo nelle righe selezionate. Le voci di menu Annulla e Ripeti possono essere utilizzate per annullare e ripetere le operazioni effettuate in precedenza. Tutte le modifiche a un gruppo di righe possono essere annullate utilizzando la voce di menu Annulla modifiche indipendentemente dall'ordine con cui le modifiche sono state effettuate.

CONTROLLO DI VERSIONE¶

Diffuse è in grado di recuperare le revisioni dei file da diversi sistemi di controllo di versione attraverso la loro interfaccia da linea di comando. Il pacchetto di Diffuse compilato per Microsoft Windows è in grado di utilizzare sia Cygwin che le versioni native dei sistemi di controllo di versione supportati. Quando si utilizza Diffuse con Cygwin, assicurarsi che le preferenze di Diffuse relative a Cygwin descrivano correttamente il proprio sistema. Se la preferenza Aggiorna i percorsi per Cygwin esiste per un sistema di controllo di versione, deve essere abilitata per utilizzare la versione di Cygwin. I sistemi di controllo di versione sono sensibili al percorso di sistema e ad altre impostazioni delle variabili di sistema. La preferenza Avvia dalla Bash di una shell di login può essere usata per impostare facilmente l'ambiente per i sistemi di controllo di versione Cygwin.

Visualizzare le modifiche non applicate¶

L'opzione -m farà aprire a Diffuse tante schede di confronto quanti sono i file con modifiche non applicate così come riportati dal sistema di controllo di versione. Questo è utile per controllare tutti i cambiamenti prima di effettuare il "commit" o di risolvere i conflitti di unione. Se non vengono specificati dei percorsi, verrà utilizzata la cartella di lavoro corrente. Per esempio, visualizzare tutte le proprie modifiche non applicate con il seguente comando: La revisione predefinita di un file verrà usata per il confronto se viene specificato un solo file. Per esempio, il seguente comando visualizzerà un'unione a due file tra la revisione predefinita del file foo.C e la copia locale dello stesso file:

Specificare le revisioni¶

L'opzione -r può essere usata per specificare esplicitamente una particolare revisione di un file. Può essere utilizzato un qualsiasi identificatore della revisione riconosciuto dal sistema di controllo di versione. Se viene specificata un'unica revisione, il confronto verrà fatto rispetto al file locale. Per esempio, il seguente comando visualizzerà una unione a 2 file tra la revisione 123 del file foo.C e la copia locale dello stesso file: Diverse revisioni dello stesso file possono essere confrontate specificando più opzioni -r. Per esempio, il seguente comando visualizzerà una unione a due file tra la revisione 123 del file foo.C e la revisione 321 dello stesso file: I file locali possono essere combinati con file dal controllo di versione. Per esempio, il seguente comando visualizzerà una unione a 3 file tra la revisione MERGE_HEAD del file foo.C, il file locale foo.C e la revisione HEAD dello stesso file: L'opzione -c può essere usata per specificare facilmente una coppia di revisioni con numerazioni successive. Per esempio, questo comando visualizzerà una unione a 2 file tra la revisione 1.2.2 del file foo.C e la revisione 1.2.3 dello stesso file: Diffuse non limita il numero di riquadri che possono essere usati per confrontare i file. Gli input a una unione Git a più direzioni possono essere visualizzati con un comando di questo tipo:

RISORSE¶

Le risorse possono essere utilizzate per personalizzare vari parametri dell'aspetto e del comportamento di Diffuse. È possibile infatti modificare i colori utilizzati nell'interfaccia, personalizzare le scorciatoie da tastiera, aggiungere o sostituire regole per il riconoscimento della sintassi o modificare la mappatura tra estensione del file e regole di riconoscimento della sintassi. Quando Diffuse viene avviato, legge i comandi dal file di inizializzazione del sistema /etc/diffuserc (%CARTELLA_DI_INSTALLAZIONE%\diffuserc su Microsoft Windows) e in seguito il file di inizializzazione personale ~/.config/diffuse/diffuserc (%HOME%\.config\diffuse\diffuserc su Microsoft Windows). Questo comportamento può essere modificato con le opzioni di configurazione --no-rcfile e --rcfile. Un analizzatore di lessico simile alla Bourne shell è utilizzato per analizzare i comandi di inizializzazione. I commenti e i caratteri speciali possono essere inseriti utilizzando lo stesso stile di "escaping" utilizzato per gli script della Bourne shell.

Generali¶

import file

Keybinding¶

keybinding contesto azione combinazione_tasti Keybinding delle voci di menu Keybinding per la modalità di modifica delle righe Keybinding per la modalità di modifica dell'allineamento Keybinding della modalità di modifica testo

Stringhe¶

stringa nome valore Risorse stringa utilizzate

Colori¶

[ colour | color ] nome rosso verde blu Risorse colori utilizzati

Valori a virgola mobile¶

float nome valore Risorse a virgola mobile utilizzate

Riconoscimento della sintassi¶

syntax nome [stato_iniziale default_tag] syntax_files nome [schema] syntax_magic nome [schema [ignorecase]] syntax_pattern nome stato_iniziale stato_finale tag schema [ignorecase]

FILE¶

Diffuse utilizza i seguenti file: /etc/diffuserc /usr/share/diffuse/syntax/*.syntax ~/.config/diffuse/diffuserc ~/.config/diffuse/prefs ~/.local/share/diffuse/state

AUTORE¶

Diffuse è stato scritto da Derrick Moser derrick_moser@yahoo.com. © 2006-2011 Derrick Moser. Tutti i diritti riservati.

COPIA¶

Diffuse è software libero; è possibile ridistribuirlo e modificarlo nel rispetto dei termini della GNU General Public License come pubblicata dalla Free Software Foundation sia essa nella versione 2 o (a propria scelta) qualsiasi versione successiva.