hgbook

annotate it/ch05-daily.xml @ 740:5c6bd9084a7e

First literal translation of Ch.5.
author Giulio@puck
date Sun Jul 05 20:45:19 2009 +0200 (2009-07-05)
parents
children 5a3725bde11e
rev   line source
Giulio@740 1 <chapter id="chap:daily">
Giulio@740 2 <?dbhtml filename="uso-quotidiano-di-mercurial.html"?>
Giulio@740 3 <title>L'uso quotidiano di Mercurial</title>
Giulio@740 4
Giulio@740 5 <sect1>
Giulio@740 6 <title>Dire a Mercurial di quali file tenere traccia</title>
Giulio@740 7
Giulio@740 8 <para id="x_1a3">Mercurial non lavora con i file nel vostro repository a meno che voi non gli diciate di gestirli. Il comando <command role="hg-cmd">hg status</command> vi dirà quali file Mercurial non conosce; usa un <quote><literal>?</literal></quote> per mostrare tali file.</para>
Giulio@740 9
Giulio@740 10 <para id="x_1a4">Per dire a Mercurial di tenere traccia di un file, usate il comando <command role="hg-cmd">hg add</command>. Una volta che avete aggiunto un file, la voce per quel file nell'elenco visualizzato da <command role="hg-cmd">hg status</command> cambia da <quote><literal>?</literal></quote> a <quote><literal>A</literal></quote>.</para>
Giulio@740 11
Giulio@740 12 &interaction.daily.files.add;
Giulio@740 13
Giulio@740 14 <para id="x_1a5">Dopo aver eseguito <command role="hg-cmd">hg commit</command>, i file che avete aggiunto prima dell'inserimento non verranno più elencati dal comando <command role="hg-cmd">hg status</command>. La ragione per questo è che di default, <command role="hg-cmd">hg status</command> vi segnala solo i file <quote>interessanti</quote>&emdash;quelli che avete (per esempio) modificato, rimosso, o rinominato. Se avete un repository che contiene miglia di file, vorrete raramente sapere qualcosa dei file che Mercurial ha già registrato ma che non sono cambiati. (Potete comunque ottenere questa informazione, come vedremo più avanti.)</para>
Giulio@740 15
Giulio@740 16 <para id="x_1a6">Una volta che aggiungete un file, Mercurial non fa nulla con quello immediatamente. Invece, scatterà una fotografia dello stato del file la prossima volta che eseguirete un commit. Poi continuerà a tenere traccia dei cambiamenti che apportate al file ogni volta che effettuate un commit, fino a quando non rimuovete il file.</para>
Giulio@740 17
Giulio@740 18 <sect2>
Giulio@740 19 <title>Designazione esplicita o implicita dei file</title>
Giulio@740 20
Giulio@740 21 <para id="x_1a7">Un comportamento utile che Mercurial ha è che se passate un nome di una directory a un comando, ogni comando Mercurial tratterà questo come <quote>Voglio operare su ogni file in questa directory e nelle sue sottodirectory</quote>.</para>
Giulio@740 22
Giulio@740 23 &interaction.daily.files.add-dir;
Giulio@740 24
Giulio@740 25 <para id="x_1a8">Notate in questo esempio che Mercurial ha stampato i nomi dei file che ha aggiunto, laddove non ha fatto così quando abbiamo aggiunto il file chiamato <filename>myfile.txt</filename> nell'esempio precedente.</para>
Giulio@740 26
Giulio@740 27 <para id="x_1a9">Quello che sta succedendo è che nel primo caso, abbiamo esplicitamente designato il file da aggiungere sulla linea di comando. L'assunzione fatta da Mercurial in questi casi è che sappiamo quello che stiamo facendo, per cui non stampa alcun ~output~.</para>
Giulio@740 28
Giulio@740 29 <para id="x_1aa">Tuttavia, quando <emphasis>implichiamo</emphasis> i nomi dei file dando il nome di una directory, Mercurial compie il passo aggiuntivo di stampare il nome di ogni file con cui fa qualcosa. Questo rende più chiaro ciò che sta succedendo e riduce la probabilità di una sorpresa sgradita e silenziosa. Questo comportamento è comune alla maggior parte dei comandi Mercurial.</para>
Giulio@740 30 </sect2>
Giulio@740 31
Giulio@740 32 <sect2>
Giulio@740 33 <title>Mercurial registra i file, non le directory</title>
Giulio@740 34
Giulio@740 35 <para id="x_1ab">Mercurial non tiene traccia delle informazioni sulle directory. Invece, tiene traccia del percorso di un file. Prima di creare un file, come prima cosa crea tutte le directory mancanti che ne compongono il percorso. Dopo che ha cancellato un file, cancella ogni directory vuota che faceva parte del percorso del file cancellato. Questa sembra una distinzione insignificante, ma ha una minore conseguenza pratica: non è possibile rappresentare una directory completamente vuota in Mercurial.</para>
Giulio@740 36
Giulio@740 37 <para id="x_1ac">Le directory vuote sono raramente utili, e ci sono soluzioni non invadenti che potete usare per ottenere un effetto appropriato. Quindi, gli sviluppatori di Mercurial hanno sentito che la complessità che sarebbe stata richiesta per gestire le directory vuote non valesse il limitato beneficio che questa funzionalità avrebbe portato.</para>
Giulio@740 38
Giulio@740 39 <para id="x_1ad">Se avete bisogno di una directory vuota nel vostro repository, ci sono alcuni modi per ottenerla. Uno di questi è quello di creare una directory, poi di usare <command role="hg-cmd">hg add</command> per aggiungere un file <quote>nascosto</quote> a quella directory. Sui sistemi di tipo Unix, qualsiasi file il cui nome comincia con un punto (<quote><literal>.</literal></quote>) viene considerato nascosto dalla maggior parte dei comandi e dalle applicazioni con interfaccia grafica. Questo approccio è illustrato qui di seguito.</para>
Giulio@740 40
Giulio@740 41 &interaction.daily.files.hidden;
Giulio@740 42
Giulio@740 43 <para id="x_1ae">Un altro modo per fronteggiare il bisogno di una directory vuota è semplicemente quello di crearne una nel vostro script automatico di ~build~ nel momento in cui ne avete bisogno.</para>
Giulio@740 44 </sect2>
Giulio@740 45 </sect1>
Giulio@740 46
Giulio@740 47 <sect1>
Giulio@740 48 <title>Come smettere di tenere traccia di un file</title>
Giulio@740 49
Giulio@740 50 <para id="x_1af">Una volta che avete deciso che un file non appartiene più al vostro repository, usate il comando <command role="hg-cmd">hg remove</command>. Questo cancella il file e dice a Mercurial di non tenerne più traccia (cosa che avverrà nel prossimo commit). Un file rimosso viene rappresentato nell'elenco prodotto da <command role="hg-cmd">hg status</command> con una <quote><literal>R</literal></quote>.</para>
Giulio@740 51
Giulio@740 52 &interaction.daily.files.remove;
Giulio@740 53
Giulio@740 54 <para id="x_1b0">Dopo che avete rimosso un file tramite <command role="hg-cmd">hg remove</command>, Mercurial non terrà più traccia di quel file anche se ricreate un file con lo stesso nome nella vostra directory di lavoro. Se ricreate effettivamente un file con lo stesso nome e volete che Mercurial registri il nuovo file, usate semplicemente <command role="hg-cmd">hg add</command>. Mercurial saprà che il nuovo file non è in alcun modo legato al vecchio file con lo stesso nome.</para>
Giulio@740 55
Giulio@740 56 <sect2>
Giulio@740 57 <title>La rimozione di un file non ha effetti sulla sua cronologia.</title>
Giulio@740 58
Giulio@740 59 <para id="x_1b1">&Egrave; importante capire che la rimozione di un file ha solo due effetti.</para>
Giulio@740 60 <itemizedlist>
Giulio@740 61 <listitem><para id="x_1b2">Rimuove la versione corrente del file dalla directory di lavoro.</para>
Giulio@740 62 </listitem>
Giulio@740 63 <listitem><para id="x_1b3">Ferma Mercurial dal tenere traccia dei cambiamenti al file, dal momento del commit successivo.</para>
Giulio@740 64 </listitem></itemizedlist>
Giulio@740 65 <para id="x_1b4">La rimozione di un file <emphasis>non</emphasis> altera la <emphasis>cronologia</emphasis> del file in alcun modo.</para>
Giulio@740 66
Giulio@740 67 <para id="x_1b5">Se aggiornate la directory di lavoro a un changeset che era stato inserito quando stava ancora tenendo traccia del file che più tardi avete rimosso, il file riapparirà nella directory di lavoro, con i contenuti che aveva quando avete inserito quel changeset. Se poi aggiornate la directory di lavoro a un changeset successivo, in cui il file è stato rimosso, Mercurial rimuoverà ancora una volta il file dalla directory di lavoro.</para>
Giulio@740 68 </sect2>
Giulio@740 69
Giulio@740 70 <sect2>
Giulio@740 71 <title>File mancanti</title>
Giulio@740 72
Giulio@740 73 <para id="x_1b6">Mercurial considera <emphasis>mancante</emphasis> un file che avete cancellato senza usare <command role="hg-cmd">hg remove</command>. Un file mancante viene rappresentato con <quote><literal>!</literal></quote> nell'elenco mostrato da <command role="hg-cmd">hg status</command>. Di solito, i comandi Mercurial non fanno nulla con i file mancanti.</para>
Giulio@740 74
Giulio@740 75 &interaction.daily.files.missing;
Giulio@740 76
Giulio@740 77 <para id="x_1b7">Se il vostro repository contiene un file che <command role="hg-cmd">hg status</command> riporta come mancante, e volete che il file rimanga assente, potete eseguire <command role="hg-cmd">hg remove <option role="hg-opt-remove">--after</option></command> in ogni momento più tardi, per dire a Mercurial che volevate effettivamente rimuovere il file.</para>
Giulio@740 78
Giulio@740 79 &interaction.daily.files.remove-after;
Giulio@740 80
Giulio@740 81 <para id="x_1b8">D'altra parte, se avete cancellato il file mancante per errore, date al comando <command role="hg-cmd">hg revert</command> il nome del file da recuperare. Il file riapparirà, senza alcun cambiamento.</para>
Giulio@740 82
Giulio@740 83 &interaction.daily.files.recover-missing;
Giulio@740 84 </sect2>
Giulio@740 85
Giulio@740 86 <sect2>
Giulio@740 87 <title>Digressione: perché dire esplicitamente a Mercurial di rimuovere un file?</title>
Giulio@740 88
Giulio@740 89 <para id="x_1b9">Potreste chiedervi perché Mercurial richiede che gli diciate esplicitamente che state cancellando un file. Nelle prime fasi di sviluppo, Mercurial vi permetteva di cancellare un file nel modo che preferivate; avrebbe notato l'assenza del file automaticamente quando avreste successivamente eseguito <command role="hg-cmd">hg commit</command>, e avrebbe smesso di tenere traccia del file. In pratica, questo rendeva troppo facile rimuovere un file accidentalmente senza accorgersene.</para>
Giulio@740 90 </sect2>
Giulio@740 91
Giulio@740 92 <sect2>
Giulio@740 93 <title>Utile scorciatoia&emdash;aggiungere e rimuovere file in un unico passo</title>
Giulio@740 94
Giulio@740 95 <para id="x_1ba">Mercurial offre un comando combinato chiamato <command role="hg-cmd">hg addremove</command> che aggiunge i file non ancora registrati e segnala i file mancanti come rimossi.</para>
Giulio@740 96
Giulio@740 97 &interaction.daily.files.addremove;
Giulio@740 98
Giulio@740 99 <para id="x_1bb">Il comando <command role="hg-cmd">hg commit</command> fornisce anche un'opzione <option role="hg-opt-commit">-A</option> che effettua questo stesso aggiungi-e-rimuovi, immediatamente seguito da un commit.</para>
Giulio@740 100
Giulio@740 101 &interaction.daily.files.commit-addremove;
Giulio@740 102 </sect2>
Giulio@740 103 </sect1>
Giulio@740 104
Giulio@740 105 <sect1 id="chap:daily.copy">
Giulio@740 106 <title>Copiare i file</title>
Giulio@740 107
Giulio@740 108 <para id="x_1bc">Mercurial fornisce un comando <command role="hg-cmd">hg copy</command> che vi permette di creare una nuova copia di un file. Quando copiate un file usando questo comando, Mercurial registra il fatto che il nuovo file è una copia del file originale e tratta queste copie in maniera speciale quando unite il vostro lavoro con quello di qualcun altro.</para>
Giulio@740 109
Giulio@740 110 <sect2>
Giulio@740 111 <title>I risultati di una copia durante un'unione</title>
Giulio@740 112
Giulio@740 113 <para id="x_1bd">Quello che succede durante un'unione è che i cambiamenti <quote>seguono</quote> la copia. Per illustrare al meglio cosa questo significa, creiamo un esempio. Cominceremo con il solito piccolo repository che contiene un singolo file.</para>
Giulio@740 114
Giulio@740 115 &interaction.daily.copy.init;
Giulio@740 116
Giulio@740 117 <para id="x_1be">Abbiamo bisogno di fare del lavoro in parallelo, in modo da avere qualcosa da incorporare. Quindi cloniamo il nostro repository.</para>
Giulio@740 118
Giulio@740 119 &interaction.daily.copy.clone;
Giulio@740 120
Giulio@740 121 <para id="x_1bf">Tornando al nostro repository iniziale, usiamo il comando <command role="hg-cmd">hg copy</command> per fare una copia del primo file che abbiamo creato.</para>
Giulio@740 122
Giulio@740 123 &interaction.daily.copy.copy;
Giulio@740 124
Giulio@740 125 <para id="x_1c0">Se successivamente osserviamo il risultato del comando <command role="hg-cmd">hg status</command>, il file copiato appare come un normale file aggiunto.</para>
Giulio@740 126
Giulio@740 127 &interaction.daily.copy.status;
Giulio@740 128
Giulio@740 129 <para id="x_1c1">Ma se passiamo l'opzione <option role="hg-opt-status">-C</option> al comando <command role="hg-cmd">hg status</command>, otterremo un'altra riga nell'elenco stampato: questo è il file <emphasis>da cui</emphasis> il nostro file appena aggiunto è stato copiato.</para>
Giulio@740 130
Giulio@740 131 &interaction.daily.copy.status-copy;
Giulio@740 132
Giulio@740 133 <para id="x_1c2">Ora, tornando al repository che abbiamo clonato, apportiamo un cambiamento in parallelo. Aggiungeremo una riga di contenuto al file originale che abbiamo creato.</para>
Giulio@740 134
Giulio@740 135 &interaction.daily.copy.other;
Giulio@740 136
Giulio@740 137 <para id="x_1c3">Ora abbiamo un <filename>file</filename> modificato in questo repository. Quando estraiamo i cambiamenti dal primo repository e uniamo le due teste, Mercurial propagherà i cambiamenti che abbiamo apportato localmente a <filename>file</filename> nella sua copia, <filename>new-file</filename>.</para>
Giulio@740 138
Giulio@740 139 &interaction.daily.copy.merge;
Giulio@740 140 </sect2>
Giulio@740 141
Giulio@740 142 <sect2 id="sec:daily:why-copy">
Giulio@740 143 <title>Perché i cambiamenti dovrebbeo seguire le copie?</title>
Giulio@740 144
Giulio@740 145 <para id="x_1c4">Questo comportamento&emdash;dei cambiamenti a un file che si propagano alle copie del file&emdash;potrebbe sembrare esoterico, ma nella maggior parte dei casi è altamente desiderabile.</para>
Giulio@740 146
Giulio@740 147 <para id="x_1c5">Prima di tutto, ricordatevi che questa propagazione avviene <emphasis>solamente</emphasis> durante un'unione. Quindi se usate <command role="hg-cmd">hg copy</command> su un file e in seguito modificate il file originale nel normale corso del vostro lavoro, non accadrà nulla.</para>
Giulio@740 148
Giulio@740 149 <para id="x_1c6">La seconda cosa da sapere è che le modifiche si propagheranno alla copia solo se il changeset da cui state incorporando le modifiche <emphasis>non ha ancora visto</emphasis> la copia.</para>
Giulio@740 150
Giulio@740 151 <para id="x_1c7">Il motivo per cui Mercurial si comporta in questo modo è il seguente. Diciamo che correggo un bug importante in un file sorgente e inserisco i miei cambiamenti nel repository. Nel frattempo, voi avete deciso di eseguire <command role="hg-cmd">hg copy</command> per fare una copia del file nel vostro repository, senza sapere del bug o aver visto la correzione, e avete cominciato a lavorare sulla vostra copia del file.</para>
Giulio@740 152
Giulio@740 153 <para id="x_1c8">Se aveste estratto e incorporato i miei cambiamenti, e Mercurial <emphasis>non</emphasis> avesse propagato i cambiamenti attraverso le copie, il vostro nuovo file sorgente ora conterrebbe il bug, e a meno che voi sapeste come propagare la correzione a mano, il bug <emphasis>rimarrebbe</emphasis> nella vostra copia del file.</para>
Giulio@740 154
Giulio@740 155 <para id="x_1c9">Propagando automaticamente le modifiche che hanno corretto il bug dal file originale alla copia, Mercurial previene questo tipo di problemi. A quanto ne so, Mercurial è <emphasis>l'unico</emphasis> sistema di controllo di revisione che propaga i cambiamenti verso le copie in questo modo.</para>
Giulio@740 156
Giulio@740 157 <para id="x_1ca">Una volta che la vostra cronologia dei cambiamenti contiene la registrazione che la copia e la successiva unione sono avvenute, di solito non c'è ulteriore bisogno di propagare cambiamenti dal file originale al file copiato, e questo è il motivo per cui Mercurial propaga i cambiamenti verso le copie durante la prima unione, e non successivamente.</para>
Giulio@740 158 </sect2>
Giulio@740 159
Giulio@740 160 <sect2>
Giulio@740 161 <title>Come <emphasis>evitare</emphasis> che i cambiamenti seguano una copia</title>
Giulio@740 162
Giulio@740 163 <para id="x_1cb">Se, per qualche ragione, decidete che questo affare di propagare automaticamente i cambiamenti verso le copie non fa per voi, utilizzate il normale comando per la copia dei file fornito dal vostro sistema (<command>cp</command> per i sistemi di tipo Unix) per fare la copia di un file, poi aggiungete a mano la nuova copia invocando <command role="hg-cmd">hg add</command>. Prima di farlo, però, rileggete la <xref linkend="sec:daily:why-copy"/> e prendete una decisione informata sulla appropriatezza di questo comportamento nel vostro caso specifico.</para>
Giulio@740 164
Giulio@740 165 </sect2>
Giulio@740 166 <sect2>
Giulio@740 167 <title>Il comportamento del comando <command role="hg-cmd">hg copy</command></title>
Giulio@740 168
Giulio@740 169 <para id="x_1cc">Quando usate il comando <command role="hg-cmd">hg copy</command>, Mercurial esegue la copia di ogni file sorgente nello stato in cui si trova nella directory di lavoro in quel momento. Questo significa che se fate alcune modifiche a un file, poi lo copiate tramite <command role="hg-cmd">hg copy</command> senza prima aver inserito quelle modifiche nel repository, anche la nuova copia conterrà le modifiche che avete apportato fino a quel momento. (Trovo che questo comportamento sia leggermente controintuitivo ed è per questo che lo menziono qui.)</para>
Giulio@740 170
Giulio@740 171 <para id="x_1cd">Il comando <command role="hg-cmd">hg copy</command> agisce in maniera simile al comando Unix <command>cp</command> (potete usare l'alias <command role="hg-cmd">hg cp</command> se preferite). Dobbiamo fornirgli due o più argomenti, di cui l'ultimo viene trattato come <emphasis>destinazione</emphasis> e tutti gli altri vengono trattati come <emphasis>sorgenti</emphasis>.</para>
Giulio@740 172
Giulio@740 173 <para id="x_685">Se invocate <command role="hg-cmd">hg copy</command> con un singolo file come sorgente, e la destinazione non esiste, il comando crea un nuovo file con quel nome.</para>
Giulio@740 174
Giulio@740 175 &interaction.daily.copy.simple;
Giulio@740 176
Giulio@740 177 <para id="x_1ce">Se la destinazione è una directory, Mercurial copia le sorgenti in quella directory.</para>
Giulio@740 178
Giulio@740 179 &interaction.daily.copy.dir-dest;
Giulio@740 180
Giulio@740 181 <para id="x_1cf">Copiare una directory è un'operazione ricorsiva e preserva la struttura delle directory della sorgente.</para>
Giulio@740 182
Giulio@740 183 &interaction.daily.copy.dir-src;
Giulio@740 184
Giulio@740 185 <para id="x_1d0">Se la sorgente e la destinazione sono entrambe directory, l'albero della sorgente viene ricreato nella directory di destinazione.</para>
Giulio@740 186
Giulio@740 187 &interaction.daily.copy.dir-src-dest;
Giulio@740 188
Giulio@740 189 <para id="x_1d1">Come con il comando <command role="hg-cmd">hg remove</command>, se copiate un file manualmente e poi volete far sapere a Mercurial che avete copiato il file, usate semplicemente l'opzione <option role="hg-opt-copy">--after</option> per <command role="hg-cmd">hg copy</command>.</para>
Giulio@740 190
Giulio@740 191 &interaction.daily.copy.after;
Giulio@740 192 </sect2>
Giulio@740 193 </sect1>
Giulio@740 194
Giulio@740 195 <sect1>
Giulio@740 196 <title>Rinominare i file</title>
Giulio@740 197
Giulio@740 198 <para id="x_1d2">&Egrave; molto più comune avere bisogno di rinominare un file piuttosto che copiarlo. La ragione per cui ho discusso il comando <command role="hg-cmd">hg copy</command> prima di parlare di come rinominare i file è che Mercurial tratta un cambiamento di nome essenzialmente nello stesso modo di una copia. Perciò, sapere cosa fa Mercurial qunado copiate un file vi dice che cosa aspettarvi quando rinominate un file.</para>
Giulio@740 199
Giulio@740 200 <para id="x_1d3">Quando usate il comando <command role="hg-cmd">hg rename</command>, Mercurial crea una copia di ogni file sorgente, poi li cancella e segnala i file come rimossi.</para>
Giulio@740 201
Giulio@740 202 &interaction.daily.rename.rename;
Giulio@740 203
Giulio@740 204 <para id="x_1d4">Il comando <command role="hg-cmd">hg status</command> mostra la nuova copia del file come aggiunta e il file da cui è stata effettuata la copia come rimosso.</para>
Giulio@740 205
Giulio@740 206 &interaction.daily.rename.status;
Giulio@740 207
Giulio@740 208 <para id="x_1d5">Come con i risultati del comando <command role="hg-cmd">hg copy</command>, dobbiamo dare l'opzione <option role="hg-opt-status">-C</option> al comando <command role="hg-cmd">hg status</command> per vedere che il file aggiunto viene considerato da Mercurial come una copia del file originale ora rimosso.</para>
Giulio@740 209
Giulio@740 210 &interaction.daily.rename.status-copy;
Giulio@740 211
Giulio@740 212 <para id="x_1d6">Come con <command role="hg-cmd">hg remove</command> e <command role="hg-cmd">hg copy</command>, potete informare Mercurial del cambiamento di nome dopo che il fatto è avvenuto usando l'opzione <option role="hg-opt-rename">--after</option> option. Nella maggior parte degli altri aspetti, il comportamento del comando <command role="hg-cmd">hg rename</command> e le opzioni che accetta sono simili a quelli del comando <command role="hg-cmd">hg copy</command>.</para>
Giulio@740 213
Giulio@740 214 <para id="x_686">Se avete familiarità con la riga di comando Unix, sarete contenti di sapere che il comando <command role="hg-cmd">hg rename</command> può essere invocato come <command role="hg-cmd">hg mv</command>.</para>
Giulio@740 215
Giulio@740 216 <sect2>
Giulio@740 217 <title>Rinominare i file e unire i cambiamenti</title>
Giulio@740 218
Giulio@740 219 <para id="x_1d7">Dato che i cambiamenti di nome in Mercurial sono implementati come copia-e-rimuovi, la stessa propagazione dei cambiamenti avviene quando unite dopo un cambiamento di nome che dopo una copia.</para>
Giulio@740 220
Giulio@740 221 <para id="x_1d8">Se io modifico un file e voi lo rinominate e poi uniamo i nostri rispettivi cambiamenti, le mie modifiche al file sotto il suo nome originale verranno propagate al file sotto il suo nuovo nome. (Questo è qualcosa che potreste aspettarvi che <quote>funzioni e basta</quote> ma in realtà non tutti i sistemi di controllo di revisione lo fanno.)</para>
Giulio@740 222
Giulio@740 223 <para id="x_1d9">Sebbene avere i cambiamenti che seguono una copia è una funzionalità dove potreste forse annuire e dire <quote>sì, questo potrebbe essere utile,</quote> deve essere chiaro che averli che seguono un cambiamento di nome è assolutamente importante. Senza questa agevolazione, sarebbe semplicemente troppo facile per i cambiamenti venire abbandonati quando i file vengono rinominati.</para>
Giulio@740 224 </sect2>
Giulio@740 225
Giulio@740 226 <sect2>
Giulio@740 227 <title>Cambiamenti di nome divergenti e unioni</title>
Giulio@740 228
Giulio@740 229 <para id="x_1da">Il caso dei nomi divergenti accade quando due sviluppatori cominciano con un file&emdash;chiamiamolo <filename>foo</filename>&emdash;nei loro rispettivi repository.</para>
Giulio@740 230
Giulio@740 231 &interaction.rename.divergent.clone;
Giulio@740 232
Giulio@740 233 <para id="x_1db">Anna cambia il nome del file a <filename>bar</filename>.</para>
Giulio@740 234
Giulio@740 235 &interaction.rename.divergent.rename.anne;
Giulio@740 236
Giulio@740 237 <para id="x_1dc">Nel frattempo, Bruno lo rinomina <filename>quux</filename>. (Ricordatevi che <command role="hg-cmd">hg mv</command> è un alias di <command role="hg-cmd">hg rename</command>.)</para>
Giulio@740 238
Giulio@740 239 &interaction.rename.divergent.rename.bob;
Giulio@740 240
Giulio@740 241 <para id="x_1dd">Mi piace pensare a questo come a un conflitto perché entrambi gli sviluppatori hanno espresso intenzioni differenti a proposito di come il file dovrebbe essere chiamato.</para>
Giulio@740 242
Giulio@740 243 <para id="x_1de">Cosa pensate che dovrebbe accadere quando uniscono il loro lavoro? Il reale comportamento di Mercurial è quello di preservare sempre <emphasis>entrambi</emphasis> i nomi quando unisce changeset che contengono cambiamenti di nome divergenti.</para>
Giulio@740 244
Giulio@740 245 &interaction.rename.divergent.merge;
Giulio@740 246
Giulio@740 247 <para id="x_1df">Notate che, se anche Mercurial vi avverte del cambiamento di nome divergente, lascia che siate voi a risolvere la divergenza dopo l'unione.</para>
Giulio@740 248 </sect2>
Giulio@740 249
Giulio@740 250 <sect2>
Giulio@740 251 <title>Cambiamenti di nome convergenti e unioni</title>
Giulio@740 252
Giulio@740 253 <para id="x_1e0">Un altro tipo di conflitto tra i cambiamenti di nome avviene quando due persone rinominano differenti file <emphasis>sorgenti</emphasis> alla stessa <emphasis>destinazione</emphasis>. In questo caso, Mercurial esegue l'unione normalmente e lascia che siate voi a guidarlo verso una risoluzione ragionevole.</para>
Giulio@740 254 </sect2>
Giulio@740 255
Giulio@740 256 <sect2>
Giulio@740 257 <title>Altri casi particolari legati ai nomi</title>
Giulio@740 258
Giulio@740 259 <para id="x_1e1">Mercurial ha un bug permanente che gli impedisce di portare a termine un'unione dove una parte contiene un file con un certo nome mentre l'altra contiene una directory con lo stesso nome. Questo è documentato come <ulink role="hg-bug" url="http://www.selenic.com/mercurial/bts/issue29">problema 29</ulink>.</para>
Giulio@740 260
Giulio@740 261 &interaction.issue29.go;
Giulio@740 262
Giulio@740 263 </sect2>
Giulio@740 264 </sect1>
Giulio@740 265
Giulio@740 266 <sect1>
Giulio@740 267 <title>Rimediare agli errori</title>
Giulio@740 268
Giulio@740 269 <para id="x_1e2">Mercurial possiede alcuni utili comandi che vi aiuteranno a rimediare ad alcuni errori comuni.</para>
Giulio@740 270
Giulio@740 271 <para id="x_1e3">Il comando <command role="hg-cmd">hg revert</command> vi permette di annullare i cambiamenti che avete apportato alla vostra directory di lavoro. Per esempio, se avete aggiunto un file invocando <command role="hg-cmd">hg add</command> per errore, vi basta eseguire <command role="hg-cmd">hg revert</command> con il nome del file che avete aggiunto, e il file non verrà toccato in alcun modo e non sarà più registrato per essere aggiunto da Mercurial. Potete anche usare <command role="hg-cmd">hg revert</command> per disfarvi di cambiamenti sbagliati apportati a un file.</para>
Giulio@740 272
Giulio@740 273 <para id="x_1e4">&Egrave; vantaggioso ricordare che il comando <command role="hg-cmd">hg revert</command> è utile per i cambiamenti che non avete ancora inserito. Una volta che avete inserito un cambiamento, se decidete che è stato un errore potete ancora fare qualcosa, sebbene le vostre opzioni siano molto più limitate.</para>
Giulio@740 274
Giulio@740 275 <para id="x_1e5">Per maggiori informazioni sul comando <command role="hg-cmd">hg revert</command> e dettagli su come trattare i cambiamenti che avete gia inserito, leggete la <!--<xref
Giulio@740 276 linkend="chap:undo"/>-->FIXME.</para>
Giulio@740 277 </sect1>
Giulio@740 278
Giulio@740 279 <sect1>
Giulio@740 280 <title>Affrontare unioni complesse</title>
Giulio@740 281
Giulio@740 282 <para id="x_687">In un progetto grande o complicato, non è inusuale che l'unione tra due changeset risulti in qualche mal di testa. Supponete che ci sia un file sorgente di grandi dimensioni che è stato ampiamente modificato da entrambe le parti di un'unione: quasi inevitabilmente, questo risulterà in conflitti, alcuni dei quali potrebbero volerci alcuni tentativi per risolverli.</para>
Giulio@740 283
Giulio@740 284 <para id="x_688">Costruiamoci un semplice esempio di questo e vediamo come affrontarlo. Cominceremo con un repository contenente un file e lo cloneremo due volte.</para>
Giulio@740 285
Giulio@740 286 &interaction.ch04-resolve.init;
Giulio@740 287
Giulio@740 288 <para id="x_689">In uno dei cloni, modificheremo il file in un modo.</para>
Giulio@740 289
Giulio@740 290 &interaction.ch04-resolve.left;
Giulio@740 291
Giulio@740 292 <para id="x_68a">Nell'altro, modificheremo il file in modo differente.</para>
Giulio@740 293
Giulio@740 294 &interaction.ch04-resolve.right;
Giulio@740 295
Giulio@740 296 <para id="x_68b">Poi, propagheremo entrambi i cambiamenti nel nostro repository originale.</para>
Giulio@740 297
Giulio@740 298 &interaction.ch04-resolve.pull;
Giulio@740 299
Giulio@740 300 <para id="x_68c">Ora ci aspettiamo che il nostro repository contenga due teste.</para>
Giulio@740 301
Giulio@740 302 &interaction.ch04-resolve.heads;
Giulio@740 303
Giulio@740 304 <para id="x_68d">Normalmente, se eseguissimo il comando <command role="hg-cmd">hg merge</command> a questo punto, ci presenterebbe un'applicazione grafica che ci permetterebbe di riconciliare manualmente le modifiche in conflitto su <filename>myfile.txt</filename>. Tuttavia, per semplificare le cose ai fini della presentazione, vorremmo invece che l'unione fallisse immediatamente. Ecco un modo in cui possiamo farlo.</para>
Giulio@740 305
Giulio@740 306 &interaction.ch04-resolve.export;
Giulio@740 307
Giulio@740 308 <para id="x_68e">Abbiamo chiesto al meccanismo di unione di Mercurial di eseguire il comando <command>false</command> (che, come desideriamo, fallisce immediatamente) se si accorge di un'unione che non è in grado di risolvere automaticamente.</para>
Giulio@740 309
Giulio@740 310 <para id="x_68f">Se ora lanciamo <command role="hg-cmd">hg merge</command>, dovrebbe fermarsi e riportare un fallimento.</para>
Giulio@740 311
Giulio@740 312 &interaction.ch04-resolve.merge;
Giulio@740 313
Giulio@740 314 <para id="x_690">Se anche non abbiamo notato che l'unione è fallita, Mercurial eviterà di farci accidentalmente inserire i risultati di un'unione fallita.</para>
Giulio@740 315
Giulio@740 316 &interaction.ch04-resolve.cifail;
Giulio@740 317
Giulio@740 318 <para id="x_691">Quando <command role="hg-cmd">hg commit</command> fallisce in questo caso, suggerisce di usare il comando <command role="hg-cmd">hg resolve</command> a noi sconosciuto. Come al solito, <command role="hg-cmd">hg help resolve</command> stamperà un'utile sinossi.</para>
Giulio@740 319
Giulio@740 320 <sect2>
Giulio@740 321 <title>Gli stati di risoluzione di un file</title>
Giulio@740 322
Giulio@740 323 <para id="x_692">Quando avviene un'unione, di solito la maggior parte dei file rimarrà tale e quale. Per ogni file per cui deve fare qualcosa, Mercurial terrà traccia del suo stato.</para>
Giulio@740 324
Giulio@740 325 <itemizedlist>
Giulio@740 326 <listitem>
Giulio@740 327 <para id="x_693">Un file <emphasis>risolto</emphasis> è stato unito con successo, automaticamente da Mercurial oppure con un intervento umano.</para>
Giulio@740 328 </listitem>
Giulio@740 329 <listitem>
Giulio@740 330 <para id="x_694">Un file <emphasis>irrisolto</emphasis> non è stato unito con successo e necessità di ulteriori attenzioni.</para>
Giulio@740 331 </listitem>
Giulio@740 332 </itemizedlist>
Giulio@740 333
Giulio@740 334 <para id="x_695">Se Mercurial vede un <emphasis>qualsiasi</emphasis> file nello stato irrisolto dopo un'unione, considera l'unione come fallita. Fortunatamente, non abbiamo bisogno di ricominciare l'intera unione da zero.</para>
Giulio@740 335
Giulio@740 336 <para id="x_696">L'opzione <option role="hg-opt-resolve">--list</option> o <option role="hg-opt-resolve">-l</option> per il comando <command role="hg-cmd">hg resolve</command> mostra lo stato di ogni file coinvolto in un'unione.</para>
Giulio@740 337
Giulio@740 338 &interaction.ch04-resolve.list;
Giulio@740 339
Giulio@740 340 <para id="x_697">Nell'elenco stampato da <command role="hg-cmd">hg resolve</command>, un file risolto è contrassegnato con una <literal>R</literal> mentre un file irrisolto è contrassegnato con una <literal>U</literal>. Se un file qualsiasi viene elencato con una <literal>U</literal>, sappiamo che un tentativo di inserire i risultati dell'unione nel repository andrebbe incontro al fallimento.</para>
Giulio@740 341 </sect2>
Giulio@740 342
Giulio@740 343 <sect2>
Giulio@740 344 <title>Risolvere un'unione di file</title>
Giulio@740 345
Giulio@740 346 <para id="x_698">Abbiamo diverse opzioni per muovere un file dallo stato irrisolto a quello risolto. Quella di gran lunga più comune consiste nell'eseguire nuovamente <command role="hg-cmd">hg resolve</command>. Se passiamo i nomi di singoli file o directory, il comando riproverà a unire i file irrisolti presenti in quelle ubicazioni. Possiamo anche passare l'opzione <option role="hg-opt-resolve">--all</option> o <option role="hg-opt-resolve">-a</option>, che riproverà a unire <emphasis>tutti</emphasis> i file irrisolti.</para>
Giulio@740 347
Giulio@740 348 <para id="x_699">Mercurial ci permette anche di modificare direttamente lo stato di risoluzione di un file. Possiamo manualmente contrassegnare un file come risolto usando l'opzione <option role="hg-opt-resolve">--mark</option>, o come irrisolto usando l'opzione <option role="hg-opt-resolve">--unmark</option>. Questo ci consente di ripulire a mano un'unione particolarmente confusa e di tenere traccia dei nostri progressi con ogni file man mano che procediamo.</para>
Giulio@740 349 </sect2>
Giulio@740 350 </sect1>
Giulio@740 351
Giulio@740 352 <sect1>
Giulio@740 353 <title>Formati di diff più utili</title>
Giulio@740 354
Giulio@740 355 <para id="x_6c7">L'uscita di default del comando <command role="hg-cmd">hg diff</command> è compatibile all'indietro con il normale comando <command>diff</command>, ma questo presenta alcuni svantaggi.</para>
Giulio@740 356
Giulio@740 357 <para id="x_6c8">Considerate il caso in cui usiamo <command role="hg-cmd">hg rename</command> per rinominare un file.</para>
Giulio@740 358
Giulio@740 359 &interaction.ch04-diff.rename.basic;
Giulio@740 360
Giulio@740 361 <para id="x_6c9">Il risultato di <command role="hg-cmd">hg diff</command> mostrato qui sopra oscura il fatto che abbiamo semplicemente rinominato un file. Il comando <command role="hg-cmd">hg diff</command> accetta l'opzione <option>--git</option> o <option>-g</option> per usare un formato di diff più nuovo che mostra queste informazioni in una forma più leggibile.</para>
Giulio@740 362
Giulio@740 363 &interaction.ch04-diff.rename.git;
Giulio@740 364
Giulio@740 365 <para id="x_6ca">Questa opzione ci viene in aiuto anche in un caso che altrimenti risulterebbe confuso: un file che sembra essere stato modificato secondo <command role="hg-cmd">hg status</command>, ma per il quale <command role="hg-cmd">hg diff</command> non stampa nulla. Questa situazione può presentarsi se cambiamo i permessi di esecuzione di un file.</para>
Giulio@740 366
Giulio@740 367 &interaction.ch04-diff.chmod;
Giulio@740 368
Giulio@740 369 <para id="x_6cb">Il normale comando <command>diff</command> non fa attenzione di permessi dei file, e questo è il motivo per cui <command role="hg-cmd">hg diff</command> non stampa nulla di default. Se forniamo al comando l'opzione <option>-g</option>, ci dice che cos'è realmente accaduto.</para>
Giulio@740 370
Giulio@740 371 &interaction.ch04-diff.chmod.git;
Giulio@740 372 </sect1>
Giulio@740 373
Giulio@740 374 <sect1>
Giulio@740 375 <title>Quali file gestire e quali file evitare</title>
Giulio@740 376
Giulio@740 377 <para id="x_6cc">I sistemi di controllo di revisione sono generalmente migliori a gestire file di testo che sono scritti da esseri umani, come il codice sorgente, dove i file non cambiano molto da una revisione all'altra. Alcuni sistemi centralizzati di controllo di revisione possono anche affrontare abbastanza bene i file binari, come immagini bitmap.</para>
Giulio@740 378
Giulio@740 379 <para id="x_6cd">Per esempio, il gruppo di sviluppo di un gioco dovrà tipicamente gestire sia il proprio codice sorgente sia i propri asset binari (e.g. dati geometrici, texture, schemi di mappe) in un sistema di controllo di revisione.</para>
Giulio@740 380
Giulio@740 381 <para id="x_6ce">Dato che di solito è impossibile unire due modifiche in conflitto a un file binario, i sistemi centralizzati spesso forniscono un meccanismo di bloccaggio dei file che permette a un utente di dire <quote>sono la sola persona che può modificare questo file</quote>.</para>
Giulio@740 382
Giulio@740 383 <para id="x_6cf">Confrontato con un sistema centralizzato, un sistema distribuito di controllo di revisione modifica alcuni dei fattori che guidano le decisioni su quali file gestire e come.</para>
Giulio@740 384
Giulio@740 385 <para id="x_6d0">Per esempio, un sistema distribuito di controllo di revisione non può, per la sua natura, offrire un meccanismo di bloccaggio dei file. Qunidi non c'è alcun meccanismo predefinito per evitare che due persone apportino cambiamenti in conflitto a un file binario. Se avete un gruppo dove diverse persone potrebbero modificare frequentemente i file binari, potrebbe non essere una buona idea impiegare Mercurial&emdash;o un qualsiasi altro sistema distribuito di controllo di revisione&emdash;per gestire quei file.</para>
Giulio@740 386
Giulio@740 387 <para id="x_6d1">Quando memorizza le modifiche a un file, di solito Mercurial salva solo le differenze tra la versione corrente del file e quella precedente. Per la maggior parte dei file di testo, questo si rivela estremamente efficiente. Tuttavia, alcuni file (in particolare i file binari) sono costruiti in modo tale che persino un piccolo cambiamento al contenuto logico del file risulta nel cambiamento di molti o della maggior parte dei byte contenuti nel file. Per esempio, i file compressi sono particolarmente suscettibili a questo. Se le differenze tra ogni versione successiva di un file sono sempre grandi, Mercurial non riuscirà a memorizzare la cronologia del file in maniera molto efficiente. Questo potrebbe avere effetti sia sul bisogno di spazio di memorizzazione locale sia sulla quantità di tempo che viene impiegata per clonare un repository.</para>
Giulio@740 388
Giulio@740 389 <para id="x_6d2">Per avere un'idea di come questo potrebbe riguardarvi nella pratica, supponete di voler usare Mercurial per gestire un documento OpenOffice. OpenOffice memorizza i documenti su disco sotto forma di file zip compressi. Modificate anche solo una lettera nel vostro documento in OpenOffice e quasi ogni byte nell'intero file cambieranno quando lo salverete. Ora supponete che quel file sia di 2MB. Dato che la maggior parte del file cambia ogni volta che lo salvate, Mercurial dovrà memorizzare tutti i 2MB del file ogni volta che eseguite un commit, anche se dal vostro punto di vista forse solo poche parole vengono cambiate ogni volta. Un singolo file modificato frequentemente che non rispetti amichevolmente le assunzioni dei meccanismi di memorizzazione di Mercurial può facilmente avere un effetto fuori misura sulle dimensioni del repository.</para>
Giulio@740 390
Giulio@740 391 <para id="x_6d3">Anche peggio, se voi e qualcun altro modificate il documento OpenOffice su cui state lavorando, non c'è alcun modo utile di effettuare un'unione tra le diverse versioni. In effetti, non c'è nemmeno un buon modo di capire quali sono le differenze tra i vostri rispettivi cambiamenti.</para>
Giulio@740 392
Giulio@740 393 <para id="x_6d4">Quindi, ci sono alcune chiare raccomandazioni sui tipi di file con i quali dovete fare molta attenzione.</para>
Giulio@740 394
Giulio@740 395 <itemizedlist>
Giulio@740 396 <listitem>
Giulio@740 397 <para id="x_6d5">I file che sono molto grandi e incomprimibili, e.g. le immagini ISO dei CD-ROM, renderanno la clonazione attraverso la rete molto lenta semplicemente a causa delle loro dimensioni.</para>
Giulio@740 398 </listitem>
Giulio@740 399 <listitem>
Giulio@740 400 <para id="x_6d6">I file che cambiano parecchio da una revisoine alla successiva potrebbero essere costosi da memorizzare se li modificate frequentemente, e i conflitti causati da modifiche in parallelo potrebbero essere difficili da risolvere.</para>
Giulio@740 401 </listitem>
Giulio@740 402 </itemizedlist>
Giulio@740 403 </sect1>
Giulio@740 404
Giulio@740 405 <sect1>
Giulio@740 406 <title>Backup e ~mirroring~</title>
Giulio@740 407
Giulio@740 408 <para id="x_6d7">Dato che Mercurial mantiene una copia completa della cronologia in ogni clone, chiunque usi Mercurial per collaborare su un progetto può potenzialmente agire come una sorgente di backup nell'eventualità di una catastrofe. Se un repository centrale diventa inaccessibile, potete costruire un rimpiazzo semplicemente clonando la copia del repository da un collaboratore ed estraendo qualsiasi cambiamento che potrebbe non aver visto da altre persone.</para>
Giulio@740 409
Giulio@740 410 <para id="x_6d8">&Egrave; semplice usare Mercurial per effettuare backup ~off-site~ e mirror remoti. Impostate un ~job~ periodico (e.g. tramite il comando <command>cron</command>) su un server remoto per estrarre i cambiamenti dai vostri repository principali ogni ora. Questo sarà complicato solo nell'improbabile caso in cui il numero di repository principali che mantenete cambia frequentemente, caso in cui avrete bisogno di usare uno script per programmare l'aggiornamento della lista dei repository di cui fare il backup.</para>
Giulio@740 411
Giulio@740 412 <para id="x_6d9">Se effettuate un backup tradizionale dei vostri repository principali su nastro o disco e volete fare il backup di un repository chiamato <filename>myrepo</filename>, usate il comando <command>hg clone -U myrepo myrepo.bak</command> per creare un clone di <filename>myrepo</filename> prima di cominciare i vostri backup. L'opzione <option>-U</option> non estrae una directory di lavoro dopo che la clonazione si è conclusa, dato che sarebbe superfluo e renderebbe più lungo il backup.</para>
Giulio@740 413
Giulio@740 414 <para id="x_6da">Se poi effettuate il backup di <filename>myrepo.bak</filename> invece di <filename>myrepo</filename>, avrete la garanzia di possedere una fotografia consistente del vostro repository a cui nessuno sviluppatore insonne trasmetterà i propri cambiamenti nel bel mezzo di un'operazione di backup.</para>
Giulio@740 415 </sect1>
Giulio@740 416 </chapter>