[svnbook] r3731 committed - * src/fr/book/ch07-customizing-svn.xml...
svnbook at googlecode.com
svnbook at googlecode.com
Thu May 6 06:03:01 CDT 2010
Revision: 3731
Author: subversif999 at gmail.com
Date: Thu May 6 04:02:41 2010
Log: * src/fr/book/ch07-customizing-svn.xml
- Translate Chapter 7
http://code.google.com/p/svnbook/source/detail?r=3731
Modified:
/trunk/src/fr/book/ch07-customizing-svn.xml
=======================================
--- /trunk/src/fr/book/ch07-customizing-svn.xml Fri Sep 12 07:39:35 2008
+++ /trunk/src/fr/book/ch07-customizing-svn.xml Thu May 6 04:02:41 2010
@@ -1,15 +1,16 @@
<chapter id="svn.customization">
- <title>Customizing Your Subversion Experience</title>
-
- <para>Version control can be a complex subject, as much art as
- science, that offers myriad ways of getting stuff done.
- Throughout this book, you've read of the various Subversion
- command-line client subcommands and the options that modify their
- behavior. In this chapter, we'll look into still more ways to
- customize the way Subversion works for you—setting up the
- Subversion runtime configuration, using external helper
- applications, Subversion's interaction with the operating system's
- configured locale, and so on.</para>
+ <title>Personnalisation de Subversion</title>
+
+ <para>La gestion de versions est un sujet complexe, au moins autant
+ un art qu'une science, qui offre une myriade de façons d'accomplir
+ chaque tâche. En lisant ce livre, vous avez expérimenté les
+ sous-commandes Subversion en ligne de commande et les options pour
+ modifier leur comportement. Dans ce chapitre, nous passons
+ en revue les moyens de personnaliser le fonctionnement
+ de Subversion : la configuration des options d'exécution,
+ l'utilisation d'applications externes pour faciliter certains
+ traitements, les interactions de Subversion avec la configuration
+ des paramètres régionaux du système d'exploitation, etc.</para>
<!-- TODO(cmpilato): Gut the runtime config stuff like I did the
property stuff, making larger topical sections to which the
@@ -21,166 +22,186 @@
<!-- =================================================================
-->
<!-- =================================================================
-->
<sect1 id="svn.advanced.confarea">
- <title>Runtime Configuration Area</title>
-
- <para>Subversion provides many optional behaviors that the user can
- control. 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
- for specifying these options and to use them for every
- operation they perform, Subversion uses configuration files,
- segregated into a Subversion configuration area.</para>
-
- <para>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),
- which are just text files in standard INI format (with
- <quote>sections</quote> providing the second tier). You can
- easily edit these files using your favorite text editor (such as
- Emacs or vi), and they contain directives read by the client to
- determine which of several optional behaviors the user
- prefers.</para>
+ <title>Zone de configuration des exécutables</title>
+
+ <para>Subversion permet à l'utilisateur de contrôler finement son
+ comportement. Beaucoup d'options ont vocation à s'appliquer à
+ l'ensemble des opérations de Subversion. Ainsi, plutôt que de
+ forcer les utilisateurs à se souvenir d'arguments en ligne de
+ commande pour spécifier ces options et de les utiliser à chaque
+ invocation, Subversion utilise des fichiers de configuration,
+ tenus à l'écart dans une zone de configuration spécifique à
+ Subversion.</para>
+
+ <para>La <firstterm>zone de configuration</firstterm> Subversion
+ consiste en une hiérarchie à deux niveaux constituée de noms
+ d'options et de leurs valeurs. Habituellement, cela se traduit
+ par un répertoire dédié qui contient les
+ <firstterm>fichiers de configuration</firstterm> (le premier
+ niveau) : des fichiers texte au format standard INI
+ (dont les <quote>sections</quote> constituent le deuxième
+ niveau). Vous pouvez facilement éditer ces fichiers à l'aide de
+ votre éditeur de texte favori (tel qu'Emacs ou vi). Ils
+ contiennent des directives lues par le client Subversion afin de
+ déterminer le comportement par défaut choisi par
+ l'utilisateur.</para>
<!-- ===============================================================
-->
<sect2 id="svn.advanced.confarea.layout">
- <title>Configuration Area Layout</title>
-
- <para>The first time 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
- user's home directory. On Win32 systems, Subversion creates a
- folder named <filename>Subversion</filename>, typically inside
- the <filename>Application Data</filename> area of the user's
- profile directory (which, by the way, is usually a hidden
- directory). However, on this platform, the exact location
- differs from system to system and is dictated by the Windows
- Registry.
+ <title>Agencement de la zone de configuration</title>
+
+ <para>La première fois que le client <command>svn</command> en
+ ligne de commande est exécuté, il crée une zone de
+ configuration propre à l'utilisateur. Sur les systèmes de type
+ Unix, cette zone est un répertoire nommé
+ <filename>.subversion</filename> dans le répertoire personnel
+ de l'utilisateur. Sur les systèmes Windows, Subversion crée un
+ dossier nommé <filename>Subversion</filename>, généralement
+ dans la zone <filename>Application Data</filename> du
+ répertoire qui contient le profil de l'utilisateur (qui est
+ habituellement, au passage, un répertoire caché). Cependant,
+ sur cette plate-forme, l'emplacement exact du profil
+ utilisateur varie d'un système à l'autre et est dicté par la
+ base de registre Windows
<footnote>
- <para>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>
- </footnote>
- 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
- 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
- that the system-wide configuration area alone does not dictate
- mandatory policy—the settings in the per-user
- configuration area override those in the system-wide one, and
- command-line arguments supplied to the <command>svn</command>
- program have the final word on behavior. On Unix-like
- platforms, the system-wide configuration area is
- expected to be the <filename>/etc/subversion</filename>
- directory; on Windows machines, it looks for a
- <filename>Subversion</filename> directory inside the common
- <filename>Application Data</filename> location (again, as
- specified by the Windows Registry). Unlike the per-user
- case, the <command>svn</command> program does not attempt
- to create the system-wide configuration area.</para>
-
- <para>The per-user configuration area currently contains three
- files—two configuration files (<filename>config</filename>
and
- <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
- with textual descriptions about how the values for the key
- affect Subversion's behavior. To change a certain behavior,
- you need only to load the appropriate configuration file into
- a text editor, and to modify the desired option's value. If at
- any time you wish to have the default configuration settings
- restored, you can simply remove (or rename) your configuration
- directory and then run some innocuous <command>svn</command>
- command, such as <userinput>svn --version</userinput>. A new
- configuration directory with the default contents will be
- created.</para>
-
- <para>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
- authentication methods. This directory is created in such a
- way that only the user herself has permission to read its
- contents.</para>
+ <para>La variable d'environnement <literal>APPDATA</literal>
+ pointe vers la zone <filename>Application Data</filename>,
+ vous pouvez donc toujours faire référence à ce dossier en
+ utilisant <filename>%APPDATA%\Subversion</filename>.</para>
+ </footnote>.
+ Nous nous référerons à cette zone de configuration propre à
+ l'utilisateur en utilisant son nom Unix :
+ <filename>.subversion</filename>.</para>
+
+ <para>En plus de la zone de configuration propre à l'utilisateur,
+ Subversion reconnaît l'existence d'une zone de configuration
+ globale pour le système. Cela permet aux administrateurs du
+ système d'établir une configuration par défaut pour l'ensemble
+ des utilisateurs d'une machine donnée. Notez que la zone de
+ configuration globale seule ne fixe pas de politique
+ définitive : les réglages de l'utilisateur sont
+ prioritaires par rapport aux réglages globaux et les options
+ de la ligne de commande ont toujours le dernier mot. Sur les
+ plate-formes de type Unix, la zone de configuration globale
+ doit se trouver dans le répertoire
+ <filename>/etc/subversion</filename> ; sur les machines
+ Windows, Subversion cherche un répertoire
+ <filename>Subversion</filename> dans le dossier commun
+ <filename>Application Data</filename> (là encore, l'endroit
+ exact dépend de la base de registre Windows). Au contraire de
+ la zone propre à l'utilisateur, le programme
+ <command>svn</command> ne tente pas de créer la zone de
+ configuration globale.</para>
+
+ <para>La zone de configuration propre à l'utilisateur contient
+ actuellement trois fichiers : deux fichiers de
+ configuration (<filename>config</filename> et
+ <filename>servers</filename>) et un fichier
+ <filename>README.txt</filename> qui décrit le format INI. Lors
+ de leur création, ces fichiers contiennent les valeurs par
+ défaut de toutes les options supportées par Subversion,
+ généralement mises en commentaire et groupées avec une
+ description textuelle de l'effet de la clé sur le
+ fonctionnement de Subversion. Pour modifier un comportement
+ précis, il suffit de charger le fichier de configuration dans
+ un éditeur de texte et de changer la valeur de l'option
+ correspondante. Si, par la suite, vous voulez rétablir les
+ valeurs par défaut, vous n'avez qu'à supprimer ou renommer
+ votre répertoire de configuration puis lancer une commande
+ <command>svn</command> inoffensive, telle que
+ <userinput>svn --version</userinput>. Un nouveau répertoire
+ de configuration sera créé, qui contiendra les valeurs par
+ défaut.</para>
+
+ <para>La zone de configuration propre à l'utilisateur contient
+ également un cache pour les données d'authentification. Le
+ répertoire <filename>auth</filename> héberge un ensemble de
+ sous-répertoires qui contiennent des informations mises en
+ cache, relatives aux différentes méthodes d'authentification
+ utilisées par Subversion. Ce répertoire est créé de telle
+ manière que seul l'utilisateur ait accès à son contenu.</para>
</sect2>
<!-- ===============================================================
-->
<sect2 id="svn.advanced.confarea.windows-registry">
- <title>Configuration and the Windows Registry</title>
-
- <para>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
- files. The <quote>file/section</quote> hierarchy is
- preserved as well, though addressed in a slightly different
- fashion—in this schema, files and sections are just
- levels in the Registry key tree.</para>
-
- <para>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,
- which is in the <literal>miscellany</literal> section of the
- <filename>config</filename> file, would be found at
+ <title>Configuration via la base de registre Windows</title>
+
+ <para>En plus de la zone de configuration classique contenant
+ les fichiers INI, les clients Subversion qui tournent sur une
+ plate-forme Windows peuvent aussi utiliser la base de registre
+ Windows pour stocker leurs données de configuration. Les noms
+ des options et leurs valeurs sont les mêmes que dans les
+ fichiers INI. La hiérarchie <quote>fichier/section</quote> est
+ également présente, bien que traitée de manière légèrement
+ différente : dans ce cas, les fichiers et les sections
+ sont juste des niveaux dans l'arborescence des clés de
+ registres.</para>
+
+ <para>Subversion cherche les valeurs de configuration
+ applicables à tout le système sous la clé
+
<literal>HKEY_LOCAL_MACHINE\Software\Tigris.org\Subversion</literal>.
+ Par exemple, l'option <literal>global-ignores</literal>, qui
+ se trouve dans la section <literal>miscellany</literal> du
+ fichier de configuration, est située dans
<literal>HKEY_LOCAL_MACHINE\Software\Tigris.org\Subversion\Config\Miscellany\global-ignores</literal>.
- Per-user configuration values should be stored under
+ Les valeurs propres à un utilisateur doivent être stockées sous
<literal>HKEY_CURRENT_USER\Software\Tigris.org\Subversion</literal>.
- </para>
-
- <para>Registry-based configuration options are parsed
- <emphasis>before</emphasis> their file-based counterparts, so
- they are overridden by values found in the configuration files. In
- other words, Subversion looks for configuration information in
- the following locations on a Windows system; lower-numbered
- locations take precedence over higher-numbered locations:</para>
-
+ </para>
+
+ <para>Les options de configuration de la base de registre sont
+ analysées <emphasis>avant</emphasis> les options des fichiers
+ INI ; elles sont donc supplantées par les valeurs trouvées
+ dans les fichiers de configuration. En d'autres termes,
+ Subversion cherche les options de configuration dans l'ordre
+ suivant sur un système Windows (les plus prioritaires sont
+ citées en premier) :</para>
+
<orderedlist>
<listitem>
- <para>Command-line options</para>
+ <para>les options en ligne de commande ;</para>
</listitem>
<listitem>
- <para>The per-user INI files</para>
+ <para>les fichiers INI propres à l'utilisateur ;</para>
</listitem>
<listitem>
- <para>The per-user Registry values</para>
+ <para>les valeurs de la base de registre propres
+ à l'utilisateur ;</para>
</listitem>
<listitem>
- <para>The system-wide INI files</para>
+ <para>les fichiers INI applicables à l'ensemble
+ du système ;</para>
</listitem>
<listitem>
- <para>The system-wide Registry values</para>
+ <para>les valeurs de la base de registre applicables
+ à l'ensemble du système.</para>
</listitem>
</orderedlist>
- <para>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
- allows you to effectively comment out a Subversion option
- 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
- 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>
- program. Alternatively, you can create a
- <filename>.reg</filename> file (such as the one in <xref
- linkend="svn.advanced.confarea.windows-registry.ex-1" />), and
- then double-click on that file's icon in the Explorer shell,
- which will cause the data to be merged into your
- Registry.</para>
+ <para>Par ailleurs, la base de registre Windows ne supporte pas
+ vraiment la notion de <quote>mise en commentaire</quote>.
+ Cependant, Subversion ignorera toute clé dont le nom commence
+ par le caractère dièse (<literal>#</literal>). Cela vous
+ permet de mettre en commentaire efficacement une option
+ Subversion sans avoir à effacer entièrement la clé de la base
+ de registre, ce qui simplifie manifestement la procédure de
+ restauration de l'option.</para>
+
+ <para>Le client en ligne de commande <command>svn</command>
+ n'écrit jamais dans la base de registre et ne tentera pas d'y
+ créer une zone de configuration par défaut. Vous pouvez créer
+ les clés dont vous avez besoin en utilisant le programme
+ <command>REGEDIT</command>. Une autre alternative consiste à
+ créer un fichier <filename>.reg</filename> (tel que celui
+ donné dans l'<xref
+ linkend="svn.advanced.confarea.windows-registry.ex-1" />)
+ puis à double-cliquer sur l'icône de ce fichier dans
+ l'explorateur Windows afin d'appliquer les modifications
+ à votre base de registre.</para>
<example id="svn.advanced.confarea.windows-registry.ex-1">
- <title>Sample registration entries (.reg) file</title>
+ <title>Exemple de fichier de modification de la base
+ de registre (.reg)</title>
<programlisting>
REGEDIT4
@@ -224,230 +245,250 @@
</programlisting>
</example>
- <para>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
- proxy-related options) and per-user settings (editor programs
- and password storage, among others). Also note that all the
- options are effectively commented out. You need only to
- remove the hash (<literal>#</literal>) character from the
- beginning of the option names and set the values as you
- desire.</para>
+ <para>L'exemple précédent présente le contenu d'un fichier
+ <filename>.reg</filename> qui contient quelques unes des
+ options les plus communément utilisées et leurs valeurs
+ par défaut. Notez la présence de réglages propres à
+ l'utilisateur (notamment l'éditeur de texte et le stockage
+ des mots de passe) ainsi que de réglages applicables à
+ l'ensemble du système (comme les options relatives au
+ mandataire réseau). Notez également que toutes les options
+ sont mises en commentaire. Il ne vous reste qu'à supprimer
+ le caractère dièse (<literal>#</literal>) initial des noms
+ d'options et à leur affecter la valeur que vous
+ souhaitez.</para>
</sect2>
<!-- ===============================================================
-->
<sect2 id="svn.advanced.confarea.opts">
- <title>Configuration Options</title>
+ <title>Options de configuration</title>
<!-- TODO(cmpilato): Rework and move this section to the Reference
-->
- <para>In this section, we will discuss the specific
- runtime configuration options that Subversion currently
- supports.</para>
+ <para>Dans cette section, nous allons nous intéresser aux
+ options de configuration des programmes supportées par la
+ version actuelle de Subversion.</para>
<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<sect3 id="svn.advanced.confarea.opts.servers">
- <title>Servers</title>
-
- <para>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
- <literal>global</literal>. The <literal>groups</literal>
- section is essentially a cross-reference table. The keys in
- this section are the names of other sections in the file;
- their values are <firstterm>globs</firstterm>—textual
- tokens that possibly contain wildcard
- characters—that are compared against the hostnames of
- the machine to which Subversion requests are sent.</para>
+ <title>Fichier <filename>servers</filename></title>
+
+ <para>Le fichier <filename>servers</filename> contient les
+ options de configuration relatives aux couches réseau. Il
+ y a deux sections spéciales dans ce fichier :
+ <literal>groups</literal> et <literal>global</literal>.
+ La section <literal>groups</literal> n'est rien d'autre
+ qu'un tableau de références croisées. Les clés de cette
+ section sont les noms des autres sections du fichier ;
+ ses valeurs sont des <firstterm>globs</firstterm> (des
+ représentations textuelles qui peuvent contenir des
+ caractères joker) qui sont comparés aux noms des machines
+ auxquelles des requêtes Subversion sont envoyées.</para>
<programlisting>
[groups]
-beanie-babies = *.red-bean.com
+serveurs-red-beans = *.red-bean.com
collabnet = svn.collab.net
-[beanie-babies]
+[serveurs-red-beans]
…
[collabnet]
…
</programlisting>
- <para>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
- <filename>servers</filename> file whose name is the matched
- group's name. From that section, it reads the actual network
- configuration settings.</para>
-
- <para>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
- exactly the same as those that are valid for the other server
- sections in the file (except, of course, the special
- <literal>groups</literal> section), and are as
- follows:</para>
+ <para>Quand vous utilisez Subversion en réseau, il essaie de
+ faire correspondre le nom du serveur auquel il tente de se
+ connecter avec un nom de groupe de la section
+ <literal>groups</literal>. Si une correspondance existe,
+ Subversion vérifie alors s'il existe dans le fichier
+ <filename>servers</filename> une section dont le nom est
+ le nom du groupe correspondant. Le cas échéant, il tire
+ de cette section la configuration réseau à appliquer.</para>
+
+ <para>La section <literal>global</literal> contient la
+ configuration à appliquer à tous les serveurs qui ne
+ correspondent à aucun glob de la section
+ <literal>groups</literal>. Les options disponibles dans
+ cette section sont exactement les mêmes que pour les autres
+ sections du fichier (exceptée bien sûr la section spéciale
+ <literal>groups</literal>) et sont :</para>
<variablelist>
<varlistentry>
<term><literal>http-proxy-exceptions</literal></term>
<listitem>
- <para>This specifies a comma-separated list of patterns
- for repository hostnames that should be accessed
- directly, without using the proxy machine. The
- pattern syntax is the same as is used in the Unix
- shell for filenames. A repository hostname matching
- any of these patterns will not be proxied.</para>
+ <para>Cette option contient une liste de motifs
+ (séparés par des virgules) de noms de machines
+ qui doivent être contactées directement, sans passer
+ par le mandataire. La syntaxe des motifs est la même
+ que celle utilisée par le shell Unix pour les noms de
+ fichiers. L'accès aux dépôts d'une machine dont le nom
+ correspond à l'un de ces motifs se fera sans passer
+ par un mandataire.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>http-proxy-host</literal></term>
<listitem>
- <para>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>Cette option contient le nom de la machine
+ mandataire pour les requêtes HTTP de Subversion. La
+ valeur par défaut est vide, ce qui signifie que
+ Subversion ne tentera pas de faire passer ses requêtes
+ par un mandataire mais essaiera de contacter la machine
+ de destination directement.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>http-proxy-port</literal></term>
<listitem>
- <para>This specifies the port number on the proxy host
- to use. It defaults to an empty value.</para>
+ <para>Cette option contient le numéro du port à
+ utiliser sur la machine mandataire. Par défaut,
+ la valeur est vide.</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>Cette option contient le nom d'utilisateur à
+ fournir à la machine mandataire. Par défaut, la valeur
+ est vide.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>http-proxy-password</literal></term>
<listitem>
- <para>This specifies the password to supply to the proxy
- machine. It defaults to an empty value.</para>
+ <para>cette option contient le mot de passe à fournir à
+ la machine mandataire. Par défaut, la valeur est
+ vide.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>http-timeout</literal></term>
<listitem>
- <para>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 time out, you should increase
- the value of this option. The default value is
- <literal>0</literal>, which instructs the underlying
- HTTP library, Neon, to use its default timeout
- setting.</para>
+ <para>Cette option contient la durée maximum, en
+ secondes, pendant laquelle Subversion attend la
+ réponse du serveur. Si vous rencontrez des problèmes
+ d'opérations Subversion qui expirent à cause d'une
+ connexion réseau trop lente, vous devez augmenter
+ cette valeur. Par défaut, la valeur est
+ <literal>0</literal>, ce qui conduit la bibliothèque
+ HTTP sous-jacente (Neon) à utiliser sa propre valeur
+ par défaut.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>http-compression</literal></term>
<listitem>
- <para>This specifies whether Subversion should
- attempt to compress network requests made to DAV-ready
- servers. The default value is <literal>yes</literal>
- (though compression will occur only 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>Cette option indique si oui ou non Subversion
+ doit essayer de compresser les requêtes réseaux à
+ destination de serveurs DAV. La valeur par défaut est
+ <literal>yes</literal>. Notez que la compression ne
+ sera effective que si la couche réseau a été compilée
+ avec le support de la compression. Mettez
+ <literal>no</literal> pour ne pas activer la
+ compression, par exemple lorsque vous analysez les
+ transmissions réseaux.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>http-library</literal></term>
<listitem>
- <para>Subversion provides a pair of repository access
- modules that understand its WebDAV network protocol.
- The original one, which shipped with Subversion 1.0, is
- <literal>libsvn_ra_neon</literal> (though back then it
- was called <literal>libsvn_ra_dav</literal>). Newer
- Subversion versions also provide
- <literal>libsvn_ra_serf</literal>, which uses a
- different underlying implementation and aims to
- support some of the newer HTTP concepts.</para>
-
- <para>At this point, <literal>libsvn_ra_serf</literal>
- is still considered experimental, though it appears to
- work in the common cases quite well. To encourage
- experimentation, Subversion provides the
- <literal>http-library</literal> runtime configuration
- option to allow users to specify (generally, or in a
- per-server-group fashion) which WebDAV access module
- they'd prefer to use—<literal>neon</literal> or
+ <para>Subversion est fourni avec deux modules d'accès
+ aux dépôts qui utilisent le protocole réseau WebDAV.
+ Le module originel, fourni avec Subversion 1.0, est
+ <literal>libsvn_ra_neon</literal>
+ (bien qu'en ce temps-là, il s'appelait
+ <literal>libsvn_ra_dav</literal>). Les nouvelles
+ versions de Subversion fournissent également
+ <literal>libsvn_ra_serf</literal>, qui utilise une
+ implémentation sous-jacente différente et qui vise à
+ supporter certains des concepts HTTP les plus
+ récents.</para>
+
+ <para>Actuellement, <literal>libsvn_ra_serf</literal>
+ est toujours considérée en version expérimentale,
+ bien qu'elle semble fonctionner correctement dans les
+ cas usuels. Afin d'inciter les gens à l'essayer,
+ Subversion fournit l'option de configuration
+ <literal>http-library</literal> pour permettre aux
+ utilisateurs de définir (globalement ou par groupe de
+ serveurs) quel module d'accès WebDAV ils veulent
+ utiliser : <literal>neon</literal> ou
<literal>serf</literal>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>http-auth-types</literal></term>
<listitem>
- <para>This option is a semicolon-delimited list of
- authentication types supported by the Neon-based
- WebDAV repository access modules. Valid members of
- this list are <literal>basic</literal>,
- <literal>digest</literal>, and
+ <para>Cette option liste les méthodes
+ d'authentification (séparées par des points-virgules)
+ supportées par les module d'accès aux dépôts WebDAV
+ basés sur Neon. Les valeurs valides sont :
+ <literal>basic</literal>,
+ <literal>digest</literal> et
<literal>negotiate</literal>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>neon-debug-mask</literal></term>
<listitem>
- <para>This is an integer mask that the underlying HTTP
- library, Neon, uses for choosing what type of
- debugging output to yield. The default value is
- <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>Cette option contient un entier qui représente un
+ masque que la bibliothèque HTTP sous-jacente (Neon)
+ utilise pour choisir quel type d'affichage de débogage
+ autoriser. La valeur par défaut est <literal>0</literal>,
+ ce qui interdit tout affichage de débogage. Pour plus
+ d'informations sur l'utilisation de Neon par
+ Subversion, reportez-vous au <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
- containing certificates of the certificate authorities
- (or CAs) that
- are accepted by the Subversion client when accessing the
- repository over HTTPS.</para>
+ <para>Cette option contient une liste de chemins
+ (séparés par des points-virgules) vers les fichiers
+ contenant les certificats des autorités de
+ certifications (AC) qui doivent être reconnues comme
+ de confiance par le client Subversion lors des accès
+ aux dépôts en HTTPS.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>ssl-trust-default-ca</literal></term>
<listitem>
- <para>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>Mettez cette variable à <literal>yes</literal>
+ si vous voulez que Subversion fasse automatiquement
+ confiance à l'ensemble des autorités de certification
+ livrées par défaut avec 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
- 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
- certificate automatically without prompting you.
- There's no standard place to store your certificate on
- disk; Subversion will grab it from any path you
- specify.</para>
+ <para>Si un hôte (ou un ensemble d'hôtes) demande un
+ certificat SSL au client, vous serez sollicité pour
+ fournir le chemin de votre certificat. Dès que cette
+ variable contient ce chemin, Subversion sera capable
+ de trouver automatiquement votre certificat et ne
+ vous sollicitera pas. Il n'existe pas d'emplacement
+ standard pour stocker un certificat utilisateur sur
+ le disque ; Subversion va le chercher à l'endroit
+ que vous lui spécifiez.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>ssl-client-cert-password</literal></term>
<listitem>
- <para>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),
- you can set this variable to the certificate's
- passphrase. You won't be prompted anymore.</para>
+ <para>Si votre certificat client SSL est protégé par
+ une phrase de passe, Subversion vous la demandera
+ à chaque fois que le certificat est utilisé. Si vous
+ trouvez cela pénible (et que cela ne vous dérange pas
+ que cette phrase de passe soit stockée dans le fichier
+ <filename>servers</filename>), vous pouvez placer
+ dans cette variable la phrase de passe de votre
+ certificat. Vous ne serez plus sollicité.</para>
</listitem>
</varlistentry>
</variablelist>
@@ -456,334 +497,367 @@
<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<sect3 id="svn.advanced.confarea.opts.config">
- <title>Config</title>
-
- <para>The <filename>config</filename> file contains the rest
- of the currently available Subversion runtime
- options—those not related to networking. There are
- only a few options in use as of this writing, but they are
- again grouped into sections in expectation of future
- additions.</para>
-
- <para>The <literal>auth</literal> section contains settings
- related to Subversion's authentication and authorization
- against the repository. It contains the following:</para>
+ <title>Fichier <filename>config</filename></title>
+
+ <para>Le fichier <filename>config</filename> contient le reste
+ des options du programme Subversion disponibles actuellement,
+ c'est-à-dire celles qui ne se rapportent pas au réseau. Au
+ moment où ces lignes sont écrites, seules quelques options
+ sont utilisées, mais elles sont quand même regroupées en
+ sections en prévision d'ajouts futurs.</para>
+
+ <para>La section <literal>auth</literal> contient les
+ paramètres relatifs à l'authentification et au contrôle
+ d'accès de Subversion pour les dépôts. Elle comprend les
+ options suivantes :</para>
<variablelist>
<varlistentry>
<term><literal>store-passwords</literal></term>
<listitem>
- <para>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
- <literal>no</literal> to disable this on-disk password
- caching. You can override this option for a single
- instance of the <command>svn</command> command using
- the <option>--no-auth-cache</option> command-line
- parameter (for those subcommands that support it).
- For more information, see <xref
+ <para>Cette option demande à Subversion de garder en
+ cache (ou non) les mots de passe qui sont tapés par
+ l'utilisateur en réponse aux demandes
+ d'authentification des serveurs. La valeur par défaut
+ est <literal>yes</literal>. Remplacez cette valeur par
+ <literal>no</literal> pour désactiver la mise en cache
+ sur le disque. Vous pouvez outrepasser cette option
+ pour un appel donné d'une commande
+ <command>svn</command> en utilisant l'option de ligne
+ de commande <option>--no-auth-cache</option> (pour les
+ sous-commandes qui acceptent cette option). Pour plus
+ d'informations, consultez <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
- <literal>store-passwords</literal>, except that it
- enables or disables on-disk caching of
- <emphasis>all</emphasis> authentication information:
- usernames, passwords, server certificates, and any
- other types of cacheable credentials.</para>
+ <para>cette option est équivalente à
+ <literal>store-passwords</literal> sauf qu'elle
+ applique la mise en cache sur le disque (ou non) à
+ <emphasis>l'ensemble</emphasis> des informations
+ d'authentification : identifiants, mots de passe,
+ certificats serveur et tout autre type d'élément
+ pouvant être mis en cache.</para>
</listitem>
</varlistentry>
</variablelist>
- <para>The <literal>helpers</literal> section controls which
- external applications Subversion uses to accomplish its
- tasks. Valid options in this section are:</para>
+ <para>La section <literal>helpers</literal> définit quelles
+ sont les applications externes utilisées par Subversion pour
+ accomplir ses tâches. Les options valides dans cette section
+ sont :</para>
<variablelist>
<varlistentry>
<term><literal>editor-cmd</literal></term>
<listitem>
- <para>This specifies the program Subversion will use to
- query the user for certain types of textual metadata
- or when interactively resolving conflicts. See
- <xref linkend="svn.advanced.externaleditors"/> for
- more details on using external text editors with
- Subversion.</para>
+ <para>Cette option indique le programme utilisé par
+ l'utilisateur auquel Subversion demande d'entrer des
+ méta-données textuelles ou de résoudre les conflits de
+ manière interactive. Consultez <xref
+ linkend="svn.advanced.externaleditors"/>
+ pour plus de détails sur l'utilisation d'un éditeur de
+ texte externe avec Subversion.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>diff-cmd</literal></term>
<listitem>
- <para>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,
- Subversion uses an internal differencing
- library—setting this option will cause it to
- perform this task using an external program. See
- <xref linkend="svn.advanced.externaldifftools"/> for
- more details on using such programs.</para>
+ <para>Cette option contient le chemin absolu du
+ programme de comparaison qui est utilisé lorsque
+ Subversion doit afficher à l'utilisateur plusieurs
+ fichiers à comparer (par exemple lors de l'utilisation
+ de la commande <command>svn diff</command>). Par
+ défaut, Subversion utilise une bibliothèque interne de
+ comparaison. Définir cette option le forcera à utiliser
+ un programme externe pour effectuer cette tâche.
+ Consultez <xref linkend="svn.advanced.externaldifftools"/>
+ pour plus de détails sur l'utilisation de tels
+ programmes.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>diff3-cmd</literal></term>
<listitem>
- <para>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
- internal differencing library—setting this
- option will cause it to perform this task using an
- external program. See <xref
- linkend="svn.advanced.externaldifftools"/> for more
- details on using such programs.</para>
+ <para>Cette option contient le chemin absolu d'un
+ programme de comparaison à trois entrées. Subversion
+ utilise ce programme pour fusionner les changements
+ effectués par l'utilisateur avec ceux en provenance
+ du dépôt. Par défaut, Subversion utilise une
+ bibliothèque interne de comparaison. Définir cette
+ option le forcera à utiliser un programme externe pour
+ effectuer cette tâche. Consultez <xref
+ linkend="svn.advanced.externaldifftools"/>
+ pour plus de détails sur l'utilisation de tels
+ programmes.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>diff3-has-program-arg</literal></term>
<listitem>
- <para>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>Ce drapeau doit être mis à <literal>true</literal>
+ si le programme spécifié par l'option
+ <literal>diff3-cmd</literal> accepte l'option
+ <option>--diff-program</option> en ligne de
+ commande.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>merge-tool-cmd</literal></term>
<listitem>
- <para>This specifies the program that Subversion will
- use to perform three-way merge operations on your
- versioned files. See <xref
- linkend="svn.advanced.externaldifftools"/> for more
- details on using such programs.</para>
+ <para>Cette option contient le programme que Subversion
+ utilise pour effectuer les opérations de fusion à
+ trois sources sur vos fichiers suivis en versions.
+ Consultez <xref
+ linkend="svn.advanced.externaldifftools"/> pour plus
+ de détails sur l'utilisation de tels
+ programmes.</para>
</listitem>
</varlistentry>
</variablelist>
- <para>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
- everything that doesn't belong elsewhere winds up.
+ <para>La section <literal>tunnels</literal> vous permet de
+ définir de nouveaux tunnels à utiliser avec les connexions
+ clientes <command>svnserve</command> et
+ <literal>svn://</literal>. Pour plus de détails, consultez
+ <xref linkend="svn.serverconfig.svnserve.sshauth"/>.</para>
+
+ <para>La section <literal>miscellany</literal> récolte tout
+ ce qui n'a pas sa place ailleurs
<footnote>
- <para>Anyone for potluck dinner?</para>
+ <para>En clair, c'est un joyeux fourre-tout.</para>
</footnote>
- In this section, you can find:</para>
+ Dans cette section, vous trouvez :</para>
<variablelist>
<varlistentry>
<term><literal>global-ignores</literal></term>
<listitem>
- <para>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
- linkend="svn.tour.cycle.examine.status" />). Sometimes it
can
- be annoying to see uninteresting, unversioned
- items—for example, object files that result from
- a program's compilation—in this display. The
- <literal>global-ignores</literal> option is a list of
- whitespace-delimited globs that describe the names of
- files and directories that Subversion should not
- display unless they are versioned. The default value
- is <literal>*.o *.lo *.la #*# .*.rej *.rej .*~ *~
- .#* .DS_Store</literal>.</para>
-
- <para>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
- behavior for a single instance of any of these commands
- by explicitly specifying the filename, or by using
- the <option>--no-ignore</option> command-line flag.</para>
-
- <para>For information on finer-grained control of
- ignored items, see
- <xref linkend="svn.advanced.props.special.ignore"
/>.</para>
+ <para>Quand vous exécutez la commande
+ <command>svn status</command>, Subversion affiche la
+ liste des fichiers et répertoires non suivis en versions
+ avec ceux qui sont suivis en versions, en les marquant
+ d'un caractère <literal>?</literal> (voir
+ <xref linkend="svn.tour.cycle.examine.status"/>).
+ Parfois, ces éléments inutiles et non suivis en version
+ ne font que rendre l'affichage plus confus, par exemple
+ dans le cas des fichiers objets générés par les
+ compilations. L'option <option>global-ignores</option>
+ contient une liste de globs séparés par des espaces
+ qui décrivent les noms de fichiers et de répertoires
+ que Subversion ne doit pas afficher, sauf s'ils sont
+ suivis en versions. La valeur par défaut est
+ <literal>*.o *.lo *.la #*# .*.rej
+ *.rej .*~ *~ .#* .DS_Store</literal>.</para>
+
+ <para>Tout comme <command>svn status</command>, les
+ commandes <command>svn add</command> et <command>svn
+ import</command> ignorent les fichiers qui entrent en
+ correspondance avec la liste lors du parcours d'un
+ répertoire. Vous pouvez bloquer ce comportement pour
+ une instance donnée de ces commandes en spécifiant
+ explicitement le nom de fichier ou en utilisant
+ l'option <option>--no-ignore</option> en ligne de
+ commande.</para>
***The diff for this file has been truncated for email.***
More information about the svnbook-dev
mailing list