[svnbook commit] r2827 - trunk/src/it/book
Miky
noreply at red-bean.com
Mon Aug 6 10:58:56 CDT 2007
Author: Miky
Date: Mon Aug 6 10:58:55 2007
New Revision: 2827
Log:
new contribution from Miky
Modified:
trunk/src/it/book/ch07.xml
Modified: trunk/src/it/book/ch07.xml
==============================================================================
--- trunk/src/it/book/ch07.xml (original)
+++ trunk/src/it/book/ch07.xml Mon Aug 6 10:58:55 2007
@@ -1,9 +1,9 @@
<chapter id="svn.advanced">
- <title>Advanced Topics</title>
+ <title>Temi avanzati</title>
<simplesect>
- <para>If you've been reading this book chapter by chapter, from
+ <para lang="en">If you've been reading this book chapter by chapter, from
start to finish, you should by now have acquired enough
knowledge to use the Subversion client to perform the most
common version control operations. You understand how to
@@ -15,10 +15,23 @@
unconsciously. For all intents and purposes, you are ready to
use Subversion in a typical environment.</para>
- <para>But the Subversion feature set doesn't stop at <quote>common
- version control operations</quote>.</para>
+ <para>Se si è letto questo libro capitolo per capitolo, dall'inizio
+ alla fine, si dovrebbe aver acquisito la necessaria competenza
+ per usare il client Subversion per effettuare le più comuni operazioni
+ del controllo di versione. Si è visto come fare il checkout della
+ propria cartella di lavoro dal repository di Subversion.Si è ormai
+ a proprio agio nel registrare e ricevere modifiche utilizzando i comandi
+ <command>svn commit</command> e <command>svn update</command>.
+ Si è probabilmente anche sviluppato un riflesso incondizionato
+ che permette di utilizzare il comando <command>svn status</command>
+ quasi incosciamente. Per tutti questi motivi , si è pronti ad usare
+ Subversion in un normale ambiente di lavoro.</para>
+ <para lang="en">But the Subversion feature set doesn't stop at <quote>common
+ version control operations</quote>.</para>
+ <para >Ma l'insieme delle funzioni di Subversion non si ferma alle <quote>
+ comuni operazioni del controllo di versione</quote>.</para>
- <para>This chapter highlights some of Subversion's features that
+ <para lang="en">This chapter highlights some of Subversion's features that
aren't quite so regularly used. In it, we will discuss
Subversion's property (or <quote>metadata</quote>) support, and
how to modify Subversion's default behaviors by tweaking its
@@ -28,7 +41,19 @@
additional client- and server-side tools that are part of the
Subversion distribution.</para>
- <para>Before reading this chapter, you should be familiar with the
+
+ <para>Questo capitolo mette in evidenza alcune funzionalità di Subversion
+ che non sono usate regolarmente. In esso , sarà discusso come
+ supportare la proprietà di Subversion (o <quote>metadata</quote>) ,
+ e come modificare i comportamenti di default di Subversion operando
+ piccole variazioni nell'area di configurazione durante l'esecuzione.
+ Verrà descritto come si possono usare le definizioni esterne per
+ far si che Subversion possa prendere dati da repository
+ diversi. Verrano descritti nei dettagli alcuni tool addizionali
+ lato client e lato server che fanno parte della distribuzione di
+ Subversion .</para>
+
+ <para lang="en">Before reading this chapter, you should be familiar with the
basic file and directory versioning capabilities of Subversion.
If you haven't already read about those, or if you need a
refresher, we recommend that you check out <xref
@@ -37,12 +62,20 @@
a Subversion power-user!
</para>
+ <para>Prima di leggere questo capitolo, si deve avere familiarità
+ con le funzionalità di base di Subversion nel revisionare file e directory.
+ Se non si è ancora letto niente di esse, o se serve un
+ richiamo,si raccomanda il check out di <xref
+ linkend="svn.basic" /> e <xref linkend="svn.tour" />. Una
+ volta che si è acquisita padronanza con le funzionalità di base e che si è terminato
+ questo capitolo, si diventerà un'autorità nell'utilizzo di Subversion!
+ </para>
</simplesect>
<sect1 id="svn.advanced.confarea">
- <title>Runtime Configuration Area</title>
-
- <para>Subversion provides many optional behaviors that can be
+ <title>Area di configurazione di esecuzione</title>
+
+ <para lang="en">Subversion provides many optional behaviors that can be
controlled by the user. Many of these options are of the kind
that a user would wish to apply to all Subversion operations.
So, rather than forcing users to remember command-line arguments
@@ -50,7 +83,15 @@
operation they perform, Subversion uses configuration files,
segregated into a Subversion configuration area.</para>
- <para>The Subversion <firstterm>configuration area</firstterm> is
+ <para>Subversion fornisce molti comportamenti aggiuntivi che possono
+ essere controllati dall'utente. Molte di queste opzioni sono del tipo
+ che l'utente vorrebbe applicare a tutte le operazioni di Subversion.
+ Così, piuttosto che costringere gli utenti a ricordare gli argomenti da passare da linea di comando
+ per specificare queste opzioni, e di usarli ogni volta che si effettua un'operazione,
+ Subversion utilizza file di configurazione,
+ segregati nell'aria di configuarzione di Subversion .</para>
+
+ <para lang="en">The Subversion <firstterm>configuration area</firstterm> is
a two-tiered hierarchy of option names and their values.
Usually, this boils down to a special directory that contains
<firstterm>configuration files</firstterm> (the first tier),
@@ -61,11 +102,21 @@
determine which of several optional behaviors the user
prefers.</para>
+ <para> <firstterm>L'area di configurazione</firstterm>di Subversion
+ è una struttura gerarchica a due livelli con le opzioni nome-valore.
+ Di solito, questo si condensa in una speciale directory che
+ contiene<firstterm>file di configurazione</firstterm> (il primo livello),
+ che sono semplicemente dei file di testo nel formato INI (con
+ <quote>sezioni</quote> che si occupano del secondo livello). Questi file
+ possono facilmente essere modificati utilizzando il proprio editor di testo preferito
+ (come ad esempio Emacs o vi), e contengono istruzioni lette dal client
+ per stabilire quale dei diversi comportamenti opzionali l'utente preferisce.</para>
+
<!-- =============================================================== -->
<sect2 id="svn.advanced.confarea.layout">
- <title>Configuration Area Layout</title>
+ <title> Layout della sezione di configurazione</title>
- <para>The first time that the <command>svn</command>
+ <para lang="en">The first time that the <command>svn</command>
command-line client is executed, it creates a per-user
configuration area. On Unix-like systems, this area appears
as a directory named <filename>.subversion</filename> in the
@@ -77,7 +128,7 @@
differs from system to system, and is dictated by the Windows
registry.
<footnote>
- <para>The <literal>APPDATA</literal> environment variable
+ <para lang="en">The <literal>APPDATA</literal> environment variable
points to the <filename>Application Data</filename> area,
so you can always refer to this folder as
<filename>%APPDATA%\Subversion</filename>.</para>
@@ -85,7 +136,28 @@
We will refer to the per-user configuration area using its Unix
name, <filename>.subversion</filename>.</para>
- <para>In addition to the per-user configuration area, Subversion
+ <para>La prima volta che viene eseguito il comando <command>svn</command>
+ da linea di comando, esso crea una sezione di configurazione per ogni singolo utente.
+ Su un sistema tipo Unix , quest' area appare come
+ una directory chiamata <filename>.subversion</filename> nella directory
+ principale dell'utente. Su sistemi Win 32, Subversion crea una cartella
+ chiamata <filename>Subversion</filename>, tipicamente all'interno
+ dell'area <filename>Application Data</filename> della directory del profilo utente
+ (che, tra l'altro, è di solito nascosta). Comunque, su questo tipo di piattaforme
+ l'esatta collocazione differisce da sistema a sistema,
+ ed è dettata dal registro di Windows.
+ <footnote>
+ <para>La variabile d'ambiente <literal>APPDATA</literal>
+ punta all'area <filename>Application Data</filename> ,
+ perciò si può sempre far riferimento a questa cartella con
+ <filename>%APPDATA%\Subversion</filename>.</para>
+ </footnote>
+ Si farà riferimento alla sezione di configurazione del singolo utente con
+ il suo nome Unix, <filename>.subversion</filename>.</para>
+
+
+
+ <para lang="en">In addition to the per-user configuration area, Subversion
also recognizes the existence of a system-wide configuration
area. This gives system administrators the ability to
establish defaults for all users on a given machine. Note
@@ -103,9 +175,27 @@
case, the <command>svn</command> program does not attempt
to create the system-wide configuration area.</para>
- <para>The configuration area currently contains three
+ <para>In aggiunta alla sezione di configurazione del singolo utente, Subversion
+ riconosce anche l'esistenza di una sezione di configurazione a livello dell'intero sistema.
+ Questo permette agli amministratori di sistema di stabilire
+ comportamenti di default per tutti glu utenti su una data macchina.
+ Si noti che questa sezione di configurazione a livello dell'intero sistema non è solo dettata
+ da una politica obbligatoria—le impostazioni nella sezione
+ di configurazione del singolo utente sovrascrivono quelle nella sezione di sistema,
+ e gli argomenti passati da linea di comando forniti con il comando <command>svn</command>
+ hanno l'ultima parola sul comportamento scelto. Sulle
+ piattaforme tipo Unix, la sezione configurazione di sistema
+ si trova di solito nalla directory <filename>/etc/subversion</filename> ;
+ sulle macchine Windows, essa ppare come una directory
+ <filename>Subversion</filename> all'interno dell'area comune
+ <filename>Application Data</filename> (di nuovo, come specificato
+ dal registro di Windows ). Diversamente dal caso dell'area utente ,
+ con il comando <command>svn</command> il programma non crea
+ l'area di configurazione di sistema.</para>
+
+ <para lang="en">The configuration area currently contains three
files—two configuration files (<filename>config</filename> and
- <filename>servers</filename>), and a <filename>README.txt</filename>
+ <filename>servers</filename>), and a <filename>README.txt</filename>
file which describes the INI format. At the time of their
creation, the files contain default values for each of the
supported Subversion options, mostly commented out and grouped
@@ -120,7 +210,26 @@
configuration directory with the default contents will be
created.</para>
- <para>The per-user configuration area also contains a cache of
+
+ <para>L'area di configurazione contiene correntemente tre
+ file—due file di configurazione(<filename>config</filename> e
+ <filename>servers</filename>), e un file il formato INI
+ <filename>README.txt</filename>.
+ Al momento della loro creazione, i file contengono
+ valori di default per ognuna delle opzioni supportate da
+ Subversion , la maggior parte commentate e raggruppate
+ con descrizioni su come i loro valori influenzano il comportamento di
+ Subversion. Per modificare un determinato comportamento,
+ serve soltanto caricare l'opportuno file di configurazione
+ all'interno dell'editor di testo, e modificare il valore dell'opzione desiderata.
+ Se in qualsiasi momento si desidera tornare alle impostazioni
+ della configurazione di default ,
+ si può semplicemente rimuovere (o rinominare) la propria directory di configurazione
+ e quindi eseguire alcuni innocui comandi <command>svn</command> ,
+ come <command>svn --version</command>. Verrà creata una nuova directory di configurazione
+ con i contenuti di default.</para>
+
+ <para lang="en">The per-user configuration area also contains a cache of
authentication data. The <filename>auth</filename> directory
holds a set of subdirectories that contain pieces of cached
information used by Subversion's various supported
@@ -128,13 +237,20 @@
way that only the user herself has permission to read its
contents.</para>
+ <para>La sezione di configurazione del singolo utente contiene anche una cache di
+ dati di autenticazione. La directory <filename>auth</filename>
+ è formata da un insieme di sottodirectory che contiene pezzi di informazioni nascoste
+ usate da vari metodi di autenticazione supportati da Subversion.
+ Questa directory è creata in modo tale che soltanto
+ l'utente ha i privilegi per leggere il suo contenuto.</para>
+
</sect2>
<!-- =============================================================== -->
<sect2 id="svn.advanced.confarea.windows-registry">
- <title>Configuration and the Windows Registry</title>
+ <title>Configurazione e il registro di Windows</title>
- <para>In addition to the usual INI-based configuration area,
+ <para lang="en">In addition to the usual INI-based configuration area,
Subversion clients running on Windows platforms may also use
the Windows registry to hold the configuration data. The
option names and their values are the same as in the INI
@@ -143,7 +259,16 @@
fashion—in this schema, files and sections are just
levels in the registry key tree.</para>
- <para>Subversion looks for system-wide configuration values
+ <para>In aggiunta alla solita area di configurazione basata su INI,
+ i client Subversion che lavorano su piattaforme Windows possono anche
+ usare il registro di Windows per custodire i dati di configurazione.
+ Le opzioni di nomi e i loro valori sono gli stessi che ci sono nei file INI.
+ La gerarchia <quote>file/section</quote> è comunque preservata,
+ nonostante sia indirizzata in un modo &mdash leggermente diverso;
+ in questo schema , file e sezioni sono solo livelli nell'albero
+ delle chiavi di registro.</para>
+
+ <para lang="en">Subversion looks for system-wide configuration values
under the
<literal>HKEY_LOCAL_MACHINE\Software\Tigris.org\Subversion</literal>
key. For example, the <literal>global-ignores</literal> option,
@@ -154,31 +279,56 @@
<literal>HKEY_CURRENT_USER\Software\Tigris.org\Subversion</literal>.
</para>
- <para>Registry-based configuration options are parsed
+ <para>Subversion cerca i valori per la configurazione di sistema
+ sotto la chiave
+ <literal>HKEY_LOCAL_MACHINE\Software\Tigris.org\Subversion</literal>.
+ Ad esempio, l'opzione <literal>global-ignores</literal> ,
+ che si trova nella sezione <literal>miscellany</literal> nel file
+ <filename>config</filename> , verrebbe trovata in
+ <literal>HKEY_LOCAL_MACHINE\Software\Tigris.org\Subversion\Config\Miscellany\global-ignores</literal>.
+ I valori di configurazione dell'utente dovrebbero essere memorizzati sotto
+ <literal>HKEY_CURRENT_USER\Software\Tigris.org\Subversion</literal>.
+ </para>
+
+
+ <para lang="en">Registry-based configuration options are parsed
<emphasis>before</emphasis> their file-based counterparts,
so are overridden by values found in the configuration
files. In other words, configuration priority is granted in
the following order on a Windows system:</para>
-
+
+ <para>Le opzioni di configurazione basate sul registro sono analizzate
+ <emphasis>prima</emphasis> delle loro omologhe basate sui file,
+ cosicchè vengono sovrascritte dai valori trovati nei file di configurazione.
+ In altre parole, la priorità di configurazione su un sistema Windows è
+ stabilita dal seguente ordine:</para>
+
<orderedlist>
<listitem>
- <para>Command-line options</para>
+ <para lang="en">Command-line options</para>
+ <para>Opzioni da linea di comando</para>
</listitem>
<listitem>
- <para>The per-user INI files</para>
+ <para lang="en">The per-user INI files</para>
+ <para>File Ini dell'utente</para>
</listitem>
<listitem>
- <para>The per-user Registry values</para>
+ <para lang="en">The per-user Registry values</para>
+ <para>Valori del registro dell'utente</para>
</listitem>
<listitem>
- <para>The system-wide INI files</para>
+ <para lang="en">The system-wide INI files</para>
+ <para>File INI di sistema</para>
</listitem>
<listitem>
- <para>The system-wide Registry values</para>
+ <para lang="en">The system-wide Registry values</para>
+ <para> Valori del registro di sistema</para>
</listitem>
</orderedlist>
- <para>Also, the Windows Registry doesn't really support the
+
+
+ <para lang="en">Also, the Windows Registry doesn't really support the
notion of something being <quote>commented out</quote>.
However, Subversion will ignore any option key whose name
begins with a hash (<literal>#</literal>) character. This
@@ -186,7 +336,16 @@
without deleting the entire key from the Registry, obviously
simplifying the process of restoring that option.</para>
- <para>The <command>svn</command> command-line client never
+ <para>Inoltre, il registro di Windows non supporta realmente la nozione
+ di qualcosa di esistente <quote> commentata </quote>.
+ Comunque, Subversion ignorerà ogni opzione il cui nome
+ comincia con il carattere (<literal>#</literal>) . Questo permette
+ di commentare un'opzione di Subversion
+ senza cancellare l'intera chiave dal registro,
+ semplificando, ovviamente, il processo di recupero di quella opzione.</para>
+
+
+ <para lang="en">The <command>svn</command> command-line client never
attempts to write to the Windows Registry, and will not
attempt to create a default configuration area there. You can
create the keys you need using the <command>REGEDIT</command>
@@ -195,8 +354,16 @@
file from the Explorer shell, which will cause the data to be
merged into your registry.</para>
+ <para>Il comando <command>svn</command> eseguito da linea di comando del client
+ non tenta mai di scrivere al registro di Windows, e non proverà a creare
+ una sezione di configurazione di default nel registro.Si possono
+ creare le chiavi di cui si ha bisogno usando il comando <command>REGEDIT</command>.
+ In alternativa,si può creare un file
+ <filename>.reg</filename> , e quindi con un doppio click su di esso
+ dalla finestra di Explorer , i dati saranno incorporati nel registro.</para>
+
<example id="svn.advanced.confarea.windows-registry.ex-1">
- <title>Sample Registration Entries (.reg) File.</title>
+ <title>Esempio di file di registrazione(.reg) .</title>
<programlisting>
REGEDIT4
@@ -239,7 +406,7 @@
</programlisting>
</example>
- <para>The previous example shows the contents of a
+ <para lang="en">The previous example shows the contents of a
<filename>.reg</filename> file which contains some of the most
commonly used configuration options and their default values.
Note the presence of both system-wide (for network
@@ -250,20 +417,38 @@
beginning of the option names, and set the values as you
desire.</para>
+
+ <para>Il precedente esempio mostra il contenuto di un file
+ <filename>.reg</filename> che contiene alcune delle opzioni di configurazione
+ più comunemente usate e i loro valori di default.
+ Si noti la presenza contemporanea sia delle impostazioni di sistema
+ (per le opzioni relative al proxy di rete) sia delle impostazioni dell'utente
+ (programmi di editor e memorizzazione delle password , tra le altre).
+ Si noti, inoltre, che tutte le opzioni sono effettivamente
+ commentate. Bisognerà soltanto rimuovere il carattere
+ (<literal>#</literal>) dall'inizio dei nomi delle opzioni,
+ e settare i valori come si desidera.</para>
+
+
+
+
</sect2>
<!-- =============================================================== -->
<sect2 id="svn.advanced.confarea.opts">
- <title>Configuration Options</title>
-
- <para>In this section, we will discuss the specific
+ <title>Opzioni di configurazione</title>
+
+ <para lang="en">In this section, we will discuss the specific
run-time configuration options that are currently supported
by Subversion.</para>
+ <para>In questa sezione saranno discusse le opzioni specifiche per la
+ configurazione a run-time, che sono correntemente supportate da Subversion.</para>
+
<sect3 id="svn.advanced.confarea.opts.servers">
- <title>Servers</title>
+ <title>Server</title>
- <para>The <filename>servers</filename> file contains
+ <para lang="en">The <filename>servers</filename> file contains
Subversion configuration options related to the network
layers. There are two special section names in this
file—<literal>groups</literal> and
@@ -275,6 +460,20 @@
characters—that are compared against the hostnames of
the machine to which Subversion requests are sent.</para>
+ <para>Il file <filename>server</filename> contiene opzioni di configurazione di
+ Subversion relative ai livelli di rete.
+ Ci sono due sezioni speciali in questo file—
+ <literal>gruppi</literal> e
+ <literal>globale</literal>. La sezione <literal>gruppi</literal>
+ è essenzialmente una tabella a riferimento incrociato.Le chiavi,
+ in questa sezione,sono i nomi delle altre sezioni del file;
+ i loro valori sono <firstterm>globs</firstterm>—textual
+ token testuali che possono contenere caratteri jolly—
+ che vengono confrontati con l'hostname della macchina
+ a cui Subversion invia le richieste.</para>
+
+
+
<programlisting>
[groups]
beanie-babies = *.red-bean.com
@@ -287,7 +486,7 @@
…
</programlisting>
- <para>When Subversion is used over a network, it attempts to
+ <para lang="en">When Subversion is used over a network, it attempts to
match the name of the server it is trying to reach with a
group name under the <literal>groups</literal> section. If
a match is made, Subversion then looks for a section in the
@@ -295,7 +494,14 @@
group's name. From that section it reads the actual network
configuration settings.</para>
- <para>The <literal>global</literal> section contains the
+ <para>Quando Subversion è usata su una rete, prova a far corrispondere il nome
+ del server che cerca di raggiungere con un gruppo di nomi
+ che si trovano nella sezione <literal>gruppi</literal> .
+ Se trova riscontro, Subversion cerca una sezione nel file
+ <filename>server</filename> il cui nome corrisponde al nome del gruppo.
+ Da quella sezione legge le attuali impostazioni di configurazione della rete. </para>
+
+ <para lang="en">The <literal>global</literal> section contains the
settings that are meant for all of the servers not matched
by one of the globs under the <literal>groups</literal>
section. The options available in this section are
@@ -304,43 +510,75 @@
<literal>groups</literal> section), and are as
follows:</para>
+ <para>La sezione <literal>globale</literal> contiene le
+ impostazioni che hanno significato per tutti i server che non trovano riscontro
+ con uno di quelli presenti nella sezione <literal>gruppi</literal>.
+ Le opzioni disponibili in questa sezione, sono esattamente
+ le stesse valide per le altre sezioni server
+ nel file (eccetto, naturalmente, la sezione speciale
+ <literal>gruppi</literal> ), e sono le seguenti:
+ </para>
+
<variablelist>
<varlistentry>
<term><literal>http-proxy-host</literal></term>
<listitem>
- <para>This specifies the hostname of the proxy computer
+ <para lang="en">This specifies the hostname of the proxy computer
through which your HTTP-based Subversion requests must
pass. It defaults to an empty value, which means that
Subversion will not attempt to route HTTP requests
through a proxy computer, and will instead attempt to
contact the destination machine directly.</para>
+
+ <para>Questa specifica l'host del computer proxy
+ attraverso il quale devono passare le richieste basate su HTTP di Subversion.
+ E' settato di default ad un alore nullo, che sta a significare che
+ Subversion non invierà le richieste HTTP attarverso un computer
+ proxy , e che proverà a contattare la macchina di destinazione direttamente.
+ </para>
+
+
</listitem>
</varlistentry>
<varlistentry>
<term><literal>http-proxy-port</literal></term>
<listitem>
- <para>This specifies the port number on the proxy host
+ <para lang="en">This specifies the port number on the proxy host
to use. It defaults to an empty value.</para>
+
+ <para>Specifica il numero di porta del proxy da utilizzare.
+ Di default è settato ad un valore nullo.</para>
+
+
</listitem>
</varlistentry>
<varlistentry>
<term><literal>http-proxy-username</literal></term>
<listitem>
- <para>This specifies the username to supply to the proxy
- machine. It defaults to an empty value.</para>
+ <para lang="en">This specifies the username to supply to the proxy
+ machine. It defaults to an empty value.</para>
+
+ <para>Specifica il nome utente da fornire al computer proxy.
+ Di default è un valore nullo.</para>
+
+
</listitem>
</varlistentry>
<varlistentry>
<term><literal>http-proxy-password</literal></term>
<listitem>
- <para>This specifies the password to supply to the proxy
+ <para lang="en">This specifies the password to supply to the proxy
machine. It defaults to an empty value.</para>
+
+ <para>Specifica la password da fornire al computer proxy.
+ Di default è un valore nullo.</para>
+
</listitem>
</varlistentry>
<varlistentry>
<term><literal>http-timeout</literal></term>
<listitem>
- <para>This specifies the amount of time, in seconds, to
+ <para lang="en">This specifies the amount of time, in seconds, to
wait for a server response. If you experience
problems with a slow network connection causing
Subversion operations to timeout, you should increase
@@ -348,18 +586,37 @@
<literal>0</literal>, which instructs the underlying
HTTP library, Neon, to use its default timeout
setting.</para>
+
+ <para>Specifica la quantità di tempo, in secondi,
+ in cui aspettare la risposta dal server. Se si ha esperienza di problemi
+ di connessione con una rete lente che possono causare
+ la scadenza della operazioni di Subversion operations to timeout,
+ andrebbe aumentato il valore di questa opzione. Il valore di default è
+ <literal>0</literal>, che istruisce la libreria
+ HTTP , Neon, ad usare il suo tempo di scadenza di default .
+ </para>
+
+
</listitem>
</varlistentry>
<varlistentry>
<term><literal>http-compression</literal></term>
<listitem>
- <para>This specifies whether or not Subversion should
+ <para lang="en">This specifies whether or not Subversion should
attempt to compress network requests made to DAV-ready
servers. The default value is <literal>yes</literal>
(though compression will only occur if that capability
is compiled into the network layer). Set this to
<literal>no</literal> to disable compression, such as
when debugging network transmissions.</para>
+
+ <para>Specifica se Subversion debba o meno provare a comprimere
+ le richeste di rete fatte al server DAV.
+ Il valore di default è <literal>si</literal>
+ (la compressione occorre soltanto se la capacità
+ è compilata in un livello di rete). Impostare il valore a
+ <literal>no</literal> per disabilitare la compressione, così come
+ avviene nelle trasmissioni di rete di debug.</para>
</listitem>
</varlistentry>
<varlistentry>
@@ -371,30 +628,49 @@
<literal>0</literal>, which will silence all debugging
output. For more information about how Subversion
makes use of Neon, see <xref linkend="svn.developer" />.</para>
+
+ <para>E' una maschera usata dalla libreria HTTP,
+ Neon, per scegliere che tipo di messaggio di debug fornire.
+ Il valore di default è
+ <literal>0</literal>, che annulla tutti i messaggi di debug.
+ Per avere maggiori informazioni su come Subversion
+ utilizza Neon, si veda <xref linkend="svn.developer" />.</para>
+
</listitem>
</varlistentry>
<varlistentry>
<term><literal>ssl-authority-files</literal></term>
<listitem>
- <para>This is a semicolon-delimited list of paths to files
+ <para lang="en">This is a semicolon-delimited list of paths to files
containing certificates of the certificate authorities
(or CAs) that
are accepted by the Subversion client when accessing the
repository over HTTPS.</para>
+ <para>E' un elenco, delimitato da punto e virgola, di percorsi
+ di file che contengono certificati delle autorità di certificazione
+ (o CAs) che sono accettati dal client
+ Subversion quando si accede al repository attraverso
+ HTTPS.</para>
+
</listitem>
</varlistentry>
<varlistentry>
<term><literal>ssl-trust-default-ca</literal></term>
<listitem>
- <para>Set this variable to <literal>yes</literal> if you
+ <para lang="en">Set this variable to <literal>yes</literal> if you
want Subversion to automatically trust the set of
default CAs that ship with OpenSSL.</para>
+
+ <para>Si imposti questa variabile a <literal>si</literal> se
+ si vuole che Subversion verifichi automaticamente l'insieme di default
+ CAs che viaggia con OpenSSL.</para>
+
</listitem>
</varlistentry>
<varlistentry>
<term><literal>ssl-client-cert-file</literal></term>
<listitem>
- <para>If a host (or set of hosts) requires an SSL client
+ <para lang="en">If a host (or set of hosts) requires an SSL client
certificate, you'll normally be prompted for a path to
your certificate. By setting this variable to that
same path, Subversion will be able to find your client
@@ -402,18 +678,36 @@
There's no standard place to store your certificate on
disk; Subversion will grab it from any path you
specify.</para>
+
+ <para>Se un host (o un insieme di host) richiede un certificato SSL
+ al client, normalmente si cerca un percorso rapido
+ per trovare il certificato. Impostando questa variabile con lo stesso percorso,
+ Subversion sarà in grado di trovare il certificato del client
+ in modo automatico.
+ Sul disco non ci sono luoghi standard in cui conservare il certificato;
+ Subversion lo prenderà da qualsiasi percorso venga specificato.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>ssl-client-cert-password</literal></term>
<listitem>
- <para>If your SSL client certificate file is encrypted
+ <para lang="en">If your SSL client certificate file is encrypted
by a passphrase, Subversion will prompt you for the
passphrase whenever the certificate is used. If you
find this annoying (and don't mind storing the
password in the <filename>servers</filename> file),
then you can set this variable to the certificate's
passphrase. You won't be prompted anymore.</para>
+
+ <para>Se il file certificato SSL è criptato,
+ Subversion richiederà la chiave di decifrazione ogni
+ volta che il certificato viene usato.Se si trova la cosa noiosa
+ (e ci si dimentica di memorizzare la password
+ nel file <filename>servers</filename> file),
+ si può impostare questa variabile con il valore della
+ chiave di decifrazione del certificato.
+ Non si verrà più interrogati.</para>
+
</listitem>
</varlistentry>
</variablelist>
@@ -422,21 +716,31 @@
<sect3 id="svn.advanced.confarea.opts.config">
<title>Config</title>
- <para>The <filename>config</filename> file contains the rest
+ <para lang="en">The <filename>config</filename> file contains the rest
of the currently available Subversion run-time options,
those not related to networking. There are only a few
options in use at this time, but they are again grouped into
sections in expectation of future additions.</para>
- <para>The <literal>auth</literal> section contains settings
+ <para>Il file <filename>config</filename> contiene le
+ restanti opzioni normalmente disponibili in Subversion,
+ quelle che non sono in relazione con la rete. Ci sono solo poche opzioni
+ in uso in questo momento, ma sono di nuovo raggruppate in sezioni
+ in attesa di future aggiunte.</para>
+
+ <para lang="en">The <literal>auth</literal> section contains settings
related to Subversion's authentication and authorization
against the repository. It contains:</para>
+ <para>La sezione <literal>auth</literal> contiene impostazioni
+ relative all'autenticazione e autorizzazione di Subversion
+ nei confronti del repository. Essa contiene:</para>
+
<variablelist>
<varlistentry>
<term><literal>store-passwords</literal></term>
<listitem>
- <para>This instructs Subversion to cache, or not to
+ <para lang="en">This instructs Subversion to cache, or not to
cache, passwords that are supplied by the user in
response to server authentication challenges. The
default value is <literal>yes</literal>. Set this to
@@ -447,30 +751,57 @@
parameter (for those subcommands that support it).
For more information, see <xref
linkend="svn.serverconfig.netmodel.credcache"/>.</para>
+
+
+ <para>Questa indica a Subversion se memorizzare o no,
+ password fornite dall'utente in
+ risposta alle richieste di autenticazione da paret del server .
+ Il valore di default è <literal>si</literal>. Si imposti a
+ <literal>no</literal> per disabilitare la memorizzazione
+ della password sul disco.
+ Si può sovrascrivere questa opzione per una singola
+ instanza del comando <command>svn</command> usando
+ il parametro da riga di comando <option>--no-auth-cache</option>
+ (per quelle versioni che lo supportano).
+ Per maggiori informazioni, si veda <xref
+ linkend="svn.serverconfig.netmodel.credcache"/>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>store-auth-creds</literal></term>
<listitem>
- <para>This setting is the same as
+ <para lang="en">This setting is the same as
<literal>store-passwords</literal>, except that it
enables or disables disk-caching of
<emphasis>all</emphasis> authentication information:
usernames, passwords, server certificates, and any
other types of cacheable credentials.</para>
+
+ <para>Questa imposatzione è la stessa della
+ <literal>memorizzazione-password</literal>, eccetto che per il fatto
+ che abilita o disabilita la memorizzazione su disco di
+ <emphasis>tutte</emphasis> le informazioni di autenticazione:
+ nome utente, password, certificati del server , e ogni
+ altro tipo di cerdenziali memorizzabili.</para>
+
+
</listitem>
</varlistentry>
</variablelist>
- <para>The <literal>helpers</literal> section controls which
+ <para lang="en">The <literal>helpers</literal> section controls which
external applications Subversion uses to accomplish its
tasks. Valid options in this section are:</para>
+ <para>La sezione <literal>aiuti</literal> section controlla le applicazioni
+ esterne che Subversion usa per assolvere ai suoi compiti.
+ Opzioni valide in questa sezione sono:</para>
+
<variablelist>
<varlistentry>
<term><literal>editor-cmd</literal></term>
<listitem>
- <para>This specifies the program Subversion will use to
+ <para lang="en">This specifies the program Subversion will use to
query the user for a log message during a commit
operation, such as when using <command>svn
commit</command> without either the
@@ -484,39 +815,75 @@
linkend="svn.advanced.props" />). This option's default
value is empty. The order of priority for determining the
editor command is:</para>
+
+ <para>Specifica il programma che Subversion userà per
+ chiedere all'utente un messaggio di log durante il commit,
+ così come si usa il comando <command>svn
+ commit</command>senza usare nè l'opzione
+ <option>--message</option> (<option>-m</option>) nè l'opzione
+ <option>--file</option> (<option>-F</option>) .
+ Questo programma è usato anche con il comando <command>svn
+ propedit</command> un file temporaneo viene popolato
+ con il valore corrente della proprietà che l'utente vuole modificare,
+ e la modifica avviene nel programma di editor.
+ (si veda <xref
+ linkend="svn.advanced.props" />).Il valore di default
+ di questa opzione è nullo. L'ordine di priorità per determinare il comando di editor è:</para>
+
<orderedlist>
<listitem>
- <para>Command-line option <literal>--editor-cmd</literal></para>
+ <para lang="en">Command-line option <literal>--editor-cmd</literal></para>
+ <para>Opzione da riga di comando <literal>--editor-cmd</literal></para>
</listitem>
<listitem>
- <para>Environment variable <literal>SVN_EDITOR</literal></para>
+ <para lang="en">Environment variable <literal>SVN_EDITOR</literal></para>
+ <para> Variabile d'ambiente<literal>SVN_EDITOR</literal></para>
</listitem>
<listitem>
- <para>Configuration option <literal>editor-cmd</literal></para>
+ <para lang="en">Configuration option <literal>editor-cmd</literal></para>
+ <para>Opzioni di configurazione <literal>editor-cmd</literal></para>
</listitem>
<listitem>
- <para>Environment variable <literal>VISUAL</literal></para>
+ <para lang="en">Environment variable <literal>VISUAL</literal></para>
+ <para>Variabile d'ambiente <literal>VISUAL</literal></para>
</listitem>
<listitem>
- <para>Environment variable <literal>EDITOR</literal></para>
+ <para lang="en">Environment variable <literal>EDITOR</literal></para>
+ <para>Variabile d'ambiente <literal>EDITOR</literal></para>
</listitem>
<listitem>
- <para>Possibly, a default value built in to Subversion
+ <para lang="en">Possibly, a default value built in to Subversion
(not present in the official builds)</para>
+ <para>Possibilmente,un valore di default costruito in Subversion
+ (non presente nelle versioni ufficiali)</para>
</listitem>
</orderedlist>
- <para>The value of any of these options or variables is
+
+
+
+
+
+ <para lang="en">The value of any of these options or variables is
(unlike <literal>diff-cmd</literal>) the beginning of a
command line to be executed by the shell. Subversion
appends a space and the pathname of the temporary file to be
edited. The editor should modify the temporary file and
return a zero exit code to indicate success.</para>
+
+ <para>Il valore di ognuna di queste opzioni e variabili è
+ (diversamente da <literal>diff-cmd</literal>) l'inizio di una
+ linea di comando da eseguire da shell. Subversion
+ aggiunge uno spazio e il percorso del file temporaneo da
+ modificare. L'editor di testo può modificare il file temporaneo
+ e restituire un codice di uscita pari a 0 per indicare il successo
+ dell'operazione.</para>
+
</listitem>
</varlistentry>
<varlistentry>
<term><literal>diff-cmd</literal></term>
<listitem>
- <para>This specifies the absolute path of a differencing
+ <para lang="en">This specifies the absolute path of a differencing
program, used when Subversion generates
<quote>diff</quote> output (such as when using the
<command>svn diff</command> command). By default
@@ -525,12 +892,24 @@
perform this task using an external program. See
<xref linkend="svn.advanced.externaldifftools"/> for
more details on using such programs.</para>
+
+ <para>Specifica il percorso assoluto di un programma differente
+ usato quando Subversion genera
+ <quote>diff</quote> un risultato (così come avviene usando il comando
+ <command>svn diff</command> ).Di default
+ Subversion usa una libreria&mdash interna;
+ impostando questa opzione il compito sarà eseguito
+ da un programma esterno. Per maggiori dettagli sull'utilizzo di tali
+ programmi si veda
+ <xref linkend="svn.advanced.externaldifftools"/>.
+ </para>
+
</listitem>
</varlistentry>
<varlistentry>
<term><literal>diff3-cmd</literal></term>
<listitem>
- <para>This specifies the absolute path of a three-way
+ <para lang="en">This specifies the absolute path of a three-way
differencing program. Subversion uses this program to
merge changes made by the user with those received
from the repository. By default Subversion uses an
@@ -539,38 +918,68 @@
external program. See <xref
linkend="svn.advanced.externaldifftools"/> for more
details on using such programs.</para>
+
+ <para>Specifica il percorso di un programma a tre vie di differenze.
+ Subversion usa questo programma per
+ fondere le modifiche fatte dall'utente con quelle ricevute
+ dal repository. Di default Subversion usa una libreria
+ interna;impostando questa opzione il compito sarà eseguito
+ da un programma esterno. er maggiori dettagli sull'utilizzo di tali
+ programmi si veda
+ <xref linkend="svn.advanced.externaldifftools"/>.
+ </para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><literal>diff3-has-program-arg</literal></term>
<listitem>
- <para>This flag should be set to <literal>true</literal>
+ <para lang="en">This flag should be set to <literal>true</literal>
if the program specified by the
<literal>diff3-cmd</literal> option accepts a
<option>--diff-program</option> command-line
parameter.</para>
+
+ <para>Questo flag deve essere impostato a <literal>vero</literal>
+ se il programma specificato dall'opzione
+ <literal>diff3-cmd</literal> accetta il parametro
+ <option>--diff-program</option> da linea di comando.
+ </para>
</listitem>
</varlistentry>
</variablelist>
- <para>The <literal>tunnels</literal> section allows you to
+ <para lang="en">The <literal>tunnels</literal> section allows you to
define new tunnel schemes for use with
<command>svnserve</command> and <literal>svn://</literal>
client connections. For more details, see <xref
linkend="svn.serverconfig.svnserve.sshauth"/>.</para>
- <para>The <literal>miscellany</literal> section is where
+ <para>Le sezioni <literal>tunnel</literal> permettono di definire
+ nuovi schemi tunnel per usare con il comando
+ <command>svnserve</command> e <literal>svn://</literal>
+ le connessioni client. Per maggiori dettagli , si veda <xref
+ linkend="svn.serverconfig.svnserve.sshauth"/>.</para>
+
+
+ <para lang="en">The <literal>miscellany</literal> section is where
everything that doesn't belong elsewhere winds up.
<footnote>
- <para>Anyone for potluck dinner?</para>
+ <para lang="en">Anyone for potluck dinner?</para>
</footnote>
In this section, you can find:</para>
+ <para>La sezione <literal>miscellany</literal> è il luogo in cui tutto
+ ciò che non appartiene ad altri luoghi trova posto.
+ <footnote>
+ <para>Nessuno per una cena alla buona?</para>
+ </footnote>
+ In questa sezione , si possono trovare:</para>
<variablelist>
<varlistentry>
- <term><literal>global-ignores</literal></term>
+ <term><literal>tutte le cose ignorate</literal></term>
<listitem>
- <para>When running the <command>svn status</command>
+ <para lang="en">When running the <command>svn status</command>
command, Subversion lists unversioned files and
directories along with the versioned ones, annotating
them with a <literal>?</literal> character (see <xref
@@ -585,7 +994,23 @@
is <literal>*.o *.lo *.la #*# .*.rej *.rej .*~ *~
.#* .DS_Store</literal>.</para>
- <para>As well as <command>svn status</command>, the
+
+ <para>Quando si esegue il comando <command>svn status</command>,
+ Subversion elenca i file e le directory non versionati
+ insieme a quelli versionati, indicandoli con il carattere
+ <literal>?</literal> (si veda <xref
+ linkend="svn.tour.cycle.examine.status" />). Qualche volta,
+ può essere seccante vedere oggetti che non interessano e non sono versionati;
+ per esempio, file che sono il risultato della compilazione&mdash di un programma.
+ L'opzione <literal>global-ignores</literal> è un elenco
+ di globs delimitati da spazi che descrive i nomi di
+ file e directory che Subversion non dovrebbe mostrare
+ a meno che non sono sotto controllo di versione. Il valore di default
+ è <literal>*.o *.lo *.la #*# .*.rej *.rej .*~ *~
+ .#* .DS_Store</literal>.</para>
+
+
+ <para lang="en">As well as <command>svn status</command>, the
<command>svn add</command> and <command>svn import</command>
commands also ignore files that match the list
when they are scanning a directory. You can override this
@@ -593,27 +1018,49 @@
by explicitly specifying the file name, or by using
the <option>--no-ignore</option> command-line flag.</para>
- <para>For information on more fine-grained control of
+ <para>Così come il comando <command>svn status</command>, anche
+ i comandi <command>svn add</command> e <command>svn import</command>
+ ignorano file si trovano nella lista
+ quando eseguono la scansione di una directory. Si può sovrascrivere
+ questo comportamento per una singola istanza o per tutte
+ specificando esplicitamente il nome del file , oppure utilizzando l'opzione
+ <option>--no-ignore</option> da linea di comando.</para>
+
+ <para lang="en">For information on more fine-grained control of
ignored items, see <xref linkend="svn.advanced.props.special.ignore"
/>.</para>
+
+ <para>Per informazioni su un controllo più raffinato degli
+ oggetti ignorati, si veda
+ <xref linkend="svn.advanced.props.special.ignore"
+ />.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><literal>enable-auto-props</literal></term>
<listitem>
- <para>This instructs Subversion to automatically set
+ <para lang="en">This instructs Subversion to automatically set
properties on newly added or imported files. The
default value is <literal>no</literal>, so set this to
<literal>yes</literal> to enable Auto-props.
The <literal>auto-props</literal> section of this file
specifies which properties are to be set on which files.</para>
- </listitem>
+
+ <para>Fa in modo che Subversion imposti automaticamente
+ le proprietà su file aggiunti o importati. Il valore di
+ default è <literal>no</literal>, si deve impostare a
+ <literal>si</literal> per abilitare l' Auto-props.
+ La sezione <literal>auto-props</literal>di questo file
+ specifica quali proprietà bisogna impostare e su quali file.</para>
+
+
+ </listitem>
</varlistentry>
<varlistentry>
<term><literal>log-encoding</literal></term>
- <listitem>
+ <listitem>
<para>This variable sets the default character set
encoding for commit log messages. It's a permanent
form of the <option>--encoding</option> option (see
@@ -623,13 +1070,24 @@
system's native locale. You should specify a
different encoding if your commit messages are written
in any other encoding.</para>
+
+ <para>Questa variabile imposta il carattere di default
+ per segnalare i messaggi di log quando si effettua il commit.
+ E' una forma permanente dell'opzione <option>--encoding</option>
+ (si veda <xref linkend="svn.ref.svn.sw"/>). Il repository di Subversion
+ memorizza i messaggi di log con la codifica in UTF-8,
+ e assume che i messaggi di log siano scritti utilizzando
+ il proprio sistema operativo locale. Si deve specificare una codifica
+ differente se i messaggi di commit sono scritti con qualsiasi altra codifica.</para>
+
+
</listitem>
</varlistentry>
<varlistentry>
<term><literal>use-commit-times</literal></term>
- <listitem>
- <para>Normally your working copy files have timestamps
+ <listitem>
+ <para lang="en">Normally your working copy files have timestamps
that reflect the last time they were touched by any
process, whether that be your own editor or by some
<command>svn</command> subcommand. This is generally
@@ -637,7 +1095,19 @@
build systems often look at timestamps as a way of
deciding which files need to be recompiled.</para>
- <para>In other situations, however, it's sometimes nice
+ <para>Di solito i file della propria copia di lavoro
+ hanno una marcatura temporale che indica l'ultimo istante
+ in cui sono stati toccati da un qualsiasi processo,
+ sia che si tratti del proprio editor sia che si tratti di qualche
+ altro sottocomando
+ <command>svn</command> . Questo è generalmente
+ conveniente per coloro che sviluppano software, perchè
+ costruiscono sistemi che mostrano la marcatura temporale permettendo di decidere
+ quali file devono essere ricompilati.</para>
+
+
+
+ <para lang="en">In other situations, however, it's sometimes nice
for the working copy files to have timestamps that
reflect the last time they were changed in the
repository. The <command>svn export</command> command
@@ -649,14 +1119,29 @@
<command>svn switch</command>, and <command>svn
revert</command> commands will also set last-commit
timestamps on files that they touch.</para>
+
+ <para>In altre situazioni, comunque, può essere piacevole
+ per i file presenti nella copia di lavoro avere marcature temporali
+ che riflettono le ultime modifiche fatte sul
+ repository. Il comando <command>svn export</command>
+ colloca questi <quote>ultimi -commit
+ </quote> su alberi che produce. Settando la variabile
+ di configurazione su
+ <literal>si</literal>, i comandi <command>svn
+ checkout</command>, <command>svn update</command>,
+ <command>svn switch</command>, e <command>svn
+ revert</command> imposteranno la marca temporale dell'ultimo
+ commit sui file che toccano.</para
+
+
</listitem>
</varlistentry>
-
+
<!-- ###TODO add description of other options shown in example
registry file, e.g., template-root -->
</variablelist>
- <para>The <literal>auto-props</literal> section controls
+ <para lang="en">The <literal>auto-props</literal> section controls
the Subversion client's ability to automatically set
properties on files when they are added or imported.
It contains any number of key-value pairs in the
@@ -675,18 +1160,40 @@
<literal>yes</literal> in the <literal>miscellany</literal>
section if you want to enable auto-props.</para>
+
+ <para>La sezione <literal>auto-props</literal> controlla
+ la possibilità da parte del client Subversion di impostare
+ automaticamente le proprietà sui file quando sono aggiunti o importati.
+ Contiene contiene tutti i numeri pari dei valkori chiave nel formato
+ <literal>PATTERN = PROPNAME=PROPVALUE</literal>
+ dove <literal>PATTERN</literal> è un file modello
+ che abbina un insieme di nomi di file e il resto della linea
+ è la proprietà e il suo valore. Possono risultare più riscontri
+ con un file che risulta in più prospetti per quel file;
+ comunque,non è garantito che l' auto-props
+ venga applicato nell'ordine nel quale le proprietà sono elencate
+ nel config file , cosicchè può succedere che alcune regole ne
+ <quote>sovrascrivono</quote> altre. Si possono trovare diversi esempi
+ dell'utilizzo di auto-props nel file
+ <filename>config</filename> . Come ultima cosa , non bisogna dimenticarsi di
+ impostare la proprietà <literal>enable-auto-props</literal> a
+ <literal>si</literal> nella sezione <literal>miscellany</literal>
+ se si vuole abilitare l'auto-props.</para>
+
+
</sect3>
</sect2>
</sect1>
- <!-- ================================================================= -->
- <!-- ================================================================= -->
- <!-- ================================================================= -->
+
<sect1 id="svn.advanced.props">
- <title>Properties</title>
- <para>We've already covered in detail how Subversion stores and
+ <!--<title>Properties</title> -->
+
+ <title>Proprietà</title>
+
+ <para lang="en">We've already covered in detail how Subversion stores and
retrieves various versions of files and directories in its
repository. Whole chapters have been devoted to this most
fundamental piece of functionality provided by the tool. And
@@ -694,7 +1201,17 @@
be complete from a version control perspective. But it
doesn't stop there.</para>
- <para>In addition to versioning your directories and files,
+
+ <para>Si è già visto nel dettaglio come Subversion memorizza e
+ recupera varie versioni di file e directory nel suo
+ repository. Tutti i capitoli sono stati dedicati a questa fondamnetale
+ funzionalità fornita dal tool. E, se , il supporto si fermasse qui,
+ Subversion sarebbe completo dal punto di vista del controllo di versione.
+ Ma non si ferma qui.
+ </para>
+
+
+ <para lang="en">In addition to versioning your directories and files,
Subversion provides interfaces for adding, modifying, and
removing versioned metadata on each of your versioned
directories and files. We refer to this metadata as
@@ -710,10 +1227,27 @@
receive other people's property changes as you update your
working copy.</para>
- <sidebar>
- <title>Other Properties in Subversion</title>
+ <para>Oltre a versionare directory e file,
+ Subversion fornisce interfacce per aggiungere , modificare, e
+ rimuovere metadati sotto il controllo di versione su ciascun file e directory
+ sotto controllo di versione.Si farà riferimento a questi metadati come
+ <firstterm>proprietà</firstterm>,e possono essere considerati come
+ una tabella composta da due colonne che mappa i nomi delle proprietà su arbitrari valori
+ legati a ciascun oggetto presente nella propria cartella di lavoro.
+ Parlando in generale,i nomi e i valori delle proprietà possono essere scelti a piacere
+ con la condizione che i nomi siano testi umanamente comprensibili.
+ L'aspetto migliore di queste proprietà è che anche loro sono sotto controllo di versione
+ come i contenuti testuali dei propri file.
+ I cambiamenti di queste proprietà possono essere modificati,committati e recuperati
+ altrettanto semplicemente rispetto alle modifiche testuali.
+ Facendo l'aggiornamento della propria copia di lavoro si ricevono anche i cambiamenti
+ sulle proprietà fatti da altre persone.
+ </para>
- <para>Properties show up elsewhere in Subversion, too. Just as
+ <sidebar>
+ <!-- <title>Other Properties in Subversion</title> -->
+ <title>Altre proprietà in Subversion</title>
+ <para lang="en">Properties show up elsewhere in Subversion, too. Just as
files and directories may have arbitrary property names and
values attached to them, each revision as a whole may have
arbitrary properties attached to it. The same constraints
@@ -721,9 +1255,18 @@
binary values—except that revision properties are not
versioned. See <xref linkend="svn.reposadmin.basics.revprops" /> for more
information on these unversioned properties.</para>
+
+ <para>Le proprietà vengono mostrate anche in altre parti di Subversion.
+ Come i file e le directory possono avere nomi di proprietà arbitrari
+ e valori legati ad essi , ogni revisione nel suo complesso può avere
+ proprietà arbitrarie che fanno riferimento ad essa. Si applica la stessa
+ condizione—leggibilità, testo e qualsiasi altra cosa si vuole,
+ valori binari—l'unica differenza è che le proprietà di una revisione
+ non sono sotto controllo di versione.Si veda <xref linkend="svn.reposadmin.basics.revprops" />
+ per maggiori informazioni.</para>
</sidebar>
- <para>In this section, we will examine the utility—both to
+ <para lang="en">In this section, we will examine the utility—both to
users of Subversion, and to Subversion itself—of property
support. You'll learn about the property-related
<command>svn</command> subcommands, and how property
@@ -731,11 +1274,20 @@
Hopefully, you'll be convinced that Subversion properties can
enhance your version control experience.</para>
+ <para>In questa sezione,si esaminerà l' utilità—sia nell'utilizzare
+ Subversion,sia dello stesso Subversion—del supporto
+ delle proprietà. Si impareranno i sottocomandi
+ <command>svn</command> subcommands per le proprietà e le relazioni,
+ e come le modifiche di tali proprietà influenzano
+ il normale flusso di lavoro di Subversion .
+ Si spera , che si riuscirà a convincere che le proprietà di Subversion
+ rafforzano l'esperienza del controllo di versione.</para>
+
<!-- =============================================================== -->
<sect2 id="svn.advanced.props.why">
- <title>Why Properties?</title>
-
- <para>Properties can be very useful additions to your working
+ <!--<title>Why Properties?</title> -->
+ <title>Perchè le proprietà?</title>
+ <para lang="en">Properties can be very useful additions to your working
copy. In fact, Subversion itself uses properties to house
special information, and as a way to denote that certain
special processing might be needed. Likewise, you can use
@@ -743,8 +1295,16 @@
do with properties you could also do using regular versioned
files, but consider the following example of Subversion
property use.</para>
+ <para>Può essere molto utile aggiungere proprietà
+ alla propria copia di lavoro.Infatti,lo stesso Subversion usa proprietà
+ per immagazzinare speciali informazioni,ed è un modo per indicare
+ che sono necessari alcuni processi speciali.Allo stesso modo, si possono
+ usare le proprietà per i propri scopi. Naturalmente, qualsiasi cosa si possa fare
+ con le proprietà si potrebbe fare anche usando regolari file versionati,
+ ma si consideri il seguente esempio sull'uso delle proprietà in Subversion.
+ </para>
- <para>Say you wish to design a website that houses many digital
+ <para lang="en">Say you wish to design a website that houses many digital
photos, and displays them with captions and a datestamp. Now,
your set of photos is constantly changing, so you'd like to
have as much of this site automated as possible. These photos
@@ -761,7 +1321,24 @@
files is a mess, and grows in multiples with each new photo
added to the site.</para>
- <para>Now consider the same setup using Subversion's file
+ <para>Si supponga di voler progettare un sito web che ospiti molte
+ foto digitali, e che le mostri con una didascalia e un marcatore temporale.
+ L'insieme di foto cambia nel tempo costantemente, e il sito deve essere il più
+ automatico possibile. Queste foto possono essere
+ piuttosto grandi,come avviene normalmente con siti di questa natura,
+ e si vogliono fornire ai visitatori anteprime più piccole delle stesse immagini.
+ Questo può essere fatto con file tradizionali. Ad esempio si può avere
+ l'immagine <filename>image123.jpg</filename> e una minifoto
+ <filename>image123-thumbnail.jpg</filename> fianco a fianco in una
+ directory. Oppure se si vuole mantenere lo stesso nome al file, si
+ possono mettere le minifoto in una directory differente,come
+ <filename>thumbnails/image123.jpg</filename>. Inoltre è possibile
+ salvare le didascalie e i marcatori temporali in modo simile, magari
+ separati dal file immagine originale. Si vede subito che l'albero
+ di file diventa confuso ,e si moltiplica man mano che si aggiunge una nuova foto al sito.
+ </para>
+
+ <para lang="en">Now consider the same setup using Subversion's file
properties. Imagine having a single image file,
<filename>image123.jpg</filename>, and then properties set on
that file named <literal>caption</literal>,
@@ -776,32 +1353,63 @@
information that your site needs to display without having to
read an index file or play path manipulation games.</para>
- <para>How (and if) you use Subversion properties is up to you.
+ <para>Adesso si consideri la stessa struttura utilizzzando
+ i file proprietà di Subversion.
+ Si supponga di avere una singola immagine,
+ <filename>image123.jpg</filename>, e un insieme di proprietà sul file
+ chiamate <literal>didascalia</literal>,
+ <literal>marcatore temporale</literal>, e anche
+ <literal>anteprima</literal>. Ora la propria directory di lavoro
+ appare molto più maneggevole—infatti, è come se nella directory
+ ci sono solo file immagine. Ma gli script di automazione conoscono il
+ contenuto completo. Sanno di poter usare
+ <command>svn</command> (o ancora meglio, possono usare
+ il linguaggio obbligatorio&mdash di Subversion;si veda <xref
+ linkend="svn.developer.usingapi.otherlangs" />) per scandagliare le
+ informazioni extra di cui il sito ha bisogno per mostrare le foto
+ senza dover leggere un file indicizzato o giocare complicate manipolazioni sui percorsi.
+ </para>
+
+ <para lang="en">How (and if) you use Subversion properties is up to you.
As we mentioned, Subversion has it own uses for properties,
which we'll discuss a little later in this chapter. But
first, let's discuss how to manipulate properties using the
<command>svn</command> program.</para>
+ <para>Come (e se ) usare le proprietà di Subversion dipende da te.
+ Come si è detto, Subversion ha il suo uso personale delle proprietà,
+ che verrà discusso successivamente in questo capitolo. Ma
+ prima, si veda come manipolare le proprietà usando il programma
+ <command>svn</command> .</para>
+
</sect2>
- <!-- =============================================================== -->
+
<sect2 id="svn.advanced.props.manip">
- <title>Manipulating Properties</title>
+ <!--<title>Manipulating Properties</title>-->
+ <title>Manipolare le proprietà </title>
- <para>The <command>svn</command> command affords a few ways to
+ <para lang="en">The <command>svn</command> command affords a few ways to
add or modify file and directory properties. For properties
with short, human-readable values, perhaps the simplest way to
add a new property is to specify the property name and value
on the command-line of the <command>propset</command>
subcommand.</para>
+ <para>Il comando <command>svn</command> permette di aggiungere o
+ o modificare le proprietà di file e directory in diversi modi. Per proprietà
+ con valori corti, e leggibili, forse il modo più semplice per aggiungere
+ una nuova proprietà è specificare il nome della proprietà e il valore
+ da riga di comnado utilizzando il sottocomando
+ <command>propset</command> .
+ </para>
<screen>
$ svn propset copyright '(c) 2003 Red-Bean Software' calc/button.c
property 'copyright' set on 'calc/button.c'
$
</screen>
-
- <para>But we've been touting the flexibility that Subversion
+
+ <para lang="en">But we've been touting the flexibility that Subversion
offers for your property values. And if you are planning to
have a multi-line textual, or even binary, property value, you
probably do not want to supply that value on the command-line.
@@ -810,25 +1418,46 @@
specifying the name of
a file which contains the new property value.</para>
+
+ <para>Ma finora si è decantata la flessibilità che Subversion
+ offre per i valori delle proprietà. E se si vuole un valore testuale
+ multi-linea , o anche binario, probabilmente non si vuole fornire tale valore da
+ riga di comando.
+ Perciò il sottocomando <command>propset</command> accetta l'opzione
+ <option>--file</option> (<option>-F</option>) per specificare il nome
+ di un file che contiene il valore della nuova proprietà.</para>
+
<screen>
$ svn propset license -F /path/to/LICENSE calc/button.c
property 'license' set on 'calc/button.c'
$
</screen>
- <para>There are some restrictions on the names you can use for
+ <para lang="en">There are some restrictions on the names you can use for
properties. A property name must start with a letter, a colon
(<literal>:</literal>), or an underscore
(<literal>_</literal>); after that, you can also use digits,
hyphens (<literal>-</literal>), and periods
(<literal>.</literal>).
<footnote>
- <para>If you're familiar with XML, this is pretty much the
+ <para lang="en">If you're familiar with XML, this is pretty much the
ASCII subset of the syntax for XML "Name".</para>
</footnote>
</para>
- <para>In addition to the <command>propset</command> command, the
+ <para>Ci sono alcune restrizioni sui nomi che si possono usare per le
+ proprietà.Un nome di una proprietà deve cominciare con una lettera, due punti
+ (<literal>:</literal>), o un underscore
+ (<literal>_</literal>); dopo , si possono usare anche numeri,
+ trattini(<literal>-</literal>), e punti
+ (<literal>.</literal>).
+ <footnote>
+ <para>Se si ha familiarità con XML, questo è più o meno lo stesso
+ insieme ASCII della sintassi per i "Nomi" XML .</para>
+ </footnote>
+ </para>
+
+ <para lang="en">In addition to the <command>propset</command> command, the
<command>svn</command> program supplies the
<command>propedit</command> command. This command uses the
configured editor program (see <xref
@@ -845,18 +1474,42 @@
editor without making any changes, no property modification
will occur.</para>
+
+
+ <para>Oltre al comando <command>propset</command> , il programma
+ <command>svn</command> fornisce il comando
+ <command>propedit</command> command. Questo comando utilizza
+ l'editor di testo configurato (see <xref
+ linkend="svn.advanced.confarea.opts.config" />) per aggiungere o modificare proprietà.
+ Quando si esegue il comando, <command>svn</command> invoca l'editor
+ su un file temporaneo che contiene il valore corrente della proprietà
+ (oppure che è vuoto, se si sta aggiungendo una nuova proprietà).
+ Quindi, basta modificare il valore nel programma di editor
+ finchè non si ottiene il nuovo valore che si vuole memorizzare per la proprietà,
+ si salva il file temporaneo, e quindi si esce dal programma di editor.
+ Se Subversion si accorge che è stato appena modificato
+ il valore esistente della proprietà, lo accetta come nuovo valore.
+ Se si esce dall'editor senza aver effettuato modifiche,
+ non sarà modificate nessuna proprietà.
+ </para>
<screen>
$ svn propedit copyright calc/button.c ### exit the editor without changes
No changes to property 'copyright' on 'calc/button.c'
$
</screen>
- <para>We should note that, as with other <command>svn</command>
+ <para lang="en">We should note that, as with other <command>svn</command>
subcommands, those related to properties can act on multiple
paths at once. This enables you to modify properties on whole
sets of files with a single command. For example, we could
have done:</para>
+ <para>Si noti che , come altri sottocomandi <command>svn</command>,
+ questi collegamenti alle proprietà possono riferirsi a diversi percorsi
+ contemporaneamente. Questo permette di modificare le proprietà di un intero insieme
+ di file con un unico comando. Ad esempio, si può fare:
+ </para>
+
<screen>
$ svn propset copyright '(c) 2002 Red-Bean Software' calc/*
property 'copyright' set on 'calc/Makefile'
@@ -866,7 +1519,7 @@
$
</screen>
- <para>All of this property adding and editing isn't really very
+ <para lang="en">All of this property adding and editing isn't really very
useful if you can't easily get the stored property value. So
the <command>svn</command> program supplies two subcommands
for displaying the names and values of properties stored on
@@ -878,6 +1531,18 @@
paths) and a property name, print the value of the property to
the standard output stream.</para>
+ <para>Tutto questo aggiungere e modificare proprietà non è realmente utile
+ se non si può facilmente memorizzare i valori delle proprietòà. Perciò
+ il programma <command>svn</command> fornisce due sottocomandi
+ per visualizzare i nomi e i valori delle proprietà salvati nei file
+ e nelle directory. Il comando <command>svn proplist</command>
+ elencherà i nomi delle proprietà che esistono in un percorso.
+ Una volta che si conoscono i nomi delle proprietà su un nodo,
+ si possono chiedere i singoli valori usando <command>svn
+ propget</command>. Questo comnado, dato un percorso (o un insieme di percorsi)
+ e il nome di una proprietà,stamperà il valore della proprietà sul sistema di output
+ standard .</para>
+
<screen>
$ svn proplist calc/button.c
Properties on 'calc/button.c':
@@ -887,11 +1552,17 @@
(c) 2003 Red-Bean Software
</screen>
- <para>There's even a variation of the
+ <para lang="en">There's even a variation of the
<command>proplist</command> command that will list both the
name and value of all of the properties. Simply supply the
<option>--verbose</option> (<option>-v</option>) option.</para>
+ <para>C'è anche una variante del comando the
+ <command>proplist</command> che elenca sia il nome che il valore
+ di tutte le proprietà. Semplicemente fornendo l'opzione
+ <option>--verbose</option> (<option>-v</option>).</para>
+
+
<screen>
$ svn proplist --verbose calc/button.c
Properties on 'calc/button.c':
@@ -900,7 +1571,7 @@
Copyright (c) 2003 Red-Bean Software. All rights reserved.
Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions
+modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
@@ -909,27 +1580,38 @@
…
</screen>
- <para>The last property-related subcommand is
+ <para lang="en">The last property-related subcommand is
<command>propdel</command>. Since Subversion allows you to
store properties with empty values, you can't remove a
property altogether using <command>propedit</command> or
<command>propset</command>. For example, this command will
<emphasis>not</emphasis> yield the desired effect:</para>
+ <para>L'ultimo comando legato alle proprietà è
+ <command>propdel</command>. Poichè Subversion permette di memorizzare proprietà
+ con valori vuoti, non è possibile cancellare una
+ proprietà usando nel complesso <command>propedit</command> o
+ <command>propset</command>. Per esempio, questo comando
+ <emphasis>non</emphasis> produrrà l'effetto desiderato:</para>
+
<screen>
$ svn propset license '' calc/button.c
property 'license' set on 'calc/button.c'
$ svn proplist --verbose calc/button.c
Properties on 'calc/button.c':
copyright : (c) 2003 Red-Bean Software
- license :
+ license :
$
</screen>
- <para>You need to use the <command>propdel</command> command to
+ <para lang="en">You need to use the <command>propdel</command> command to
delete properties altogether. The syntax is similar to the
other property commands:</para>
+
+ <para>Bisogna usare il comando <command>propdel</command>
+ per cancellare complessivamente le proprietà.La sintassi è simile a quella degli altri
+ comandi:</para>
<screen>
$ svn propdel license calc/button.c
property 'license' deleted from 'calc/button.c'.
@@ -939,7 +1621,7 @@
$
</screen>
- <para>Now that you are familiar with all of the
+ <para lang="en">Now that you are familiar with all of the
property-related <command>svn</command> subcommands, let's see
how property modifications affect the usual Subversion
workflow. As we mentioned earlier, file and directory
@@ -948,10 +1630,24 @@
merging—in cleanly or conflicting fashions—someone
else's modifications into your own.</para>
+ <para>Adesso che si ha familiarità con tutti i comandi legati alle
+ proprietà <command>svn</command> ,si vedrà come le modifiche
+ fatte sulle proprietà influiscono sul normale flusso di lavoro di Subversion .
+ Come si è detto precedentemente,le proprietà di file e directory
+ sono sotto il controllo di versione, proprio come il contenuto del file.
+ Come conseguenza, Subversion fornisce le stesse opportunità per eseguire
+ il merge—nel risolvere o cancellare i conflitti—le modifiche
+ effettuate da qualcun altro.</para>
+
<sidebar>
- <title>Modifying Revision Properties</title>
- <para>Remember those unversioned revision properties? You can
+
+
+
+ <!-- <title>Modifying Revision Properties</title> -->
+ <title>Modificare le proprietà della revisione </title>
+
+ <para lang="en">Remember those unversioned revision properties? You can
modify those, too, with the <command>svn</command> program.
Simply add the <option>--revprop</option> command-line
parameter, and specify the revision whose property you wish
@@ -961,19 +1657,33 @@
you wish to modify. For example, you might want to replace
the commit log message of an existing revision.
<footnote>
- <para>Fixing spelling errors, grammatical gotchas, and
+ <para lang="en">Fixing spelling errors, grammatical gotchas, and
<quote>just-plain-wrongness</quote> in commit log
messages is perhaps the most common use case for the
<option>--revprop</option> option.</para>
</footnote></para>
+ <para>Ricordate quelle proprietà non revisionate? Si possono
+ modificare anche quelle, con il programma <command>svn</command>.
+ Semplicemente aggiungendo il parametro <option>--revprop</option>
+ da linea di comando, e specificando la revisione di cui si vuole modificare la proprietà.
+ Le revisioni sono globali perciò non serve specificare un percorso
+ nei casi in cui ci si trova nella copia di lavoro del repository
+ e si vogliono modificare le proprietà di quella revisione.
+ Per esempio,si potrebbe voler sostiutire il messaggio di log del commit
+ di una revisione già esistente.
+ <footnote>
+ <para>Forse il caso più comune in cui si utilizza l'opzione <option>--revprop</option>,
+ è quando si vogliono correggere errori grammaticali nei messaggi di log dei commit.</para>
+ </footnote></para>
+
<screen>
$ svn propset svn:log '* button.c: Fix a compiler warning.' -r11 --revprop
property 'svn:log' set on repository revision '11'
$
</screen>
- <para>Note that the ability to modify these unversioned
+ <para lang="en">Note that the ability to modify these unversioned
properties must be explicitly added by the repository
administrator (see <xref linkend="svn.reposadmin.create.hooks" />).
Since the properties aren't versioned, you run the risk of
@@ -982,9 +1692,21 @@
against this loss, and by default, modification of
unversioned properties is disabled.</para>
+ <para>Si noti che la possibilità di modificare queste proprietà
+ non revisionate deve essere esplicitamente aggiunta
+ dall'amministartore del repository
+ (si veda <xref linkend="svn.reposadmin.create.hooks" />).
+ Visto che le proprietà non sono revisionate, si corre il rischio
+ di perdere informazioni se non si sta attenti con le modifiche.
+ L'amministratore del repository può implementare metodi
+ per proteggere contro queste perdite , e di default,
+ la possibilità di modificare queste proprietà non revisionate
+ è disabilitata.</para>
+
+
</sidebar>
- <para>And as with file contents, your property changes are local
+ <para lang="en">And as with file contents, your property changes are local
modifications, only made permanent when you commit them to the
repository with <command>svn commit</command>. Your property
changes can be easily unmade, too—the <command>svn
@@ -995,6 +1717,18 @@
<command>svn status</command> and <command>svn diff</command>
commands.</para>
+ <para>Come con i contenuti dei file, i cambiamenti che si apportano alle proprietà
+ sono modifiche locali,soltanto quando si fa il commit sul repository
+ con il comando <command>svn commit</command> si rendono permanenti.
+ Le modifiche alle proprietà possono anche essere facilmente cancellate;
+ il comando <command>svn
+ revert</command> riporterà i file e le directory allo stato precedente
+ alle modifiche, contenuto, proprietà, e tutto.
+ Inoltre , si possono avere informazioni interessanti sullo stato delle
+ proprietà di un file e di una directory utilizzando i comandi
+ <command>svn status</command> and <command>svn diff</command> .
+ </para>
+
<screen>
$ svn status calc/button.c
M calc/button.c
@@ -1007,7 +1741,7 @@
$
</screen>
- <para>Notice how the <command>status</command> subcommand
+ <para lang="en"> Notice how the <command>status</command> subcommand
displays <literal>M</literal> in the second column instead of
the first. That is because we have modified the properties on
<filename>calc/button.c</filename>, but not modified its
@@ -1015,25 +1749,41 @@
<literal>M</literal> in the first column, too (see <xref
linkend="svn.tour.cycle.examine.status" />).</para>
+ <para>Si noti come il comando <command>status</command>
+ mostri una <literal>M</literal> nella seconda colonna invece che nella prima.
+ Ciò avviene perchè sono state modificate le proprietà su
+ <filename>calc/button.c</filename>, ma non è stato modificato il suo contenuto
+ testuale. Se avessimo modificato entrambi ,si sarebbe vista la lettera
+ <literal>M</literal> nella prima colonna , si veda ( <xref
+ linkend="svn.tour.cycle.examine.status" />).</para>
+
<sidebar>
- <title>Property Conflicts</title>
+ <!-- <title>Property Conflicts</title> -->
+ <title>Conflitti di proprietà</title>
- <para>As with file contents, local property modifications can
+ <para lang="en">As with file contents, local property modifications can
conflict with changes committed by someone else. If you
update your working copy directory and receive property
changes on a versioned resource that clash with your own,
Subversion will report that the resource is in a conflicted
state.</para>
-
+
+ <para>Così come avviene con i contenuti dei file, le modifiche fatte alle proprietà
+ locali possono causare conflitti con i cambiamenti registrati da qualcun altro.
+ Se si aggiorna la prorpia copia di alvoro e si ricevono le modifiche alle proprietà
+ su una risorsa che è sotto revisione e che sono in conflitto con le proprie,
+ Subversion riporterà uno stato di conflitto.
+ </para>
+
<screen>
% svn update calc
M calc/Makefile.in
C calc/button.c
Updated to revision 143.
-$
+$
</screen>
-
- <para>Subversion will also create, in the same directory as
+
+ <para lang="en">Subversion will also create, in the same directory as
the conflicted resource, a file with a
<filename>.prej</filename> extension which contains the
details of the conflict. You should examine the contents of
@@ -1043,24 +1793,48 @@
status</command> output for that resource, and attempts to
commit your local modifications will fail.</para>
+ <para>Subversion crea inoltre, nella stessa directory in cui si trova
+ la risorsa che ha il conflitto, un file di estensione
+ <filename>.prej</filename> che contiene i dettagli del conflitto.
+ Si può esaminare il contenuto di questo file
+ per decidere come risolvere il conflitto.
+ Finchè il conflitto non è risolto, nella seconda colonna del comando
+ <command>svn status</command> ci sarà la lettera <literal>C</literal>
+ e il tentativo di committare i propri cambiamenti fallirebbe.
+ </para>
+
<screen>
$ svn status calc
C calc/button.c
? calc/button.c.prej
-$ cat calc/button.c.prej
+$ cat calc/button.c.prej
prop 'linecount': user set to '1256', but update set to '1301'.
$
</screen>
-
- <para>To resolve property conflicts, simply ensure that the
+
+
+
+
+
+
+
+
+
+ <para lang="en">To resolve property conflicts, simply ensure that the
conflicting properties contain the values that they should,
and then use the <command>svn resolved</command> command to
alert Subversion that you have manually resolved the
problem.</para>
+ <para>Per risolvere i conflitti delle prorpietà, bisogna semplicemente assicurarsi
+ che le proprietà in conflitto contengano i valori che dovrebebro avere,
+ e quindi usare il comando <command>svn resolved</command>per avvisare
+ Subversion che il problema è stato risolto manualmente.
+ </para>
+
</sidebar>
- <para>You might also have noticed the non-standard way that
+ <para lang="en">You might also have noticed the non-standard way that
Subversion currently displays property differences. You can
still run <command>svn diff</command> and redirect the output
to create a usable patch file. The <command>patch</command>
@@ -1070,7 +1844,17 @@
<command>svn diff</command>, any property modifications will
need to be applied by hand.</para>
- <para>As you can see, the presence of property modifications has
+ <para>Dovrebbe esser stato notato il modo non-standard in cui
+ Subversion mostra le differenze tra le proprietà. Si può eseguire
+ il comando <command>svn diff</command> e reindirizzare l'output
+ per creare un file patch. Il comando <command>patch</command>
+ ignorerà le patches&mdash delle proprietà ;come regola,
+ ignora qualsiasi disturbo che non riconosce. Questo significa
+ sfortunatamente che per applicare pienamente una patch generata dal comando
+ <command>svn diff</command>, tutte le modifiche fatte alle proprietà
+ devono essere applicate a mano.</para>
+
+ <para lang="en">As you can see, the presence of property modifications has
no outstanding effect on the typical Subversion workflow.
Your general patterns of updating your working copy, checking
the status of your files and directories, reporting on the
@@ -1080,14 +1864,25 @@
program has some additional subcommands for actually making
property changes, but that is the only noticeable asymmetry.</para>
+ <para>Come si può vedere, la presenza di modifiche fatte alle proprietà non
+ ha effetti rilevanti sul normale flusso di lavoro di Subversion.
+ La abituali operazioni di aggiornamento della propria copia di lavoro, controllo
+ dello stato di file e directory, resoconto delle modifiche effettuate
+ e il commit dei cambiamenti fatti sul repository
+ sono completamente immuni dalla presenza o assenza di proprietà.
+ Il comando <command>svn</command>
+ ha alcuni sottocomandi aggiuntivi per modificare le proprietà,
+ ma questa è l'unica asimmetria notevole.</para>
+
</sect2>
<!-- =============================================================== -->
<sect2 id="svn.advanced.props.special">
-
- <title>Special Properties</title>
- <para>Subversion has no particular policy regarding
+ <!--<title>Special Properties</title> -->
+ <title>Proprietà speciali </title>
+
+ <para lang="en">Subversion has no particular policy regarding
properties—you can use them for any purpose. Subversion
asks only that you not use property names that begin with the
prefix <literal>svn:</literal>. That's the namespace that it
@@ -1096,11 +1891,23 @@
directories to which they are attached. In this section,
we'll untangle the mystery, and describe how these special
properties make your life just a little easier.</para>
-
+
+ <para>Subversion non ha una politica particolare rispetto alla gestione delle
+ properties—si possono usare per qualsiasi utilizzo.Subversion
+ richiede soltanto che non si usino nomi per le proprietà che iniziano
+ con il prefisso <literal>svn:</literal>. Quello è il namespace che
+ si riserva per il proprio uso.Infatti, Subversion definisce
+ delle proprietà specifiche che hanno effetti magici su file e
+ directory ai quali sono allegate.In questa sezione,
+ sarà svelato il mistero, e si descriverà come queste proprietà speciali
+ rendono la vita un pò più semplice.</para>
+
<sect3 id="svn.advanced.props.special.executable">
- <title><literal>svn:executable</literal></title>
-
- <para>The <literal>svn:executable</literal> property is used
+ <!-- <title><literal>svn:executable</literal></title> -->
+ <title><literal>svn:eseguibile</literal></title>
+
+
+ <para lang="en">The <literal>svn:executable</literal> property is used
to control a versioned file's filesystem-level execute
permission bit in a semi-automated way. This property has
no defined values—its mere presence indicates a desire
@@ -1108,7 +1915,17 @@
Removing this property will restore full control of the
execute bit back to the operating system.</para>
- <para>On many operating systems, the ability to execute a file
+ <para>La proprietà <literal>svn:executable</literal> è usata
+ per controllare i permessi di esecuzione di un file sotto controllo di versione
+ in modo semi automatico . Questa proprietà non ha un valore definito;
+ la sua presenza implica il desiderio che i diritti di esecuzione
+ siano abilitati da Subversion.
+ Rimuovendo questa proprietà si ridarà il controllo completo sui permessi di escuzione
+ al sistema operativo.</para>
+
+
+
+ <para lang="en">On many operating systems, the ability to execute a file
as a command is governed by the presence of an execute
permission bit. This bit usually defaults to being
disabled, and must be explicitly enabled by the user for
@@ -1121,33 +1938,68 @@
the <literal>svn:executable</literal> property as a way to
keep the execute bit enabled.</para>
- <para>This property has no effect on filesystems that have no
+ <para>Su molti sistemi operativi, la possibilità di eseguire un file
+ come un comando è governata dalla presenza di un bit di permesso di escuzione.
+ Questo bit di solito di dafault è disabilitato,
+ e deve essere esplicitamente abilitato dall'utente per ogni file che
+ ne necessita. In una copia di lavoro, nuovi file vengono creati
+ in ogni momento come nuove versioni di un file esistente
+ oppure sono ricevuti durante un aggiornamento. Questo significa che
+ che se si è abilitati a esguire il file,e poi si fa l'aggiornamento della propria copia di lavoro,
+ e quel file ha subito delle modifiche,
+ iil suo bit di esecuzione potrebbe essere disabilitato. Perciò, Subversion fornisce
+ la proprietà <literal>svn:executable</literal> come un modo
+ per conservare abilitato il bit di escuzione.</para>
+ <!--*****************************************************************************-->
+ <para lang="en">This property has no effect on filesystems that have no
concept of an executable permission bit, such as FAT32 and
NTFS.
<footnote>
- <para>The Windows filesystems use file extensions (such as
+ <para lang="en">The Windows filesystems use file extensions (such as
<literal>.EXE</literal>, <literal>.BAT</literal>, and
<literal>.COM</literal>) to denote executable
files.</para>
- </footnote>
- Also, although it has no defined values, Subversion will force
+ Also, although it has no defined values, Subversion will force
its value to <literal>*</literal> when setting this property.
Finally, this property is valid only on files, not on
directories.</para>
+ <para>Questa proprietà non ha effetti su filesystem che non hanno il concetto
+ del bit per i permessi di esecuzione , come FAT32 e
+ NTFS.
+ <footnote>
+
+ <para>Il filesystem di Windows usa per estensioni (come
+ <literal>.EXE</literal>, <literal>.BAT</literal>, e
+ <literal>.COM</literal>) per indicare file eseguibili.
+ </para>
+ </footnote>
+ Inoltre,anche se non ha valori definiti, Subversion forzerà
+ il suo valore a <literal>*</literal>quando si setta questa proprietà.
+ Infine, questa proprietà è valida solo per i file, non per le
+ directory.</para>
+
+
</sect3>
<sect3 id="svn.advanced.props.special.mime-type">
<title><literal>svn:mime-type</literal></title>
-
- <para>The <literal>svn:mime-type</literal> property serves
+
+ <para lang="en">The <literal>svn:mime-type</literal> property serves
many purposes in Subversion. Besides being a
general-purpose storage location for a file's Multipurpose
Internet Mail Extensions (MIME) classification, the value of
this property determines some behavioral characteristics
of Subversion itself.</para>
- <para>For example, if a file's
+ <para>La proprietà <literal>svn:mime-type</literal> serve a diversi scopi
+ in Subversion. Oltre ad essere una locazione per uso generale
+ per la classificazione dei file Multipurpose
+ Internet Mail Extensions (MIME) , il suo valore determina
+ alcune caratteristiche comportamentali dello stesso
+ Subversion .</para>
+
+ <para lang="en">For example, if a file's
<literal>svn:mime-type</literal> property is set to a
non-text MIME type (generally, something that doesn't begin
with <literal>text/</literal>, though there are exceptions),
@@ -1169,19 +2021,49 @@
against failed attempts at performing contextual merges on
files that simply cannot be contextually merged.</para>
- <para>Also, if the <literal>svn:mime-type</literal>
+
+ <para>Ad esempio, se la proprietà di un file
+ <literal>svn:mime-type</literal> è settata come tipo
+ non-text MIME (generalmente, qualcosa che non inizia con
+ <literal>text/</literal>, anche se ci sono delle eccezioni),
+ Subversion assumerà che il file contiene valori
+ binari—che sono dati , non leggibili&mdash dall'uomo. Uno dei
+ benefici che Subversion tipicamente fornisce è il merge contestuale,
+ lined-based delle modifche ricevute dal server
+ durante un update nel proprio file di lavoro. Ma per i file che si ritiene contengano
+ dati binari, non c'è il concetto di
+ <quote>line</quote>. Così, per questi file, Subversion
+ non fornisce merge contestuali durente l'update.
+ Invece, ogni volta che viene modificato localmente
+ la copia di lavoro di un file binario che è stato anche aggiornato,il file
+ viene rinominato con un'estensione <filename>.orig</filename> ,
+ e quindi Subversion memorizza una nuova copia del file che
+ contiene le modifiche ricevute durante l' update, ma
+ non le modifiche fatte localmente, al file originale.
+ Questo comportamento protegge l'utente
+ contro i tentativi falliti di far confluire contestualemnte
+ file che semplicemente non possono essere fusi contestualmente.</para>
+
+
+ <para lang="en">Also, if the <literal>svn:mime-type</literal>
property is set, then the Subversion Apache module will use
its value to populate the <literal>Content-type:</literal>
HTTP header when responding to GET requests. This gives a
crucial clue about how to display a file when perusing
your repository with a web browser.</para>
+ <para>Inoltre , se è settata la proprietà <literal>svn:mime-type</literal>
+ il modulo Apache di Subversion userà il suo valore
+ per popolare <literal>Content-type:</literal>
+ l'intestazione HTTP quando risponde a richieste ricevute .Questo fornisce
+ una indicazione cruciale su come mostrare un file quando si ricerca in rete
+ il proprio repository con un browser web.</para>
</sect3>
<sect3 id="svn.advanced.props.special.ignore">
<title><literal>svn:ignore</literal></title>
- <para>The <literal>svn:ignore</literal> property contains a
+ <para lang ="en">The <literal>svn:ignore</literal> property contains a
list of file patterns which certain Subversion operations
will ignore. Perhaps the most commonly used special
property, it works in conjunction with the
@@ -1191,7 +2073,19 @@
<command>svn status</command>, <command>svn
add</command>, and <command>svn import</command>.</para>
- <para>The rationale behind the <literal>svn:ignore</literal>
+ <para>La proprietà <literal>svn:ignore</literal> contiene una lista
+ di percorsi di file che le operazioni di Subversion ignoreranno.
+ Forse la proprietà speciale più comunemente usata
+ lavora insieme all'opzione di configurazione fatta in fase di esecuzione
+ <literal>global-ignores</literal>
+ (si veda <xref linkend="svn.advanced.confarea.opts.config" />) per
+ filtrare file che non sono sotto il controllo di versione e directory non incluse nei
+ comandi <command>svn status</command>, <command>svn
+ add</command>, and <command>svn import</command>.</para>
+
+
+
+ <para lang="en">The rationale behind the <literal>svn:ignore</literal>
property is easily explained. Subversion does not assume
that every file or subdirectory in a working copy directory
is intended for version control. Resources must be
@@ -1200,7 +2094,17 @@
commands. As a result, there are often many resources in a
working copy that are not versioned.</para>
- <para>Now, the <command>svn status</command> command displays
+
+ <para>Il motivo della proprietà <literal>svn:ignore</literal>
+ è facilmente spiegato. Subversion non assume che ogni
+ file o subdirectory presenti in una copia di lavoro
+ siano sotto controllo di versione. Le risorse devono essere
+ esplicitamente poste sotto il controllo di Subversion utilizzando
+ il comnado <command>svn add</command> oppure il comando <command>svn import</command>.
+ Come conseguenza, ci sono spesso molte risorse in una
+ copia di lavoro che non sono sotto controllo di versione.</para>
+
+ <para lang="en">Now, the <command>svn status</command> command displays
as part of its output every unversioned file or subdirectory
in a working copy that is not already filtered out by the
<literal>global-ignores</literal> option (or its built-in
@@ -1208,7 +2112,15 @@
perhaps they've forgotten to add a resource to version
control.</para>
- <para>But Subversion cannot possibly guess the names of
+ <para>Ora, il comando <command>svn status</command> mostra come parte
+ del suo output tutti i file o le subdirectory
+ presenti in una copia di lavoro che non sono ancora stati filtrati
+ dall'opzione <literal>global-ignores</literal> (oppure che sono incorporati
+ nel valore di default). Questo è fatto affinchè gli utenti possano vedere se
+ hanno dimenticato di aggiungere una risorsa al controllo di versione.
+ </para>
+
+ <para lang="en">But Subversion cannot possibly guess the names of
every resource that should be ignored. Also, quite often
there are things that should be ignored in
<emphasis>every</emphasis> working copy of a particular
@@ -1218,7 +2130,17 @@
clash with the configuration needs of other working copies
that the user has checked out.</para>
- <para>The solution is to store ignore patterns that are unique
+ <para>Ma Subversion non ha la possibilità di ospitare i nomi di
+ tutte le risorse che possono essere ignorate. Inoltre, piuttosto spesso
+ ci sono cose che devono essere ignorate in
+ <emphasis>ogni</emphasis> cartella di lavoro di un particolare
+ repository. Costringere ogni utente del repository ad aggiungere
+ i percorsi di queste risorse nella loro area di configurazione
+ non è solo pesante , ma può causare anche un potenziale conflitto
+ con le esigenze di configurazione di copie di lavoro di altri
+ che l'utente ha aggiornato.</para>
+
+ <para lang="en">The solution is to store ignore patterns that are unique
to the resources likely to appear in a given directory with
the directory itself. Common examples of unversioned
resources that are basically unique to a directory, yet
@@ -1228,24 +2150,43 @@
generated as the result of a conversion of some source
DocBook XML files to a more legible output format.</para>
+ <para>La soluzione è memorizzare i modellida ignorare che siano
+ unici così come appare in una data directory con la directory stessa.
+ Esempi comuni di risorse non revisionate
+ che sono fondamentalmente uniche in una directory,
+ sono forniti da output provenienti dalla compilazione di programmi.
+ Oppure—per usare un esempio più appropriato
+ per questo libro—i file HTML, PDF, o PostScript
+ generati come risultato di una conversione di alcuni file sorgenti
+ DocBook XML in un formato output più facilemnte leggibile.</para>
+
<sidebar>
- <title>Ignore Patterns for CVS Users</title>
-
- <para>The Subversion <literal>svn:ignore</literal> property
+ <!-- <title>Ignore Patterns for CVS Users</title> -->
+ <title>Modelli da ignorare per utenti CVS </title>
+
+ <para lang="en">The Subversion <literal>svn:ignore</literal> property
is very similar in syntax and function to the CVS
<filename>.cvsignore</filename> file. In fact, if you are
migrating a CVS working copy to Subversion, you can
directly migrate the ignore patterns by using the
<filename>.cvsignore</filename> file as input file to the
<command>svn propset</command> command:</para>
-
+
+ <para>La proprietà di Subversion <literal>svn:ignore</literal>
+ è molto simile nella sintassi e nella funzionalità al file CVS
+ <filename>.cvsignore</filename> . Infatti, se si sta migrando
+ una copia di lavoro da CVS a Subversion,si possono direttamente
+ migrari i modelli da ignorare usando il file
+ <filename>.cvsignore</filename> come file di input del comando
+ <command>svn propset</command> :</para>
+
<screen>
$ svn propset svn:ignore -F .cvsignore .
property 'svn:ignore' set on '.'
$
-</screen>
+</screen>
- <para>There are, however, some differences in the ways that
+ <para lang="en">There are, however, some differences in the ways that
CVS and Subversion handle ignore patterns. The two systems
use the ignore patterns at some different times, and there
are slight discrepancies in what the ignore patterns apply
@@ -1253,21 +2194,43 @@
<literal>!</literal> pattern as a reset back to having no
ignore patterns at all.</para>
+ <para>Ci sono, comunque, alcune differenze nel modo in cui
+ CVS e Subversion gestiscono i modelli da ignorare.
+ I due sistemi usano i modelli da ignorare in due diversi momenti,
+ e ci sono delle lievi discrepanze rispetto a cosa si rivolgono i modelli da ignorare.
+ Inoltre, Subversion non riconosce l'uso del modello
+ <literal>!</literal> per azzerare tutto e non avere nessun modello da ignorare.</para>
+
</sidebar>
- <para>For this purpose, the <literal>svn:ignore</literal>
+
+
+
+ <para lang="en">For this purpose, the <literal>svn:ignore</literal>
property is the solution. Its value is a multi-line
collection of file patterns, one pattern per line. The
property is set on the directory in which you wish the
patterns to be applied.
<footnote>
- <para>The patterns are strictly for that
+ <para lang="en">The patterns are strictly for that
directory—they do not carry recursively into
subdirectories.</para>
</footnote>
For example, say you have the following output from
<command>svn status</command>:</para>
+ <para>A tale scopo, la proprietà <literal>svn:ignore</literal>
+ è la soluzione. Il suo valore è una collezione a righe multiple
+ di modelli di file , un modello per linea. La proprietà
+ è settata nella directory nella quale si desidera che i modelli vengano
+ applicati.
+ <footnote>
+ <para>I modelli sono rigorosamente per quella
+ directory—non si trasportano ricorsivamente nelle
+ subdirectory.</para>
+ </footnote>
+ Ad esempio supponiamo di avere il seguente output dal comando
+ <command>svn status</command>:</para>
<screen>
$ svn status calc
M calc/button.c
@@ -1279,7 +2242,7 @@
? calc/debug_log.3.gz
</screen>
- <para>In this example, you have made some property
+ <para lang="en">In this example, you have made some property
modifications to <filename>button.c</filename>, but in your
working copy you also have some unversioned files:
the latest <filename>calculator</filename> program
@@ -1289,7 +2252,7 @@
always results in the <filename>calculator</filename>
program being generated.
<footnote>
- <para>Isn't that the whole point of a build system?</para>
+ <para lang="en">Isn't that the whole point of a build system?</para>
</footnote>
And you know that your test suite always leaves those
debugging log files lying around. These facts are true for
@@ -1301,16 +2264,43 @@
example, you might add this as the new value of the
<literal>svn:ignore</literal> property:</para>
+ <para>In questo esempio, sono state effettuate alcune modifiche
+ alla proprietà <filename>button.c</filename>, ma nella propria copia di lavoro
+ ci sono anche alcuni file che non sono sotto controllo di versione:
+ l'ultimo programma <filename>calculator</filename>
+ che è stato compilato dal codice sorgente,un file sorgente chiamato
+ <filename>data.c</filename>,e un insieme di file di log con l'output del debug.
+ Ora, si sa che il sistema costruito
+ risulta sempre nel programma che è stato generato <filename>calculator</filename>.
+
+ <footnote>
+ <para>Non è l'intero punto della costruzione di un sistema?</para>
+ </footnote>
+ E si sa che la piattaforma di test lascia sempre questi file di log
+ in giro. Questo è vero per ciascuna copia di lavoro,
+ non soltanto per la propria. E si sa che non si ha alcun interesse
+ nel vedere queste cose ogni volta che si esegue il comando
+ <command>svn status</command>. Così si usa il comando <command>svn
+ propedit svn:ignore calc</command> per aggiungere alcuni modelli da ignorare
+ alla directory <filename>calc</filename>. Ad esempio,
+ si può aggiungere questo come nuovo valore dalla proprietà
+ <literal>svn:ignore</literal>:</para>
+
<programlisting>
calculator
debug_log*
</programlisting>
- <para>After you've added this property, you will now have a
+ <para lang="en">After you've added this property, you will now have a
local property modification on the <filename>calc</filename>
directory. But notice what else is different about your
<command>svn status</command> output:</para>
+ <para>Dopo che si è aggiunta questa proprietà,si avrà una modifica
+ locale nella directory <filename>calc</filename>.
+ Ma si noti cos'altro è diverso rispetto all'output del comando
+ <command>svn status</command> :</para>
+
<screen>
$ svn status
M calc
@@ -1318,7 +2308,7 @@
? calc/data.c
</screen>
- <para>Now, all the cruft is missing from the output! Of
+ <para lang="en">Now, all the cruft is missing from the output! Of
course, those files are still in your working copy.
Subversion is simply not reminding you that they are present
and unversioned. And now with all the trivial noise removed
@@ -1326,9 +2316,22 @@
items—such as that source code file that you probably
forgot to add to version control.</para>
- <para>If you want to see the ignored files, you can pass the
+ <para>Ora, tutti i file di log mancano! Naturalmente,
+ questi file sono ancora nella propria copia di lavoro.
+ Subversion semplicemnte non mostra che essi sono presenti
+ e non sono sotot controllo di versione.
+ E ora che tutti questi disturbi di poco conto sono stati rimossi
+ dalla visualizzazione, si resta con
+ oggetti&mdash più interessanti;come il file sorgente che probabilmente
+ si è dimenticato di aggiungere al controllo di versione.</para>
+
+
+ <para lang="en">If you want to see the ignored files, you can pass the
<option>--no-ignore</option> option to Subversion:</para>
+ <para>Se si vogliono vedere i file ignorati, si può usare l'opzione
+ <option>--no-ignore</option> di Subversion:</para>
+
<screen>
$ svn status --no-ignore
M calc/button.c
@@ -1340,7 +2343,7 @@
I calc/debug_log.3.gz
</screen>
- <para>The list of patterns to ignore is also used by
+ <para lang="en">The list of patterns to ignore is also used by
<command>svn add</command> and <command>svn
import</command>. Both of these operations involve asking
Subversion to begin managing some set of files and
@@ -1349,13 +2352,31 @@
Subversion uses the ignore patterns to determine which files
should not be swept into the version control system as part
of a larger recursive addition or import operation.</para>
-
+
+ <para>La lista dei modelli da ignorare è usata anche dai comandi
+ <command>svn add</command> e <command>svn
+ import</command>. Entrambe queste operazioni implicano il richiedere a
+ Subversion di gestire alcuni insiemi di file e
+ directory. Piuttosto che costringere l'utente a scegliere quali file
+ devono essere messi sotto il controllo di versione,
+ Subversion usa i modelli da ignorare per determinare quali file
+ non devono essere messi sotto controllo di versione come parte
+ di un'operazione ricorsiva di aggiunta o di importazione.</para>
+
</sect3>
<sect3 id="svn.advanced.props.special.keywords">
- <title><literal>svn:keywords</literal></title>
+ <!-- <title><literal>svn:keywords</literal></title> -->
+ <title><literal>svn:parolechiave</literal></title>
+
+
+
+
+
+
- <para>Subversion has the ability to substitute
+
+ <para lang="en">Subversion has the ability to substitute
<firstterm>keywords</firstterm>—pieces of useful,
dynamic information about a versioned file—into the
contents of the file itself. Keywords generally describe
@@ -1367,7 +2388,19 @@
the data completely up-to-date. Left to human authors, the
information would inevitably grow stale.</para>
- <para>For example, say you have a document in which you would
+ <para>Subversion ha la capacità di sostituire le
+ <firstterm>parolechiave</firstterm>—informazione utile,
+ dinamica su file&mdash sotto controllo di versione;all'interno
+ del file stesso. Le parole chiave generalmente descrivono
+ informazioni sull'ultima volta che il file è stato modificato.
+ Poichè questa informazione cambia ad ogni istante il file cambia e, each time the
+ cosa più importante, solo
+ <emphasis>dopo</emphasis> che il file è cambiato,esso crea un disturbo
+ ad ogni processo eccetto al sistema sotto controllo di versione
+ per mantenere la data aggiornata. L'informazione diventa inevitabilmente
+ vecchia.</para>
+
+ <para lang="en">For example, say you have a document in which you would
like to display the last date on which it was modified. You
could burden every author of that document to, just before
committing their changes, also tweak the part of the
@@ -1381,88 +2414,170 @@
formatted as
<literal>$</literal><replaceable>KeywordName</replaceable><literal>$</literal>.</para>
- <para>All keywords are case-sensitive where they appear as
+ <para>Ad esempio, supponimao di avere un documento nel
+ quale si vuole visualizzare la data in cui è stato modificato.
+ Si potrebbe costringere ogni autore di quel documento a modificare
+ la parte di documento che descrive quando è stato modificato, subito prima
+ di effettuare il commit delle modifiche.
+ Ma prima o poi, qualcuno si dimenticherà di farlo.
+ Invece semplicemente si chiede a Subversion di effettuare la sostituzione
+ della chiave sulla
+ <literal>DataUltimaModifica</literal> . Si controlla dove la chiave
+ è inserita all'interno del documento mettendo
+ una <firstterm> ancora chiave</firstterm> nel punto desiderato del file.
+ Quest'ancora è semplicemente una stringa di testo
+ formattata in questo modo
+ <literal>$</literal><replaceable>Nome chiave</replaceable><literal>$</literal>.</para>
+
+
+ <para lang="en">All keywords are case-sensitive where they appear as
anchors in files: you must use the correct capitalization in
order for the keyword to be expanded. You should consider the
value of the <literal>svn:keywords</literal> property to be
case-sensitive too—certain keyword names will be recognized
regardless of case, but this behavior is deprecated.</para>
- <para>Subversion defines the list of keywords available for
- substitution. That list contains the following five keywords,
+ <para>Tutte le chiavi sono case-sensitive quando appaiono come ancore nei file:
+ bisogna usare la corretta scrittura in maiuscolo perchè
+ le chiavi possano essere diffuse.
+ Bisogna considerare il valore della proprietà
+ <literal>svn:keywords</literal> anch'essa
+ case-sensitive;alcuni nomi di chiavi vengono riconosciuti
+ indipendentemente dal carattere,ma questo comportamento è deprecato.</para>
+
+ <para lang="en">Subversion defines the list of keywords available for
+ substitution. That list contains the following five keywords,
some of which have aliases that you can also use:</para>
+ <para>Subversion definisce la lista di chiavi che possono essere sostituite.
+ Questa lista contiene le seguenti cinque chiavi,
+ alcune delle quali sono alias che si possono usare:</para>
+
<variablelist>
<varlistentry>
<term><literal>Date</literal></term>
<listitem>
- <para>This keyword describes the last time the file was
+ <para lang="en">This keyword describes the last time the file was
known to have been changed in the repository, and
looks something like <literal>$Date:
2002-07-22 21:42:37 -0700 (Mon, 22 Jul 2002)
$</literal>. It may also be specified as
<literal>LastChangedDate</literal>.</para>
+
+ <para>Questa chiave descrive l'ultima volta che il
+ file è stato modificato nel repository, e appare come
+ <literal>$Date:
+ 2002-07-22 21:42:37 -0700 (Mon, 22 Jul 2002)
+ $</literal>. Può anche essere specificata come
+ <literal>LastChangedDate</literal>.</para>
+
+
</listitem>
</varlistentry>
<varlistentry>
<term><literal>Revision</literal></term>
<listitem>
- <para>This keyword describes the last known revision in
+ <para lang="en">This keyword describes the last known revision in
which this file changed in the repository, and looks
- something like <literal>$Revision: 144 $</literal>.
+ something like <literal>$Revision: 144 $</literal>.
It may also be specified as
<literal>LastChangedRevision</literal> or
<literal>Rev</literal>.</para>
+
+ <para>Questa chiave descrive l'ultima revisione nella quale il
+ il file è stato modificato nel repository, e appare come
+ <literal>$Revision: 144 $</literal>.
+ Può essere anche specificata come
+ <literal>LastChangedRevision</literal> o
+ <literal>Rev</literal>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>Author</literal></term>
<listitem>
- <para>This keyword describes the last known user to
+ <para lang="en">This keyword describes the last known user to
change this file in the repository, and looks
- something like <literal>$Author: harry $</literal>.
- It may also be specified as
+ something like <literal>$Author: harry $</literal>.
+ It may also be specified as
+ <literal>LastChangedBy</literal>.</para>
+
+ <para>Questa chiave descrive l'ultimo utenete che ha
+ modificato il file nel repository, e appare come
+ <literal>$Author: harry $</literal>.
+ Può anche essere specificata come
<literal>LastChangedBy</literal>.</para>
+
</listitem>
</varlistentry>
<varlistentry>
<term><literal>HeadURL</literal></term>
<listitem>
- <para>This keyword describes the full URL to the latest
+ <para lang="en">This keyword describes the full URL to the latest
version of the file in the repository, and looks
something like <literal>$HeadURL:
http://svn.collab.net/repos/trunk/README $</literal>.
It may be abbreviated as
<literal>URL</literal>.</para>
+
+ <para>Questa chiave descrive la URL completa dell'ultima
+ versione del file nel repository,e appare come
+ <literal>$HeadURL:
+ http://svn.collab.net/repos/trunk/README $</literal>.
+ Può essere abbreviata come
+ <literal>URL</literal>.</para>
+
</listitem>
</varlistentry>
<varlistentry>
<term><literal>Id</literal></term>
<listitem>
- <para>This keyword is a compressed combination of the
+ <para lang="en">This keyword is a compressed combination of the
other keywords. Its substitution looks something like
<literal>$Id: calc.c 148 2002-07-28 21:30:43Z sally
$</literal>, and is interpreted to mean that the file
<filename>calc.c</filename> was last changed in revision
148 on the evening of July 28, 2002 by the user
<literal>sally</literal>.</para>
+
+ <para>questa chiave è una combinazione compressa delle altre.
+ La sua sostituzione appare come
+ <literal>$Id: calc.c 148 2002-07-28 21:30:43Z sally
+ $</literal>, e sta a significare che il file
+ <filename>calc.c</filename>è stato modificato l'ultima volta nella revisione
+ 148 la sera del 28 luglio 2002 dall'utente
+ <literal>sally</literal>.</para>
+
</listitem>
</varlistentry>
</variablelist>
- <para>Simply adding keyword anchor text to your file does
+
+ <para lang="en">Simply adding keyword anchor text to your file does
nothing special. Subversion will never attempt to perform
textual substitutions on your file contents unless
explicitly asked to do so. After all, you might be writing
a document
<footnote>
- <para>… or maybe even a section of a book …</para>
- </footnote>
+ <para lang="en">… or maybe even a section of a book …</para>
+ </footnote>
about how to use keywords, and you don't want Subversion to
substitute your beautiful examples of un-substituted keyword
anchors!</para>
- <para>To tell Subversion whether or not to substitute keywords
+
+ <para>Aggiungere semplicemente delle chiavi ancora ai propri file
+ non comporta niente di speciale. Subversion non provvederà mai
+ ad effettuare sostituzioni testuali sui contenuti di un file senza che sia
+ richiesto esplicitamente. Dopo tutto,si potrebbe aver scritto un documento
+
+ <footnote>
+ <para>…o anche la sezione di un libro …</para>
+ </footnote>
+ su come usare le chiavi, e certo non si vorrebbe che Subversion
+ sostituisse i propri esempi belli con le chiavi ancora!
+ </para>
+
+ <para lang="en">To tell Subversion whether or not to substitute keywords
on a particular file, we again turn to the property-related
subcommands. The <literal>svn:keywords</literal> property,
when set on a versioned file, controls which keywords will
@@ -1470,29 +2585,50 @@
list of the keyword names or aliases found in the previous
table.</para>
- <para>For example, say you have a versioned file named
+ <para>Per dire a Subversion se sostituire o meno le chiavi
+ di un particolare file, bisogna tornare sui sottocomandi collegati alle proprietà.
+ La proprietà <literal>svn:keywords</literal> ,
+ quando settata su un file sotto controllo di versione, controlla quali chiavi
+ dovranno essere sostituite su quel file. Il valore è una lista delimitata da spazi
+ di nomi di chiavi o alias trovati nella precedente tabella.
+ </para>
+
+ <para lang="en">For example, say you have a versioned file named
<filename>weather.txt</filename> that looks like
this:</para>
+ <para >Ad esempio, si supponga di avere un file sotto controllo di versione
+ chiamato <filename>weather.txt</filename> che ha questa forma:
+ </para>
+
+
+
+
<programlisting>
Here is the latest report from the front lines.
$LastChangedDate$
$Rev$
Cumulus clouds are appearing more frequently as summer approaches.
</programlisting>
-
- <para>With no <literal>svn:keywords</literal> property set on
+
+ <para lang="en">With no <literal>svn:keywords</literal> property set on
that file, Subversion will do nothing special. Now, let's
enable substitution of the
<literal>LastChangedDate</literal> keyword.</para>
+ <para>Senza la proprietà <literal>svn:keywords</literal> settata su quel file,
+ Subversionnon farà niente di speciale. Ora, si abiliti la
+ sostituzione della chiave
+ <literal>LastChangedDate</literal>.</para>
+
+
<screen>
$ svn propset svn:keywords "Date Author" weather.txt
property 'svn:keywords' set on 'weather.txt'
$
-</screen>
+</screen>
- <para>Now you have made a local property modification on the
+ <para lang="en">Now you have made a local property modification on the
<filename>weather.txt</filename> file. You will see no
changes to the file's contents (unless you made some of your
own prior to setting the property). Notice that the file
@@ -1503,10 +2639,26 @@
will not substitute keywords that are not present in the
<literal>svn:keywords</literal> property value.</para>
+ <para>A questo punto è stata fatta una modifica locale sul file
+ <filename>weather.txt</filename> . Non si vedranno cambiamenti
+ sui contenuti del file (a meno che non ne sia stato fatto qualcuno
+ prima per settare la proprietà). Si noti che il file
+ conteneva un ancora chiave per la chiave <literal>Rev</literal>,
+ non è ancora stata inclusa quella chiave nel valore settato alla proprietà.
+ Subversion ignorerà le richieste di sostituire chiavi
+ che non sono presenti nel file, e
+ non sostituirà chiavi che non sono presenti nel valore della proprietà
+ <literal>svn:keywords</literal>.</para>
+
<sidebar>
- <title>Keywords and Spurious Differences</title>
- <para>The user-visible result of keyword substitution might
+
+
+
+ <!-- <title>Keywords and Spurious Differences</title> -->
+ <title>Parole chiave e false differenze</title>
+
+ <para lang="en">The user-visible result of keyword substitution might
lead you to think that every version of a file with that
feature in use differs from the previous version in at
least the area where the keyword anchor was placed.
@@ -1520,9 +2672,24 @@
contain only the real modifications that users make to the
file.</para>
+
+ <para>Il risultato di una sostituione di una parola chiave visibile all'utente
+ potrebbe far pensare che ogni versione di un file con
+ quella caratteristica in uso si differenzi dalla versione precedente
+ almeno nell'area in cui è posta la parola chiave che fa da ancora.
+ Comunque, non è attualmente così. Subversion durante la ricerca
+ di modifiche locali <command>svn
+ diff</command>, e prima di trasmetterle
+ <command>svn commit</command>,
+ <quote>non sostituisce</quote> ogni parola chiave che è stata
+ sostituita in precedenza. Il risultato è che le versioni
+ di un file che sono memorizzate nel repository
+ contengono soltanto le modifiche reali che gli utenti fanno al file.
+ </para>
+
</sidebar>
- <para>Immediately after you commit this property change,
+ <para lang="en">Immediately after you commit this property change,
Subversion will update your working file with the new
substitute text. Instead of seeing your keyword anchor
<literal>$LastChangedDate$</literal>, you'll see its
@@ -1532,19 +2699,35 @@
<literal>Rev</literal> keyword was not substituted because
we didn't ask for it to be.</para>
- <para>Note also that we set the <literal>svn:keywords</literal>
+ <para>Subito dopo il commit questa propretà cambia,
+ Subversion aggiornerà il file di lavoro con il nuovo testo.
+ Invece di vedere la propria parola chiave ancora,
+ <literal>$LastChangedDate$</literal>, si vedrà la sua sostituzione.
+ Questo risultato contiene anche il nome della chiave,
+ e continua ad essere delimitata dal simbolo del dollaro
+ (<literal>$</literal>) . Come è stato predetto, la chiave
+ <literal>Rev</literal> non è stata sostituita perchè non è stato richiesto espressamente
+ di farlo.</para>
+
+
+ <para lang="en">Note also that we set the <literal>svn:keywords</literal>
property to <quote>Date Author</quote> yet the keyword
anchor used the alias <literal>$LastChangedDate$</literal>
and still expanded correctly.</para>
+ <para>Si noti anche che la proprietà <literal>svn:keywords</literal>
+ è stata settata a <quote>Date Author</quote> la chiave ancora
+ usa l'alias <literal>$LastChangedDate$</literal>
+ ed è ancora ampliata correttamente.</para>
+
<screen>
Here is the latest report from the front lines.
$LastChangedDate: 2002-07-22 21:42:37 -0700 (Mon, 22 Jul 2002) $
$Rev$
Cumulus clouds are appearing more frequently as summer approaches.
</screen>
-
- <para>If someone else now commits a change to
+
+ <para lang="en">If someone else now commits a change to
<filename>weather.txt</filename>, your copy of that file
will continue to display the same substituted keyword value
as before—until you update your working copy. At that
@@ -1552,7 +2735,15 @@
file will be re-substituted with information that
reflects the most recent known commit to that file.</para>
- <para>Subversion 1.2 introduced a new variant of the keyword
+ <para>Se qualcun altro adesso fa il commit di una modifica al file
+ <filename>weather.txt</filename>, la propria copia del file
+ continuerà a mostrare gli stessi valoridelle chiavi sostituite
+ come prima—finchè non si aggiorna la propria copia. In quel momento
+ la chiave nella propria copia del file <filename>weather.txt</filename>
+ verrà risostiutita con informazioni che riflettono il commit
+ più recente conosciuto per quel file.</para>
+
+ <para lang="en">Subversion 1.2 introduced a new variant of the keyword
syntax which brought additional, useful—though perhaps
atypical—functionality. You can now tell Subversion
to maintain a fixed length (in terms of the number of bytes
@@ -1569,29 +2760,57 @@
special hash (<literal>#</literal>) character just before
the final dollar sign terminator.</para>
- <para>For example, say you have a document in which you have
+
+ <para>Subversion 1.2 ha introdotto una nuova variante della sintassi
+ delle chiavi che apporta funzionalità aggiuntive, utili—anche se forse
+ atipiche&mdash. Adesso si può dire a Subversion
+ di mantenere una lunghezza fissata(in termini di numero di byte
+ usati) per le chiavi sostiutite. Usando una coppia di due punti
+ (<literal>::</literal>) dopo il nome della chiave,
+ seguita da un numero di spazi, si definisce la dimensione
+ fissata. Quando Subversion va a sostituire la propria chiave
+ con la chiave e il suo valore, essenzialmente sostituisce solo
+ questi spazi, lasciando complessivamente invariata la
+ la dimensione del campo. Se il valore sostituito è più corto ,
+ saranno aggiunti caratteri di riempimento (spazi) alla fine
+ del campo sostituito; se è troppo lungo, sarà troncato con un carattere speciale
+ (<literal>#</literal>) prima del simbolo di dollaro di chiusura.
+ </para>
+
+ <para lang="en">For example, say you have a document in which you have
some section of tabular data reflecting the document's
Subversion keywords. Using the original Subversion keyword
substitution syntax, your file might look something
like:</para>
+ <para>Ad esempio, si supponga di avere un documento nel quale
+ si ha una sezione di dati tabulare che riflette le chiavi di
+ Subversion . Usando la sintassi originale di sostituzione della
+ chiave di Subversion , il file assume questo aspetto:
+ </para>
+
+
<screen>
$Rev$: Revision of last commit
$Author$: Author of last commit
$Date$: Date of last commit
</screen>
- <para>Now, that looks nice and tabular at the start of things.
+ <para lang="en">Now, that looks nice and tabular at the start of things.
But when you then commit that file (with keyword substitution
enabled, of course), you see:</para>
+ <para>Adesso, sembra bello e tabulare .
+ Ma quando si fa il commit del file (naturalmente con la sostituzione
+ della chiave abilitata), si vedrà:</para>
+
<screen>
$Rev: 12 $: Revision of last commit
$Author: harry $: Author of last commit
$Date: 2006-03-15 02:33:03 -0500 (Wed, 15 Mar 2006) $: Date of last commit
</screen>
- <para>The result is not so beautiful. And you might be
+ <para lang="en">The result is not so beautiful. And you might be
tempted to then adjust the file after the substitution so
that it again looks tabular. But that only holds as long as
the keyword values are the same width. If the last
@@ -1602,13 +2821,27 @@
fixed-length keyword syntax, define some field widths that
seem sane, and now your file might look like this:</para>
+ <para>Questo risultato non è così bello. E si potrebbe essere
+ tentati ad aggiustare il file dopo la sostituzione cosicchè
+ torni ad essere tabulare. Ma questo vale soltanto se
+ i valori delle chiavi hanno la stessa dimensione.
+ Se l'ultima revisione di cui si è fatto il commit
+ si sposta in un nuovo valore (ad esempio, da
+ 99 a 100), o un'altra persona con uno username più lungo
+ fa il commit del file, le cose si mettono male nuovamente.
+ Comunque, se si sta usando Subversion 1.2 o più avanzate, si può usare
+ la sintassi dei valori di lunghezza fissata, definire alcune dimensioni di campi
+ che sembrino giusti, e a questo punto il file avrà questo aspetto:</para>
+
<screen>
$Rev:: $: Revision of last commit
$Author:: $: Author of last commit
$Date:: $: Date of last commit
</screen>
- <para>You commit this change to your file. This time,
+
+
+ <para lang="en">You commit this change to your file. This time,
Subversion notices the new fixed-length keyword syntax, and
maintains the width of the fields as defined by the padding
you placed between the double-colon and the trailing dollar
@@ -1618,21 +2851,39 @@
padded with spaces, and the long <literal>Date</literal>
field is truncated by a hash character:</para>
+ <para>Si fa il commit di questa modifica sul proprio file.Questa volta,
+ Subversion si accorge della nuova sintassi della chiave che fissa la lunghezza,
+ e mantiene la larghezza dei campi com'è definita dal rivestimento inserito
+ tra la colonna doppia e il simbolo del dollaro.
+ Dopo la sostituzione, la larghezza dei campi è completamente
+ invariata—i valori brevi per
+ <literal>Rev</literal> e <literal>Author</literal> sono
+ imbottiti con spazi, e il campo della <literal>Date</literal>
+ è troncato da un carattere hash :</para>
+
<screen>
$Rev:: 13 $: Revision of last commit
$Author:: harry $: Author of last commit
$Date:: 2006-03-15 0#$: Date of last commit
</screen>
-
- <para>The use of fixed-length keywords is especially handy
+
+ <para lang="en">The use of fixed-length keywords is especially handy
when performing substitutions into complex file formats that
themselves use fixed-length fields for data, or for which
the stored size of a given data field is overbearingly
difficult to modify from outside the format's native
application (such as for Microsoft Office documents).</para>
+
+ <para>L'uso delle chiavi di lunghezza fissata è molto pratico soprattutto
+ quando si effettuano sostituzioni in un file complesso che già usa
+ campi di lunghezza fissata per i dati, o per il quale
+ la dimensione per la memorizzazione di un dato è difficile da
+ modificare dall'esterno dell'applicazione
+ (come ad esempio per i documenti Microsoft Office ).</para>
+
<warning>
- <para>Be aware that because the width of a keyword field is
+ <para lang="en">Be aware that because the width of a keyword field is
measured in bytes, the potential for corruption of
multi-byte values exists. For example, a username which
contains some multi-byte UTF-8 characters might suffer
@@ -1644,22 +2895,45 @@
that certain applications, when asked to load the file,
would notice the broken UTF-8 text and deem the entire
file corrupt, refusing to operate on the file
- altogether.</para>
+ altogether.</para>
+
+ <para>Bisogna prestare attenzione a questa cosa poichè
+ lalarghezza di un campo chiave è misurata in bytes,
+ e quindi esiste la possibilità di corruzione per i valori
+ multi-byte. Ad esempio, uno username che contiene
+ alcuni caratteri multi-byte UTF-8 potrebbe risentire dell'interruzione
+ nel mezzo di una stringa di bytes quale quella fatta da uno di
+ questi caratteri. Il risultato sarà uno spezzamento
+ visto a livello di byte, ma apparirà come una stringa
+ con un carattere finale errato o alterato quando si guarda il testo
+ UTF-8. E' immaginabile che certe applicazioni,
+ quando si chiede di caricare il file,
+ notano il testo UTF-8 rotto e considerano corrotto l'intero file,
+ rifiutando completamente di operare su quel file.</para>
</warning>
</sect3>
<sect3 id="svn.advanced.props.special.eol-style">
- <title><literal>svn:eol-style</literal></title>
+ <!--<title><literal>svn:eol-style</literal></title> -->
+ <title><literal>svn:eol-stile</literal></title>
- <para>Unless otherwise noted using a versioned file's
+ <para lang="en">Unless otherwise noted using a versioned file's
<literal>svn:mime-type</literal> property, Subversion
assumes the file contains human-readable data. Generally
speaking, Subversion only uses this knowledge to determine
if contextual difference reports for that file are
possible. Otherwise, to Subversion, bytes are bytes.</para>
-
- <para>This means that by default, Subversion doesn't pay any
+
+
+ <para>Se non diversamente notato usando la proprietà
+ <literal>svn:mime-type</literal>di un file sotto versione, Subversion
+ assume che il file contiene dati leggibili dall'uomo. Parlando
+ in generale, Subversion usa questa conoscenza per determinare
+ se per quel file sono possibili differenze contestuali.
+ In caso contrario, per Subversion, bytes sono bytes.</para>
+
+ <para lang="en">This means that by default, Subversion doesn't pay any
attention to the type of <firstterm>end-of-line (EOL)
markers</firstterm> used in your files. Unfortunately,
different operating systems use different tokens to represent
@@ -1671,7 +2945,19 @@
the <literal>LF</literal> character to denote the end of a
line.</para>
- <para>Not all of the various tools on these operating systems
+ <para>Questo significa che di default, Subversion non presta
+ nessuna attenzione al tipo di marcatori <firstterm>end-of-line (EOL)
+ </firstterm> usati nei propri file. Sfortunamente,
+ diversi sistemi operativi usano diversi segni per rappresentare
+ la fine di una linea del testo in un file.Ad esempio, il segno di fine linea
+ di solito usato dal software della piattaforma Windows
+ è una coppia di caratteri&mdash di controllo ASCII ; il tasto return
+ (<literal>CR</literal>) e
+ (<literal>LF</literal>). I software Unix, tuttavia, usano soltanto
+ il carattere <literal>LF</literal> per indicare la fine della linea.
+ </para>
+
+ <para lang="en">Not all of the various tools on these operating systems
are prepared to understand files that contain line endings
in a format that differs from the <firstterm>native line
ending style</firstterm> of the operating system on which
@@ -1684,7 +2970,19 @@
character combination was found to denote the end of
line.</para>
- <para>This sensitivity to foreign EOL markers can become
+ <para>Non tutti i varo tool di questi sistemi operativi
+ sono preparati a capire file che contengono indicatori di fine di linea
+ in un formato che differisce dallo <firstterm>stile nativo di fine linea
+ </firstterm> del sistema operativo sul quale vengono eseguiti.
+ Risultati comuni sono che i programmi Unix
+ trattano il carattere <literal>CR</literal> presente nei file Windows
+ come un carattere regolare (di solito trattato come
+ <literal>^M</literal>), e che i programmi Windows combinano
+ tutte le linee di un file Unixin una sola gigante linea perchè
+ non ci sono caratteri di fine linea ( <literal>CRLF</literal>).
+ </para>
+
+ <para lang="en">This sensitivity to foreign EOL markers can become
frustrating for folks who share a file across different
operating systems. For example, consider a source code
file, and developers that edit this file on both Windows and
@@ -1692,7 +2990,15 @@
preserve the line ending style of the file, no problems
occur.</para>
- <para>But in practice, many common tools either fail to
+ <para>Questa sensibilità ai marcatori esterni di EOL può
+ diventare frustrante per persone che condividono un file su diversi
+ sistemi operativi. Ad esempio, si consideri un file di codice sorgente,
+ e gli sviluppatori che modificano questo file su entrmbi i sistemi Windows e
+ Unix . Se tutti gli sviluppatori usano sempre tool che conservano lo stile di
+ fine linea del file, non si genera nessun problema.
+ </para>
+
+ <para lang="en">But in practice, many common tools either fail to
properly read a file with foreign EOL markers, or they
convert the file's line endings to the native style when the
file is saved. If the former is true for a developer, he
@@ -1708,7 +3014,24 @@
Or, he can simply commit the file—new EOL markers and
all.</para>
- <para>The result of scenarios like these include wasted time
+
+ <para>Ma in pratica, i più comuni tool o falliscono nel leggere
+ un file con marcatori EOL esterni, o convertono
+ la fine della linea nello stile nativo quando il file è salvato.
+ Se il primo è vero per uno sviluppatore, egli
+ dovrà usare una conversione esterna (come
+ <command>dos2unix</command> o il suo compagno,
+ <command>unix2dos</command>) per preparare il file per la modifica.
+ Il secondo caso non richiede preparazione extra.
+ Ma in entrambi i casi il risultato è un file che differisce dall'originale
+ molto letteralmente su ogni linea! Prima di committare
+ le proprie modifiche, l'utente ha due scelte. Può usare una conversione
+ per reintegrare il file modificato con lo stesso stile di eol
+ che aveva prima che egli facesse le sue modifiche.
+ Oppure, può semplicemente committare il file—nuovi marcatori EOL e tutto.
+ </para>
+
+ <para lang="en">The result of scenarios like these include wasted time
and unnecessary modifications to committed files. Wasted
time is painful enough. But when commits change every line
in a file, this complicates the job of determining which of
@@ -1716,7 +3039,17 @@
that bug really fixed? On what line was a syntax error
introduced?</para>
- <para>The solution to this problem is the
+ <para>Il risultato di scenari come questi include perdita di tempo
+ e modifiche non necessaria per committare i file.
+ Già la perdita di tempo è abbastanza dolorosa.
+ Ma quando si fa il commit di modifiche su ogni linea del file,
+ questo complica il lavoro per determinare quale di quelle linee
+ sono state modificate in modo non significativo. Dov'è
+ realmente fissato il bug ?
+ Su quale linea c'è un errore di sintassi?
+ </para>
+
+ <para lang="en">The solution to this problem is the
<literal>svn:eol-style</literal> property. When this
property is set to a valid value, Subversion uses it to
determine what special processing to perform on the file so
@@ -1724,11 +3057,19 @@
every commit that comes from a different operating
system. The valid values are:</para>
+ <para>La soluzione a questo problema è la proprietà
+ <literal>svn:eol-style</literal>.Quando questa proprietà è settata
+ ad un valore valido, Subversion la usa per determinare
+ quale lvorazione speciale deve essere fatta sul file per
+ fare in modo che lo stile di fine linea del file non oscilli
+ con ogni commit che viene fatto da un diverso sistema operativo.
+ I valori validi sono:</para>
+
<variablelist>
<varlistentry>
<term><literal>native</literal></term>
<listitem>
- <para>This causes the file to contain the EOL markers
+ <para lang="en">This causes the file to contain the EOL markers
that are native to the operating system on which
Subversion was run. In other words, if a user on a
Windows machine checks out a working copy that
@@ -1740,17 +3081,36 @@
file will see <literal>LF</literal> EOL markers in his
copy of the file.</para>
- <para>Note that Subversion will actually store the file
+ <para>Questo valore fa in modo che il file contiene i marcatori EOL
+ che sono nativi del sistema operativo sul quale viene eseguito.
+ In altre parole,se un utente su una macchina
+ Windows fa il check out di una copia di lavoro che contiene
+ un file con uan proprietà
+ <literal>svn:eol-style</literal> settata a
+ <literal>native</literal>, quel file conterrà
+ <literal>CRLF</literal> come marcatori di EOL. Un utente Unix
+ che fa il check out di una copia di lavoro che contiene lo stesso file
+ vedrà i marcatori di EOL <literal>LF</literal> EOL nella sua copia del
+ file.</para>
+
+ <para lang="en">Note that Subversion will actually store the file
in the repository using normalized
<literal>LF</literal> EOL markers regardless of the
operating system. This is basically transparent to
the user, though.</para>
+
+ <para>Si noti che Subversion memorizzerò attualemnte il file
+ nel repository usando i marcatori di EOL
+ <literal>LF</literal> indipendentemente dal sistema operativo.
+ Sebbene questo sia trasparente per l'utente.
+ </para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>CRLF</literal></term>
<listitem>
- <para>This causes the file to contain
+
+ <para lang="en">This causes the file to contain
<literal>CRLF</literal> sequences for EOL markers,
regardless of the operating system in use.</para>
</listitem>
@@ -1758,41 +3118,54 @@
<varlistentry>
<term><literal>LF</literal></term>
<listitem>
- <para>This causes the file to contain
- <literal>LF</literal> characters for EOL markers,
- regardless of the operating system in use.</para>
+ <para>Questo valore fa in modo che il file contenga i caratteri
+ <literal>LF</literal> come marcatori di EOL,
+ indipendentemente dal sistema operativo in uso.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>CR</literal></term>
<listitem>
- <para>This causes the file to contain
+ <para lang="en">This causes the file to contain
<literal>CR</literal> characters for EOL markers,
regardless of the operating system in use. This line
ending style is not very common. It was used on older
Macintosh platforms (on which Subversion doesn't even
run).</para>
+ <para>Questo valore fa in modo che il file contenga i caratteri
+ <literal>CR</literal> come marcatori di EOL,
+ indipendentemente dal sistema operativo in uso. Questo stile
+ di fine linea non è molto comune. E' usato sulle vecchie piattaforme
+ Macintosh (sulle quali Subversion non gira ancora).
+ </para>
</listitem>
</varlistentry>
</variablelist>
-
+
</sect3>
<sect3 id="svn.advanced.props.special.externals">
<title><literal>svn:externals</literal></title>
- <para>The <literal>svn:externals</literal> property contains
+ <para lang="en">The <literal>svn:externals</literal> property contains
instructions for Subversion to populate a versioned
directory with one or more other checked-out Subversion
working copies. For more information on this keyword and
its use, see <xref linkend="svn.advanced.externals"/>.</para>
+ <para>La proprietà <literal>svn:externals</literal> contiene
+ istruzioni per far popolare da Subversion to populate una
+ directory sotto controllo di versione con una o più copie di lavoro
+ di cui si è fatto il check-out.
+ Per maggiori informazioni su questa chiave e il suo uso,
+ si veda <xref linkend="svn.advanced.externals"/>.</para>
+
</sect3>
<sect3 id="svn.advanced.props.special.special">
<title><literal>svn:special</literal></title>
- <para>The <literal>svn:special</literal> property is the only
+ <para lang="en">The <literal>svn:special</literal> property is the only
<literal>svn:</literal> property that isn't meant to be
directly set or modified by users. Subversion automatically
sets this property whenever a <quote>special</quote> object
@@ -1807,17 +3180,40 @@
types of nodes will probably use this property as
well.</para>
- <para>Note: Windows clients don't have symbolic links, and
+ <para>La proprietà <literal>svn:special</literal>è l'unica
+ proprietà <literal>svn:</literal> che non può essere direttamente
+ settata o modificata dagli utenti. Subversion setta automaticamente
+ questa proprietà ogni volta che si vuole aggiungere
+ un oggetto <quote>speciale</quote>,
+ come ad esempio, un link simbolico. Il
+ repository immagazzina un oggetto<literal>svn:special</literal>
+ come un file ordinario. Comunque, quando un client vede questa proprietà
+ durante il check out per l'aggiornamento, esso interpreta il contenuto del
+ file e riporta l'oggetto nel suo tipo speciale.
+ Nelle versioni di Subversion che ci sono al momento in cui si sta scrivendo,
+ soltanto i colelgamenti simbolici sotto controllo di versione hanno allegata questa proprietà,
+ ma in futuro, nelle nuove versioni di Subversion, altri speciali
+ tipi di nodi probabilmente useranno questa proprietà altrettanto bene.
+ </para>
+
+
+ <para lang="en">Note: Windows clients don't have symbolic links, and
thus ignore any <literal>svn:special</literal> files coming
from a repository that claim to be symbolic links. On
Windows, the user ends up with an ordinary versioned file in
the working copy.</para>
+
+ <para>Nota: i client Windows non hanno collegamenti simbolici, and
+ perciò ignorano tutti i file <literal>svn:special</literal> che vengono
+ da un repository e che pretendono di essere collegamenti simbolici. Su
+ Windows, l'utente finisce con un file ordinario sotto controllo di versione
+ nella cartella di lavoro.</para>
</sect3>
<sect3 id="svn.advanced.props.special.needs-lock">
<title><literal>svn:needs-lock</literal></title>
- <para>This property is used to signify that the file it's
+ <para lang="en">This property is used to signify that the file it's
attached to ought to be locked before editing. The value of
the property is irrelevant; Subversion will normalize its
value to <literal>*</literal>. When present, the file will
@@ -1827,19 +3223,34 @@
file becomes read-write. When the lock is released, the
file becomes read-only again.</para>
- <para>To learn more about how, when, and why this property
+ <para>Questa proprietà è usata per indicare che il file a cui è allegata
+ è bloccato prima della modifica. Il valore della proprietà
+ è irrilevante; Subversion normalizzerà il suo valore a
+ <literal>*</literal>. Se presente, il file sarà di sola lettura
+ <emphasis>a meno che</emphasis> l'utente non abbia esplicitamente
+ bloccato il file. Se è presente un simbolo di blocco
+ (come sirultato di un comando <command>svn lock</command>), il
+ file diventa leggibile e scrivibile. Quando il blocco viene tolto, il
+ file diventa di nuovo di sola lettura.</para>
+
+ <para lang="en">To learn more about how, when, and why this property
should be used, see
<xref
linkend="svn.advanced.locking.lock-communication"/>.</para>
+
+ <para>Per saperne di più su come, quando e perchè questa proprietà dovrebbe
+ essere usata, si veda <xref linkend="svn.advanced.locking.lock-communication"/>.</para>
</sect3>
</sect2>
- <!-- =============================================================== -->
+
+
<sect2 id="svn.advanced.props.auto">
- <title>Automatic Property Setting</title>
+ <!--<title>Automatic Property Setting</title>-->
+ <title>Settaggio automatico delle proprietà</title>
- <para>Properties are a powerful feature of Subversion, acting as
+ <para lang="en">Properties are a powerful feature of Subversion, acting as
key components of many Subversion features discussed elsewhere
in this and other chapters—textual diff and merge
support, keyword substitution, newline translation, etc. But
@@ -1852,7 +3263,21 @@
applied to the places that need them, Subversion provides a
couple of simple but useful features.</para>
- <para>Whenever you introduce a file to version control using the
+ <para>Le proprietà sono una caratteristica di Subversion potente, agendo
+ come componenti chiave di molte caratteristiche di Subversion discusse altrove
+ in questo e altri capitoli—differenze testuali e supporto per il merge,
+ sostituzioni di chiavi, spostamento di nuove linee, etc. Ma
+ per ottenere tutti i benefici possibili dalle proprietà, queste
+ devono essere settate nei giusti file e directory.
+ Sfortunatamente, questo può essere un passo facile da dimenticare
+ nella routine delle cose, specialmente perchè l'errato settaggio
+ di una proprietà non risulta di solito in un errore ovvio
+ (almeno se confrontato con un errore di aggiunta di un file al controllo di versione).
+ Per aiutare l'utente ad applicare le proprietà nel posto giusto,
+ Subversion fornisce un paio di semplici ma molto utili caratteristiche.
+ </para>
+
+ <para lang="en">Whenever you introduce a file to version control using the
<command>svn add</command> or <command>svn import</command>
commands, Subversion runs a very basic heuristic to determine
if that file consists of human-readable or non-human-readable
@@ -1867,7 +3292,25 @@
<literal>application/x-shockwave-flash</literal>—you can
always remove or edit that property.</para>
- <para>Subversion also provides the auto-props feature, which
+
+ <para>Ogni volta che si introduce un file sotto il controllo
+ di versione utilizzando i comandi
+ <command>svn add</command> o <command>svn import</command>,
+ Subversion esegue un metodo euristico per determinare
+ se il contenuto di quel file è leggibile per l'uomo
+ oppure noo.
+ A seconda del risultato, Subversion setterà
+ automaticamente la proprietà <literal>svn:mime-type</literal>
+ su quel file a
+ <literal>application/octet-stream</literal> (genericamente
+ <quote>questa è una collezione di bytes</quote> MIME type).
+ Naturalmente, se Subversion sbaglia l'interpretazione, o se si vuole
+ settare la proprietà <literal>svn:mime-type</literal> a qualcosa
+ di più preciso—magari <literal>image/png</literal> o
+ <literal>application/x-shockwave-flash</literal>—si può sempre rimuovere
+ o modificare quella proprietà.</para>
+
+ <para lang="en">Subversion also provides the auto-props feature, which
allows you to create mappings of filename patterns to property
names and values. These mappings are made in your runtime
configuration area. They again affect adds and imports, and
@@ -1887,16 +3330,40 @@
See <xref linkend="svn.advanced.confarea.opts.config"/> for more about
configuring that support.</para>
- </sect2>
+ <para>Subversion fornisce inoltre comportamneti auto-props, che
+ permettono di creare una mappatura dei nomi e dei valori delle proprietà.
+ Queste mappature vengono fatte nell'area di configurazione a
+ runtime. Influenzano le operazioni di aggiunta e di import, e
+ non solo possono sovrascrivere qualsiasi tipo di decisione di default di MIME type presa
+ da Subversion durante queste operazioni, ma possono anche settare o customizzare
+ proprietà addizionali di Subversion. Ad esempio,
+ si può creare una mappatura che dice che ogni volta che si aggiunge
+ un JPEG file—tutti quelli che trovano riscontro nello schema
+ <literal>*.jpg</literal>—Subversion setterà automaticamente
+ la proprietà <literal>svn:mime-type</literal> su quei file a
+ <literal>image/jpeg</literal>. o magari alcuni file che
+ hanno <literal>*.cpp</literal> potrebbero avere
+ <literal>svn:eol-style</literal> settato a
+ <literal>native</literal>, e <literal>svn:keywords</literal>
+ settato a <literal>Id</literal>. Il supporto auto-prop è forse
+ la proprietà più pratica collegata ad uno strumento all'interno della scatola
+ degli strumenti di Subversion .
+ Si veda <xref linkend="svn.advanced.confarea.opts.config"/> per maggiori dettagli
+ sulla configurazione di questo supporto.</para>
+
+ </sect2>
</sect1>
- <!-- ================================================================= -->
- <!-- ================================================================= -->
- <!-- ================================================================= -->
+ <!-- =============================================================== -->
+ <!-- =============================================================== -->
+ <!-- =============================================================== -->
+ <!-- =============================================================== -->
+ <!-- =============================================================== -->
+ <!-- =============================================================== -->
<sect1 id="svn.advanced.locking">
<title>Locking</title>
- <para>Subversion's <quote>copy-modify-merge</quote> model is
+ <para lang="en">Subversion's <quote>copy-modify-merge</quote> model is
optimal when users are collaborating on projects that consist of
line-based text files, such as program source code. However, as
discussed in <xref
@@ -1909,16 +3376,31 @@
<firstterm>locking</firstterm>, often known as <quote>reserved
checkouts</quote> in other version control systems.</para>
- <para>Subversion's locking feature has two main goals:</para>
+
+ <para>Il modello di Subversion<quote>copia-modifica-merge</quote> è ottimale
+ quando gli utenti collaborano a progetti che sono costituiti
+ da file basati su linee di testo, come un programma di codice sorgente.
+ Comunque, come si è discusso in <xref
+ linkend="svn.basic.vsn-models.copy-merge.sb-1"/>, a volte
+ bisogna usare il modello <quote>blocco-modifica-sblocco</quote> al posto
+ del modello concorrente standard di Subversion. Quando un file
+ contiene dati binari, è spesso difficile o impossibile fare il merge di
+ due insiemi di modifiche fatte in paralleloda diversi utenti.Per questa ragione,
+ Subversion 1.2 e successive offre una funzionalità conosciuta come
+ <firstterm>locking</firstterm>, spesso nota come <quote>
+ checkout riservato</quote> in altri sistemi di controllo di versione.</para>
+
+ <para lang="en">Subversion's locking feature has two main goals:</para>
+ <para>La caratteristica locking di Subversionha due obiettivi principali:</para>
<itemizedlist>
- <listitem><para><emphasis>Serializing access to a
+ <listitem><para lang="en"><emphasis>Serializing access to a
resource</emphasis>. Allow a user to grab an exclusive
right to change to a file in the repository. If Harry
reserves the right to change <filename>foo.jpg</filename>,
then Sally should not be able to commit a change to it.</para>
</listitem>
- <listitem><para><emphasis>Aiding communication</emphasis>.
+ <listitem><para lang="en"><emphasis>Aiding communication</emphasis>.
Prevent users from wasting time on unmergeable changes. If
Harry has reserved the right to change
<filename>foo.jpg</filename>, then it should be easy for
@@ -1927,6 +3409,21 @@
</listitem>
</itemizedlist>
+
+ <listitem><para><emphasis>Serializing access to a
+ resource</emphasis>. Allow a user to grab an exclusive
+ right to change to a file in the repository. If Harry
+ reserves the right to change <filename>foo.jpg</filename>,
+ then Sally should not be able to commit a change to it.</para>
+ </listitem>
+ <listitem><para><emphasis>Aiding communication</emphasis>.
+ Prevent users from wasting time on unmergeable changes. If
+ Harry has reserved the right to change
+ <filename>foo.jpg</filename>, then it should be easy for
+ Sally to notice this fact and avoid working on the
+ file.</para>
+ </listitem>
+ </itemizedlist>
<para>Subversion's locking feature is currently limited to files
only—it's not yet possible to reserve access to a whole
directory tree.</para>
@@ -1974,7 +3471,7 @@
<!-- =============================================================== -->
<sect2 id="svn.advanced.locking.creation">
<title>Creating locks</title>
-
+
<para>In the Subversion repository, a
<firstterm>lock</firstterm> is a piece of metadata which
grants exclusive access to one user to change a file. This
@@ -1986,7 +3483,7 @@
commit transaction attempts to modify or delete the file (or
delete a parent of the file), the repository will demand two
pieces of information:</para>
-
+
<orderedlist>
<listitem><para><emphasis role="bold">User
authentication</emphasis>. The client performing the commit
@@ -1998,7 +3495,7 @@
exactly which lock it's using.</para>
</listitem>
</orderedlist>
-
+
<para>An example is in order, to demonstrate. Let's say that
Harry has decided to change a JPEG image. To prevent other
people from committing changes to the file, he locks the file
@@ -2267,7 +3764,7 @@
UUID Token: opaquelocktoken:c32b4d88-e8fb-2310-abb3-153ff1236923
Owner: frank
Created: 2005-06-15 13:29:18 -0500 (Wed, 15 Jun 2005)
-Expires:
+Expires:
Comment (1 line):
Still improving the yellow color.
@@ -2275,7 +3772,7 @@
UUID Token: opaquelocktoken:fc2b4dee-98f9-0310-abf3-653ff3226e6b
Owner: harry
Created: 2005-02-16 13:29:18 -0500 (Wed, 16 Feb 2005)
-Expires:
+Expires:
Comment (1 line):
Need to make a quick tweak to this image.
@@ -2321,7 +3818,7 @@
passes <option>--force</option>, the authentication and
authorization requirements are ignored, and the remote lock is
broken.</para>
-
+
<para>Of course, simply breaking a lock may not be enough. In
the running example, Sally may not only want to break Harry's
long-forgotten lock, but re-lock the file for her own use.
@@ -2380,7 +3877,7 @@
<sidebar>
<title>Locking Policies</title>
-
+
<para>Different systems have different notions of how strict
a lock should be. Some folks argue that locks must be
strictly enforced at all costs, releasable only by the
@@ -2433,7 +3930,7 @@
Regardless, her changes aren't mergeable with Harry's. One of
these two people has to throw away their work, and a lot of
time has been wasted.</para>
-
+
<para>Subversion's solution to this problem is provide a
mechanism to remind users that a file ought to be locked
<emphasis>before</emphasis> the editing begins.</para>
@@ -2446,7 +3943,7 @@
the lock is released—either explicitly unlocked, or
released via commit—the file returns to read-only
again.</para>
-
+
<para>The theory, then, is that if the image file has this
property attached, then Sally would immediately notice
something is strange when she opens the file for editing. Her
@@ -2563,7 +4060,7 @@
Frabnaggilywort releases a 1.0 version, and is downloaded and
used daily by hordes of people aiming to improve their
lives.</para>
-
+
<para>It's a nice story, really, but it doesn't end there.
Entrepreneur that you are, you've already got another think in
the tank. So you make a new directory,
@@ -2625,18 +4122,18 @@
<sidebar>
<title>The "peg-revision" algorithm</title>
-
+
<para>When the commandline client sees a command of the
form:</para>
<screen>
$ svn <replaceable>command</replaceable> -r <replaceable>OPERATIVE-REV</replaceable> item@<replaceable>PEG-REV</replaceable>
</screen>
-
+
<para>...it performs the following algorithm:</para>
<itemizedlist>
-
+
<listitem>
<para>Go to revision <replaceable>PEG-REV</replaceable>, and
find <replaceable>item</replaceable>. This locates a unique
@@ -2660,7 +4157,7 @@
<para>Remember that even when you don't explicitly supply a
peg-revision, it's still present. It defaults to BASE for
working copy items, and to HEAD for URLs.</para>
-
+
</sidebar>
<para>Say that long ago we created our repository, and in revision 1
@@ -2686,7 +4183,7 @@
revision, you run:</para>
<screen>
-$ svn cat -r 1 concept/IDEA
+$ svn cat -r 1 concept/IDEA
subversion/libsvn_client/ra.c:775: (apr_err=20014)
svn: Unable to find repository location for 'concept/IDEA' in revision 1
</screen>
@@ -2784,7 +4281,7 @@
<!-- ================================================================= -->
<sect1 id="svn.advanced.externals">
<title>Externals Definitions</title>
-
+
<para>Sometimes it is useful to construct a working copy that is
made out of a number of different checkouts. For example, you
may want different subdirectories to come from different
@@ -2804,7 +4301,7 @@
definitions in groups using the <literal>svn:externals</literal>
property. You can create or modify this property using
<command>svn propset</command> or <command>svn
- propedit</command> (see <xref linkend="svn.advanced.props.why"/>).
+ propedit</command> (see <xref linkend="svn.advanced.props.why"/>).
It can be set on any versioned directory,
and its value is a multi-line table of subdirectories (relative
to the versioned directory on which the property is set) and
@@ -2942,7 +4439,7 @@
This scenario plays itself out all the time—anywhere that
the information generated by one group of people has a direct
effect on that which is generated by another group.</para>
-
+
<para>For example, software developers might be working on an
application which makes use of a third-party library.
Subversion has just such a relationship with the Apache Portable
@@ -2992,7 +4489,7 @@
your own version control system that contains information
provided by a third-party entity, or vendor. Each version of
the vendor's data that you decide to absorb into your project is
- called a <firstterm>vendor drop</firstterm>.</para>
+ called a <firstterm>vendor drop</firstterm>.</para>
<para>Vendor branches provide two key benefits. First, by storing
the currently supported vendor drop in your own version control
@@ -3041,7 +4538,7 @@
-m 'importing initial 1.0 vendor drop'
…
</screen>
-
+
<para>We now have the current version of the libcomplex source
code in <filename>/vendor/libcomplex/current</filename>. Now,
we tag that version (see <xref linkend="svn.branchmerge.tags" />)
@@ -3051,7 +4548,7 @@
<filename>calc</filename> project directory. It is in this
copied version of the vendor data that we will make our
customizations.</para>
-
+
<screen>
$ svn copy http://svn.example.com/repos/vendor/libcomplex/current \
http://svn.example.com/repos/vendor/libcomplex/1.0 \
@@ -3085,7 +4582,7 @@
approach the problem from the other direction, applying the
changes made to libcomplex between versions 1.0 and 1.1 to our
modified copy of it.</para>
-
+
<para>To perform this upgrade, we checkout a copy of our vendor
branch, and replace the code in the
<filename>current</filename> directory with the new libcomplex
@@ -3303,7 +4800,7 @@
<!-- =============================================================== -->
<sect2 id="svn.advanced.l10n.understanding">
<title>Understanding locales</title>
-
+
<para>Most modern operating systems have a notion of the
<quote>current locale</quote>—that is, the region or
country whose localization conventions are honored. These
@@ -3437,7 +4934,7 @@
svn: Can't convert string from 'UTF-8' to native encoding:
…
</screen>
-
+
<para>Errors like this typically occur when the Subversion
client has received a UTF-8 string from the repository, but
not all of the characters in that string can be represented
@@ -3578,7 +5075,7 @@
# Configure your favorite diff program here.
DIFF="/usr/local/bin/my-diff-tool"
-# Subversion provides the paths we need as the sixth and seventh
+# Subversion provides the paths we need as the sixth and seventh
# parameters.
LEFT=${6}
RIGHT=${7}
@@ -3600,7 +5097,7 @@
REM Configure your favorite diff program here.
SET DIFF="C:\Program Files\Funky Stuff\My Diff Tool.exe"
-REM Subversion provides the paths we need as the sixth and seventh
+REM Subversion provides the paths we need as the sixth and seventh
REM parameters.
SET LEFT=%6
SET RIGHT=%7
@@ -3637,7 +5134,7 @@
conflicts remain in the output—any other errorcode is
considered a fatal error.</para>
- <para><xref linkend="svn.advanced.externaldifftools.diff3.ex-1"/>
+ <para><xref linkend="svn.advanced.externaldifftools.diff3.ex-1"/>
and <xref linkend="svn.advanced.externaldifftools.diff3.ex-2"/> are
templates for external merge tool wrappers in the Bourne shell
and Windows batch scripting languages, respectively.</para>
@@ -3650,7 +5147,7 @@
# Configure your favorite diff3/merge program here.
DIFF3="/usr/local/bin/my-merge-tool"
-# Subversion provides the paths we need as the ninth, tenth, and eleventh
+# Subversion provides the paths we need as the ninth, tenth, and eleventh
# parameters.
MINE=${9}
OLDER=${10}
@@ -3675,7 +5172,7 @@
REM Configure your favorite diff3/merge program here.
SET DIFF3="C:\Program Files\Funky Stuff\My Merge Tool.exe"
-REM Subversion provides the paths we need as the ninth, tenth, and eleventh
+REM Subversion provides the paths we need as the ninth, tenth, and eleventh
REM parameters. But we only have access to nine parameters at a time, so we
REM shift our nine-parameter window twice to let us get to what we need.
SHIFT
@@ -3721,7 +5218,7 @@
repositories) must, in accordance with convention, have either a
server name of <literal>localhost</literal> or no server name at
all:</para>
-
+
<screen>
$ svn checkout file:///path/to/repos
…
@@ -3744,12 +5241,12 @@
C:\> svn checkout "file:///X|/path/to/repos"
…
</screen>
-
+
<para>In the second syntax, you need to quote the URL so that the
vertical bar character is not interpreted as a pipe. Also, note
that a URL uses ordinary slashes even though the native
(non-URL) form of a path on Windows uses backslashes.</para>
-
+
<para>Finally, it should be noted that the Subversion client will
automatically encode URLs as necessary, just like a web browser
does. For example, if a URL contains a space or upper-ASCII
@@ -3758,7 +5255,7 @@
<screen>
$ svn checkout "http://host/path with space/project/españa"
</screen>
-
+
<para>…then Subversion will escape the unsafe characters
and behave as if you had typed:</para>
@@ -3771,11 +5268,11 @@
argument to the <command>svn</command> program.</para>
</sect1>
-
+
</chapter>
<!--
-local variables:
+local variables:
sgml-parent-document: ("book.xml" "chapter")
end:
--->
+-->
\ No newline at end of file
More information about the svnbook-dev
mailing list