# HG changeset patch # User Giulio@puck # Date 1248281818 -7200 # Node ID e4196f0a470104e739159ad98168d9cfdb083393 # Parent 6cb8638afe1a70224fcee4d103b446b5efc08b1e Deep revision of Ch.8. diff -r 6cb8638afe1a -r e4196f0a4701 it/ch08-branch.xml --- a/it/ch08-branch.xml Tue Jul 21 18:25:15 2009 +0200 +++ b/it/ch08-branch.xml Wed Jul 22 18:56:58 2009 +0200 @@ -2,23 +2,23 @@ Gestire le release e lo sviluppo con i rami - Mercurial vi fornisce diversi meccanismi per gestire un progetto che sta facendo progressi su più fronti contemporaneamente. Per comprendere questi meccanismi, come prima cosa diamo una breve occhiata alla struttura di un progetto software abbastanza normale. - - Molti progetti software distribuiscono periodicamente release principali che contengono nuove funzionalità sostanziali. In parallelo, possono distribuire release minori che di solito sono identiche alle release principali su cui sono basate e in più contengono alcune correzioni di bug. - - In questo capitolo, cominceremo parlando di come mantenere una registrazione di pietre miliari di un progetto come le release. Poi, continueremo parlando del flusso di lavoro tra fasi differenti di un progetto e di come Mercurial può aiutarvi a isolare e gestire questo lavoro. + Mercurial vi fornisce diversi meccanismi per gestire un progetto che sta facendo progressi su più fronti contemporaneamente. Per comprendere questi meccanismi, come prima cosa daremo una breve occhiata alla struttura di un progetto software abbastanza ordinario. + + Molti progetti software distribuiscono periodicamente release principali (o maggiori) che contengono nuove funzionalità sostanziali. In parallelo, possono distribuire release secondarie (o minori) che di solito sono identiche alle release principali su cui sono basate e in più contengono alcune correzioni di bug. + + In questo capitolo, cominceremo parlando di come mantenere una registrazione delle milestone di progetto come le release. Poi, continueremo parlando del flusso di lavoro tra fasi differenti di un progetto e di come Mercurial può aiutarvi a isolare e gestire questo lavoro. Dare un nome persistente a una revisione - Una volta che avete deciso che vi piacerebbe chiamare release una particolare revisione, è una buona idea registrare l'identità di quella revisione. Questo vi permetterà di riprodurre quella release in un momento successivo, per qualsiasi scopo potreste averne bisogno in quel momento (riprodurre un bug, convertirla verso una nuova piattaforma, etc). + Una volta che avete deciso che vi piacerebbe chiamare release una particolare revisione, è una buona idea registrare l'identità di quella revisione. Questo vi permetterà di riprodurre quella release in un momento successivo, per qualsiasi scopo abbiate bisogno di raggiungere in quel momento (riprodurre un bug, convertirla verso una nuova piattaforma, etc). &interaction.tag.init; - Mercurial vi consente di dare un nome permanente a qualsiasi revisione usando il comando hg tag. Ovviamente, questi nomi sono chiamati etichette (in inglese, tag). + Mercurial vi consente di dare un nome permanente a qualsiasi revisione usando il comando hg tag. Ovviamente, questi nomi sono chiamati etichette (in inglese, appunto, tag). &interaction.tag.tag; - Un'etichetta non è altro che un nome simbolico per una revisione. Le etichette esistono puramente per la vostra convenienza, cosicché abbiate un modo comodo e permanente per riferirvi a una revisione. Mercurial non interpreta in alcun modo i nomi delle etichette che usate, né impone alcuna restrizione sul nome di un'etichetta, a parte le poche che sono necessarie affinché un'etichetta possa essere riconosciuta senza ambiguità. Un nome di etichetta non può contenere nessuno dei caratteri seguenti: + Un'etichetta non è altro che un nome simbolico per una revisione. Le etichette esistono puramente per la vostra convenienza: vi offrono un modo comodo e permanente per fare riferimento a una revisione. Mercurial non interpreta in alcun modo i nomi delle etichette che usate, né impone alcuna restrizione sul nome di un'etichetta a parte le poche che sono necessarie affinché l'etichetta possa essere riconosciuta senza ambiguità. Un nome di etichetta non può contenere i seguenti caratteri: due punti (ASCII 58, :) @@ -30,109 +30,109 @@ \n) - Potete usare il comando hg tags per visualizzare le etichette presenti nel vostro repository. Nel risultato del comando, ogni revisione etichettata è identificata prima dal proprio nome, poi dal numero di revisione e infine dallo hash unico della revisione. + Potete usare il comando hg tags per visualizzare le etichette presenti nel vostro repository. Nel risultato del comando, ogni revisione etichettata è identificata prima dal proprio nome, poi dal numero di revisione e infine dall'hash unico della revisione. &interaction.tag.tags; - Notate che tip viene compreso nell'elenco mostrato da hg tags. L'etichetta tip è una speciale etichetta mobile che identifica sempre la revisione più recente contenuta in un repository. - - Il comando hg tags command elenca le etichette in ordine inverso secondo il numero di revisione. Di solito questo significa che le etichette recenti sono elencate prima delle etichette più vecchie. Significa anche che tip è sempre la prima etichetta elencata nel risultato di hg tags. - - Quando eseguite hg log, se visualizza una revisione che ha una o più etichette associate, stamperà quelle etichette. + Notate che tip viene inclusa nell'elenco mostrato da hg tags. L'etichetta tip è una speciale etichetta mobile che identifica sempre la revisione più recente contenuta in un repository. + + Il comando hg tags elenca le etichette in ordine inverso secondo il numero di revisione. Di solito questo significa che le etichette recenti vengono elencate prima delle etichette più vecchie. Significa anche che tip è sempre la prima etichetta elencata nel risultato di hg tags. + + Il comando hg log stamperà le etichette associate a ogni revisione visualizzata. &interaction.tag.log; - Ogni volta che dovete fornire un identificatore di revisione a un comando Mercurial, il comando accetterà il nome di un'etichetta al suo posto. Internamente, Mercurial tradurrà il nome della vostra etichetta nel corrispondente identificatore di revisione e poi userà quello. + I comandi Mercurial a cui dovete passare un identificatore di revisione accetteranno il nome di un'etichetta al suo posto. Internamente, Mercurial tradurrà il nome della vostra etichetta nel corrispondente identificatore di revisione e poi userà quest'ultimo per operare. &interaction.tag.log.v1.0; - Non c'è alcun limite al numero di etichette che potete avere in un repository, o al numero di etichette che può avere una singola revisione. Nella pratica, non è una grande idea averne troppe (un numero che varierà da progetto a progetto), semplicemente perché le etichette sono pensate per aiutarvi a rintracciare le revisioni. Se avete molte etichette, la comodità di usarle per identificare le revisioni diminuisce rapidamente. - - Per esempio, se il vostro progetto ha pietre miliari con una frequenza di pochi giorni, è perfettamente ragionevole dotare ognuna di un'etichetta. Ma se avete un sistema di assemblaggio continuo che si assicura che ogni revisione possa essere assemblata in modo pulito, introdurreste troppo rumore se etichettaste ogni assemblaggio pulito. Invece, potreste etichettare gli assemblaggi falliti (supponendo che siano rari!) o semplicemente evitare di usare le etichette per tenere traccia degli assemblaggi. + Non c'è alcun limite al numero di etichette che potete avere in un repository, o al numero di etichette che una singola revisione può avere. Nella pratica, non è una grande idea averne troppe (un numero che varierà da progetto a progetto), semplicemente perché le etichette sono pensate per aiutarvi a rintracciare le revisioni: se avete molte etichette, la comodità di usarle per identificare le revisioni diminuisce rapidamente. + + Per esempio, se il vostro progetto definisce nuove milestone con una frequenza di alcuni giorni, è perfettamente ragionevole dotare ognuna di un'etichetta. Ma se avete un sistema di assemblaggio continuo che si assicura di poter assemblare ogni revisione in modo pulito, introdurreste troppo rumore se etichettaste ogni assemblaggio pulito. Invece, potreste etichettare gli assemblaggi falliti (supponendo che siano rari!) o semplicemente evitare di usare le etichette per tenere traccia degli assemblaggi. Se volete rimuovere un'etichetta che non volete più, usate hg tag --remove. &interaction.tag.remove; - Potete anche modificare un'etichetta in qualsiasi momenti, in modo che identifichi una revisione differente, semplicemente invocando di nuovo il comando hg tag. Dovrete usare l'opzione per dire a Mercurial che volete davvero aggiornare l'etichetta. + Potete anche modificare un'etichetta in qualsiasi momento, in modo che identifichi una revisione differente, semplicemente invocando di nuovo il comando hg tag. Dovrete usare l'opzione per dire a Mercurial che volete davvero aggiornare l'etichetta. &interaction.tag.replace; - La registrazione permanente della precedente identità dell'etichetta rimarrà, ma Mercurial non la userà più. Quindi non c'è alcuna penalità per etichettare la revisione sbagliata; tutto quello che dovete fare è tornare sui vostri passi ed etichettare la revisione corretta una volta che scoprite il vostro errore. - - Mercurial memorizza le etichette nel vostro repository in un file ordinario soggetto al controllo di revisione. Se avete creato qualche etichetta, le troverete in un file chiamato .hgtags alla radice del vostro repository. Quando eseguite il comando hg tag, Mercurial modifica questo file, poi ne effettua automaticamente il commit registrandone i cambiamenti. Questo significa che ogni volta che eseguite hg tag, vedrete un corrispondente changeset nell'elenco mostrato da hg log. + La precedente identità dell'etichetta rimarrà permanentemente registrata, ma Mercurial non la userà più. Quindi non c'è alcuna penalità da pagare se etichettate la revisione sbagliata, ma tutto quello che dovete fare dopo aver scoperto il vostro errore è tornare sui vostri passi ed etichettare la revisione corretta. + + Mercurial memorizza le etichette nel vostro repository in un file ordinario soggetto al controllo di revisione. Troverete le etichette che avete creato in un file chiamato .hgtags alla radice del vostro repository. Quando eseguite il comando hg tag, Mercurial modifica questo file, poi ne effettua automaticamente il commit registrandone i cambiamenti. Questo significa che ad ogni esecuzione di hg tag corrisponderà un changeset nell'elenco mostrato da hg log. &interaction.tag.tip; Gestire i conflitti di etichette durante un'unione - Non avrete spesso bisogno di preoccuparvi del file .hgtags, ma talvolta la sua presenza si farà sentire durante un'unione. Il formato del file è semplice: consiste di una serie di righe. Ogni riga comincia con un hash di changeset, seguito da uno spazio, seguito dal nome di un'etichetta. - - Se state risolvendo un conflitto nel file .hgtags durante un'unione, c'è un ~twist~ nel modificare il file .hgtags: quando Mercurial sta analizzando le etichette in un repository, non legge mai la copia di lavoro del file .hgtags, ma legge la revisione del file registrata più recentemente. - - Una sfortunata conseguenza di questo design è che non potete verificare la correttezza del file .hgtags risultato dall'unione se non dopo aver effettuato il commit di un cambiamento. Quindi, se vi trovate a risolvere un conflitto su .hgtags durante un'unione, assicuratevi di eseguire hg tags dopo aver effettuato il commit. Se il comando trova un errore nel file .hgtags, riporterà la posizione dell'errore, che potrete dunque correggere, registrando la correzione nel repository. Dovreste poi eseguire ancora hg tags, giusto per essere sicuri che la vostra correzione è corretta. + Avrete raramente bisogno di preoccuparvi del file .hgtags, ma talvolta la sua presenza si farà sentire durante un'unione. Il formato del file è semplice: consiste di una serie di righe, ognuna delle quali comincia con un hash di changeset, seguito da uno spazio, seguito dal nome di un'etichetta. + + Se state risolvendo un conflitto nel file .hgtags durante un'unione, c'è una particolarità da ricordare quando modificate il file .hgtags: quando Mercurial sta analizzando le etichette in un repository, non legge mai la copia di lavoro del file .hgtags, ma legge la revisione del file registrata più recentemente. + + Una sfortunata conseguenza di questo comportamento è che non potete verificare la correttezza del file .hgtags risultato dall'unione se non dopo aver effettuato il commit di un cambiamento. Quindi, se vi trovate a risolvere un conflitto su .hgtags durante un'unione, assicuratevi di eseguire hg tags dopo aver effettuato il commit. Se il comando trova un errore nel file .hgtags, riporterà la posizione dell'errore, che potrete dunque correggere, registrando la correzione nel repository. Dovreste poi eseguire ancora hg tags, giusto per essere sicuri che la vostra correzione sia giusta. Etichette e cloni - Potreste aver notato che il comando hg clone offre un'opzione per lasciarvi clonare una copia esatta di un repository a un particolare changeset. Il nuovo clone non conterrà alcuna cronologia del progetto registrata dopo la revisione che avete specificato. Questo ha una interazione con le etichette che potrebbe sorprendere gli incauti. - - Se ricordate, un'etichetta viene memorizzata come una revisione del file .hgtags. Quando create un'etichetta, il changeset in cui viene registrata si riferisce a un changeset precedente. Quando eseguite hg clone -r foo per clonare un repository all'etichetta foo, il nuovo clone non conterrà alcuna revisione più recente di quella a cui si riferisce l'etichetta, compresa la revisione in cui l'etichetta è stata creata. Il risultato è che otterrete esattamente il sottoinsieme corretto della cronologia del progetto nel nuovo repository, ma non l'etichetta che vi sareste potuti aspettare. + Potreste aver notato che il comando hg clone offre un'opzione per lasciarvi clonare la copia esatta di una particolare revisione di un repository. Il nuovo clone non conterrà alcuna cronologia del progetto registrata dopo la revisione che avete specificato. Questa operazione interagisce con le etichette in un modo che potrebbe sorprendere i più distratti. + + Se ricordate, un'etichetta viene memorizzata come una revisione del file .hgtags. Quando create un'etichetta, il changeset in cui viene registrata si riferisce a un changeset precedente. Quando eseguite hg clone -r foo per clonare un repository all'etichetta foo, il nuovo clone non conterrà alcuna revisione più recente di quella a cui si riferisce l'etichetta, compresa la revisione in cui l'etichetta è stata creata. Come risultato, otterrete esattamente il sottoinsieme corretto della cronologia del progetto nel nuovo repository, ma non l'etichetta che vi sareste potuti aspettare. Quando le etichette permanenti sono eccessive - Dato che le etichette di Mercurial sono soggette a controllo di revisione e trasportate insieme alla cronologia del progetto, chiunque lavori con voi vedrà le etichette che create. Ma dare nomi alle revisioni ha usi che vanno al di là della semplice annotazione che la revisione 4237e45506ee in realtà è la v2.0.2. Se state provando a rintracciare un oscuro bug, poteste volere un'etichetta per ricordarvi di qualcosa come Anna ha visto gli effetti con questa revisione. - - Per casi come questo, quello che potreste voler usare sono le etichette locali. Potete creare un'etichetta locale con l'opzione del comando hg tag. Questo memorizzerà l'etichetta in un file chiamato .hg/localtags. Diversamente da .hgtags, .hg/localtags non è soggetto a controllo di revisione. Qualsiasi etichetta creiate usando l'opzione rimarrà strettamente locale al repository in cui state correntemente lavorando. + Dato che le etichette di Mercurial sono soggette a controllo di revisione e fanno parte della cronologia del progetto, chiunque lavori con voi vedrà le etichette che avete creato. Ma i nomi delle revisioni possono essere usati in modi che vanno oltre la semplice annotazione che la revisione 4237e45506ee è in realtà la v2.0.2. Se state provando a rintracciare un bug intricato, poteste volere un'etichetta per ricordarvi di qualcosa come Anna ha visto gli effetti del bug in questa revisione. + + In casi come questo, quello che potreste voler usare sono le etichette locali. Un'etichetta locale viene creata tramite l'opzione del comando hg tag e viene memorizzata in un file chiamato .hg/localtags. Diversamente da .hgtags, .hg/localtags non è soggetto a controllo di revisione, quindi qualsiasi etichetta creiate usando l'opzione rimarrà strettamente locale al repository in cui state attualmente lavorando. Il flusso dei cambiamenti&emdash;la visione d'insieme e la visione di dettaglio - Per ritornare allo schema che ho abbozzato all'inizio del capitolo, pensiamo a un progetto che ha molteplici attività di sviluppo parallele in lavorazione contemporaneamente. - - Potrebbero esserci iniziative per una nuova release principale, per una nuova release minore che corregge alcuni bug trovati nell'ultima release principale, e per un'inattesa correzione a caldo di una vecchia release che ora è in fase di manutenzione. - - Di solito, le persone chiamano ramo (in inglese, branch) ognuna di queste direzioni di sviluppo parallele. Tuttavia, abbiamo già visto più volte che Mercurial tratta tutta la cronologia come una serie di rami e unioni. In realtà, quello che abbiamo qui sono due idee marginalmente correlate che condividono casualmente lo stesso nome. + Per ritornare allo schema abbozzato all'inizio del capitolo, consideriamo a un progetto che contiene molteplici attività di sviluppo parallele in lavorazione contemporaneamente. + + Potrebbero esserci attività dedicate a una nuova release principale, a una nuova release minore che corregge alcuni bug trovati nell'ultima release principale e a un'inattesa correzione a caldo di una vecchia release che ora si trova in fase di manutenzione. + + Di solito, ognuna di queste direzioni di sviluppo parallele viene chiamata ramo (in inglese, branch). Tuttavia, abbiamo già visto più volte che Mercurial tratta tutta la cronologia come una serie di rami e unioni. In realtà, quello che abbiamo qui sono due idee marginalmente correlate che condividono casualmente lo stesso nome. - Nella visione d'insieme i rami rappresentano il flusso dell'evoluzione di un progetto; le persone danno loro nomi e parlano di loro durante le conversazioni. + Nella visione d'insieme i rami rappresentano il flusso dell'evoluzione di un progetto. Ognuno di questi rami ha il proprio nome ed è oggetto di conversazione tra gli sviluppatori. - Nella visione di dettaglio i rami sono artefatti costruiti durante l'attività quotidiana di sviluppo e unione dei cambiamenti. Narrano la storia di come il codice è stato sviluppato. + Nella visione di dettaglio i rami sono artefatti costruiti durante l'attività quotidiana di sviluppo e unione dei cambiamenti. Questi rami narrano la storia di come il codice è stato sviluppato. Gestire i rami nella visione d'insieme - Nella visione d'insieme, il modo più facile di isolare un ramo in Mercurial è quello di utilizzare un repository dedicato. Se avete un repository condiviso esistente&emdash;chiamiamolo mioprogetto&emdash;che raggiunge una release 1.0, potete cominciare a preparare le future release di mantenimento basate sulla versione 1.0 etichettando la revisione dalla quale avete preparato la release 1.0. + Nella visione d'insieme, il modo più facile per isolare un ramo in Mercurial è quello di utilizzare un repository dedicato. Se avete un repository condiviso esistente&emdash;chiamiamolo myproject&emdash;che raggiunge una milestone 1.0, potete cominciare a preparare le future release di manutenzione basate sulla versione 1.0 etichettando la revisione dalla quale avete preparato la release 1.0. &interaction.branch-repo.tag; - Potete quindi clonare un nuovo repository condiviso mioprogetto-1.0.1 da quella etichetta. + Potete quindi clonare un nuovo repository condiviso myproject-1.0.1 da quella etichetta. &interaction.branch-repo.clone; - Successivamente, chi ha bisogno di lavorare sulla correzione di un bug che dovrebbe essere contenuta in una prossima release minore 1.0.1 potrà clonare il repository myproject-1.0.1, fare le proprie modifiche e poi trasmetterle a quel repository. + Successivamente, chi ha bisogno di lavorare sulla correzione di un bug che dovrebbe essere contenuta in una prossima release minore 1.0.1 potrà clonare il repository myproject-1.0.1, fare le proprie modifiche e poi trasmetterle a quel repository. &interaction.branch-repo.bugfix; - Nel frattempo, lo sviluppo della prossima release principale può continuare, isolato e inesorabile, nel repository mioprogetto. + Nel frattempo, lo sviluppo della prossima release principale può continuare, isolato e ininterrotto, nel repository mioprogetto. &interaction.branch-repo.new; - Non ripetetevi: unire i rami - - In molti casi, se avete un bug da correggere in un ramo di manutenzione, è probabile che il bug sia presenta anche nel ramo principale del progetto (e magari anche in altri rami di manutenzione). È raro che uno sviluppatore voglia correggere lo stesso bug più volte, quindi diamo un'occhiata ad alcuni modi in cui Mercurial può aiutarvi a gestire queste correzioni senza duplicare il vostro lavoro. - - Nel caso più semplice, tutto quello che dovete fare è propagare i cambiamenti dal vostro ramo di manutenzione al vostro clone locale del ramo obiettivo. + Non ripetetevi: le unioni tra rami + + In molti casi, se avete un bug da correggere in un ramo di manutenzione, è probabile che il bug sia presente anche nel ramo principale del progetto (e magari anche in altri rami di manutenzione). È raro che uno sviluppatore voglia correggere lo stesso bug più volte, quindi diamo un'occhiata ad alcuni modi in cui Mercurial può aiutarvi a gestire queste correzioni senza duplicare il vostro lavoro. + + Nel caso più semplice, tutto quello che dovete fare è propagare i cambiamenti dal vostro ramo di manutenzione al vostro clone locale del ramo di destinazione. &interaction.branch-repo.pull; @@ -144,39 +144,39 @@ Denominare i rami in un repository - Nella maggior parte dei casi, isolare ogni ramo in un proprio repository è l'approccio giusto. La sua semplicità lo rende facile da cpaire e quindi è difficile commettere erori. Esiste una relazione uno-a-uno tra i rami in cui state lavorando e le directory sul vostro sistema. Questo vi consente di usare strumenti ordinari (inconsapevoli di Mercurial) per lavorare sui file all'interno di un ramo/repository. - - Se invece appartenete alla categoria degli utenti avanzati (e vi appartengono anche i vostri collaboratori), esiste un modo alternativo di gestire i rami che potete considerare. Ho già menzionato la distinzione a livello umano tra i rami nella visione di dettaglio e nella visione d'insieme. Mentre Mercurial lavora con molteplici rami di dettaglio alla volta in un repository (per esempio dopo che avete propagato i cambiamenti, ma prima di incorporarli), può anche lavorare con molteplici rami d'insieme. - - La chiave per lavorare in questo modo è che Mercurial vi permette di assegnare un nome persistente a un ramo. Esiste sempre un ramo chiamato default. Anche prima che cominciate a denominare rami voi stessi, potete trovare tracce del ramo default se le cercate. - - Per esempio, quando esguite il comando hg commit e vi viene presentato un editor per farvi inserire un messaggio di commit, cercate una riga che contiene il testo HG: branch default verso il fondo. Questo vi dice che il vostro commit avverrà sul ramo chiamato default. + Nella maggior parte dei casi, isolare ogni ramo in un proprio repository è l'approccio giusto. La sua semplicità lo rende facile da capire e quindi è difficile commettere erori. Esiste una relazione uno-a-uno tra i rami in cui state lavorando e le directory sul vostro sistema che vi consente di usare strumenti ordinari (ignari dell'esistenza di Mercurial) per lavorare sui file all'interno di un ramo/repository. + + Se invece appartenete alla categoria degli utenti avanzati (e vi appartengono anche i vostri collaboratori), potete considerare un modo alternativo di gestire i rami. Ho già menzionato la distinzione con cui gli sviluppatori percepiscono i rami nella visione di dettaglio e nella visione d'insieme. Se Mercurial lavora con molteplici rami di dettaglio alla volta in un repository (per esempio dopo che avete propagato i cambiamenti, ma prima di incorporarli), può anche lavorare con molteplici rami d'insieme. + + La chiave per lavorare in questo modo è che Mercurial vi permette di assegnare un nome persistente a un ramo. In ogni repository c'è sempre un ramo chiamato default. Anche prima che cominciate a creare voi stessi nuovi rami con il proprio nome, potete trovare tracce del ramo default se le cercate. + + Per esempio, quando esguite il comando hg commit e vi viene presentato un editor per farvi inserire un messaggio di commit, cercate una riga che contiene il testo HG: branch default verso il fondo. Questo comando vi informa che il vostro commit avverrà sul ramo chiamato default. Per cominciare a lavorare con i rami con nome, usate il comando hg branches. Questo comando elenca i rami con nome già presenti nel vostro repository, dicendovi quale changeset è in cima a ognuno di loro. &interaction.branch-named.branches; - Dato che non avete ancora creato alcun ramo con nome, l'unico che esiste è default. - - Per trovare qual è il ramo corrente, eseguite il comando hg branch senza passargli alcun argomento. Questo vi dice in quale ramo si trova il genitore del changeset corrente. + Dato che non avete ancora creato alcun ramo con nome, l'unico ramo esistente è default. + + Per trovare qual è il ramo corrente, eseguite il comando hg branch senza passargli alcun argomento. Otterrete il nome del ramo in cui trova il genitore del changeset corrente. &interaction.branch-named.branch; - Per creare un nuovo ramo, eseguite di nuovo il comando hg branch. Questa volta, passategli un argomento: il nome del ramo che volete creare. + Per creare un nuovo ramo, eseguite ancora il comando hg branch. Questa volta, passategli un argomento: il nome del ramo che volete creare. &interaction.branch-named.create; - Dopo che avete creato un ramo, potreste chiedervi qual è stato l'effetto del comando hg branch. Che cosa riportano i comandi hg status e hg tip? + Dopo che avete creato un ramo, potreste chiedervi qual è stato l'effetto del comando hg branch. Che cosa ci dicono i comandi hg status e hg tip? &interaction.branch-named.status; - Niente è cambiato nella directory di lavoro e non è stata creata nuova cronologia. Come questo suggerisce, eseguire il comando hg branch non ha alcun effetto permanente, ma dice solo a Mercurial quale nome di ramo usare la prossima volta che effettuate il commit di un changeset. - - Quando inserite un cambiamento nel repository, Mercurial registra il nome del ramo su cui lo avete inserito. Una volta che siete passati dal ramo default a un altro e avete eseguito il commit, vedrete il nome del nuovo ramo apparire nel risultato dei comandi hg log, hg tip e altri comandi che mostrano lo stesso tipo di informazioni. + Niente è cambiato nella directory di lavoro e non è stata creata nuova cronologia. Come queste osservazioni suggeriscono, il comando hg branch non ha alcun effetto permanente, ma si limita a dire a Mercurial quale nome di ramo usare la prossima volta che effettuerete il commit di un changeset. + + Quando inserite un cambiamento nel repository, Mercurial registra il nome del ramo su cui lo avete inserito. Una volta che siete passati dal ramo default a un altro e avete eseguito il commit, vedrete apparire il nome del nuovo ramo nel risultato di hg log, hg tip e altri comandi che mostrano lo stesso tipo di informazioni. &interaction.branch-named.commit; - I comandi tipo hg log stamperanno il nome del ramo di ogni changeset che non è nel ramo default. Come risultato, se non avete mai usato i rami con nome, non vedrete mai questa informazione. + I comandi come hg log stamperanno il nome del ramo di ogni changeset che non appartiene al ramo default. Come risultato, se non avete mai usato i rami con nome, non vedrete mai questa informazione. Una volta che avete denominato un ramo e inserito un cambiamento in quel ramo, ogni commit successivo che discende da quel cambiamento erediterà lo stesso nome di ramo. Potete cambiare il nome a un ramo in ogni momento, usando il comando hg branch. @@ -188,9 +188,9 @@ Gestire molti rami con nome in un repository - Se avete più di un ramo con nome in un repository, Mercurial ricorderà il ramo in cui si trova la vostra directory di lavoro quando eseguite un comando tipo hg update o hg pull -u e aggiornerà la directory di lavoro alla revisione di punta di quel ramo, a prescindere da quale sia la punta dell'intero repository. Per aggiornare la directory di lavoro a una revisione che si trova su un ramo con un nome diverso, potreste dover usare l'opzione per il comando hg update. - - Questo comprotamento è leggermente oscuro, quindi vediamolo in azione. Per prima cosa, controlliamo in quale ramo ci troviamo al momento e quali rami ci sono nel nostro repository. + Se un repository contiene più di un ramo con nome, Mercurial ricorderà il ramo in cui si trova la vostra directory di lavoro quando eseguite un comando come hg update o hg pull -u e aggiornerà la directory di lavoro alla revisione di punta di quel ramo, a prescindere da quale sia la punta dell'intero repository. Per aggiornare la directory di lavoro a una revisione che si trova su un ramo con un nome diverso, potreste dover usare l'opzione del comando hg update. + + Questo comportamento è leggermente complicato, quindi vediamolo in azione. Per prima cosa, controlliamo in quale ramo ci troviamo al momento e quali sono i rami contenuti nel nostro repository. &interaction.branch-named.parents; @@ -200,11 +200,11 @@ &interaction.branch-named.update-switchy; - Se torniamo indietro al ramo foo ed eseguiamo hg update, il comando ci manterrà su foo, senza spostarci alla punta di bar. + Se torniamo indietro al ramo foo ed eseguiamo hg update, il comando ci manterrà su foo piuttosto che spostarci alla punta di bar. &interaction.branch-named.update-nothing; - Inserire un nuovo cambiamento sul ramo foo introduce una nuova testa. + Il commit di una nuova modifica sul ramo foo introduce una nuova testa. &interaction.branch-named.foo-commit; @@ -212,27 +212,27 @@ I nomi di ramo e le unioni - Come probabilmente avete notato, le unioni in Mercurial non sono simmetriche. Diciamo che il nostro repository possiede due teste, 17 e 23. Se uso hg update per aggiornare alla 17 e poi eseguo hg merge per incorporare la 23, Mercurial registra la 17 come il primo genitore dell'unione e la 23 come il secondo. Ma se uso hg update per aggiornare alla 23 e poi eseguo hg merge per incorporare la 17, Mercurial registra la 23 come primo genitore e la 17 come secondo. - - Questo influenza la scelta di Mercurial sui nomi di ramo quando effettuate un'unione. Dopo un'unione, Mercurial manterrà il nome del ramo del primo genitore quando registrate i risultati dell'unione. Se il nome del ramo del primo genitore è foo e lo unite con bar, dopo l'unione il nome del ramo in cui vi troverete sarà ancora foo. - - Capita spesso che un repository contenga più teste, ognuna con lo stesso nome di ramo. Diciamo che io sto lavorando sul ramo foo e anche voi. Effettuiamo il commit di cambiamenti differenti; io estraggo i vostri cambiamenti e mi ritrovo con due teste, ognuna che dichiara di appartenere al ramo foo. Il risultato di un'unione sarà una singola testa sul ramo foo, come potreste sperare. + Come avete probabilmente notato, le unioni in Mercurial non sono simmetriche. Diciamo che il nostro repository possiede due teste, 17 e 23. Se uso hg update per aggiornare alla 17 e poi eseguo hg merge per incorporare la 23, Mercurial registra la 17 come il primo genitore dell'unione e la 23 come il secondo. Ma se uso hg update per aggiornare alla 23 e poi eseguo hg merge per incorporare la 17, Mercurial registra la 23 come primo genitore e la 17 come secondo. + + Questo comportamento influenza la scelta del nome di ramo compiuta da Mercurial quando effettuate un'unione. Dopo un'unione, Mercurial manterrà il nome del ramo del primo genitore quando registrate i risultati dell'unione. Se il nome del ramo del primo genitore è foo, e unite quel ramo con bar, dopo l'unione il nome del ramo in cui vi troverete sarà ancora foo. + + Capita spesso che un repository contenga più teste, ognuna con lo stesso nome di ramo. Diciamo che io sto lavorando sul ramo foo e così fate anche voi. Eseguiamo il commit di cambiamenti differenti, dopodiché io estraggo i vostri cambiamenti e mi ritrovo con due teste, ognuna che dichiara di appartenere al ramo foo. Sperabilmente, il risultato di un'unione sarà una singola testa sul ramo foo. Ma se io sto lavorando sul ramo bar e incorporo il lavoro dal ramo foo, il risultato rimarrà sul ramo bar. &interaction.branch-named.merge; - Per farvi un esempio più concreto, se sto lavorando sul ramo bleeding-edge e voglio incorporare le ultime correzioni dal ramo stable, Mercurial sceglierà il nome del ramo corretto (bleeding-edge) quando estrarrò e incorporerò i cambiamenti da stable. + Per farvi un esempio più concreto, se sto lavorando sul ramo avanzato e voglio incorporare le ultime correzioni dal ramo stabile, Mercurial sceglierà il nome del ramo corretto (avanzato) quando estrarrò e incorporerò i cambiamenti da stabile. La denominazione dei rami è generalmente utile - Non dovreste pensare che i rami con nome siano applicabili solo in situazioni dove avete molteplici rami longevi che coabitano in un singolo repository. Sono molto utili anche nel caso in cui utilizziate un ramo per repository. - - Nel caso più semplice, dare un nome a ogni ramo vi offre una registrazione permanente di quale sia il ramo da cui un changeset ha avuto origine. Questo vi dà un contesto maggiore quando state cercando di seguire la cronologia di un progetto longevo e ramificato. - - Se state lavorando con repository condivisi, potete impostare un hook pretxnchangegroup su ognuno in modo da bloccare i cambiamenti in entrata che appartengono al nome di ramo sbagliato. Questo vi offre una semplice ma efficace difesa contro persone che trasmettono accidentalmente i cambiamenti da un ramo bleeding edge a un ramo stabile. Un hook di questo tipo potrebbe somigliare al seguente, contenuto all'interno del file /.hgrc del repository condiviso. + Non dovreste pensare che i rami con nome si possano utilizzare solo in situazioni dove avete molteplici rami di lunga data che coabitano in un singolo repository. Sono molto utili anche nel caso in cui utilizziate un singolo ramo per repository. + + Nel caso più semplice, dare un nome a ogni ramo vi offre una registrazione permanente dell'identità del ramo da cui un changeset ha avuto origine. Questo vi dà un contesto maggiore quando state cercando di seguire la cronologia di un progetto di lunga data e ramificato. + + Se state lavorando con repository condivisi, potete impostare un hook pretxnchangegroup su ogni repository in modo da bloccare i cambiamenti in entrata che appartengono al nome di ramo sbagliato. Questo accorgimento vi offre una difesa semplice ma efficace nei confronti di chi trasmette accidentalmente i cambiamenti da un ramo avanzato a un ramo stabile. Un hook di questo tipo potrebbe somigliare al seguente, contenuto all'interno del file /.hgrc del repository condiviso. [hooks] pretxnchangegroup.branch = hg heads --template '{branches} ' | grep mybranch