[svnbook] r5123 committed - branches/1.8/fr/book/ch03-advanced-topics.xml
chris-nanteuil at users.sourceforge.net
chris-nanteuil at users.sourceforge.net
Fri Mar 11 03:28:10 CST 2016
Revision: 5123
http://sourceforge.net/p/svnbook/source/5123
Author: chris-nanteuil
Date: 2016-03-11 09:28:10 +0000 (Fri, 11 Mar 2016)
Log Message:
-----------
Chapter 3 French translation
Manque la fin du chapitre
N?\195?\169cessite une relecture
Modified Paths:
--------------
branches/1.8/fr/book/ch03-advanced-topics.xml
Modified: branches/1.8/fr/book/ch03-advanced-topics.xml
===================================================================
--- branches/1.8/fr/book/ch03-advanced-topics.xml 2016-03-11 09:21:59 UTC (rev 5122)
+++ branches/1.8/fr/book/ch03-advanced-topics.xml 2016-03-11 09:28:10 UTC (rev 5123)
@@ -1,8 +1,12 @@
<!-- -*- sgml -*- -->
<chapter id="svn.advanced">
+<!--
<title>Advanced Topics</title>
+-->
+ <title>Sujets avancés</title>
+<!--
<para>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
@@ -14,12 +18,32 @@
you to run the <command>svn status</command> command almost
unconsciously. For all intents and purposes, you are ready to
use Subversion in a typical environment.</para>
+-->
+ <para>Si vous lisez ce livre chapitre par chapitre, du début à la fin,
+ vous avez acquis maintenant suffisamment de connaissance du
+ fonctionnement de Subversion pour effectuer les opérations les plus
+ courantes de gestion de versions. Vous savez comment extraire une
+ copie de travail du dépôt Subversion. Vous n'avez aucune difficulté
+ à propager vos modifications et à recevoir des mises à jour en
+ utilisant les commandes <command>svn commit</command> et
+ <command>svn update</command>. Vous avez probablement acquis le
+ réflexe, presque inconscient, de lancer la commande
+ <command>svn status</command>. Bref, vous êtes apte à utiliser
+ Subversion dans un environnement normal pour tout type de
+ projet.</para>
+<!--
<para>But the Subversion feature set doesn't stop at <quote>common
version control operations.</quote> It has other bits of
functionality besides just communicating file and
directory changes to and from a central repository.</para>
+-->
+ <para>Mais les fonctionnalités de Subversion ne s'arrêtent pas aux
+ <quote>opérations courantes de gestion de versions</quote>. Il
+ possède d'autres atouts, en plus de permettre simplement le partage
+ de fichiers et de dossiers depuis un dépôt central.</para>
+<!--
<para>This chapter highlights some of Subversion's features that,
while important, may not be part of the typical user's daily routine.
It assumes that you are familiar with Subversion's basic file and
@@ -27,14 +51,27 @@
first read <xref linkend="svn.basic" /> and <xref
linkend="svn.tour" />. Once you've mastered those basics and
consumed this chapter, you'll be a Subversion power user!</para>
+-->
+ <para>Ce chapitre dévoile certaines fonctionnalités de Subversion qui,
+ bien qu'importantes, ne sont pas d'une utilisation quotidienne pour
+ un utilisateur normal. Nous supposons que vous êtes familier avec
+ les possibilités de base de gestion de versions sur les fichiers et
+ dossiers. Sinon, reportez-vous au <xref linkend="svn.basic" />
+ et au <xref linkend="svn.tour" />. Une fois que vous maîtriserez ces
+ bases et que vous aurez assimilé ce chapitre, vous serez un
+ super-utilisateur de Subversion !</para>
<!-- ================================================================= -->
<!-- ================================================================= -->
<!-- ================================================================= -->
<sect1 id="svn.tour.revs.specifiers">
+<!--
<title>Revision Specifiers</title>
+-->
+ <title>Identifiants de révisions</title>
+<!--
<para>As we described in <xref linkend="svn.basic.in-action.revs"
/>, revision numbers in Subversion are pretty
straightforward—integers that keep getting larger as you
@@ -48,8 +85,25 @@
in a commit email, in the output of some other Subversion
operation, or in some other context that would give meaning to
that particular number.</para>
+-->
+ <para>Comme vous avez pu le constater dans
+ <xref linkend="svn.basic.in-action.revs"/>, les numéros de
+ révision dans Subversion sont d'une grande simplicité, formant une
+ suite d'entiers incrémentés au fur et à mesure des changements
+ propagés dans le dépôt. Néanmoins, il ne faudra pas longtemps
+ avant que vous ne puissiez plus vous rappeler exactement quel
+ changement correspond à quelle révision. Heureusement, le
+ fonctionnement normal de Subversion ne requiert pas souvent que
+ vous fournissiez explicitement un numéro de révision pour une
+ opération. Pour les opérations qui nécessitent
+ <emphasis>vraiment</emphasis> un numéro de révision, ce sera
+ généralement un numéro de révision que vous avez vu soit dans un
+ mail de propagation, soit dans la sortie d'une autre opération
+ Subversion, soit dans un autre contexte où ce numéro possédait
+ une signification particulière.</para>
<note>
+<!--
<para>Referring to revision numbers with
an <quote><literal>r</literal></quote> prefix
(<literal>r314</literal>, for example) is an established
@@ -59,8 +113,18 @@
line, you may also use
the <literal>r</literal><replaceable>NNN</replaceable>
syntax.</para>
+-->
+ <para>Faire référence aux numéros de révision avec le préfixe
+ <quote><literal>r</literal></quote> (par exemple
+ <literal>r314</literal>) est d'un usage courant dans la
+ communauté Subversion et est accepté voire encouragé par de
+ nombreux outils en relation avec Subversion. Dans la plupart des
+ cas où vous spécifiez un numéro de révision dans la ligne de
+ commande, vous pouvez tout aussi bien utliser la syntaxe
+ <literal>r</literal><replaceable>NNN</replaceable>.</para>
</note>
+<!--
<para>
<indexterm>
<primary>revisions</primary>
@@ -71,7 +135,20 @@
<command>svn</command> allows as input some additional forms of
revision specifiers: <firstterm>revision keywords</firstterm>
and revision dates.</para>
+-->
+ <para>
+ <indexterm>
+ <primary>révisions</primary>
+ <secondary>mots-clés</secondary>
+ </indexterm>À l'occasion, vous aurez besoin d'indiquer un moment
+ précis dans le temps pour lequel vous n'avez pas encore le numéro
+ de révision sous la main ou en mémoire. C'est pourquoi, en sus des
+ numéros de révision, la commande <command>svn</command> autorise
+ d'autres formes d'appellations pour les révisions : les
+ <firstterm>mots-clés de révision</firstterm> et les dates de
+ révision.</para>
+<!--
<note>
<para>The various forms of Subversion revision specifiers can be
mixed and matched when used to specify revision ranges. For
@@ -85,24 +162,53 @@
evaluated, so you can put whatever you want on the opposite
sides of that colon.</para>
</note>
-
+-->
+ <note>
+ <para>Les différentes formes d'appellations pour les révisions
+ peuvent être mélangées et comparées pour définir des intervalles
+ de révisions. Par exemple, vous pouvez spécifier <option>-r
+ <replaceable>REV1</replaceable>:<replaceable>REV2</replaceable></option>
+ où <replaceable>REV1</replaceable> est un mot-clé de révision et
+ <replaceable>REV2</replaceable> est un numéro de révision, ou
+ bien où <replaceable>REV1</replaceable> est une date et
+ <replaceable>REV2</replaceable> est un numéro de révision. Comme
+ chaque appellation de révision est évaluée indépendamment, vous
+ pouvez placer n'importe quel type d'appellation de chaque côté
+ du symbole deux-points.</para>
+ </note>
+
<!-- =============================================================== -->
<sect2 id="svn.tour.revs.keywords">
+<!--
<title>Revision Keywords</title>
-
+-->
+ <title>Mots-clés de révision</title>
+
<indexterm>
+<!--
<primary>revisions</primary>
<secondary>keywords</secondary>
+-->
+ <primary>révisions</primary>
+ <secondary>mots-clés</secondary>
</indexterm>
+<!--
<para>The Subversion client understands a number of revision
keywords. These keywords can be used instead of integer
- arguments to the <option>--revision</option>
+ arguments to the <option>- -revision</option>
(<option>-r</option>) option, and are resolved into specific
revision numbers by Subversion:</para>
+-->
+ <para>Le client Subversion accepte une grande variété de mots-clés
+ de révision. En tant qu'argument de l'option
+ <option>--revision</option> (<option>-r</option>) ces mots-clés
+ peuvent être utilisés en lieu et place des numéros et sont
+ remplacés par les numéros correspondants par
+ Subversion :</para>
<variablelist>
-
+
<varlistentry>
<term><literal>HEAD</literal></term>
<listitem>
@@ -110,15 +216,23 @@
<primary>HEAD</primary>
</indexterm>
<indexterm>
+<!--
<primary>revisions</primary>
<secondary>keywords</secondary>
+-->
+ <primary>révisions</primary>
+ <secondary>mots-clés</secondary>
<tertiary>HEAD</tertiary>
</indexterm>
+<!--
<para>The latest (or <quote>youngest</quote>) revision in
the repository.</para>
+-->
+ <para>La dernière (c'est-à-dire la plus récente) révision
+ présente dans le dépôt.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><literal>BASE</literal></term>
<listitem>
@@ -126,17 +240,27 @@
<primary>BASE</primary>
</indexterm>
<indexterm>
+<!--
<primary>revisions</primary>
<secondary>keywords</secondary>
+-->
+ <primary>révisions</primary>
+ <secondary>mots-clés</secondary>
<tertiary>BASE</tertiary>
</indexterm>
+<!--
<para>The revision number of an item in a working copy.
If the item has been locally modified, this refers to
the way the item appears without those local
modifications.</para>
+-->
+ <para>Le numéro de révision d'un élément de la copie de
+ travail. Si l'élément a été modifié localement, la
+ <quote>version BASE</quote> fait référence à l'élément tel
+ qu'il était sans ces modifications locales.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><literal>COMMITTED</literal></term>
<listitem>
@@ -144,15 +268,24 @@
<primary>COMMITTED</primary>
</indexterm>
<indexterm>
+<!--
<primary>revisions</primary>
<secondary>keywords</secondary>
+-->
+ <primary>révisions</primary>
+ <secondary>mots-clés</secondary>
<tertiary>COMMITTED</tertiary>
</indexterm>
+<!--
<para>The most recent revision prior to, or equal to,
<literal>BASE</literal>, in which an item changed.</para>
+-->
+ <para>La révision la plus récente avant (ou égale à)
+ <literal>BASE</literal>, dans laquelle un élément a
+ changé.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><literal>PREV</literal></term>
<listitem>
@@ -160,19 +293,30 @@
<primary>PREV</primary>
</indexterm>
<indexterm>
+<!--
<primary>revisions</primary>
<secondary>keywords</secondary>
+-->
+ <primary>révisions</primary>
+ <secondary>mots-clés</secondary>
<tertiary>PREV</tertiary>
</indexterm>
+<!--
<para>The revision immediately <emphasis>before</emphasis>
the last revision in which an item changed.
Technically, this boils down to
<literal>COMMITTED</literal>-1.</para>
+-->
+ <para>La révision <emphasis>précédant</emphasis>
+ immédiatement la dernière révision dans laquelle un
+ élément a changé. Techniquement, cela revient à
+ <literal>COMMITTED</literal>−1.</para>
</listitem>
</varlistentry>
-
+
</variablelist>
+<!--
<para>As can be derived from their descriptions, the
<literal>PREV</literal>, <literal>BASE</literal>, and
<literal>COMMITTED</literal> revision keywords are used only
@@ -180,12 +324,24 @@
to repository URLs. <literal>HEAD</literal>, on the other
hand, can be used in conjunction with both of these path
types.</para>
-
+-->
+ <para>Comme vous pouvez le deviner d'après leur description, les
+ mots-clés de révision <literal>PREV</literal>,
+ <literal>BASE</literal> et <literal>COMMITTED</literal> ne sont
+ utilisés que pour faire référence à un chemin dans la copie de
+ travail ; ils ne s'appliquent pas à des URL du dépôt. En
+ revanche, <literal>HEAD</literal> peut être utilisé avec les
+ deux types de chemin (local ou URL du dépôt).</para>
+
+<!--
<para>Here are some examples of revision keywords in
action:</para>
-
+-->
+ <para>Vous trouvez ci-dessous des exemples de l'utilisation de
+ ces mots-clés :</para>
+
<informalexample>
- <screen>
+ <screen><!--
$ svn diff -r PREV:COMMITTED foo.c
# shows the last change committed to foo.c
@@ -209,30 +365,75 @@
$ svn diff -r BASE:14 foo.c
# compares the unmodified version of foo.c with the way foo.c looked
-# in revision 14
+# in revision 14-->
+$ svn diff -r PREV:COMMITTED machin.c
+# affiche le dernier changement propagé concernant machin.c
+
+$ svn log -r HEAD
+# affiche le message associé à la dernière propagation dans le dépôt.
+
+$ svn diff -r HEAD
+# compare votre copie de travail (avec tous ses changements locaux)
+# à la dernière version de l'arborescence correspondante du dépôt.
+
+$ svn diff -r BASE:HEAD machin.c
+# compare la version non modifiée localement de machin.c avec la dernière
+# version de machin.c dans le dépôt.
+
+$ svn log -r BASE:HEAD
+# affiche, pour le dossier suivi en versions courant, les messages
+# de propagation depuis la dernière mise à jour (svn update).
+
+$ svn update -r PREV machin.c
+# revient une version en arrière pour le fichier machin.c. Ceci diminue
+# de un la révision de la version de travail du fichier machin.c.
+
+$ svn diff -r BASE:14 machin.c
+# compare la version non modifiée localement de machin.c avec
+# la version de ce fichier à la révision 14.
+
+
</screen>
</informalexample>
-
+
</sect2>
-
+
<!-- =============================================================== -->
<sect2 id="svn.tour.revs.dates">
+<!--
<title>Revision Dates</title>
-
+-->
+ <title>Dates de révision</title>
+
<indexterm>
+<!--
<primary>revisions</primary>
<secondary>as dates</secondary>
+-->
+ <primary>révisions</primary>
+ <secondary>dates de révisions</secondary>
</indexterm>
+<!--
<para>Revision numbers reveal nothing about the world outside
the version control system, but sometimes you need to
correlate a moment in real time with a moment in version
- history. To facilitate this, the <option>--revision</option>
+ history. To facilitate this, the <option>- -revision</option>
(<option>-r</option>) option can also accept as input date
specifiers wrapped in curly braces (<literal>{</literal> and
<literal>}</literal>). Subversion accepts the standard
ISO-8601 date and time formats, plus a few others. Here are
some examples.</para>
+-->
+ <para>Les numéros de révision n'ont aucune signification en dehors
+ du système de gestion de versions. Cependant, parfois, vous avez
+ besoin d'associer une date réelle à un moment précis de
+ l'historique des versions. À cette fin, l'option
+ <option>--revision</option> (<option>-r</option>) accepte comme
+ argument une date placée entre accolades (<literal>{</literal>
+ et <literal>}</literal>). Subversion accepte les dates et les
+ heures aux formats définis dans le standard ISO-8601 ainsi que
+ quelques autres formats. Voici quelques exemples :</para>
<informalexample>
<screen>
@@ -252,31 +453,53 @@
</informalexample>
<note>
+<!--
<para>Keep in mind that most shells will require you to, at a
minimum, quote or otherwise escape any spaces that are
included as part of revision date specifiers. Certain
shells may also take issue with the unescaped use of curly
braces, too. Consult your shell's documentation for the
requirements specific to your environment.</para>
+-->
+ <para>Gardez à l'esprit que la plupart des interpréteurs de
+ commandes (shells) requerront de mettre les dates qui
+ contiennent des espaces entre guillemets ou
+ <quote>d'échapper</quote> les espaces. Certains interpréteurs
+ peuvent aussi poser problème avec les accolades si elles ne
+ sont pas échappées. Consulter la documentation de votre
+ interpréteur pour connaître les spécificités de votre
+ environnement.</para>
</note>
-
+
+<!--
<para>When you specify a date, Subversion resolves that date to
the most recent revision of the repository as of that date,
and then continues to operate against that resolved revision
number:</para>
-
+-->
+ <para>Quand vous spécifiez une date, Subversion convertit cette
+ date vers le numéro de révision le plus récent du dépôt à la
+ date spécifiée. Puis, il continue son travail avec ce numéro de
+ révision :</para>
+
<informalexample>
<screen>
$ svn log -r {2006-11-28}
-------------------------------------------------------------------------
+------------------------------------------------------------------------ <!--
r12 | ira | 2006-11-27 12:31:51 -0600 (Mon, 27 Nov 2006) | 6 lines
+-->
+r12 | ira | 2006-11-27 12:31:51 -0600 (lun. 27 nov. 2006) | 6 lignes
…
</screen>
</informalexample>
-
+
<sidebar>
+<!--
<title>Is Subversion a Day Early?</title>
-
+-->
+ <title>Subversion retarde-t-il d'une journée ?</title>
+
+<!--
<para>If you specify a single date as a revision without
specifying a time of day (for example
<literal>2006-11-27</literal>), you may think that Subversion
@@ -289,25 +512,48 @@
<literal>2006-11-27</literal>, Subversion assumes a time of
00:00:00, so looking for the most recent revision won't
return anything on the 27th.</para>
+-->
+ <para>Si vous spécifiez une date de révision sans préciser
+ l'heure (par exemple <literal>2006-11-27</literal>), vous
+ pourriez penser que Subversion vous donne la dernière
+ révision qui a eu lieu le 27 novembre. En fait, vous aurez une
+ révision datant du 26, voire même avant. Souvenez-vous que
+ Subversion renvoie <emphasis>la révision la plus récente du
+ dépôt</emphasis> à la date spécifiée. Si vous spécifiez une
+ date sans préciser l'heure, comme <literal>2006-11-27</literal>,
+ Subversion utilise alors 00h00 comme heure et la recherche de
+ la plus récente révision ne renvoit donc pas de résultat
+ correspondant au 27 novembre.</para>
+<!--
<para>If you want to include the 27th in your search, you can
either specify the 27th with the time (<literal>{"2006-11-27
23:59"}</literal>), or just specify the next day
(<literal>{2006-11-28}</literal>).</para>
-
+-->
+ <para>Si vous voulez inclure le 27 dans votre recherche, vous
+ pouvez soit spécifier une heure (<literal>{"2006-11-27
+ 23:59"}</literal>), soit simplement spécifier le jour suivant
+ (<literal>{2006-11-28}</literal>).</para>
</sidebar>
-
+
+<!--
<para>You can also use a range of dates. Subversion will find
all revisions between both dates, inclusive:</para>
-
+-->
+ <para>Vous pouvez également utiliser des intervalles de dates.
+ Subversion trouve alors les révisions incluses entre ces deux
+ dates :</para>
+
<informalexample>
<screen>
$ svn log -r {2006-11-20}:{2006-11-29}
…
</screen>
</informalexample>
-
+
<warning>
+<!--
<para>Since the timestamp of a revision is stored as an
unversioned, modifiable property of the revision (see <xref
linkend="svn.advanced.props" />), revision timestamps can be
@@ -320,18 +566,37 @@
you will likely find that trying to use dates to specify
revision ranges in your repository doesn't always return the
data you might have expected.</para>
+-->
+
+ <para>Puisque l'horodatage d'une révision est stocké comme une
+ propriété modifiable et non suivie en versions de la révision
+ (reportez-vous à <xref linkend="svn.advanced.props" />), les
+ horodatages peuvent être changés et ne pas refléter la
+ chronologie réelle. Ils peuvent même être tous supprimés. Or
+ la capacité de Subversion à convertir correctement les dates
+ en numéros de révision dépend des horodatages de révisions et
+ de leur ordonnancement correct dans le temps : à une
+ révision antérieure correspond un horodatage antérieur. Si cet
+ ordonnancement n'est pas maintenu, il y a de grandes chances
+ que l'utilisation des dates pour spécifier des intervalles de
+ révisions dans votre dépôt ne fournisse pas les résultats
+ attendus.</para>
</warning>
-
+
</sect2>
-
+
</sect1>
<!-- ================================================================= -->
<!-- ================================================================= -->
<!-- ================================================================= -->
<sect1 id="svn.advanced.pegrevs">
+<!--
<title>Peg and Operative Revisions</title>
+-->
+ <title>Révisions pivots et révisions opérationnelles</title>
+<!--
<para>We copy, move, rename, and completely replace files and
directories on our computers all the time. And your version
control system shouldn't get in the way of your doing these
@@ -345,7 +610,22 @@
versioned objects. This introduces a certain level of
complexity to your interactions with those paths and
objects.</para>
+-->
+ <para>Continuellement, nous copions, déplaçons, renommons et
+ remplaçons des fichiers et des dossiers sur nos ordinateurs.
+ Et votre système de gestion de versions ne doit pas être un
+ obstacle à ces opérations sur les fichiers et dossiers suivis
+ en versions. La gestion des fichiers par Subversion se fait
+ pratiquement oublier, étant presque aussi flexible pour les
+ fichiers suivis en versions que pour les autres. Mais cette
+ flexibilité signifie qu'au cours de la vie de votre dépôt un objet
+ suivi en versions a un certain nombre de chemins et qu'un
+ chemin donné peut représenter plusieurs objets suivis en
+ versions tout à fait différents. Cela ajoute un niveau de
+ complexité supplémentaire dans les actions sur les chemins et les
+ objets.</para>
+<!--
<para>Subversion is pretty smart about noticing when an object's
version history includes such <quote>changes of address.</quote>
For example, if you ask for the revision history log of a
@@ -355,7 +635,18 @@
and after that rename. So, most of the time, you don't even
have to think about such things. But occasionally, Subversion
needs your help to clear up ambiguities.</para>
+-->
+ <para>Subversion est plutôt adroit pour détecter les
+ <quote>changements d'adresses</quote> dans l'historique du suivi
+ de versions d'un objet. Par exemple, si vous demandez l'historique
+ d'un fichier qui a été renommé la semaine dernière, Subversion
+ fournit ce journal :la révision dans laquelle s'est produit
+ le changement de nom et les journaux pertinents avant et après ce
+ renommage. Ainsi, la plupart du temps, vous n'avez pas à vous
+ préoccuper de ces opérations. Mais il arrive que Subversion ait
+ besoin de votre aide pour lever des ambiguïtés.</para>
+<!--
<para>The simplest example of this occurs when a directory or file
is deleted from version control, and then a new directory or
file is created with the same name and added to version control.
@@ -369,7 +660,22 @@
have happened to <emphasis>all</emphasis> the objects that have
ever lived at that path? Subversion needs a hint about what you
really want.</para>
+-->
+ <para>L'exemple correspondant le plus simple est quand un fichier ou
+ un dossier est supprimé du suivi de versions, puis qu'un
+ nouveau dossier ou fichier est créé avec le même nom et ajouté
+ au suivi de versions. L'objet qui a été effacé et celui qui a été
+ ajouté plus tard ne sont pas les mêmes. Ils se trouve qu'ils ont
+ juste le même chemin (<filename>/trunk/objet</filename> par
+ exemple). Que signifie alors de demander à Subversion l'historique
+ de <filename>/trunk/objet</filename> ? La question
+ concerne-t-elle l'objet actuellement à cet emplacement ou l'objet
+ précédent qui a été supprimé ? Ou encore les opérations sur
+ <emphasis>tous</emphasis> les objets qui ont résidé à cet
+ emplacement ? Subversion a besoin de savoir ce que vous
+ demandez réellement.</para>
+<!--
<para>And thanks to moves, versioned object history can get far
more twisted than even that. For example, you might have a
directory named <filename>concept</filename>, containing some
@@ -386,7 +692,28 @@
Frabnaggilywort releases a 1.0 version and is downloaded and
used daily by hordes of people aiming to improve their
lives.</para>
-
+-->
+ <para>Et, en raison des déplacements, l'historique des objets suivis
+ en versions peut être beaucoup plus tordu que cela. Par exemple,
+ vous pouvez avoir un dossier appelé
+ <filename>concept</filename>, contenant une ébauche de projet
+ logiciel sur lequel vous vous êtes essayé. Il se peut que ce
+ projet mûrisse et que l'idée soit pertinente au point que, chose
+ inimaginable, vous décidiez de donner un nom au projet
+ <footnote>
+ <para><quote>Sulli, il ne faut pas l'appeler ! Tu commences
+ par l'appeler et tu finis par t'attacher</quote>, Bob Razowski
+ (le cyclope de Monstres et Cie).</para>
+ </footnote>.
+ Imaginons que vous nommiez ce logiciel
+ <filename>Frabnaggilywort</filename>. Il semble alors logique de
+ renommer le dossier <filename>concept</filename> en
+ <filename>frabnaggilywort</filename> pour refléter le nom du
+ projet. L'eau coule sous les ponts et Frabnaggilywort sort en
+ version 1.0, est téléchargé et utilisé quotidiennement par des
+ tonnes de gens qui veulent se faciliter la vie.</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,
@@ -399,7 +726,21 @@
<filename>concept</filename> to something else for a while, but
later rename the thing back to <filename>concept</filename> for
some reason.</para>
+-->
+ <para>Quelle belle histoire ! Mais elle ne s'arrête pas là.
+ Comme vous avez une âme d'entrepreneur, vous avez déjà une autre
+ idée derrière la tête : vous créez donc un nouveau dossier
+ <filename>concept</filename> et la boucle est bouclée. En fait,
+ ce cycle recommence plusieurs fois au fil du temps, à chaque fois
+ à partir de ce vieux dossier <filename>concept</filename>
+ qui, quelquefois, est renommé, quand l'idée plaît et, d'autres
+ fois, est effacé quand l'idée ne convient pas. En plus, pour être
+ réellement tordu, vous donnez parfois à
+ <filename>concept</filename> un autre nom temporaire, puis
+ renommez ce même dossier <filename>concept</filename> pour une
+ raison quelconque.</para>
+<!--
<para>In scenarios like these, attempting to instruct
Subversion to work with these reused paths can be a little like
instructing a motorist in Chicago's West Suburbs to drive east
@@ -408,7 +749,18 @@
Wheaton, Glen Ellyn, and Lombard. And no, they aren't the same
street. Our motorist—and our Subversion—need a
little more detail to do the right thing.</para>
+-->
+ <para>Avec de tels scénarios, demander à Subversion d'apprendre à
+ travailler avec ces renommages multiples est un peu comme dire à
+ un automobiliste de la banlieue de prendre la direction de Paris
+ et de prendre à gauche sur <quote>la rue du Château
+ </quote> : il croisera la rue du Château à Asnières,
+ La Garenne-Colombes, Nanterre, Neuilly, Rueil-Malmaison, …
+ et, non, ce n'est pas la même rue à chaque fois. De la même
+ manière, Subversion a besoin d'un peu plus de précisions pour
+ travailler correctement.</para>
+<!--
<para>
<indexterm>
<primary>revisions</primary>
@@ -433,7 +785,38 @@
called because the syntax involves appending an <quote>at
sign</quote> (<literal>@</literal>) and the peg revision to the
end of the path with which the revision is associated.</para>
+-->
+ <para>
+ <indexterm>
+ <primary>révisions</primary>
+ <secondary>révisions pivots</secondary>
+ </indexterm>
+ <indexterm>
+ <primary>peg revisions</primary>
+ <see>révisions pivots</see>
+ </indexterm>
+ <indexterm>
+ <primary>syntaxe at</primary>
+ </indexterm>
+ <indexterm>
+ <primary>@</primary>
+ <see>syntaxe at</see>
+ </indexterm>Heureusement, Subversion vous permet de lui indiquer
+ de quelle rue du Château vous parlez exactement. Le mécanisme
+ utilisé s'appelle les <firstterm>révisions pivots</firstterm>
+ et vous les fournissez à Subversion uniquement pour identifier de
+ manière unique une ligne de l'historique. Comme il y a au plus
+ un objet suivi en versions à un endroit et à un moment donnés (ou
+ plus précisément à une révision donnée), la combinaison d'un
+ chemin et d'une révision pivot est tout ce dont vous avez
+ besoin pour désigner une ligne spécifique de l'historique. Les
+ révisions pivots sont indiquées au client Subversion en
+ utilisant la notation <firstterm>at</firstterm> (on l'appelle
+ ainsi parce que la syntaxe de la commande utilise le signe
+ <quote>arobase</quote> :<literal>@</literal>) suivi de la
+ révision pivot demandée, en fin de chemin.</para>
+<!--
<para>
<indexterm>
<primary>revisions</primary>
@@ -442,7 +825,7 @@
<indexterm>
<primary>revisions</primary>
<secondary>operative revision range</secondary>
- </indexterm>But what of the <option>--revision</option>
+ </indexterm>But what of the <option>- -revision</option>
(<option>-r</option>) of which we've spoken so much in this
book? That revision (or set of revisions) is called the
<firstterm>operative revision</firstterm> (or
@@ -462,43 +845,111 @@
throw in <quote>606 N.</quote> as our operative revision of
sorts, and we know <emphasis>exactly</emphasis> where to
go.</para>
+-->
+ <para>
+ <indexterm>
+ <primary>révisions</primary>
+ <secondary>révisions opérationnelles</secondary>
+ </indexterm>
+ <indexterm>
+ <primary>révisions</primary>
+ <secondary>intervalle de révisions opérationnelles</secondary>
+ </indexterm>Mais alors qu'en est-il de l'option
+ <option>--revision</option> (<option>-r</option>) dont nous avons
+ tant parlé dans ce livre ? Cette révision (ou ensemble de
+ révisions) est appelée la <firstterm>révision
+ opérationnelle</firstterm> (ou <firstterm>intervalle de révisions
+ opérationnelles</firstterm>). Une fois qu'une ligne particulière
+ de l'historique a été identifiée en utilisant un chemin et une
+ révision pivot, Subversion effectue la requête en utilisant la
+ révision opérationnelle (ou l'intervallle de révisions
+ opérationnelles). Pour reprendre notre analogie avec les rues
+ françaises, si on vous dit d'aller au 15 de la rue du Château à
+ Rueil-Malmaison <footnote>
+ <para>Au 15 de la rue du Château à Rueil-Malmaison se trouve
+ un musée d'<emphasis>histoire</emphasis> (consacré à Joséphine,
+ épouse de Napoléon). Cela nous a semblé approprié…</para>
+ </footnote>,
+ vous pouvez penser que <quote>la rue du Château</quote>
+ est le chemin dans le système de fichiers et
+ <quote>Rueil-Malmaison</quote> la révision pivot. Ces deux
+ informations identifient de manière unique une route donnée et
+ vous évitent de parcourir une autre rue du Château à
+ la recherche de votre destination finale. Maintenant, vous pouvez
+ rechercher le <quote>15</quote> comme numéro de révision
+ opérationnelle puisque nous savons <emphasis>exactement</emphasis>
+ où aller.</para>
<sidebar id="svn.advanced.pegrevs.algorithm">
+<!--
<title>The Peg Revision Algorithm</title>
-
+-->
+ <title>Algorithme des révisions pivots</title>
+
+<!--
<para>The Subversion command-line client performs the peg revision
algorithm any time it needs to resolve possible ambiguities in
the paths and revisions provided to it. Here's an example of
such an invocation:</para>
+-->
+ <para>Le client texte interactif Subversion utilise l'algorithme
+ des révisions pivots chaque fois qu'il doit résoudre une
+ ambiguïté dans les chemins et numéros de versions fournis en
+ ligne de commande. Voici un exemple d'une telle ligne de
+ commande :</para>
<informalexample>
- <screen>
-$ svn <replaceable>command</replaceable> -r <replaceable>OPERATIVE-REV</replaceable> item@<replaceable>PEG-REV</replaceable>
+ <screen><!--
+$ svn <replaceable>command</replaceable> -r <replaceable>OPERATIVE-REV</replaceable> item@<replaceable>PEG-REV</replaceable>-->
+$ svn <replaceable>commande</replaceable> -r <replaceable>RÉVISION-OPÉRATIONNELLE</replaceable> élément@<replaceable>RÉVISION-PIVOT</replaceable>
+
</screen>
</informalexample>
-
+
+<!--
<para>If <replaceable>OPERATIVE-REV</replaceable> is older than
<replaceable>PEG-REV</replaceable>, the algorithm is as
follows:</para>
+-->
+ <para>Si <replaceable>RÉVISION-OPERATIONNELLE</replaceable> est
+ plus vieille que <replaceable>RÉVISION-PIVOT</replaceable>,
+ alors l'algorithme est le suivant :</para>
<orderedlist>
<listitem>
+<!--
<para>Locate <replaceable>item</replaceable> in the revision
identified by <replaceable>PEG-REV</replaceable>. There
can be only one such object.</para>
+-->
+ <para>Trouver <replaceable>élément</replaceable> dans la
+ révision identifiée par
+ <replaceable>RÉVISION-PIVOT</replaceable>. Il ne peut y
+ avoir qu'un seul objet.</para>
</listitem>
<listitem>
+<!--
<para>Trace the object's history backwards (through any
possible renames) to its ancestor in the revision
<replaceable>OPERATIVE-REV</replaceable>.</para>
+-->
+ <para>Parcourir l'historique de l'objet à l'envers (y compris
+ en tenant compte d'éventuels renommages) jusqu'à son ancêtre
+ dans la révision
+ <replaceable>RÉVISION-OPERATIONNELLE</replaceable>.</para>
</listitem>
<listitem>
+<!--
<para>Perform the requested action on that ancestor,
wherever it is located, or whatever its name might
be or might have been at that time.</para>
+-->
+ <para>Effectuer la requête sur cet ancêtre, où qu'il soit et
+ quel que soit son nom (actuel et à ce moment là).</para>
</listitem>
</orderedlist>
+<!--
<para>But what if <replaceable>OPERATIVE-REV</replaceable> is
<emphasis>younger</emphasis> than
<replaceable>PEG-REV</replaceable>? Well, that adds some
@@ -510,19 +961,47 @@
all—Subversion doesn't store enough information to
performantly trace an object's history forward, anyway. So
the algorithm is a little different:</para>
+-->
+ <para>Mais que se passe-t-il si
+ <replaceable>RÉVISION-OPERATIONNELLE</replaceable> est
+ <emphasis>plus récente</emphasis> que
+ <replaceable>RÉVISION-PIVOT</replaceable> ? Et bien,
+ cela ajoute un peu de complexité à la recherche du chemin dans
+ <replaceable>RÉVISION-OPERATIONNELLE</replaceable>, parce que
+ l'historique du chemin peut avoir bifurqué à plusieurs reprises
+ (en raison d'opérations de copie) entre
+ <replaceable>RÉVISION-PIVOT</replaceable> et
+ <replaceable>RÉVISION-OPERATIONNELLE</replaceable>. Et ce n'est
+ pas tout car, de toute façon, Subversion ne stocke pas
+ suffisamment d'informations pour retracer de façon performante
+ l'historique d'un élément dans le sens chronologique. Donc, dans
+ ce cas, l'algorithme est un peu différent :</para>
<orderedlist>
<listitem>
+<!--
<para>Locate <replaceable>item</replaceable> in the revision
identified by <replaceable>OPERATIVE-REV</replaceable>. There
can be only one such object.</para>
+-->
+ <para>Trouver <replaceable>élément</replaceable> dans la
+ révision identifiée par
+ <replaceable>RÉVISION-OPERATIONNELLE</replaceable>.
+ Il ne peut y avoir qu'un seul objet.</para>
</listitem>
<listitem>
+<!--
<para>Trace the object's history backward (through any
possible renames) to its ancestor in the revision
<replaceable>PEG-REV</replaceable>.</para>
+-->
+ <para>Parcourir l'historique de l'objet à l'envers (y compris
+ en tenant compte d'éventuels renommages) jusqu'à son ancêtre
+ dans la révision
+ <replaceable>RÉVISION-PIVOT</replaceable>.</para>
</listitem>
<listitem>
+<!--
<para>Verify that the object's location (path-wise) in
<replaceable>PEG-REV</replaceable> is the same as it is in
<replaceable>OPERATIVE-REV</replaceable>. If that's the
@@ -534,9 +1013,23 @@
(Someday, we expect that Subversion will be able to handle
this usage scenario with more flexibility and
grace.)</para>
+-->
+ <para>Vérifier que la position de l'objet (son chemin) dans
+ <replaceable>RÉVISION-PIVOT</replaceable> est la même
+ que dans <replaceable>RÉVISION-OPERATIONNELLE</replaceable>.
+ Si c'est le cas, c'est-à-dire que l'on sait que les deux
+ positions sont directement liées, effectuer la requête sur
+ la position dans
+ <replaceable>RÉVISION-OPERATIONNELLE</replaceable>.
+ Sinon, c'est-à-dire si la relation entre les deux n'est pas
+ établie, renvoyer une erreur expliquant qu'aucune position
+ viable n'a été trouvée. On peut espérer qu'un jour
+ Subversion sera plus flexible et saura mieux gérer ce type
+ de cas.</para>
</listitem>
</orderedlist>
+<!--
<para>Note that even when you don't explicitly supply a peg
revision or operative revision, they are still present. For
your convenience, the default peg revision is
@@ -544,9 +1037,18 @@
<literal>HEAD</literal> for repository URLs. And when no
operative revision is provided, it defaults to being the same
revision as the peg revision.</para>
-
+-->
+ <para>Notez que même quand vous ne spécifiez pas explicitement de
+ révision pivot ni de révision opérationnelle, elles
+ sont néanmoins présentes. Par défaut, la valeur de la révision
+ pivot est <literal>BASE</literal> pour les éléments de la
+ copie de travail et <literal>HEAD</literal> pour les URL du
+ dépôt. Et quand aucune révision opérationnelle n'est fournie,
+ la valeur par défaut est celle de la révision pivot.</para>
+
</sidebar>
+<!--
<para>Say that long ago we created our repository, and in revision 1
we added our first <filename>concept</filename> directory, plus an
<filename>IDEA</filename> file in that directory talking about
@@ -557,7 +1059,21 @@
hold it, and a new <filename>IDEA</filename> file to describe
it. And then five years and thousands of revisions flew by,
just like they would in any good romance story.</para>
+-->
+ <para>Supposons que nous ayons créé notre dépôt il y a longtemps et
+ que dans la révision 1 nous ayons ajouté notre premier
+ dossier <filename>concept</filename> ainsi qu'un fichier
+ <filename>IDÉE</filename>, situé dans ce dossier, contenant la
+ description du concept. Nous avons ensuite ajouté et modifié de
+ véritables lignes de code. À la révision 20, nous avons renommé ce
+ dossier en <filename>frabnaggilywort</filename>. Lors de la
+ révision 27, nous développons un nouveau concept et un nouveau
+ dossier <filename>concept</filename> est créé pour l'héberger,
+ avec un nouveau fichier <filename>IDÉE</filename> pour le décrire.
+ Cinq ans et vingt mille révisions passent, comme dans tout bon
+ roman d'amour.</para>
+<!--
<para>Now, years later, we wonder what the
<filename>IDEA</filename> file looked like back in revision 1.
But Subversion needs to know whether we are asking about how the
@@ -568,29 +1084,59 @@
revisions, you can ask those questions. To find out how the
current <filename>IDEA</filename> file looked in that old
revision, you run:</para>
+-->
+ <para>À présent, plusieurs années plus tard, nous nous demandons à
+ quoi ressemblait le fichier <filename>IDÉE</filename> en révision
+ 1. Mais Subversion a besoin de savoir si nous demandons à quoi
+ ressemble le fichier <emphasis>actuel</emphasis> tel qu'il était
+ lors de la révision 1 ou si nous demandons le contenu du fichier
+ positionné dans l'arborescence à <filename>concept/IDÉE</filename>
+ au moment de la révision 1. Ces questions ont certainement des
+ réponses différentes et grâce aux révisions pivots, nous
+ pouvons poser ces deux questions. Pour obtenir le contenu du
+ fichier <filename>IDÉE</filename> actuel tel qu'il était dans
+ cette vieille révision, tapez :</para>
<informalexample>
- <screen>
-$ svn cat -r 1 concept/IDEA
+ <screen><!--
+$ svn cat -r 1 concept/IDEA
svn: E195012: Unable to find repository location for 'concept/IDEA' in revision 1
+-->
+$ svn cat -r 1 concept/IDÉE
+svn: E195012: Impossible de trouver la localisation dans le dépôt de 'concept/IDÉE' pour la révision 1
</screen>
</informalexample>
+<!--
<para>Of course, in this example, the current
<filename>IDEA</filename> file didn't exist yet in revision 1,
so Subversion gives an error. The previous command is shorthand
for a longer notation which explicitly lists a peg revision.
The expanded notation is:</para>
+-->
+ <para>Bien sûr, dans cet exemple, le fichier
+ <filename>IDÉE</filename> actuel n'existait pas lors de la
+ révision 1, c'est pourquoi Subversion renvoie une erreur. La
+ commande ci-dessus est un raccourci pour la notation plus longue
+ qui explicite la révision pivot. La notation complète est
+ donc :</para>
<informalexample>
- <screen>
+ <screen><!--
$ svn cat -r 1 concept/IDEA at BASE
svn: E195012: Unable to find repository location for 'concept/IDEA' in revision 1
+-->
+$ svn cat -r 1 concept/IDÉE at BASE
+svn: E195012: Impossible de trouver la localisation dans le dépôt de 'concept/IDÉE' pour la révision 1
</screen>
</informalexample>
+<!--
<para>And when executed, it has the expected results.</para>
+-->
+ <para>On obtient bien le résultat attendu.</para>
+<!--
<para>The perceptive reader is probably wondering at this point whether
the peg revision syntax causes problems for working copy paths
or URLs that actually have at signs in them. After
@@ -607,28 +1153,68 @@
even applies to paths that end in an at sign—you would
use <literal>filename@@</literal> to talk about a file named
<filename>filename@</filename>.</para>
+-->
+ <para>Le lecteur perspicace est certainement en train de se demander
+ si la syntaxe des révisions pivots ne pose pas de problèmes
+ pour les chemins ou les URL qui comportent déjà le signe arobase.
+ Après tout, comment <command>svn</command> peut-il savoir si
+ <literal>nouveau at 11</literal> est le nom d'un dossier dans mon
+ arborescence ou juste la syntaxe pour <quote>révision 11 de
+ <filename>nouveau</filename></quote> ? Dieu merci, alors que
+ <command>svn</command> opte par défaut pour cette dernière
+ hypothèse, il existe une solution de contournement triviale :
+ il suffit juste d'ajouter un signe arobase à la fin du
+ chemin, comme ceci : <literal>nouveau at 11@</literal>.
+ <command>svn</command> ne s'intéresse qu'au dernier arobase de
+ l'argument et il n'est pas considéré comme illégal d'omettre le
+ spécificateur de révision pivot après cet arobase. Cette
+ solution de contournement s'applique même aux chemins qui se
+ terminent par arobase (utilisez
+ <literal>nom-du-fichier@@</literal> pour désigner le fichier
+ <filename>nom-du-fichier@</filename>.</para>
+<!--
<para>Let's ask the other question, then—in revision 1, what
were the contents of whatever file occupied the address
<filename>concepts/IDEA</filename> at the time? We'll use an
explicit peg revision to help us out.</para>
+-->
+ <para>Posons maintenant l'autre question : dans la révision 1,
+ quel était le contenu du fichier qui occupait l'adresse
+ <filename>concept/IDÉE</filename> à ce moment là ? Nous
+ allons utiliser explicitement une révision pivot pour nous
+ aider :</para>
<informalexample>
- <screen>
+ <screen><!--
$ svn cat concept/IDEA at 1
The idea behind this project is to come up with a piece of software
that can frab a naggily wort. Frabbing naggily worts is tricky
business, and doing it incorrectly can have serious ramifications, so
we need to employ over-the-top input validation and data verification
-mechanisms.
+mechanisms.-->
+$ svn cat concept/IDÉE at 1
+L'idée de ce projet est de fournir un logiciel qui peut frabber un
+naggily wort. Frabber les naggilys worts est particulièrement difficile
+et ne pas le faire correctement aurait des conséquences inimaginables.
+Nous devons donc utiliser des mécanismes de vérification des
+entrées et des données du dernier cri.
</screen>
</informalexample>
+<!--
<para>Notice that we didn't provide an operative revision this
time. That's because when no operative revision is specified,
Subversion assumes a default operative revision that's the same
as the peg revision.</para>
+-->
+ <para>Remarquez que cette fois nous n'avons pas fourni de révision
+ opérationnelle. C'est parce que, quand aucune révision
+ opérationnelle n'est spécifiée, Subversion considère que le
+ numéro de révision opérationnelle est égal au numéro de révision
+ pivot.</para>
+<!--
<para>As you can see, the output from our operation appears to be
correct. The text even mentions frabbing naggily worts, so this
is almost certainly the file that describes the software now
@@ -641,18 +1227,38 @@
<literal>HEAD</literal> as the path
<filename>frabnaggilywort/IDEA</filename> looked in revision
1.</para>
+-->
+ <para>Comme vous pouvez le constater, la résultat de la commande
+ semble être correct. Le texte parle même de "frabber les naggilys
+ worts", ce qui laisse supposer que c'est certainement le fichier
+ décrivant le logiciel maintenant connu sous le nom de
+ Frabnaggilywort. En fait, on peut le vérifier en combinant une
+ révision pivot explicite et une révision opérationnelle explicite.
+ Nous savons que dans <literal>HEAD</literal>, le projet
+ Frabnaggilywort se situe dans le dossier
+ <filename>frabnaggilywort</filename>. Nous spécifions donc que
+ nous voulons voir à quoi ressemblait le fichier
+ <filename>frabnaggilywort/IDÉE</filename> identifié dans
+ <literal>HEAD</literal> au moment de la révision 1.</para>
<informalexample>
- <screen>
+ <screen><!--
$ svn cat -r 1 frabnaggilywort/IDEA at HEAD
The idea behind this project is to come up with a piece of software
that can frab a naggily wort. Frabbing naggily worts is tricky
business, and doing it incorrectly can have serious ramifications, so
we need to employ over-the-top input validation and data verification
-mechanisms.
+mechanisms.-->
+$ svn cat -r 1 frabnaggilywort/IDÉE at HEAD
+L'idée de ce projet est de fournir un logiciel qui peut frabber un
+naggily wort. Frabber les naggilys worts est particulièrement difficile
+et ne pas le faire correctement aurait des conséquences inimaginables.
+Nous devons donc utiliser des mécanismes de vérification des
+entrées et des données du dernier cri.
</screen>
</informalexample>
+<!--
<para>And the peg and operative revisions need not be so trivial,
either. For example, say <filename>frabnaggilywort</filename>
had been deleted from <literal>HEAD</literal>, but we know it
@@ -662,13 +1268,25 @@
would have held Frabnaggilywort's <filename>IDEA</filename> file
in revision 20, and then use 4 and 10 as our operative revision
range.</para>
+-->
+ <para>Vous pouvez aussi spécifier des révisions pivots et des
+ révisions opérationnelles moins triviales. Par exemple, disons
+ que <filename>frabnaggilywort</filename> a été effacé de
+ <literal>HEAD</literal>, mais nous savons qu'il existait en
+ révision 20 et nous voulons voir les différences entre la
+ révision 4 et la révision 10 pour son fichier
+ <filename>IDÉE</filename>. Nous pouvons utiliser la révision pivot
+ 20 en conjonction avec l'URL qu'avait le fichier
+ <filename>frabnaggilywort/IDÉE</filename> dans la révision 20
+ et utiliser 4 et 10 pour spécifier l'intervalle de révisions
+ opérationnelles.</para>
<informalexample>
- <screen>
+ <screen> <!--
$ svn diff -r 4:10 http://svn.red-bean.com/projects/frabnaggilywort/IDEA@20
Index: frabnaggilywort/IDEA
===================================================================
---- frabnaggilywort/IDEA (revision 4)
+- - frabnaggilywort/IDEA (revision 4)
+++ frabnaggilywort/IDEA (revision 10)
@@ -1,5 +1,5 @@
-The idea behind this project is to come up with a piece of software
@@ -680,13 +1298,36 @@
+client-server software that can remotely frab a naggily wort.
+Frabbing naggily worts is tricky business, and doing it incorrectly
+can have serious ramifications, so we need to employ over-the-top
-+input validation and data verification mechanisms.
++input validation and data verification mechanisms.-->
+$ svn diff -r 4:10 http://svn.red-bean.com/projets/frabnaggilywort/IDÉE@20
+Index: frabnaggilywort/IDÉE
+===================================================================
+--- frabnaggilywort/IDÉE (révision 4)
++++ frabnaggilywort/IDÉE (révision 10)
+@@ -1,5 +1,5 @@
+-L'idée de ce projet est de fournir un logiciel qui peut frabber un
+-naggily wort. Frabber les naggilys worts est particulièrement difficile
+-et ne pas le faire correctement aurait des conséquences inimaginables.
+-Nous devons donc utiliser des mécanismes de vérification des
+-entrées et des données du dernier cri.
++L'idée de ce projet est de fournir un logiciel client-serveur qui peut
++frabber un naggily wort de manière distante. Frabber les naggilys worts
++est particulièrement difficile et ne pas le faire correctement aurait
++des conséquences inimaginables. Nous devons donc utiliser des mécanismes
++de vérification des entrées et des données du dernier cri.
</screen>
</informalexample>
+<!--
<para>Fortunately, most folks aren't faced with such complex
situations. But when you are, remember that peg revisions are
that extra hint Subversion needs to clear up ambiguity.</para>
+-->
+ <para>Heureusement, la plupart d'entre vous n'auront pas à faire
+ face à des situations aussi complexes. Mais si jamais c'est le
+ cas, rappelez-vous que les révisions pivots sont les
+ informations complémentaires dont a besoin Subversion pour lever
+ toute ambiguïté.</para>
</sect1>
@@ -694,17 +1335,38 @@
<!-- ================================================================= -->
<!-- ================================================================= -->
<sect1 id="svn.advanced.props">
+<!--
<title>Properties</title>
+-->
+ <title>Propriétés</title>
+ <indexterm>
+<!--
+ <primary>properties</primary>
+-->
+ <primary>propriétés</primary>
+ </indexterm>
+<!--
<para>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
if the versioning support stopped there, Subversion would still
be complete from a version control perspective.</para>
+-->
+ <para>Nous avons vu en détail comment Subversion stocke et récupère
+ les différentes versions des fichiers et dossiers dans le
+ dépôt. Des chapitres entiers ont décrit cette fonctionnalité
+ fondamentale de l'outil. Et si la gestion de versions se limitait
+ à ça, Subversion couvrirait déjà complètement les besoins
+ attendus pour un système de gestion de versions.</para>
+<!--
<para>But it doesn't stop there.</para>
+-->
+ <para>Mais ce n'est pas tout.</para>
+<!--
<para>
<indexterm>
<primary>properties</primary>
@@ -724,7 +1386,30 @@
receiving of property changes occurs as part of your typical
commit and update operations—you don't have to change your
basic processes to accommodate them.</para>
+-->
+ <para>
+ <indexterm>
+ <primary>propriétés</primary>
+ </indexterm>En plus de gérer les versions de vos dossiers et de
+ vos fichiers, Subversion fournit une interface pour ajouter,
+ modifier et supprimer des méta-données suivies en versions pour
+ chacun de vos dossiers et de vos fichiers. On appelle ces
+ méta-données des <firstterm>propriétés</firstterm>. Elles peuvent
+ être pensées comme des tableaux à deux colonnes, qui associent des
+ noms de propriétés à des valeurs arbitraires, pour chaque élément
+ de votre copie de travail. En termes simples, vous pouvez assigner
+ n'importe quel nom et n'importe quelle valeur à vos propriétés, à
+ la seule condition que le nom ne contiennent que des caractères
+ ASCII. Et l'atout principal de ces propriétés réside dans le fait
+ que ces propriétés sont également suivies en versions, tout comme
+ le contenu textuel de vos fichiers. Vous pouvez modifier, propager
+ et revenir en arrière sur les propriétés aussi facilement que sur
+ le contenu des fichiers. L'envoi et la réception des changements
+ concernant les propriétés intervient lors de vos propagations et
+ mises à jour : vous n'avez pas à changer vos habitudes pour
+ les utiliser.</para>
+<!--
<note>
<para>Subversion has reserved the set of properties whose names
begin with <literal>svn:</literal> as its own. While there
@@ -735,7 +1420,18 @@
or behavior driven by a property of the same name but with
perhaps an entirely different interpretation.</para>
</note>
+-->
+ <note>
+ <para>Subversion a réservé pour son propre usage les propriétés
+ dont le nom commence par <literal>svn:</literal>. Bien qu'il n'y
+ en ait seulement que quelques unes d'utilisées actuellement,
+ vous ne devez pas créer vos propres propriétés avec un nom
+ commençant par ce préfixe. Sinon, vous courez le risque qu'une
+ future version de Subversion définisse une propriété ayant le
+ même nom mais pour un usage tout autre.</para>
+ </note>
+<!--
<para>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
@@ -745,7 +1441,19 @@
versioned. In other words, if you change the value of, or
delete, a revision property, there's no way, within the scope of
Subversion's functionality, to recover the previous value.</para>
+-->
+ <para>Les propriétés sont aussi présentes ailleurs dans Subversion.
+ De la même manière que pour les fichiers et dossiers, chaque
+ révision en tant que telle peut avoir des propriétés arbitraires
+ associées. Les mêmes contraintes s'appliquent : nom lisible
+ par un humain et valeur arbitraire, éventuellement binaire. La
+ différence principale est que les propriétés des révisions ne sont
+ pas suivies en versions. Autrement dit, si vous changez la valeur
+ ou si vous supprimez une propriété d'une révision, il n'y a pas
+ moyen, en utilisant Subversion, de revenir à la valeur
+ précédente.</para>
+<!--
<para>Subversion has no particular policy regarding the use of
properties. It asks only that you do not use property names that
begin with the prefix <literal>svn:</literal> as that's the
@@ -761,7 +1469,26 @@
chapters as part of the more general topics to which they are
related. For an exhaustive list of Subversion's predefined
properties, see <xref linkend="svn.advanced.props.ref" />.</para>
+-->
+ <para>Subversion ne fournit pas de recommandation particulière quant
+ à l'utilisation des propriétés. Il demande seulement de ne pas
+ utiliser de nom de propriété qui commence par le préfixe
+ <literal>svn:</literal>. C'est l'espace de noms qu'il garde pour
+ son propre usage. Et Subversion utilise bien lui-même les
+ propriétés, suivies en versions ou pas. Certaines propriétés
+ suivies en versions ont une signification particulière ou des
+ effets particuliers quand elles font référence à un fichier ou à
+ un dossier, ou stockent des informations relatives à la
+ révision à laquelle elles sont rattachées. Certaines propriétés de
+ révision sont automatiquement rattachées à une révision par la
+ procédure de propagation et stockent des informations relatives à
+ cette révision. La plupart de ces propriétés sont mentionnées
+ ailleurs dans ce chapitre ou dans d'autres chapitres comme faisant
+ partie de sujets plus généraux. Pour une liste exhaustive des
+ propriétés pré-définies de Subversion, référez-vous à
+ <xref linkend="svn.advanced.props.ref" />.</para>
+<!--
<note>
<para>While Subversion automatically attaches properties
(<literal>svn:date</literal>, <literal>svn:author</literal>,
@@ -776,24 +1503,59 @@
assuming that any particular revision property exists on a
revision.</para>
</note>
+-->
+ <note>
+ <para>Bien que Subversion crée automatiquement des propriétés à
+ chaque révision (<literal>svn:date</literal>, <literal>svn:author</literal>,
+ <literal>svn:log</literal>, etc.), il <emphasis>ne</emphasis>
+ présage <emphasis>pas</emphasis> de leur existence par la suite
+ et vous (ou les outils que vous utilisez) ne devriez pas non
+ plus présager de leur existence dans vos interactions avec le
+ dépôt. Les propriétés de révisions peuvent être effacées par
+ programmation ou <foreignphrase>via</foreignphrase> le client
+ (si les procédures automatiques l'autorisent) sans remettre en
+ cause le bon fonctionnement de Subversion. En conséquence, lors
+ de l'écriture de scripts qui opèrent sur les données du dépôt,
+ veillez à ne pas considérer l'existence d'une propriété de
+ révision comme acquis.</para>
+ </note>
+<!--
<para>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
modifications affect your normal Subversion workflow.</para>
+-->
+ <para>Dans cette section, nous examinerons l'utilité des propriétés,
+ à la fois pour l'utilisateur et pour Subversion lui-même. Vous
+ apprendrez les sous-commandes <command>svn</command> relatives
+ aux propriétés et comment la modification des propriétés change
+ votre manière habituelle d'utiliser Subversion.</para>
<!-- =============================================================== -->
<sect2 id="svn.advanced.props.why">
+<!--
<title>Why Properties?</title>
+-->
+ <title>Utiliser les propriétés</title>
+<!--
<para>Just as Subversion uses properties to store extra
information about the files, directories, and revisions that
it contains, you might also find properties to be of similar
use. You might find it useful to have a place
close to your versioned data to hang custom metadata about
that data.</para>
+-->
+ <para>À l'instar de Subversion, qui utilise les propriétés
+ pour stocker des méta-données sur les fichiers, les dossiers
+ et les révisions qu'il gère, vous pouvez faire une utilisation
+ similaire des propriétés. Vous pouvez trouver utile d'avoir un
+ endroit, près de vos données suivies en versions, pour stocker
+ des méta-données relatives à vos données.</para>
+<!--
<para>Say you wish to design a web site 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
@@ -801,7 +1563,17 @@
can be quite large, so as is common with sites of this nature,
you want to provide smaller thumbnail images to your site
visitors.</para>
+-->
+ <para>Imaginons que vous vouliez créer un site Web qui héberge
+ beaucoup de photos et qui les affiche avec une légende et une
+ date. D'accord, mais votre collection de photos change
+ constamment, donc vous voulez automatiser le plus possible la
+ gestion du site. Ces photos peuvent être relativement
+ volumineuses et vous voulez pouvoir fournir des miniatures à vos
+ visiteurs, comme c'est généralement le cas sur ce genre de
+ site.</para>
+<!--
<para>Now, you can get this functionality using traditional
files. That is, you can have your
<filename>image123.jpg</filename> and an
@@ -813,7 +1585,21 @@
separated from the original image file. But the problem here
is that your collection of files multiplies with each new
photo added to the site.</para>
+-->
+ <para>Certes, vous pouvez le faire en utilisant des fichiers
+ traditionnels. C'est-à-dire que vous avez votre
+ <filename>image123.jpg</filename> et une
+ <filename>image123-thumbnail.jpg</filename> côte à côte dans un
+ dossier. Ou, si vous voulez garder les mêmes noms de fichier,
+ vous placez vos miniatures dans un dossier différent, comme
+ <filename>thumbnails/image123.jpg</filename>. Vous pouvez
+ également stocker vos légendes et dates de la même façon,
+ séparées encore une fois du fichier image original. Mais le
+ problème est que votre collection de fichiers s'agrandit de
+ plusieurs fichiers à chaque nouvelle photo ajoutée au
+ site.</para>
+<!--
<para>Now consider the same web site deployed in a way that
makes use of Subversion's file properties. Imagine having a
single image file, <filename>image123.jpg</filename>, with
@@ -828,8 +1614,25 @@
linkend="svn.developer.usingapi" />) to dig out the extra
information that your site needs to display without having to
read an index file or play path manipulation games.</para>
+-->
+ <para>Maintenant, considérons le même site Web conçu en utilisant
+ les propriétés des fichiers fournies par Subversion. Imaginez un
+ simple fichier image, <filename>image123.jpg</filename>, et un
+ ensemble de propriétés relatives à ce fichier nommées
+ <literal>légende</literal>, <literal>date</literal> et même
+ <literal>miniature</literal>. À présent, le dossier de votre
+ copie de travail se gère beaucoup plus facilement ; en fait,
+ vu du navigateur, il semble ne contenir que des images. Mais vos
+ scripts d'automatisation vont plus loin : ils savent qu'ils
+ peuvent utiliser les commandes <command>svn</command> (ou mieux,
+ ils peuvent utiliser les connecteurs spécifiques au langage
+ utilisé, voir <xref linkend="svn.developer.usingapi" />) pour
+ extraire les informations dont votre site a besoin sans avoir à
+ lire un fichier d'index ou à jouer avec des chemins de
+ fichiers.</para>
<note>
+<!--
<para>While Subversion places few restrictions on the names
and values you use for properties, it has not been designed
to optimally carry large property values or large sets of
@@ -838,8 +1641,20 @@
with a single item in memory at the same time, which can
cause detrimental performance or failed operations when
extremely large property sets are used.</para>
+-->
+ <para>Bien que Subversion n'impose que peu de restrictions sur
+ les noms et les valeurs des propriétés, il n'a pas été conçu
+ pour gérer de façon optimale des valeurs de propriétés de
+ grande taille ou un grand nombre de propriétés sur un fichier
+ ou un dossier donné. Subversion garde souvent en mémoire en
+ même temps tous les noms et valeurs de propriétés associés à
+ un élément, ce qui peut engendrer des problèmes de performance
+ lors de l'utilisation de très gros ensembles de
+ propriétés.</para>
</note>
+
+<!--
<para>Custom revision properties are also frequently used. One
common such use is a property whose value contains an issue
tracker ID with which the revision is associated, perhaps
@@ -850,40 +1665,83 @@
if there's, say, a <literal>test-results</literal> property on
that revision with the value <literal>all passing</literal>,
that's meaningful information to have. And Subversion allows
- you to easily do this via the <option>--with-revprop</option>
+ you to easily do this via the <option>- -with-revprop</option>
option of the <command>svn commit</command> command:</para>
+-->
+ <para>On utilise également fréquemment des propriétés de révisions
+ personnalisées. Une utilisation classique est d'avoir une
+ propriété qui contient un identifiant en provenance d'un autre
+ outil de gestion et de l'associer à une révision. Par exemple,
+ l'outil de gestion est utilisé pour suivre les bogues et la
+ révision corrige le bogue associé à l'identifiant. Il s'agit
+ parfois aussi d'utiliser des noms plus conviviaux pour les
+ révisions : il peut être difficile de se remémorer que la
+ révision 1935 correspond à une révision qui a subi la totalité
+ des tests, alors qu'une propriété
+ <literal>resultat-des-tests</literal> avec la valeur
+ <literal>tout ok</literal> est autrement plus utile.</para>
<informalexample>
- <screen>
+ <screen><!--
$ svn commit -m "Fix up the last remaining known regression bug." \
- --with-revprop "test-results=all passing"
+ - -with-revprop "test-results=all passing"
Sending lib/crit_bits.c
Transmitting file data .
Committed revision 912.
+-->
+$ svn commit -m "Corrige la dernière régression connue." \
+ --with-revprop "resultat-des-tests=tout ok"
+Envoi lib/crit_bits.c
+Transmission des données .
+Révision 912 propagée.
$
</screen>
</informalexample>
<sidebar>
+<!--
<title>Searchability (or, Why <emphasis>Not</emphasis>
Properties)</title>
+-->
+ <title>Retrouver ses petits (ou savoir <emphasis>ne pas
+ utiliser</emphasis> les propriétés)</title>
+<!--
<para>For all their utility, Subversion properties—or,
more accurately, the available interfaces to them—have
a major shortcoming: while it is a simple matter to
<emphasis>set</emphasis> a custom property,
<emphasis>finding</emphasis> that property later is a whole
different ball of wax.</para>
+-->
+ <para>Bien que très utiles, les propriétés Subversion, ou plus
+ exactement les interfaces disponibles pour y accéder, ont une
+ lacune majeure : alors qu'il est très simple de
+ <emphasis>définir</emphasis> une propriété personnalisée, la
+ <emphasis>retrouver</emphasis> plus tard est une toute autre
+ affaire.</para>
+<!--
<para>Trying to locate a custom revision property generally
involves performing a linear walk across all the revisions
of the repository, asking of each revision, <quote>Do you
have the property I'm looking for?</quote> Use
- the <option>--with-all-revprops</option> option with
+ the <option>- -with-all-revprops</option> option with
the <command>svn log</command> command's XML output mode to
facilitate this search. Notice the presence of the custom
revision property <literal>testresults</literal> in the
following output:</para>
+-->
+ <para>Trouver une propriété de révision personnalisée implique
+ généralement d'effectuer un parcours linéaire de toutes les
+ révisions du dépôt, en demandant à chacune :
+ <quote>Avez-vous la propriété que je cherche ?</quote>.
+ L'utilisation de l'option <option>--with-all-revprops</option>
+ sur la commande <command>svn log</command> avec la sortie en
+ mode XML facilite la recherche. Notez la présence de la
+ propriété de révision personnalisée
+ <literal>resultat-des-tests</literal> dans la copie d'écran
+ suivante :</para>
<informalexample>
<screen>
@@ -893,11 +1751,13 @@
<logentry
revision="912">
<author>harry</author>
-<date>2011-07-29T14:47:41.169894Z</date>
-<msg>Fix up the last remaining known regression bug.</msg>
+<date>2011-07-29T14:47:41.169894Z</date><!--
+<msg>Fix up the last remaining known regression bug.</msg>-->
+<msg>Corrige la dernière régression connue.</msg>
<revprops>
-<property
- name="testresults">all passing</property>
+<property<!--
+ name="testresults">all passing</property>-->
+ name="resultat-des-tests">tout ok</property>
</revprops>
</logentry>
…
@@ -905,6 +1765,7 @@
</screen>
</informalexample>
+<!--
<para>Trying to find a custom versioned property is painful,
too, and often involves a recursive <command>svn
propget</command> across an entire working copy. In your
@@ -913,7 +1774,17 @@
in terms of both performance and likelihood of success,
especially if the scope of your search would require a
working copy from the root of your repository.</para>
+-->
+ <para>Trouver une propriété personnalisée suivie en versions est
+ également difficile et implique souvent un appel récursif à
+ <command>svn propget</command> sur toute une copie de travail.
+ Dans votre situation, c'est peut-être moins pire que le
+ parcours linéaire de toutes les révisions. Mais cela laisse
+ certainement beaucoup à désirer en termes de performance et de
+ probabilité de réussite, surtout si, pour votre recherche, il
+ faut une copie de travail de la racine de votre dépôt.</para>
+<!--
<para>For this reason, you might choose—especially in
the revision property use case—to simply add your
metadata to the revision's log message using some
@@ -921,21 +1792,42 @@
formatting that is designed to be quickly parsed from the
output of <command>svn log</command>. It is quite common to
see the following in Subversion log messages:</para>
+-->
+ <para>C'est pourquoi vous pouvez choisir, en particulier pour
+ ce qui concerne les propriétés de révisions, de simplement
+ ajouter les méta-données au message de propagation. Par
+ exemple, utilisez une politique de formatage (idéalement
+ appliquée automatiquement par un script) conçue pour être
+ rapidement analysée à partir de la sortie de
+ <command>svn log</command>. Ainsi, il est assez fréquent de
+ voir dans Subversion des messages de propagation qui
+ ressemblent à :</para>
<informalexample>
- <programlisting>
+ <programlisting><!--
Issue(s): IZ2376, IZ1919
Reviewed by: sally
-This fixes a nasty segfault in the wort frabbing process
+This fixes a nasty segfault in the wort frabbing process-->
+Problème(s): IZ2376, IZ1919
+Corrigé par: sally
+
+Corrige un méchant plantage dans la fonction machin bidule
…
</programlisting>
</informalexample>
+<!--
<para>But here again lies some misfortune. Subversion doesn't
yet provide a log message templating mechanism, which would
go a long way toward helping users be consistent with the
formatting of their log-embedded revision metadata.</para>
+-->
+ <para>Mais hélas, cela ne résout pas tout. Subversion ne fournit
+ pas encore de mécanisme pour gérer des modèles de messages
+ associés aux propagations, ce qui aiderait pourtant beaucoup les
+ utilisateurs à respecter le format des méta-données qu'ils
+ placent dans les messages de révision.</para>
</sidebar>
@@ -943,40 +1835,68 @@
<!-- =============================================================== -->
<sect2 id="svn.advanced.props.manip">
+<!--
<title>Manipulating Properties</title>
+-->
+ <title>Manipuler les propriétés</title>
+<!--
<para>The <command>svn</command> program 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>svn propset</command>
subcommand:</para>
+-->
+ <para>La commande <command>svn</command> offre différentes
+ possibilités pour ajouter ou modifier des propriétés sur les
+ fichiers et les dossiers. Pour les propriétés avec des
+ valeurs courtes, lisibles par un humain, la solution la plus
+ simple est sûrement de spécifier le nom de la propriété et sa
+ valeur en ligne de commande avec la
+ sous-commande <command>svn propset</command> :</para>
<informalexample>
- <screen>
+ <screen><!--
$ svn propset copyright '(c) 2006 Red-Bean Software' calc/button.c
-property 'copyright' set on 'calc/button.c'
+property 'copyright' set on 'calc/button.c'-->
+$ svn propset copyright '(c) 2006 Red-Bean Software' calc/bouton.c
+Propriété 'copyright' définie sur 'calc/bouton.c'
$
</screen>
</informalexample>
-
+
+<!--
<para>But we've been touting the flexibility that Subversion
offers for your property values. And if you are planning to
have a multiline textual, or even binary, property value, you
probably do not want to supply that value on the command line.
So the <command>svn propset</command> subcommand takes a
- <option>--file</option> (<option>-F</option>) option for
+ <option>- -file</option> (<option>-F</option>) option for
specifying the name of a file that contains the new property
value.</para>
+-->
+ <para>Mais nous avons vanté la souplesse de Subversion pour
+ spécifier les valeurs des propriétés. Ainsi, si vous envisagez
+ d'avoir des valeurs de plusieurs lignes de texte, ou même une
+ valeur binaire, la passer en ligne de commande ne vous convient
+ pas. La sous-commande <command>svn propset</command> accepte donc
+ l'option <option>--file</option> (<option>-F</option>) pour
+ spécifier le nom d'un fichier qui contient la nouvelle valeur de
+ la propriété.</para>
<informalexample>
- <screen>
+ <screen><!--
$ svn propset license -F /path/to/LICENSE calc/button.c
property 'license' set on 'calc/button.c'
+-->
+$ svn propset licence -F /chemin/vers/LICENCE calc/bouton.c
+Propriété 'licence' définie sur 'calc/bouton.c'
$
</screen>
</informalexample>
+<!--
<para>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
@@ -985,7 +1905,21 @@
(<literal>.</literal>).<footnote><para>If you're familiar with
XML, this is pretty much the ASCII subset of the syntax for
XML <quote>Name</quote>.</para></footnote></para>
+-->
+ <para>Il y a quelques restrictions sur les noms de propriétés. Un
+ nom de propriété doit commencer par une lettre, le caractère
+ deux points (<literal>:</literal>), ou le caractère souligné
+ (<literal>_</literal>) ; ensuite, vous pouvez aussi
+ utiliser des chiffres, des tirets (<literal>-</literal>) et des
+ points (<literal>.</literal>)
+ <footnote>
+ <para>Pour ceux qui connaissent le XML, c'est à peu près le
+ sous-ensemble ASCII pour la syntaxe du champ "Name" en
+ XML.</para>
+ </footnote>.
+ </para>
+<!--
<para>In addition to the <command>propset</command> command, the
<command>svn</command> program supplies the
<command>propedit</command> command. This command uses the
@@ -1002,32 +1936,63 @@
value of the property, it will accept that as the new property
value. If you exit your editor without making any changes, no
property modification will occur:</para>
+-->
+ <para>En plus de la commande <command>propset</command>,
+ <command>svn</command> dispose de la commande
+ <command>propedit</command>. Cette commande utilise l'éditeur de
+ texte pré-configuré (reportez-vous à <xref
+ linkend="svn.advanced.confarea.opts.config" />) pour ajouter ou
+ modifier des propriétés. Quand vous exécutez la commande,
+ <command>svn</command> lance votre éditeur de texte avec un
+ fichier temporaire qui contient la valeur actuelle de la
+ propriété (ou un contenu vierge si vous ajoutez une nouvelle
+ propriété). Vous pouvez alors modifier la valeur dans l'éditeur
+ de texte pour y placer votre nouvelle valeur, sauvegarder le
+ fichier temporaire et quitter l'éditeur. Si Subversion détecte
+ que la valeur a effectivement changé, il la prend en compte. Si
+ vous quittez l'éditeur sans faire de changement, la propriété
+ n'est pas modifiée :</para>
<informalexample>
- <screen>
+ <screen><!--
$ svn propedit copyright calc/button.c ### exit the editor without changes
No changes to property 'copyright' on 'calc/button.c'
+-->
+$ svn propedit copyright calc/bouton.c ### sortez de l'éditeur sans faire de modification
+Pas de modification de la propriété 'copyright' sur 'calc/bouton.c'
$
</screen>
</informalexample>
+<!--
<para>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 the following:</para>
+-->
+ <para>Vous pouvez noter que, à l'instar des autres commandes
+ <command>svn</command>, celles relatives aux propriétés
+ fonctionnent aussi sur des chemins multiples. Vous pouvez ainsi
+ modifier les propriétés d'un ensemble de fichiers en une seule
+ commande. Par exemple, nous aurions pu taper :</para>
<informalexample>
<screen>
-$ svn propset copyright '(c) 2006 Red-Bean Software' calc/*
+$ svn propset copyright '(c) 2006 Red-Bean Software' calc/* <!--
property 'copyright' set on 'calc/Makefile'
property 'copyright' set on 'calc/button.c'
property 'copyright' set on 'calc/integer.c'
+-->
+Propriété 'copyright' définie sur 'calc/Makefile'
+Propriété 'copyright' définie sur 'calc/bouton.c'
+Propriété 'copyright' définie sur 'calc/entier.c'
…
$
</screen>
</informalexample>
+<!--
<para>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
@@ -1039,27 +2004,57 @@
propget</command>. This command will, given a property name
and a path (or set of paths), print the value of the property
to the standard output stream.</para>
+-->
+ <para>Toutes ces manipulations de propriétés ne seraient pas
+ vraiment utiles si vous ne pouviez pas récupérer facilement la
+ valeur d'une propriété. Subversion propose donc deux
+ sous-commandes pour afficher les noms et les valeurs des
+ propriétés associées aux fichiers et dossiers. La commande
+ <command>svn proplist</command> fournit la liste des noms de
+ propriétés qui existent dans un chemin. Une fois que vous
+ connaissez les noms des propriétés d'un élément, vous pouvez
+ obtenir les valeurs correspondantes avec la commande
+ <command>svn propget</command>. Cette commande affiche sur la
+ sortie standard la valeur de la propriété dont le nom et le
+ chemin (ou l'ensemble des chemins) ont été passés en
+ paramètres.</para>
<informalexample>
- <screen>
+ <screen><!--
$ svn proplist calc/button.c
Properties on 'calc/button.c':
+-->
+$ svn proplist calc/bouton.c
+Propriétés sur 'calc/bouton.c':
copyright
- license
-$ svn propget copyright calc/button.c
+ licence<!--
+$ svn propget copyright calc/button.c-->
+$ svn propget copyright calc/bouton.c
(c) 2006 Red-Bean Software
+$
</screen>
</informalexample>
+<!--
<para>There's even a variation of the
<command>proplist</command> command that will list both the
name and the value for all of the properties. Simply supply the
- <option>--verbose</option> (<option>-v</option>) option.</para>
+ <option>- -verbose</option> (<option>-v</option>) option.</para>
+-->
+ <para>Il y a même une variante de la commande
+ <command>proplist</command> qui liste à la fois le nom et la
+ valeur de toutes les propriétés. Ajoutez simplement l'option
+ <option>--verbose</option> (<option>-v</option>) à la
+ commande :</para>
+
<informalexample>
- <screen>
+ <screen><!--
$ svn proplist -v calc/button.c
Properties on 'calc/button.c':
+-->
+$ svn proplist -v calc/bouton.c
+Propriétés sur 'calc/bouton.c':
copyright
(c) 2006 Red-Bean Software
license
@@ -1067,7 +2062,7 @@
Copyright (c) 2006 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
@@ -1077,47 +2072,74 @@
</screen>
</informalexample>
+<!--
<para>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>svn propedit</command> or
<command>svn propset</command>. For example, this command will
<emphasis>not</emphasis> yield the desired effect:</para>
+-->
+ <para>La dernière sous-commande relative aux propriétés est
+ <command>propdel</command>. Puisque Subversion vous autorise à
+ stocker des propriétés avec une valeur vide, vous ne pouvez pas
+ supprimer une propriété en utilisant <command>svn propedit</command>
+ ou <command>svn propset</command>. Par exemple, la commande
+ suivante <emphasis>ne produit pas</emphasis> le résultat
+ escompté :</para>
<informalexample>
- <screen>
+ <screen><!--
$ svn propset license "" calc/button.c
property 'license' set on 'calc/button.c'
+-->
+$ svn propset licence calc/bouton.c
+Propriété 'licence' définie sur 'calc/bouton.c' <!--
$ svn proplist -v calc/button.c
-Properties on 'calc/button.c':
+Properties on 'calc/button.c':-->
+$ svn proplist -v calc/bouton.c
+Propriétés sur 'calc/bouton.c':
copyright
(c) 2006 Red-Bean Software
license
-
+
$
</screen>
</informalexample>
+<!--
<para>You need to use the <command>propdel</command> subcommand
to delete properties altogether. The syntax is similar to the
other property commands:</para>
+-->
+ <para>Vous devez utiliser la sous-commande
+ <command>propdel</command> pour supprimer complètement une
+ propriété. La syntaxe est similaire aux autres commandes sur les
+ propriétés :</para>
<informalexample>
- <screen>
+ <screen><!--
$ svn propdel license calc/button.c
property 'license' deleted from 'calc/button.c'.
+-->
+$ svn propdel license calc/bouton.c
+Propriété 'licence' supprimée de 'calc/bouton.c'.<!--
$ svn proplist -v calc/button.c
Properties on 'calc/button.c':
+-->
+$ svn proplist -v calc/bouton.c
+Propriétés sur 'calc/bouton.c':
copyright
(c) 2006 Red-Bean Software
$
</screen>
</informalexample>
+<!--
<para>Remember those unversioned revision properties? You can
modify those, too, using the same <command>svn</command>
subcommands that we just described. Simply add the
- <option>--revprop</option> command-line parameter and specify
+ <option>- -revprop</option> command-line parameter and specify
the revision whose property you wish to modify. Since
revisions are global, you don't need to specify a target path
to these property-related commands so long as you are
@@ -1129,32 +2151,70 @@
revision.<footnote><para>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> If
+ the <option>- -revprop</option> option.</para></footnote> If
your current working directory is part of a working copy of
your repository, you can simply run the
<command>svn propset</command> command with no target path:</para>
+-->
+ <para>Vous souvenez-vous des propriétés de révision non suivies en
+ versions ? Vous pouvez les modifier elles-aussi en
+ utilisant les mêmes sous-commandes <command>svn</command> que
+ nous venons de décrire. Il suffit juste d'ajouter l'option
+ <option>--revprop</option> à la ligne de commande et de spécifier
+ la révision à laquelle s'applique la modification. Puisque les
+ numéros de révisions s'appliquent à l'ensemble de l'arborescence,
+ vous n'avez pas besoin d'indiquer un chemin pour ces commandes,
+ du moment que vous êtes dans une copie de travail du dépôt
+ contenant la révision dont vous voulez modifier la propriété.
+ Autrement, vous pouvez simplement fournir n'importe quelle URL
+ du dépôt en question (y compris l'URL racine). Par exemple,
+ imaginons que vous vouliez remplacer le message associé à la
+ propagation d'une révision précédente
+ <footnote>
+ <para>Corriger les fautes d'orthographe, les erreurs de
+ grammaire et les informations simplement erronées au sein
+ des messages de propagation est peut-être l'usage le plus
+ courant de l'option <option>--revprop</option>.</para>
+ </footnote>.
+ Si le dossier actuel fait partie de votre copie de travail du
+ dépôt, vous pouvez simplement lancer la commande
+ <command>svn propset</command> sans spécifier de
+ chemin :</para>
<informalexample>
- <screen>
-$ svn propset svn:log "* button.c: Fix a compiler warning." -r11 --revprop
+ <screen><!--
+$ svn propset svn:log "* button.c: Fix a compiler warning." -r11 - -revprop
property 'svn:log' set on repository revision '11'
+-->
+$ svn propset svn:log "* bouton.c: corrige un avertissement du compilateur." -r11 --revprop
+Nouvelle valeur définie pour la propriété 'svn:log' à la révision du dépôt '11'
$
</screen>
</informalexample>
+<!--
<para>But even if you haven't checked out a working copy from
that repository, you can still effect the property change by
providing the repository's root URL:</para>
+-->
+ <para>Et même si vous n'avez pas extrait de copie de travail du
+ dépôt, vous pouvez toujours modifier la propriété en indiquant
+ l'URL racine du dépôt :</para>
<informalexample>
- <screen>
-$ svn propset svn:log "* button.c: Fix a compiler warning." -r11 --revprop \
+ <screen><!--
+$ svn propset svn:log "* button.c: Fix a compiler warning." -r11 - -revprop \
http://svn.example.com/repos/project
property 'svn:log' set on repository revision '11'
+-->
+$ svn propset svn:log "* bouton.c: corrige un avertissement du compilateur." -r11 --revprop \
+ http://svn.exemple.com/depot/projet
+Nouvelle valeur définie pour la propriété 'svn:log' à la révision du dépôt '11'
$
</screen>
</informalexample>
+<!--
<para>Note that the ability to modify these unversioned
properties must be explicitly added by the repository
administrator (see <xref linkend="svn.reposadmin.maint.setlog" />).
@@ -1163,8 +2223,19 @@
The repository administrator can set up methods to protect
against this loss, and by default, modification of
unversioned properties is disabled.</para>
+-->
+ <para>Notez que le droit de modifier cette propriété non suivie en
+ versions doit être explicitement ajouté par l'administrateur du
+ dépôt (voir <xref linkend="svn.reposadmin.maint.setlog" />).
+ En effet, la propriété n'étant pas suivie en versions, vous
+ risquez une perte d'informations si vous la modifiez à tort et
+ à travers. L'administrateur du dépôt peut mettre en place des
+ protections contre ce type d'incident et, par défaut, la
+ modification de propriétés non suivies en versions est
+ désactivée.</para>
<tip>
+<!--
<para>Users should, where possible, use <command>svn
propedit</command> instead of <command>svn
propset</command>. While the end result of the commands is
@@ -1176,13 +2247,29 @@
significantly easier to modify multiline property values in
a text editor than at the command line.</para>
</tip>
+-->
+ <para>Dans la mesure du possible, il est recommandé d'utiliser
+ <command>svn propedit</command> au lieu de <command>svn
+ propset</command>. Bien que le résultat soit identique, la
+ première permet de visualiser la valeur actuelle de la
+ propriété que l'on veut modifier, ce qui aide à vérifier que
+ l'on fait bien ce que l'on pense faire. C'est particulièrement
+ vrai dans le cas des propriétés non suivies en versions. Il
+ est aussi beaucoup plus facile de modifier un texte de
+ plusieurs lignes dans un éditeur de texte qu'en ligne de
+ commande.</para>
+ </tip>
</sect2>
<!-- =============================================================== -->
<sect2 id="svn.advanced.props.workflow">
+<!--
<title>Properties and the Subversion Workflow</title>
+-->
+ <title>Les propriétés et le cycle de travail Subversion</title>
+<!--
<para>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
@@ -1191,7 +2278,18 @@
result, Subversion provides the same opportunities for
merging—cleanly or with conflicts—someone
else's modifications into your own.</para>
+-->
+ <para>Maintenant que vous êtes familier avec toutes les
+ sous-commandes <command>svn</command> relatives aux propriétés,
+ voyons comment la modification des propriétés change le cycle
+ habituel d'utilisation de Subversion. Comme mentionné
+ précédemment, les propriétés des fichiers et dossiers sont
+ suivies en versions, à l'instar du contenu des fichiers. En
+ conséquence, Subversion offre les mêmes possibilités pour
+ fusionner (proprement ou quand apparaissent des conflits) vos
+ modifications avec celles des autres collaborateurs.</para>
+<!--
<para>As with file contents, your property changes are local
modifications, made permanent only when you commit them to the
repository with <command>svn commit</command>. Your property
@@ -1202,13 +2300,32 @@
the state of your file and directory properties by using the
<command>svn status</command> and <command>svn diff</command>
commands.</para>
+-->
+ <para>De même que pour le contenu des fichiers, les modifications
+ de propriétés sont locales. Elles ne deviennent permanentes que
+ quand vous les propagez dans le dépôt
+ <foreignphrase>via</foreignphrase>
+ <command>svn commit</command>. Vos modifications sur les
+ propriétés peuvent aussi être annulées facilement : la
+ commande <command>svn revert</command> restaure vos fichiers
+ et dossiers dans leur état d'avant les modifications, y
+ compris pour les propriétés. Vous pouvez également obtenir des
+ informations intéressantes sur l'état des propriétés de vos
+ fichiers et dossiers en utilisant les commandes
+ <command>svn status</command> et
+ <command>svn diff</command>.</para>
<informalexample>
- <screen>
+ <screen><!--
$ svn status calc/button.c
M calc/button.c
$ svn diff calc/button.c
Property changes on: calc/button.c
+-->
+$ svn status calc/bouton.c
+ M calc/bouton.c
+$ svn diff calc/bouton.c
+Modification de propriétés sur calc/bouton.c
___________________________________________________________________
Added: copyright
## -0,0 +1 ##
@@ -1217,6 +2334,7 @@
</screen>
</informalexample>
+<!--
<para>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
@@ -1225,22 +2343,45 @@
<literal>M</literal> in the first column, too. (We cover
<command>svn status</command> in <xref
linkend="svn.tour.cycle.examine.status" />).</para>
+-->
+ <para>Remarquez que la sous-commande <command>status</command>
+ place le <literal>M</literal> dans la deuxième colonne plutôt
+ que dans la première. C'est parce que nous avons modifié les
+ propriétés de <filename>calc/bouton.c</filename>, mais pas son
+ contenu. Si nous avions changé les deux, nous aurions vu le
+ <literal>M</literal> dans la première colonne également
+ (reportez-vous à <xref
+ linkend="svn.tour.cycle.examine.status" />).</para>
<sidebar>
+<!--
<title>Property Conflicts</title>
+-->
+ <title>Conflits sur les propriétés</title>
+<!--
<para>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 object that clash with your own,
Subversion will report that the object is in a conflicted
state.</para>
-
+-->
+ <para>De la même manière que pour le contenu des fichiers, les
+ modifications locales effectuées sur les propriétés peuvent
+ entrer en conflit avec les changements effectués par d'autres
+ collaborateurs. Si vous faites une mise à jour de votre copie
+ de travail et que vous recevez un changement incompatible avec
+ vos propres modifications d'une propriété d'un objet suivi en
+ versions, Subversion vous indique que l'objet est dans un
+ état de conflit.</para>
+
<informalexample>
<screen>
-$ svn update calc
-Updating 'calc':
-M calc/Makefile.in
+$ svn update calc<!--
+Updating 'calc': -->
+Mise à jour de 'calc' :
+M calc/Makefile.in <!--
Conflict for property 'linecount' discovered on 'calc/button.c'.
Select: (p) postpone, (df) diff-full, (e) edit,
(s) show all options: p
@@ -1248,10 +2389,20 @@
Updated to revision 143.
Summary of conflicts:
Property conflicts: 1
-$
+-->
+Actualisé à la révision 143.
+Conflit sur la propriété 'nombre_lignes' découvert sur 'calc/bouton.c'.
+local add, incoming add upon update
+Select: (p) postpone, (mf) my version, (tf) their version,
+ (dc) display conflict, (e) edit property, (q) quit resolution,
+ (h) help: p
+Résumé des conflits :
+ Property conflicts: 1
+$
</screen>
</informalexample>
-
+
+<!--
<para>Subversion will also create, in the same directory as
the conflicted object, a file with a
<filename>.prej</filename> extension that contains the
@@ -1261,27 +2412,52 @@
<literal>C</literal> in the second column of <command>svn
status</command> output for that object, and attempts to
commit your local modifications will fail.</para>
+-->
+ <para>Subversion va aussi créer, dans le même dossier que
+ l'objet en conflit, un fichier avec l'extension
+ <filename>.prej</filename> qui contient les détails du
+ conflit. Vous devrez examiner le contenu de ce fichier pour
+ décider comment résoudre le conflit. Tant que le conflit n'est
+ pas résolu, vous voyez un <literal>C</literal> dans la
+ deuxième colonne de la sortie de <command>svn status</command>
+ pour cet objet et les tentatives de propager vos modifications
+ locales échouent.</para>
<informalexample>
<screen>
-$ svn status calc
+$ svn status calc<!--
C calc/button.c
? calc/button.c.prej
-$ cat calc/button.c.prej
@@ Diff output truncated at 100000 characters. @@
More information about the svnbook-dev
mailing list