Commits

Anonymous committed 19ff2ff

Literal translation of Ch.7.

Comments (0)

Files changed (2)

 <!ENTITY ch04     SYSTEM "ch04-concepts.xml">
 <!ENTITY ch05     SYSTEM "ch05-daily.xml">
 <!ENTITY ch06     SYSTEM "ch06-collab.xml">
+<!ENTITY ch07     SYSTEM "ch07-filenames.xml">
 <!--
-<!ENTITY ch07     SYSTEM "ch07-filenames.xml">
 <!ENTITY ch08     SYSTEM "ch08-branch.xml">
 <!ENTITY ch09     SYSTEM "ch09-undo.xml">
 <!ENTITY ch10     SYSTEM "ch10-hook.xml">
   &ch05;
   <!-- BEGIN ch06 -->
   &ch06;
-  <!-- BEGIN ch07
-  &ch07; -->
+  <!-- BEGIN ch07 -->
+  &ch07;
   <!-- BEGIN ch08
   &ch08; -->
   <!-- BEGIN ch09

it/ch07-filenames.xml

+<chapter id="chap:names">
+  <?dbhtml filename="nomi-di-file-e-corrispondenze-di-pattern.html"?>
+  <title>Nomi di file e corrispondenze di pattern</title>
+
+  <para id="x_543">Mercurial fornisce meccanismi che vi permettono di lavorare con i nomi dei file in modo coerente ed espressivo.</para>
+
+  <sect1>
+    <title>Denominazione semplice dei file</title>
+
+    <para id="x_544">Mercurial usa un unico meccanismo <quote>~under the hood~</quote> per gestire i nomi dei file. Tutti i comandi si comportano in maniera uniforme rispetto ai nomi dei file. I comandi lavorano con i nomi dei file nel modo seguente.</para>
+
+    <para id="x_545">Se nominate esplicitamente file reali sulla riga di comando, Mercurial lavora esattamente con quei file, come vi aspettereste.</para>
+    
+      &interaction.filenames.files;</para>
+
+    <para id="x_546">Quando fornite un nome di directory, Mercurial interpreterà questa azione come la volontà di <quote>operare su tutti i file in questa directory e nelle sue sottodirectory</quote>. Mercurial considera i file e le sottodirectory in una directory secondo l'ordine alfabetico. Quando incontra una sottodirectory, attraverserà quella sottodirectory prima di continuare con la directory corrente.</para>
+
+      &interaction.filenames.dirs;
+  </sect1>
+
+  <sect1>
+    <title>Eseguire comandi senza nomi di file</title>
+
+    <para id="x_547">I comandi di Mercurial che lavorano con i nomi di file assumono un utile comportamento predefinito quando li invocate senza passare alcun nome di file o pattern. Il comportamento che dovreste aspettarvi dipende dalla funzionalità del comando. Ecco alcune ~rules of thumb~ che potete usare per predirre cosa è probabile che farà un comando se non gli date alcun nome con cui lavorare.</para>
+    <itemizedlist>
+      <listitem><para id="x_548">La maggior parte dei comandi opererà sull'intera directory di lavoro. Per esempio, questo è quello che fa il comando <command role="hg-cmd">hg add</command>.</para>
+      </listitem>
+      <listitem><para id="x_549">Se il comando ha effetti che sono difficili o impossibili da invertire, vi obbligherà a dargli esplicitamente almeno un nome o un pattern (si veda più avanti). Per esempio, questo vi protegge dalla cancellazione accidentale dei file causata dall'esecuzione di <command role="hg-cmd">hg remove</command> senza argomenti.</para>
+      </listitem></itemizedlist>
+
+    <para id="x_54a">Se questi comportamenti predefiniti non vi soddisfano, è facile aggirarli. Se un comando normalmente opera sull'intera directory di lavoro, potete invocarlo solo sulla directory corrente e le sue sottodirectory passandogli il nome <quote><filename class="directory">.</filename></quote>.</para>
+
+    &interaction.filenames.wdir-subdir;
+
+    <para id="x_54b">Sulla stessa falsariga, alcuni comandi normalmente stampano nomi di file relativi alla radice del repository, anche quando li invocate da una sottodirectory. Questi comandi stamperanno nomi di file relativi alla vostra sottodirectory se gli passate nomi espliciti. Qui di seguito eseguiremo <command role="hg-cmd">hg status</command> da una sottodirectory e lo faremo agire sull'intera directory di lavoro pur stampando nomi di file relativi alla nostra sottodirectory, passandogli il risultato del comando <command role="hg-cmd">hg root</command>.</para>
+
+      &interaction.filenames.wdir-relname;
+  </sect1>
+
+  <sect1>
+    <title>Dirvi cosa sta accadendo</title>
+
+    <para id="x_54c">L'esempio di <command role="hg-cmd">hg add</command> nella sezione precedente illustra qualcos'altro che è utile sapere sui comandi Mercurial. Se un comando opera su un file che non avete nominato esplicitamente sulla riga di comando, di solito stamperà il nome del file in modo che non veniate sorpresi da quello che sta succedendo.</para>
+
+    <para id="x_54d">In questo caso, Mercurial segue il principio della <emphasis>~least surprise~</emphasis>. Se avete fornito il nome esatto di un file sulla riga di comando, non ha senso ripetervelo. Se Mercurial sta agendo <emphasis>implicitamente</emphasis> su un file, e.g. perché non avete fornito alcun nome, o su una directory, o su un pattern (si veda più avanti), è più sicuro farvi sapere su quali file sta lavorando.</para>
+
+    <para id="x_54e">Potete ridurre al silenzio i comandi che si comportano in questo modo usando l'opzione <option role="hg-opt-global">-q</option>. Potete anche dirgli di stampare il nome di tuti i file, anche quelli che avete nominato esplicitamente, usando l'opzione <option role="hg-opt-global">-v</option>.</para>
+  </sect1>
+
+  <sect1>
+    <title>Usare i pattern per identificare i file</title>
+
+    <para id="x_54f">Oltre a lavorare con i nomi di file e directory, Mercurial vi consente di usare i <emphasis>pattern</emphasis> per identificare i file. La gestione dei pattern da parte di Mercurial è espressiva.</para>
+
+    <para id="x_550">Su sistemi di tipo Unix (Linux, Mac OS X, etc.), di solito è la shell ad occuparsi di trovare le corrispondenze tra i pattern e i nomi dei file. Su questi sistemi, dovete esplicitamente dire a Mercurial che un nome è un pattern. Sotto Windows, la shell non si occupa di espandere i pattern, quindi Mercurial identificherà automaticamente i nomi che sono pattern e li espanderà per voi.</para>
+
+    <para id="x_551">Per fornire un pattern al posto di un nome regolare sulla riga di comando, il meccanismo è semplice:</para>
+    <programlisting>syntax:patternbody</programlisting>
+    <para id="x_552">Cioè, un pattern viene identificato da una breve stringa di testo che indica il tipo del pattern, seguita dai due punti, seguiti dall'effettivo pattern.</para>
+
+    <para id="x_553">Mercurial supporta due tipi di sintassi per i pattern. Quello usato più spesso è chiamato <literal>glob</literal>: è lo stesso tipo di pattern usato dalla shell Unix e dovrebbe essere familiare anche agli utenti del prompt dei comandi di Windows.</para>
+
+    <para id="x_554">Quando Mercurial effettua la corrispondenza automatica di un pattern sotto Windows, usa la sintassi <literal>glob</literal>. Quindi, potete omettere il prefisso <quote><literal>glob:</literal></quote> sotto Windows, ma se volete potete anche usarlo tranquillamente.</para>
+
+    <para id="x_555">La sintassi <literal>re</literal> è più potente perché vi permette di specificare i pattern usando le espressioni regolari, anche note come regexp.</para>
+
+    <para id="x_556">Notate che, negli esempi che seguono, farò molta attenzione a racchiudere tutti i miei pattern tra caratteri di apice, in modo che non vengano espansi dalla shell prima che Mercurial li veda.</para>
+
+    <sect2>
+      <title>I pattern <literal>glob</literal> sullo stile della shell</title>
+
+      <para id="x_557">Questa è un'introduzione ai tipi di pattern che potete usare quando state cercando una corrispondenza con un pattern di tipo glob.</para>
+
+      <para id="x_558">Il carattere <quote><literal>*</literal></quote> corrisponde a qualsiasi stringa all'interno di una singola directory.</para>
+
+      &interaction.filenames.glob.star;
+
+      <para id="x_559">Il pattern <quote><literal>**</literal></quote> corrisponde a qualsiasi stringa e attraversa i confini delle directory. Non è un simbolo di tipo glob standard sotto Unix, ma viene accettato da diverse shell Unix popolari ed è molto utile.</para>
+
+      &interaction.filenames.glob.starstar;
+
+      <para id="x_55a">Il pattern <quote><literal>?</literal></quote> corrisponde a qualsiasi carattere singolo.</para>
+
+      &interaction.filenames.glob.question;
+
+      <para id="x_55b">Il carattere <quote><literal>[</literal></quote> comincia una <emphasis>classe di caratteri</emphasis>. Questo pattern corrisponde a qualsiasi carattere compreso nella classe. La classe viene terminata da un carattere <quote><literal>]</literal></quote> character. Una classe può contenere molteplici <emphasis>intervalli</emphasis> della forma <quote><literal>a-f</literal></quote>, che è una abbreviazione per <quote><literal>abcdef</literal></quote>.</para>
+
+	&interaction.filenames.glob.range;
+
+      <para id="x_55c">Se il primo carattere dopo <quote><literal>[</literal></quote> in una classe di caratteri è <quote><literal>!</literal></quote>, si ottiene l'effetto di <emphasis>negare</emphasis> la classe, facendola corrispondere a qualsiasi carattere non compreso nella classe.</para>
+
+      <para id="x_55d">Un carattere <quote><literal>{</literal></quote> comincia un gruppo di sottopattern, che trova una corrispondenza se un qualsiasi sottopattern nel gruppo trova una corrispondenza. Il carattere <quote><literal>,</literal></quote> separa i sottopattern, e il carattere <quote><literal>}</literal></quote> termina il gruppo.</para>
+
+      &interaction.filenames.glob.group;
+
+      <sect3>
+	<title>Fate attenzione!</title>
+
+	<para id="x_55e">Non dimenticate che se volete trovare corrispondenze a un pattern in qualsiasi directory, non dovreste usare il simbolo <quote><literal>*</literal></quote>, dato che questo troverà corrispondenze solo in una directory. Invece, usate il simbolo <quote><literal>**</literal></quote>. Questo piccolo esempio illustra la differenza tra i due.</para>
+
+	  &interaction.filenames.glob.star-starstar;
+      </sect3>
+    </sect2>
+
+    <sect2>
+      <title>Corrispondenze di espressioni regolari con i pattern <literal>re</literal></title>
+
+      <para id="x_55f">Mercurial accetta la stessa sintassi per le espressioni regolari che viene usata dal linugaggio di programmazione Python (usa internamente il motore di regexp di Python). Questa sintassi è basata su quella del linguaggio Perl, che è il dialetto più popolare in uso (è anche utilizzato in Java, per esempio).</para>
+
+      <para id="x_560">Non discuterò alcun dettaglio del dialetto di regexp di Mercurial, qui, dato che le regexp non vengono usate molto spesso. Le regexp in stile Perl sono comunque già documentate in maniera esauriente su una moltitudine di siti web e in numerosi libri. Invece, qui mi concentrerò su alcune cose che dovreste sapere se vi trovate ad avere bisogno di usare le espressioni regolari con Mercurial.</para>
+
+      <para id="x_561">Una regexp cerca una corrispondenza con un intero nome di file, relativo alla radice del repository. In altre parole, anche se siete già nella sottodirectory <filename class="directory">foo</filename>, se volete una corrispondenza con i file in questa directory, il vostro pattern dovrà cominciare con <quote><literal>foo/</literal></quote>.</para>
+
+      <para id="x_562">Una cosa da notare, se avete familiarità con le regexp in stile Perl, è che le espressioni regolari di Mercurial sono <emphasis>~rooted~</emphasis>. Cioè, una regexp cerca una corrispondenza dall'inizio di una stringa e non cerca corrispondenze in altre posizioni all'interno della stringa. Per cercare una corrispondenza in qualsiasi punto della stringa, il vostro pattern deve cominciare con <quote><literal>.*</literal></quote>.</para>
+    </sect2>
+  </sect1>
+
+  <sect1>
+    <title>Filtrare i file</title>
+
+    <para id="x_563">Mercurial non vi dà solo una varietà di modi per specificare i file, ma vi permette di vagliare ulteriormente quei file usando i <emphasis>filtri</emphasis>. I comandi che lavorano con i nomi dei file accettano due opzioni di filtraggio.</para>
+    <itemizedlist>
+      <listitem><para id="x_564">L'opzione <option role="hg-opt-global">-I</option>, o <option role="hg-opt-global">--include</option>, vi permette di specificare un pattern a cui i nomi dei file devono corrispondere per poter essere elaborati.</para>
+      </listitem>
+      <listitem><para id="x_565">L'opzione <option role="hg-opt-global">-X</option>, o <option role="hg-opt-global">--exclude</option>, vi fornisce un modo per <emphasis>evitare</emphasis> di elaborare i file che corrispondono a questo pattern.</para>
+      </listitem></itemizedlist>
+    <para id="x_566">Potete passare più opzioni <option role="hg-opt-global">-I</option> e <option role="hg-opt-global">-X</option> sulla riga di comando e mescolarle come preferite. Mercurial interpreta i pattern che fornite usando la sintassi glob per default (ma potete usare le espressioni regolari se ne avete bisogno).</para>
+
+    <para id="x_567">Potete interpretare un filtro <option role="hg-opt-global">-I</option> come <quote>elabora solo i file che corrispondono a questo filtro</quote>.</para>
+
+    &interaction.filenames.filter.include;
+
+    <para id="x_568">L'interpretazione migliore del filtro <option role="hg-opt-global">-X</option> è come <quote>elabora solo i file che non corrispondono a questo pattern</quote>.</para>
+
+    &interaction.filenames.filter.exclude;
+  </sect1>
+
+  <sect1>
+    <title>Ignorare permanentemente file e directory indesiderate</title>
+
+    <para id="x_569">Quando create un nuovo repository, è possibile che nel tempo crescerà fino a contenere file che <emphasis>non</emphasis> dovrebbero essere gestiti da Mercurial, ma che non volete vedere elencati ogni volta che eseguite <command>hg status</command>. Per esempio, i <quote>prodotti di assemblaggio</quote> sono file che vengono creati come parte dell'assemblaggio di un progetto ma che non dovrebbero essere gestiti da un sistema di controllo di revisione. I prodotti di assemblaggio più comuni sono file prodotti da strumenti software come i compilatori. Un altro esempio sono i file di bloccaggio, i file di lavoro temporanei e i file di backup che gli editor di testo spargono nelle directory e che non ha alcun senso gestire.</para>
+
+    <para id="x_6b4">Per fare in modo che Mercurial ignori permanentemente quei file, create un file chiamato <filename>.hgignore</filename> alla radice del vostro repository. <emphasis>Dovreste</emphasis> aggiungere al repository questo file tramite <command>hg add</command> in modo che Mercurial ne tenga traccia insieme al resto dei contenuti del vostro repository, dato che anche i vostri collaboratori potrebbero trovarlo utile.</para>
+
+    <para id="x_6b5">Di default, il file <filename>.hgignore</filename> dovrebbe contenere una lista di espressioni regolari, una per riga. Le linee vuote vengono saltate. La maggior parte delle persone preferisce descrivere i file che vogliono ignorare utilizzando la sintassi <quote>glob</quote> che abbiamo descritto in precedenza, quindi un tipico file <filename>.hgignore</filename> comincerà con questa direttiva:</para>
+
+    <programlisting>syntax: glob</programlisting>
+
+    <para id="x_6b6">Questa riga dice a Mercurial di interpretare le righe che seguono come pattern di tipo glob, non espressioni regolari.</para>
+
+    <para id="x_6b7">Ecco come appare un tipico file <filename>.hgignore</filename>.</para>
+
+    <programlisting>syntax: glob
+# Questa riga è un commento e verrà saltata.
+# Anche le righe vuote vengono saltate.
+
+# File di backup lasciati dall'editor Emacs.
+*~
+
+# File di bloccaggio usati dall'editor Emacs.
+# Notate che il carattere "#" character è preceduto da un backslash.
+# Questo evita che venga interpretato come l'inizio di un commento.
+.\#*
+
+# File temporanei usati dall'editor vim.
+.*.swp
+
+# Un file nascosto creato dal Finder di Mac OS X.
+.DS_Store
+</programlisting>
+  </sect1>
+
+  <sect1 id="sec:names:case">
+    <title>Sensibilità alle maiuscole</title>
+
+    <para id="x_56a">Se state lavorando in un ambiente di sviluppo misto che contiene sia sistemi Linux (o di tipo Unix) che sistemi Mac e Windows, dovreste tenere nel retro della vostra mente la conoscenza che trattano le lettere maiuscole (<quote>N</quote> rispetto a <quote>n</quote>) nei nomi dei file in modi incompatibili tra loro. Non è probabile che questo abbia effetti su di voi ed è facile occuparsene se succedesse, ma potrebbe sorprendervi se non lo sapete.</para>
+
+    <para id="x_56b">I sistemi operativi e i file system differiscono nel modo in cui gestiscono le <emphasis>maiuscole</emphasis> dei caratteri nei nomi di file e directory. Esisono tre modi comuni di gestire le maiuscole nei nomi.</para>
+    <itemizedlist>
+      <listitem><para id="x_56c">Completa insensibilità alle maiuscole. Le versioni maiuscole e le minuscole di una lettera sono trattate come se fossero identiche, sia quando un file viene creato sia durante i successivi accessi. Questo è comune sui vecchi sistemi basati su DOS.</para>
+      </listitem>
+      <listitem><para id="x_56d">Preservazione delle maiuscole, ma insensibilità. Quando un file o una directory vengono creati, le maiuscole del loro nome vengono memorizzate e possono essere recuperate e visualizzate dal sistema operativo. Quando un file esistente viene cercato, le maiuscole nel suo nome vengono ignorate. Questa è la situazione standard sotto Windows e MacOS. I nomi <filename>foo</filename> e <filename>FoO</filename> identificano lo stsso file. Questo trattamento intercambiabile delle lettere maiuscole e minuscole è anche chiamato <emphasis>ripiegamento delle maiuscole</emphasis>.</para>
+      </listitem>
+      <listitem><para id="x_56e">Sensibilità alle maiuscole. Le lettere maiuscole di un nome sono significative in ogni momento. I nomi <filename>foo</filename> e <filename>FoO</filename> identificano due file differenti. Questo è il modo in cui i sistemi Linux e Unix lavorano normalmente.</para>
+      </listitem></itemizedlist>
+
+    <para id="x_56f">Su sistemi di tipo Unix è possibile avere uno qualsiasi o tutti e tre i modi di gestire le maiuscole in azione allo stesso tempo. Per esempio, se usate una chiavetta USB formattata con un file system FAT32 su un sistema Linux, Linux gestirà i nomi su quel file system in modo da preservare le maiuscole ma senza esservi sensibile.</para>
+
+    <sect2>
+      <title>Memorizzazione del repository sicura e portabile</title>
+
+      <para id="x_570">Il meccanismo di memorizzazione dei repository Mercurial è <emphasis>sicuro per le maiuscole</emphasis>. Traduce i nomi dei file in modo che possano essere memorizzati senza problemi sia su file system sensibili alle maiuscole sia su quelli insensibili alle maiuscole. Questo significa che potete usare i normali strumenti per la copia di file per trasferire un repository Mercurial su, per esempio, una chiavetta USB, e spostare la chiavetta e il repository avanti e indietro tra un Mac, un PC con Windows e una macchina Linux senza problemi.</para>
+
+    </sect2>
+    <sect2>
+      <title>Riconoscere i conflitti tra maiuscole e minuscole</title>
+
+      <para id="x_571">Quando opera sulla directory di lavoro, Mercurial segue la politica di denominazione del file system su cui la directory di lavoro si trova. Se il file system preserva le maiuscole ma è insensibile ad esse, Mercurial tratterà i nomi che differiscono solo per le maiuscole come uguali.</para>
+
+      <para id="x_572">Un importante aspetto di questo approccio è che è possibile eseguire il commit di un changeset su un file system sensibile alle maiuscole (tipicamente Linux o Unix) che creerà problemi per gli utenti di file system insensibili alle maiuscole (di solito Windows e MacOS). Se un utente Linux inserisce nel repository le modifiche a due file, uno chiamato <filename>myfile.c</filename> e l'altro chiamato <filename>MyFile.c</filename>, questi verranno memorizzati correttamente. E nella directory di lavoro di altri utenti Linux quei file verranno correttamente rappresentati come due file separati.</para>
+
+      <para id="x_573">Se un utente Windows o Mac estrae questo cambiamento, inizialmente non avranno alcun problema, perché il meccanismo di memorizzazione di un repository Mercurial è sicuro per le maiuscole. Tuttavia, appena provano ad aggiornare la directory di lavoro a quel changeset tramite <command role="hg-cmd">hg update</command>, o a unire il proprio lavoro con quel changeset tramite <command role="hg-cmd">hg merge</command>, Mercurial individuerà il conflitto tra i due nomi di file che il file system tratterebbe come lo stesso nome e impedirà all'aggiornamento o all'unione di avvenire.</para>
+    </sect2>
+
+    <sect2>
+      <title>Correggere un conflitto tra maiuscole e minuscole</title>
+
+      <para id="x_574">Se state usando Windows o Mac in un ambiente misto dove alcuni dei vostri collaboratori usano Linux o Unix, e Mercurial riporta un conflitto di ripiegamento delle maiuscole quando provate a eseguire <command role="hg-cmd">hg update</command> o <command role="hg-cmd">hg merge</command>, la procedura per correggere il problema è semplice.</para>
+
+      <para id="x_575">Trovate la macchina Linux o Unix più vicina, clonate il repository problematico su di essa e usate il comando <command role="hg-cmd">hg rename</command> di Mercurial per cambiare i nomi di qualsiasi file o directory che trasgredisce in modo che non siano più causa di conflitti di ripiegamento delle maiuscole. Inserite queste modifiche nel repository, eseguite <command role="hg-cmd">hg pull</command> o <command role="hg-cmd">hg push</command> attraverso i vostri sistemi Windows o MacOS e usate <command role="hg-cmd">hg update</command> per aggiornare la directory di lavoro alla revisione con i nomi senza conflitti.</para>
+
+      <para id="x_576">Il changeset con i nomi in conflitto rimarrà nella cronologia del vostro progetto e non sarete comunque in grado di usare <command role="hg-cmd">hg update</command> per aggiornare la directory di lavoro a quel changeset su un sistema Windows o MacOS, ma potrete continuare a sviluppare senza impedimenti.</para>
+    </sect2>
+  </sect1>
+</chapter>