Guida di riferimento di Mercurial Queues

# HG changeset patch # User Giulio@puck # Date 1249923542 -7200 # Node ID 254dbe306dd49557050e405d8f26ecc54b1c4c21 # Parent ee11b9671375835b4fa4e1685ea6e2ffe147e7a2 Deep revision of App.B. diff -r ee11b9671375 -r 254dbe306dd4 it/appB-mq-ref.xml --- a/it/appB-mq-ref.xml Mon Aug 10 18:38:14 2009 +0200 +++ b/it/appB-mq-ref.xml Mon Aug 10 18:59:02 2009 +0200 @@ -1,16 +1,16 @@ - Guida di riferimento di Mercurial Queues + Guida di riferimento a Mercurial Queues - Guida di riferimento dei comandi MQ + Guida di riferimento ai comandi MQ Per un'introduzione ai comandi forniti da MQ, usate il comando hg help mq. <command role="hg-ext-mq">qapplied</command>&emdash;stampa le patch applicate - Il comando qapplied stampa la pila corrente delle patch applicate. Le patch vengono stampate nell'ordine dalla più vecchia alla più recente, così l'ultima patch nella lista è quella in cima alla pila. + Il comando qapplied stampa la pila corrente delle patch applicate. Le patch vengono stampate in ordine dalla più vecchia alla più recente, così l'ultima patch nella lista è quella in cima alla pila. @@ -23,7 +23,7 @@ <command role="hg-ext-mq">qdelete</command>&emdash;elimina una patch dal file <filename role="special">series</filename> - Il comando qdelete rimuove la voce relativa a una patch dal file series nella directory .hg/patches. Non estrae la patch se la patch è già applicata. Di default, non cancella il file della patch; usate l'opzione per fare questo. + Il comando qdelete rimuove la voce relativa a una patch dal file series nella directory .hg/patches. Non estrae la patch se la patch è già applicata. Di default, non cancella il file della patch, perciò dovrete usare l'opzione se volete fare questo. Opzioni: @@ -33,33 +33,33 @@ - <command role="hg-ext-mq">qdiff</command>&emdash;stampa un diff della patch applicata in cima alla pila - - Il comando qdiff stampa un diff della patch applicata in cima alla pila. È equivalente al comando hg diff -r-2:-1. + <command role="hg-ext-mq">qdiff</command>&emdash;stampa un diff dell'ultima patch applicata + + Il comando qdiff stampa un diff dell'ultima patch applicata. È equivalente al comando hg diff -r-2:-1. <command role="hg-ext-mq">qfinish</command>&emdash;sposta le patch applicate nella cronologia del repository - Il comando hg qfinish converte le patch applicate specificate in modifiche permanenti spostandole fuori dal controllo di MQ in modo che siano trattate come normale cronologia del repository. + Il comando hg qfinish converte le patch applicate specificate in modifiche permanenti, spostandole fuori dal controllo di MQ in modo che siano trattate come normale cronologia del repository. <command role="hg-ext-mq">qfold</command>&emdash;unisce (<quote>include</quote>) diverse patch in una - Il comando qfold unisce più patch con la patch applicata in cima alla pila, in modo che la patch applicata in cima alla pila rappresenti l'unione di tutti i cambiamenti delle patch in questione. - - Le patch da includere non devono essere applicate; qfold terminerà con un errore se una qualsiasi lo è. L'ordine in cui le patch vengono incluse è significativo; hg qfold a b significa applica la patch corrente in cima alla pila, seguita da a, seguita da b. - - I commenti dalle patch incluse vengono aggiunti alla fine dei commenti della patch di destinazione, separando ogni blocco di commenti con tre caratteri di asterisco (*). Usate l'opzione per modificare il messaggio di commit della patch/changeset combinata dopo che l'inclusione è stata completata. + Il comando qfold unisce più patch all'ultima patch applicata, in modo che l'ultima patch applicata rappresenti l'unione di tutti i cambiamenti delle patch in questione. + + Le patch da includere non devono essere applicate, altrimenti qfold terminerà segnalando un errore. L'ordine in cui le patch vengono incluse è significativo: hg qfold a b significa applica la patch più recente, seguita da a, seguita da b. + + I commenti delle patch incluse vengono aggiunti alla fine dei commenti della patch di destinazione, separando ogni blocco di commenti con tre caratteri di asterisco (*). Usate l'opzione per modificare il messaggio di commit della patch/changeset combinata dopo che l'inclusione è stata completata. Opzioni: : modifica il messaggio di commit e la descrizione di patch per la nuova patch combinata. - : usa i contenuti del file dato come il nuovo messaggio di commit e descrizione di patch per la patch combinata. - - : usa il testo dato come il nuovo messaggio di commit e descrizione di patch per la patch combinata. + : usa il testo contenuto nel file dato come nuovo messaggio di commit e descrizione di patch per la patch combinata. + + : usa il testo dato come nuovo messaggio di commit e descrizione di patch per la patch combinata. @@ -67,13 +67,13 @@ <command role="hg-ext-mq">qheader</command>&emdash;mostra l'intestazione/descrizione di una patch - Il comando qheader stampa l'intestazione, o descrizione, di una patch. Di default, stampa l'intestazione della patch applicata in cima alla pila. Dato un argomento, stampa l'intestazione della patch nominata. + Il comando qheader stampa l'intestazione, o descrizione, di una patch. Di default, stampa l'intestazione dell'ultima patch applicata. Dato un argomento, stampa l'intestazione della patch indicata. <command role="hg-ext-mq">qimport</command>&emdash;importa una patch di terze parti nella coda - Il comando qimport aggiunge una voce per una patch esterna al file series e copia la patch nella directory .hg/patches. Aggiunge la voce immediatamente dopo la patch applicata in cima alla pila, ma non inserisce la patch. + Il comando qimport aggiunge una voce per una patch esterna al file series e copia la patch nella directory .hg/patches. Aggiunge la voce immediatamente dopo l'ultima patch applicata, ma non inserisce la patch. Se la directory .hg/patches è un repository, qimport usa hg add per aggiungere automaticamente la patch importata. @@ -85,7 +85,7 @@ Opzioni: - : Crea .hg/patches sotto forma di un repository. Crea anche un file .hgignore che ignorerà il file status. + : Crea .hg/patches sotto forma di repository. Crea anche un file .hgignore che ignorerà il file status. @@ -95,13 +95,13 @@ <command role="hg-ext-mq">qnew</command>&emdash;crea una nuova patch - Il comando qnew crea una nuova patch. Prende un argomento obbligatorio, il nome da usare per il file di patch. La patch appena creata viene creata vuota di default, viene aggiunta al file series dopo la patch applicata correntemente in cima alla pila e viene immediatamente inserita sopra quella patch. - - Se qnew trova qualche file modificato nella directory di lavoro, si rifiuterà di creare una nuova patch a meno che non usiate l'opzione (vedete più avanti). Questo comportamento vi permette di aggiornare la patch applicata in cima alla pila tramite qrefresh prima di applicare una nuova patch sopra di essa. + Il comando qnew crea una nuova patch. Prende come argomento obbligatorio il nome da usare per il file di patch. La nuova patch viene creata vuota di default, viene aggiunta al file series dopo l'ultima patch applicata e viene immediatamente inserita sopra quella patch. + + Se qnew trova qualche file modificato nella directory di lavoro, si rifiuterà di creare una nuova patch a meno che non usiate l'opzione (vedete più avanti). Questo comportamento vi permette di aggiornare l'ultima patch applicata tramite qrefresh prima di applicare una nuova patch. Opzioni: - : crea una nuova patch se il contenuto della directory di lavoro è stato modificato. Ogni cambiamento in sospeso viene aggiunto alla patch appena creata in modo che, dopo che l'esecuzione del comando è terminata, la directory di lavoro non conterrò più alcuna modifica. + : crea una nuova patch se il contenuto della directory di lavoro è stato modificato. Ogni cambiamento in sospeso viene aggiunto alla patch appena creata, pertanto al termine dell'esecuzione del comando la directory di lavoro non risulterà più modificata. : usa il testo dato come messaggio di commit. Il testo verrà memorizzato all'inizio del file di patch, prima dei dati di patch. @@ -111,7 +111,7 @@ <command role="hg-ext-mq">qnext</command>&emdash;stampa il nome della patch successiva - Il comando qnext stampa il nome della prossima patch nel file series dopo la patch applicata in cima alla pila. Quella patch diventerà la patch applicata in cima alla pila se invocate qpush. + Il comando qnext stampa il nome della patch nel file series che segue la patch applicata più recentemente. Questa patch diventerà l'ultima patch applicata se invocate qpush. @@ -121,15 +121,15 @@ Questo comando rimuove dal repository i changeset che rappresentano le patch estratte e aggiorna la directory di lavoro per annullare gli effetti delle patch. - Questo comando accetta un argomento opzionale che viene usato come ilnome o l'indice numerico della patch da estrarre. Se viene dato un nome, il comando continuerà a estrarre patch fino a quando la patch nominata sarà in cima alla pila delle patch applicate. Se viene dato un numero, qpop tratterà il numero come un indice d'accesso alle voci nel file della serie, partendo da zero (le righe vuote e le righe contenenti solo commenti non vengono contate). Il comando continuerà a estrarre patch fino a quando la patch identificata dall'indice dato sarà in cima alla pila delle patch applicate. - - Il comando qpop non legge e non scrive né le patch né il file series. Perciò, potete tranquillamente usare qpop su una patch che avete rimosso dal file series, o su una patch che avete rinominato o cancellato interamente. Negli ultimi due casi, usate il nome che la patch aveva quando l'avete applicata. - - Di default, il comando qpop non estrarrà alcuna patch se la directory di lavoro è stata modificata. Potete aggirare questo comportamento usando l'opzione , che annulla tutte le modifiche nella directory di lavoro. + Questo comando accetta un argomento opzionale che viene usato per indicare il nome o l'indice numerico della patch da estrarre. Se viene passato un nome, il comando continuerà a estrarre patch fino a quando la patch nominata sarà in cima alla pila delle patch applicate. Se viene passato un numero, qpop tratterà il numero come un indice d'accesso alle voci nel file della serie, partendo da zero (le righe vuote e le righe contenenti solo commenti non vengono contate). Il comando continuerà a estrarre patch fino a quando la patch identificata dall'indice dato sarà in cima alla pila delle patch applicate. + + Il comando qpop non legge e non modifica né le patch né il file series. Perciò, potete tranquillamente usare qpop su una patch che avete rimosso dal file series, o su una patch che avete rinominato o completamente cancellato. Negli ultimi due casi, usate il nome che la patch aveva quando l'avete applicata. + + Di default, il comando qpop non estrarrà alcuna patch se la directory di lavoro è stata modificata. Potete cambiare questo comportamento usando l'opzione , che annulla tutte le modifiche nella directory di lavoro. Opzioni: - : estrae tutte le patch applicate. Questo riporta il repository allo stato in cui era prima che applicaste qualunque patch. + : estrae tutte le patch applicate, riportando il repository allo stato in cui era prima che applicaste qualunque patch. : annulla forzatamente qualsiasi modifica alla directory di lavoro al momento dell'estrazione. @@ -143,34 +143,34 @@ <command role="hg-ext-mq">qprev</command>&emdash;stampa il nome della patch precedente - Il comando qprev stampa il nome della patch nel file series che viene prima della patch applicata in cima alla pila. Quella patch diventerà la patch applicata in cima alla pila se invocate qpop. + Il comando qprev stampa il nome della patch nel file series che precede la patch applicata più recentemente. Questa patch diventerà l'ultima patch applicata se invocate qpop. <command role="hg-ext-mq">qpush</command>&emdash;inserisce le patch in cima alla pila - Il comandoqpush aggiunge le patch in cima alla pila delle patch applicate. Di default, aggiunge solo una patch. + Il comando qpush aggiunge le patch in cima alla pila delle patch applicate. Di default, aggiunge solo una patch. Questo comando crea un nuovo changeset per rappresentare ogni patch applicata e aggiorna la directory di lavoro per applicare gli effetti delle patch. I dati predefiniti usati per creare un changeset sono i seguenti. - La data e la zona temporale del commit sono la data e la zona temporale corrente. Dato che questi dati vengono usati per computare l'identità di un changeset, questo significa che se invocate qpop su una patch e poi invocate qpush sulla stessa patch, il changeset che inserite avrà una identità diversa dal changeset che avete estratto. + La data e il fuso orario del commit sono la data e il fuso orario corrente. Dato che questi dati vengono usati per computare l'identità di un changeset, questo significa che se invocate qpop su una patch e poi invocate qpush sulla stessa patch, il changeset che inserite avrà un'identità diversa dal changeset che avete estratto. L'autore è quello predefinito usato dal comando hg commit. - Il messaggio di commit è il testo proveniente dal file di patch che si trova prima della prima intestazione del diff. Se questo testo non è presente, viene usato un messaggio di commit predefinito che identifichi il nome della patch. + Il messaggio di commit è il testo proveniente dal file di patch che precede la prima intestazione del diff. Se questo testo non è presente, viene usato un messaggio di commit predefinito che identifica il nome della patch. Se una patch contiene un'intestazione di patch Mercurial, i dati nell'intestazione di patch sostituiscono quelli predefiniti. Opzioni: - : inserisce tutte le patch non applicate nel file series fino a quando non ne rimane nessuna da inserire. + : inserisce tutte le patch non applicate contenute nel file series fino a quando non ne rimane nessuna da inserire. : aggiunge il nome della patch alla fine del messaggio di commit. - : se una patch non riesce a venire applicata in maniera pulita, usa la voce per la patch in un'altra coda salvata per computare i parametri di un'unione a tre vie ed effettua un'unione a tre vie usando il normale meccanismo di unione di Mercurial. Usa il risultato dell'unione come nuovo contenuto della patch. + : se l'applicazione di una patch fallisce, usa la voce relativa alla patch contenuta in un'altra coda salvata per computare i parametri di un'unione a tre vie, effettuando poi l'unione a tre vie attraverso il normale meccanismo di unione di Mercurial. Usa il risultato dell'unione come nuovo contenuto della patch. : usa la coda nominata se effettua un'unione durante l'inserimento. @@ -181,21 +181,21 @@ <command - role="hg-ext-mq">qrefresh</command>&emdash;aggiorna la patch applicata in cima alla pila - - Il comando qrefresh aggiorna la patch applicata in cima alla pila. Modifica la patch, rimuove il vecchio changeset che rappresentava la patch e crea un nuovo changeset per rappresentare la patch modificata. + role="hg-ext-mq">qrefresh&emdash;aggiorna l'ultima patch applicata + + Il comando qrefresh aggiorna l'ultima patch applicata. Modifica la patch, rimuove il vecchio changeset che rappresentava la patch e crea un nuovo changeset per rappresentare la patch modificata. Il comando qrefresh si occupa delle seguenti modifiche. - I cambiamenti al messaggio di commit, i.e. il testo prima della prima intestazione di diff nel file di patch, vengono riflessi nel nuovo changeset che rappresenta la patch. + I cambiamenti al messaggio di commit, i.e. il testo che precede la prima intestazione di diff nel file di patch, vengono riflessi nel nuovo changeset che rappresenta la patch. Le modifiche ai file registrati nella directory di lavoro vengono aggiunte alla patch. - Per quanto riguarda i cambiamenti ai file registrati apportati tramite hg add, hg copy, hg remove, o hg rename, i file aggiunti e i file destinazione di copie e cambiamenti di nome vengono aggiunti alla patch, mentre i file rimossi e i file sorgente dei cambiamenti di nome vengono rimossi. - - - - Anche se qrefresh non scopre alcun cambiamento, ricrea comunque il changeset che rappresenta la patch. Questo produce una differenza tra l'identità del changeset e il changeset precedente che identificava la patch. + Per quanto riguarda le modifiche ai file registrati apportate tramite hg add, hg copy, hg remove, o hg rename, i file aggiunti e i file destinazione di copie e cambiamenti di nome vengono aggiunti alla patch, mentre i file rimossi e i file sorgente dei cambiamenti di nome vengono rimossi. + + + + Anche se qrefresh non trova alcun cambiamento, ricrea comunque il changeset che rappresenta la patch. Questo produce una differenza tra l'identità del nuovo changeset e quella del precedente changeset che identificava la patch. Opzioni: @@ -203,7 +203,7 @@ : modifica il messaggio di commit e la descrizione della patch, usando il testo dato. - : modifica il messaggio di commit e la descrizione della patch, usando il testo dal file dato. + : modifica il messaggio di commit e la descrizione della patch, usando il testo contenuto nel file dato. @@ -211,28 +211,28 @@ <command role="hg-ext-mq">qrename</command>&emdash;rinomina una patch - Il comando qrename rinomina una patch e modifica la voce della patch nel file series. - - Con un singolo argomento, qrename rinomina la patch applicata in cima alla pila. Con due argomenti, cambia il nome del primo argomento al secondo argomento. + Il comando qrename rinomina una patch e modifica la voce relativa alla patch nel file series. + + Con un singolo argomento, qrename rinomina l'ultima patch applicata. Con due argomenti, cambia il nome del primo argomento al secondo argomento. <command role="hg-ext-mq">qseries</command>&emdash;stampa l'intera serie di patch - Il comando qseries stampa l'intera serie di patch contenuta nel file series. Stampa solo i nomi delle patch, saltando le righe vuote e i commenti. Stampa le patch nell'ordine dalla prima a essere applicata all'ultima. + Il comando qseries stampa l'intera serie di patch contenuta nel file series. Stampa solo i nomi delle patch, saltando le righe vuote e i commenti. Stampa le patch in ordine dalla prima che è stata applicata all'ultima. <command role="hg-ext-mq">qtop</command>&emdash;stampa il nome della patch corrente - Il comando qtop stampa il nome della patch applicata correntemente in cima alla pila. + Il comando qtop stampa il nome della patch attualmente in cima alla pila delle patch applicate. <command role="hg-ext-mq">qunapplied</command>&emdash;stampa le patch non ancora applicate - Il comando qunapplied stampa i nomi delle patch contenute nel file series che non sono ancora state applicate. Le stampa in ordine dalla successiva patch che verrà inserita all'ultima. + Il comando qunapplied stampa i nomi delle patch non ancora applicate contenute nel file series, nell'ordine in cui le patch verrebbero inserite. @@ -244,11 +244,11 @@ Opzioni: - : salva i changeset non correlati che sono mischiati con i changeset eliminati nel bundle di backup. + : salva i changeset non correlati che sono mescolati ai changeset eliminati nel bundle di backup. : se un ramo ha più teste, rimuove tutte le teste. - : evita di salvare un bundle di backup. + : evita di salvare il bundle di backup. @@ -259,19 +259,19 @@ Il file <filename role="special">series</filename> - Il file series contiene una lista dei nomi di tutte le patch che MQ può applicare. Viene rappresentato come una lista di nomi, con un nome salvato per riga. Lo spazio bianco all'inizo e alla fine di ogni riga viene ignorato. - - Le righe possono contenere commenti. Un commento comincia con il carattere # character e si estende fino alla fine della riga. Le righe vuote e le righe che contengono solo commenti vengono ignorate. - - Avrete spesso bisogno di modificare il file series a mano, da cui il supporto per i commenti e le righe vuote appena notato. Per esempio, potete commentare temporaneamente una patch in modo che qpush la salti quando applica le patch. Potete anche cambiare l'ordine in cui le patch vengono applicate riordinando le loro voci nel file series. - - Viene anche supportata la possibilità di piazzare il file series sotto controllo di revisione. È una buona idea piazzare sotto controllo di revisione anche tutte le patch a cui il file si riferisce. Se create una directory di patch usando l'opzione del comando qinit, questo verrà fatto per voi automaticamente. + Il file series contiene una lista dei nomi di tutte le patch che MQ può applicare. Viene rappresentato come una lista di nomi, con un nome salvato per riga. Lo spazio bianco all'inizio e alla fine di ogni riga viene ignorato. + + Le righe possono contenere commenti. Un commento comincia con il carattere # e si estende fino alla fine della riga. Le righe vuote e le righe che contengono solo commenti vengono ignorate. + + Avrete spesso bisogno di modificare il file series a mano, da cui il supporto per i commenti e le righe vuote appena descritto. Per esempio, potete commentare temporaneamente una patch in modo che qpush la salti quando applica le patch. Potete anche cambiare l'ordine in cui le patch vengono applicate riordinando le loro voci nel file series. + + Viene anche supportata la possibilità di mettere il file series sotto controllo di revisione. È una buona idea mettere sotto controllo di revisione anche tutte le patch a cui il file si riferisce. Se create una directory di patch usando l'opzione del comando qinit, questo verrà fatto per voi automaticamente. Il file <filename role="special">status</filename> - Il flie status contiene i nomi e gli hash di changeset per tutte le patch che MQ ha correntemente applicato. A differenza del file series, questo file non è destinato a essere modificato. Non dovreste piazzare questo file sotto controllo di revisione, né modificarlo in alcun modo. Viene usato da MQ per mantenere traccia di informazioni strettamente private. + Il flie status contiene i nomi e gli hash di changeset per tutte le patch che MQ ha attualmente applicato. A differenza del file series, questo file non è destinato a essere modificato. Non dovreste mettere questo file sotto controllo di revisione, né modificarlo in alcun modo. Viene usato da MQ per mantenere traccia di informazioni strettamente private.