[svnbook] r5262 committed - branches/1.8/fr/book/ref-svn.xml

chris-nanteuil at users.sourceforge.net chris-nanteuil at users.sourceforge.net
Sat Dec 17 16:46:09 CST 2016


Revision: 5262
          http://sourceforge.net/p/svnbook/source/5262
Author:   chris-nanteuil
Date:     2016-12-17 22:46:08 +0000 (Sat, 17 Dec 2016)
Log Message:
-----------
[fr] svn R?\195?\169ference : translation started.
* ref-svn.xml

Modified Paths:
--------------
    branches/1.8/fr/book/ref-svn.xml

Modified: branches/1.8/fr/book/ref-svn.xml
===================================================================
--- branches/1.8/fr/book/ref-svn.xml	2016-12-17 12:29:27 UTC (rev 5261)
+++ branches/1.8/fr/book/ref-svn.xml	2016-12-17 22:46:08 UTC (rev 5262)
@@ -1,15 +1,26 @@
 <!-- -*- sgml -*- -->
 
 <reference id="svn.ref.svn">
+<!--
   <title>svn Reference—Subversion Command-Line Client</title>
-    
+-->
+  <title>Référence de svn : le client texte interactif</title>
+
   <partintro>
+<!--
     <para><command>svn</command> is the official command-line client
       of Subversion.  Its functionality is offered via a collection of
       task-specific subcommands, most of which accept a number of
       options for fine-grained control of the program's
       behavior.</para>
+-->
+    <para><command>svn</command> est le client texte interactif officiel de
+      Subversion. Ses fonctionnalités sont accessibles
+      <foreignphrase>via</foreignphrase> un ensemble de sous-commandes dont
+      la plupart acceptent plusieurs options pour contrôler très finement le
+      comportement du programme.</para>
 
+<!--
     <para>When using the <command>svn</command> program, subcommands
       and other non-option arguments must appear in a specified order
       on the command line.  Options, on the other hand, may appear
@@ -18,8 +29,19 @@
       example, all of the following are valid ways to use <command>svn
       status</command>, and are interpreted in exactly the same
       way:</para>
+-->
+    <para>Lorsque vous utilisez le programme <command>svn</command>, les
+      sous-commandes et les paramètres qui ne sont pas des options doivent
+      apparaître dans un ordre bien spécifié dans la ligne de commande. Les
+      options, quant à elles, peuvent être indiquées n'importe où dans la
+      ligne de commande (après le nom du programme, bien sûr) et, en général,
+      leur ordre est sans importance. Par exemple, toutes les lignes de
+      commandes qui suivent sont valides pour exécuter <command>svn
+      status</command> et sont interprétées exactement de la même
+      manière :</para>
 
     <informalexample>
+<!--
       <screen>
 $ svn -vq status myfile
 $ svn status -v -q myfile
@@ -27,22 +49,48 @@
 $ svn status -vq myfile
 $ svn status myfile -qv
 </screen>
+-->
+      <screen>
+$ svn -vq status mon-fichier
+$ svn status -v -q mon-fichier
+$ svn -q status -v mon-fichier
+$ svn status -vq mon-fichier
+$ svn status mon-fichier -qv
+</screen>
     </informalexample>
 
+<!--
     <para>The following sections describe each of the various
       subcommands and options provided by the <command>svn</command>
       command-line client program, including some examples of each
       subcommand's typical uses.</para>
+-->
+    <para>Les sections qui suivent décrivent chaque sous-commande et les
+      options correspondantes du client texte interactif
+      <command>svn</command>, avec quelques exemples d'utilisations
+      typiques pour chaque sous-commande.</para>
 
+
+<!--
     <para>While Subversion has different options for its
       subcommands, all options exist in a single
       namespace—that is, each option is guaranteed to mean the
       roughly same thing regardless of the subcommand you use it
-      with.  For example, <option>--verbose</option>
+      with.  For example, <option>- -verbose</option>
       (<option>-v</option>) always means <quote>verbose
       output,</quote> regardless of the subcommand you use it
       with.</para>
+-->
+    <para>Bien que Subversion accepte différentes options en fonction
+        des sous-commandes, toutes les options gardent leur
+        signification quelle que soit la sous-commande avec laquelle
+        elles sont utilisées — elles font partie d'un seul
+        <quote>espace de noms</quote>. Par exemple, l'option
+        <option>--verbose</option> (<option>-v</option>) signifie
+        toujours <quote>être plus bavard</quote>, quelle que soit la
+        sous-commande utilisée.</para>
 
+<!--
     <para>The <command>svn</command> command-line client usually
       exits quickly with an error if you pass it an option which
       does not apply to the specified subcommand.  But as of
@@ -54,44 +102,92 @@
       scripts.)  These options appear grouped together in the
       command-line client's usage messages as global options, as can
       be seen in the following bit of output:</para>
+-->
+    <para>Le client en ligne de commande <command>svn</command>
+      renvoie généralement rapidement une erreur si vous lui indiquez
+      une option qui ne s'applique pas à la sous-commande spécifiée.
+      Cependant, depuis la version 1.5 de Subversion, plusieurs
+      options sont acceptées par toutes (ou presque) les sous-commandes,
+      même si elles n'ont pas d'effet dans certains cas (cette modification
+      a été apportée principalement pour faciliter l'encapsulation du client
+      dans des scripts). Elles sont regroupées dans la rubrique
+      <quote>options globales</quote> des messages d'explication des
+      commandes, comme vous pouvez le voir dans l'extrait de sortie
+      suivant :</para>
 
     <informalexample>
+<!--
       <screen>
 $ svn help upgrade
 upgrade: Upgrade the metadata storage format for a working copy.
 usage: upgrade [WCPATH...]
 
   Local modifications are preserved.
-
 Valid options:
-  -q [--quiet]             : print nothing, or only summary information
-
+  -q [- -quiet]             : print nothing, or only summary information
 Global options:
-  --username ARG           : specify a username ARG
-  --password ARG           : specify a password ARG
-  --no-auth-cache          : do not cache authentication tokens
-  --non-interactive        : do no interactive prompting
-  --trust-server-cert      : accept SSL server certificates from unknown
+  - -username ARG           : specify a username ARG
+  - -password ARG           : specify a password ARG
+  - -no-auth-cache          : do not cache authentication tokens
+  - -non-interactive        : do no interactive prompting
+  - -trust-server-cert      : accept SSL server certificates from unknown
                              certificate authorities without prompting (but only
-                             with '--non-interactive')
-  --config-dir ARG         : read user configuration files from directory ARG
-  --config-option ARG      : set user configuration option in the format:
+                             with '- -non-interactive')
+  - -config-dir ARG         : read user configuration files from directory ARG
+  - -config-option ARG      : set user configuration option in the format:
                                  FILE:SECTION:OPTION=[VALUE]
                              For example:
                                  servers:global:http-library=serf
 $
 </screen>
+-->
+      <screen>
+$ svn help upgrade
+upgrade: Mise à jour des meta-données du format de stockage de la copie de travail.
+usage : upgrade CHEMIN...
+
+   Les modifications locales sont préservées.
+
+Options valides:
+  -q [--quiet]             : n'affiche rien, ou seulement des informations résumées
+
+Options globales :
+  --username ARG           : précise le nom d'utilisateur ARG
+  --password ARG           : précise le mot de passe ARG
+  --no-auth-cache          : ne conserve pas les éléments d'authentification
+  --non-interactive        : do no interactive prompting (default is to prompt
+                             only if standard input is a terminal device)
+  --force-interactive      : do interactive prompting even if standard input
+                             is not a terminal device
+  --trust-server-cert      : accepte les certificats serveur SSL d'authorités inconnues sans confirmation
+           (mais seulement avec '--non-interactive')
+  --config-dir ARG         : fichiers de configuration dans ce répertoire
+  --config-option ARG      : configuration des options utilisateurs avec le format :
+                               FICHIER:SECTION:OPTION=[VALEUR]
+                           Par exemple :
+                               servers:global:http-library=serf
+$
+</screen>
     </informalexample>
 
+<!--
     <para><command>svn</command> subcommands recognize the following
       options:</para>
-      
+
+-->
+    <para>Les sous-commandes <command>svn</command> reconnaissent les
+      options suivantes :</para>
+
     <variablelist id="svn.ref.svn.sw">
+<!--
       <title>svn Options</title>
-      
+-->
+      <title>Options de svn</title>
+
       <varlistentry id="svn.ref.svn.sw.accept">
         <term><option>--accept</option> <replaceable>ACTION</replaceable></term>
         <listitem>
+<!--
           <para>Specifies an action for automatic conflict
             resolution, disabling the interactive prompts which ask
             the user how to handle each conflict as it is noticed.
@@ -99,100 +195,161 @@
             differs depending on which subcommand is in use,
             Subversion supports the following long (and short)
             values for <replaceable>ACTION</replaceable>:</para>
+-->
+          <para>Précise l'attitude à adopter pour la résolution
+            automatique de conflits et désactive l'interface interactive qui
+            demande à l'utilisateur quelle action appliquer. Bien que les
+            actions possibles dépendent de la sous-commande utilisée,
+            Subversion accepte les valeurs suivantes (courtes et longues)
+            pour le paramètre <replaceable>ACTION</replaceable> :</para>
           <variablelist>
             <varlistentry>
               <term><literal>postpone</literal>
                 (<literal>p</literal>)</term>
               <listitem>
+<!--
                 <para>Take no resolution action at all and instead
                   allow the conflicts to be recorded for future
                   resolution.</para>
+-->
+                <para>Ne rien résoudre du tout mais marquer les éléments
+                  comme étant en conflits.</para>
               </listitem>
             </varlistentry>
             <varlistentry>
               <term><literal>edit</literal>
                 (<literal>e</literal>)</term>
               <listitem>
+<!--
                 <para>Open each conflicted file in a text editor for
                   manual resolution of line-based conflicts.</para>
+-->
+                <para>Ouvrir chaque fichier (au format texte) en conflit dans
+                  un éditeur de texte pour une résolution à la main.</para>
               </listitem>
             </varlistentry>
             <varlistentry>
               <term><literal>launch</literal>
                 (<literal>l</literal>)</term>
               <listitem>
+<!--
                 <para>Launch an interactive merge conflict
                   resolution tool for each conflicted file.</para>
+-->
+                <para>Lancer un outil interactif de résolution de conflits
+                  et de fusion pour chaque fichier en conflit.</para>
               </listitem>
             </varlistentry>
             <varlistentry>
               <term><literal>base</literal></term>
               <listitem>
+<!--
                 <para>Choose the file that was the (unmodified)
                   <literal>BASE</literal> revision before you tried
                   to integrate changes from the server into
                   your working copy.</para>
+-->
+                <para>Choisir le fichier de la révision
+                  <literal>BASE</literal> (non modifié) avant d'essayer d'y
+                  intégrer les modifications en provenance du serveur pour
+                  donner la copie de travail.</para>
               </listitem>
             </varlistentry>
             <varlistentry>
               <term><literal>working</literal></term>
               <listitem>
+<!--
                 <para>Assuming that you've manually handled the
                   conflict resolution, choose the version of the file
                   as it currently stands in your working copy.</para>
+-->
+                <para>Choisir la version actuelle de la copie de travail
+                  (i.e. Subversion suppose que vous avez géré manuellement
+                  le conflit en amont).</para>
               </listitem>
             </varlistentry>
             <varlistentry>
               <term><literal>mine-full</literal>
                 (<literal>mf</literal>)</term>
               <listitem>
+<!--
                 <para>Resolve conflicted files by preserving all
                   local modifications and discarding all changes
                   fetched from the server during the operation which
                   caused the conflict.</para>
+-->
+                <para>Résoudre les fichiers en conflits en préservant toutes
+                  les modifications locales et en ignorant les modifications
+                  en provenance du serveur pour l'opération qui a créé le
+                  conflit.</para>
               </listitem>
             </varlistentry>
             <varlistentry>
               <term><literal>theirs-full</literal>
                 (<literal>tf</literal>)</term>
               <listitem>
+<!--
                 <para>Resolve conflicted files by discarding all
                   local modifications and integrating all changes
                   fetched from the server during the operation which
                   caused the conflict.</para>
+-->
+                <para>Résoudre les fichiers en conflits en ignorant toutes
+                  les modifications locales et en intégrant les modifications
+                  en provenance du serveur pour l'opération qui a créé le
+                  conflit.</para>
               </listitem>
             </varlistentry>
             <varlistentry>
               <term><literal>mine-conflict</literal>
                 (<literal>mc</literal>)</term>
               <listitem>
+<!--
                 <para>Resolve conflicted files by preferring local
                   modifications over the changes fetched from the
                   server in conflicting regions of each file's
                   content.</para>
+-->
+                <para>Résoudre les fichiers en conflits en préférant
+                  les modifications locales par rapport aux modifications
+                  en provenance du serveur pour les régions des fichiers qui
+                  génèrent des conflits.</para>
               </listitem>
             </varlistentry>
             <varlistentry>
               <term><literal>theirs-conflict</literal>
                 (<literal>tc</literal>)</term>
               <listitem>
+<!--
                 <para>Resolve conflicted files by preferring the
                   changes fetched from the server over local
                   modifications in conflicting regions of each file's
                   content.</para>
+-->
+                <para>Résoudre les fichiers en conflits en préférant
+                  les modifications en provenance du serveur par rapport aux
+                  modifications locales pour les régions des fichiers qui
+                  génèrent des conflits.</para>
               </listitem>
             </varlistentry>
           </variablelist>
+<!--
           <para>Consult the output of <command>svn help
             <replaceable>SUBCOMMAND</replaceable></command> to see
             exactly which actions are supported by the specific
             subcommand of interest.</para>
+-->
+          <para>Consultez la sortie de <command>svn help
+            <replaceable>SOUS-COMMANDE</replaceable></command> pour voir
+            exactement quelles actions sont possibles pour chaque
+            sous-commande qui vous intéresse.</para>
         </listitem>
       </varlistentry>
 
       <varlistentry id="svn.ref.svn.sw.allow_mixed_revisions">
         <term><option>--allow-mixed-revisions</option></term>
         <listitem>
+<!--
           <para>Disables the verification—performed by default
             by <command>svn merge</command> as of Subversion
             1.7—that the target of a merge operation and all
@@ -201,22 +358,37 @@
             the recommended best practice, this option may be used
             to permit merges into mixed-revision working copies as
             necessary.</para>
+-->
+          <para>Désactiver la vérification (qui est faite par défaut par
+            <command>svn merge</command> depuis Subversion 1.7) que la cible
+            d'une opération de fusion et que tous ses fils concernent bien
+            une révision unique. Bien que fusionner vers une copie de
+            travail représentant une révision unique est une bonne pratique,
+            cette option peut être utilisée pour autoriser des fusions sur
+            des copies de travail à révisions mélangées si nécessaire.</para>
         </listitem>
       </varlistentry>
 
       <varlistentry id="svn.ref.svn.sw.auto_props">
         <term><option>--auto-props</option></term>
         <listitem>
+<!--
           <para>Enables automatic property assignment (per runtime
             configuration rules), overriding the
             <literal>enable-auto-props</literal> runtime
             configuration directive.</para>
+-->
+          <para>Activer les propriétés automatiques (suivant les règles
+            définies dans la zone de configuration), remplaçant alors la
+            directive <literal>enable-auto-props</literal> dans le fichier de
+            configuration <filename>config</filename>.</para>
         </listitem>
       </varlistentry>
-      
+
       <varlistentry id="svn.ref.svn.sw.change">
         <term><option>--change</option> (<option>-c</option>) <replaceable>ARG</replaceable></term>
         <listitem>
+<!--
           <para>Perform the requested operation using a specific
             <quote>change</quote>.  Generally speaking, this option
             is syntactic sugar for <userinput>-r
@@ -234,29 +406,61 @@
             implied revision range is reversed: <userinput>-c
             -45</userinput> is equivalent to <userinput>-r
             45:44</userinput>.</para>
+-->
+          <para>Effectuer l'opération demandée en utilisant un
+            <quote>changement</quote> particulier. Cette option est du sucre
+            syntaxique pour spécifier
+            <userinput>-r <replaceable>ARG-1</replaceable>:<replaceable>ARG</replaceable></userinput>.
+            Certaines sous-commandes autorisent une liste de numéros de
+            révisions séparés par des virgules comme argument (par exemple,
+            <userinput>-c <replaceable>ARG1</replaceable>,<replaceable>ARG2</replaceable>,<replaceable>ARG3</replaceable></userinput>).
+            Autrement, vous pouvez fournir deux arguments séparés par un
+            tiret (comme dans <userinput>-c <replaceable>ARG1</replaceable>-<replaceable>ARG2</replaceable></userinput>)
+            pour identifier un intervalle de révisions entre
+            <replaceable>ARG1</replaceable> et
+            <replaceable>ARG2</replaceable> inclus. Enfin, si le numéro de
+            révision en argument est négatif, cela veut dire que l'intervalle
+            de révision doit être pris à l'envers : <userinput>-c
+            -45</userinput> est équivalent à <userinput>-r
+            45:44</userinput>.</para>
         </listitem>
       </varlistentry>
 
       <varlistentry id="svn.ref.svn.sw.changelist">
         <term><option>--changelist</option> (<option>--cl</option>) <replaceable>ARG</replaceable></term>
         <listitem>
+<!--
           <para>Instructs Subversion to operate only on members of the changelist named
             <replaceable>ARG</replaceable>.  You can use this option
             multiple times to specify sets of changelists.</para>
+-->
+          <para>N'opérer que sur les membres de la liste de changements
+            nommée<replaceable>ARG</replaceable>.  Vous pouvez utiliser cette
+            option plusieurs fois pour spécifier un ensemble de listes de
+            changements.</para>
         </listitem>
       </varlistentry>
 
       <varlistentry id="svn.ref.svn.sw.config_dir">
         <term><option>--config-dir</option> <replaceable>DIR</replaceable></term>
         <listitem>
+    <!--
           <para>Instructs Subversion to read configuration
             information from the specified directory instead of the
             default location (<filename>.subversion</filename> in
             the user's home directory).</para>
+    -->
+          <para>Lire la configuration dans le répertoire spécifié plutôt qu'à
+            l'endroit par défaut (<filename>.subversion</filename> dans le
+            répertoire de l'utilisateur).</para>
 
           <note>
+<!--
             <para>This option is accepted by
               all <command>svn</command> subcommands.</para>
+-->
+            <para>Cette option est acceptée par toutes les sous-commandes
+              <command>svn</command>.</para>
           </note>
         </listitem>
       </varlistentry>
@@ -264,6 +468,7 @@
       <varlistentry id="svn.ref.svn.sw.config_option">
         <term><option>--config-option</option> <replaceable>CONFSPEC</replaceable></term>
         <listitem>
+<!--
           <para>Sets, for the duration of the command, the value of
             a runtime configuration
             option.  <replaceable>CONFSPEC</replaceable> is a string
@@ -284,10 +489,33 @@
             use <option>--config-option=config:miscellany:enable-auto-props=no</option>.
             You can use this option multiple times to change
             multiple option values simultaneously.</para>
+-->
+          <para>Définir, pour la durée de la commande, la valeur d'une option
+            de configuration. <replaceable>CONFSPEC</replaceable> est une
+            chaine qui spécifie l'espace de noms, le nom et la valeur de
+            l'option de configuration que vous voulez assigner, sous la forme
+            <replaceable>FICHIER</replaceable>:<replaceable>SECTION</replaceable>:<replaceable>OPTION</replaceable>=[<replaceable>VALEUR</replaceable>].
+            Dans cette syntaxe, <replaceable>FICHIER</replaceable> et
+            <replaceable>SECTION</replaceable> représentent le fichier de la
+            zone de configuration (soit <literal>config</literal>, soit
+            <literal>servers</literal>) et la section qui contient l'option
+            dont vous voulez définir la valeur.
+            <replaceable>OPTION</replaceable> est, bien sûr, l'option
+            elle-même et <replaceable>VALEUR</replaceable> est la valeur
+            (s'il y en a une) que vous voulez assigner à cette option. Par
+            exemple, pour désactiver temporairement l'utilisation de la
+            configuration automatique des propriétés, utilisez
+            <option>--config-option=config:miscellany:enable-auto-props=no</option>.
+            Vous pouvez utiliser cette option plusieurs fois pour changer
+            plusieurs valeurs d'options pour la commande en cours.</para>
 
           <note>
+<!--
             <para>This option is accepted by
               all <command>svn</command> subcommands.</para>
+-->
+            <para>Cette option est acceptée par toutes les sous-commandes
+              <command>svn</command>.</para>
           </note>
         </listitem>
       </varlistentry>
@@ -295,6 +523,7 @@
       <varlistentry id="svn.ref.svn.sw.depth">
         <term><option>--depth</option> <replaceable>ARG</replaceable></term>
         <listitem>
+<!--
           <para>Instructs Subversion to limit the scope of an
             operation to a particular tree
             depth.  <replaceable>ARG</replaceable> is one of
@@ -305,6 +534,17 @@
             immediate children thereof), or
             <literal>infinity</literal> (the target and all of its
             descendants—full recursion).</para>
+-->
+          <para>Limiter l'opération à une certaine profondeur de
+            l'arborescence. <replaceable>ARG</replaceable> peut prendre les
+            valeurs suivantes :
+            <literal>empty</literal> (uniquement la cible elle-même),
+            <literal>files</literal> (la cible et tous ses fichiers qui sont
+            enfants immédiats),
+            <literal>immediates</literal> (la cible et tous ses enfants
+            immédiats),
+            <literal>infinity</literal> (la cible et tous ses descendants
+            — la récursion est complète).</para>
         </listitem>
       </varlistentry>
 
@@ -332,7 +572,7 @@
             option.</para>
         </listitem>
       </varlistentry>
-    
+
       <varlistentry id="svn.ref.svn.sw.diff3_cmd">
         <term><option>--diff3-cmd</option> <replaceable>CMD</replaceable></term>
         <listitem>
@@ -340,7 +580,7 @@
             (used to merge line-based changes into files).</para>
         </listitem>
       </varlistentry>
-    
+
       <varlistentry id="svn.ref.svn.sw.dry_run">
         <term><option>--dry-run</option></term>
         <listitem>
@@ -349,7 +589,7 @@
             the repository.</para>
         </listitem>
       </varlistentry>
-    
+
       <varlistentry id="svn.ref.svn.sw.editor_cmd">
         <term><option>--editor-cmd</option> <replaceable>CMD</replaceable></term>
         <listitem>
@@ -359,7 +599,7 @@
             for ways to specify a default editor.</para>
         </listitem>
       </varlistentry>
-    
+
       <varlistentry id="svn.ref.svn.sw.encoding">
         <term><option>--encoding</option> <replaceable>ENC</replaceable></term>
         <listitem>
@@ -448,7 +688,7 @@
             likely to get a nasty shock.</para>
         </listitem>
       </varlistentry>
-      
+
       <varlistentry id="svn.ref.svn.sw.force_log">
         <term><option>--force-log</option></term>
         <listitem>
@@ -487,7 +727,7 @@
             the general client help text.</para>
         </listitem>
       </varlistentry>
-      
+
       <varlistentry id="svn.ref.svn.sw.ignore_ancestry">
         <term><option>--ignore-ancestry</option></term>
         <listitem>
@@ -498,7 +738,7 @@
         </para>
         </listitem>
       </varlistentry>
-    
+
       <varlistentry id="svn.ref.svn.sw.ignore_externals">
         <term><option>--ignore-externals</option></term>
         <listitem>
@@ -506,7 +746,7 @@
             the external working copies managed by them.</para>
         </listitem>
       </varlistentry>
-    
+
       <varlistentry id="svn.ref.svn.sw.ignore_keywords">
         <term><option>--ignore-keywords</option></term>
         <listitem>
@@ -538,7 +778,7 @@
             concatenation to prior similar output.</para>
         </listitem>
       </varlistentry>
-    
+
       <varlistentry id="svn.ref.svn.sw.internal_diff">
         <term><option>--internal-diff</option></term>
         <listitem>
@@ -556,7 +796,7 @@
             from working copy items after committing.</para>
         </listitem>
       </varlistentry>
-    
+
       <varlistentry id="svn.ref.svn.sw.keep_local">
         <term><option>--keep-local</option></term>
         <listitem>
@@ -564,7 +804,7 @@
             with the <command>svn delete</command> command).</para>
         </listitem>
       </varlistentry>
-    
+
       <varlistentry id="svn.ref.svn.sw.limit">
         <term><option>--limit</option> (<option>-l</option>) <replaceable>NUM</replaceable></term>
         <listitem>
@@ -572,7 +812,7 @@
             log messages.</para>
         </listitem>
       </varlistentry>
-      
+
       <varlistentry id="svn.ref.svn.sw.message">
         <term><option>--message</option> (<option>-m</option>) <replaceable>MESSAGE</replaceable></term>
         <listitem>
@@ -599,7 +839,7 @@
             or <literal>CRLF</literal>.</para>
         </listitem>
       </varlistentry>
-            
+
       <varlistentry id="svn.ref.svn.sw.new">
         <term><option>--new</option> <replaceable>ARG</replaceable></term>
         <listitem>
@@ -607,7 +847,7 @@
             target (for use with <command>svn diff</command>).</para>
         </listitem>
       </varlistentry>
-    
+
       <varlistentry id="svn.ref.svn.sw.no_auth_cache">
         <term><option>--no-auth-cache</option></term>
         <listitem>
@@ -651,7 +891,7 @@
             the file but removed all of its content.</para>
         </listitem>
       </varlistentry>
-      
+
       <varlistentry id="svn.ref.svn.sw.no_ignore">
         <term><option>--no-ignore</option></term>
         <listitem>
@@ -717,7 +957,7 @@
       <varlistentry id="svn.ref.svn.sw.notice_ancestry">
         <term><option>--notice-ancestry</option></term>
         <listitem>
-          <para>Pays attention to ancestry when calculating 
+          <para>Pays attention to ancestry when calculating
             differences.</para>
         </listitem>
       </varlistentry>
@@ -783,7 +1023,7 @@
             information while performing an operation.</para>
         </listitem>
       </varlistentry>
-      
+
       <varlistentry id="svn.ref.svn.sw.record_only">
         <term><option>--record-only</option></term>
         <listitem>
@@ -793,7 +1033,7 @@
           not actually performed.</para>
         </listitem>
       </varlistentry>
-      
+
       <varlistentry id="svn.ref.svn.sw.recursive">
         <term><option>--recursive</option> (<option>-R</option>)</term>
         <listitem>
@@ -801,7 +1041,7 @@
             (Most subcommands recurse by default.)</para>
         </listitem>
       </varlistentry>
-      
+
       <varlistentry id="svn.ref.svn.sw.reintegrate">
         <term><option>--reintegrate</option></term>
         <listitem>
@@ -815,7 +1055,7 @@
             for details.</para>
         </listitem>
       </varlistentry>
-      
+
       <varlistentry id="svn.ref.svn.sw.relocate">
         <term><option>--relocate</option></term>
         <listitem>
@@ -828,7 +1068,7 @@
             details and an example.</para>
         </listitem>
       </varlistentry>
-      
+
       <varlistentry id="svn.ref.svn.sw.remove">
         <term><option>--remove</option></term>
         <listitem>
@@ -838,7 +1078,7 @@
             changelist.</para>
         </listitem>
       </varlistentry>
-      
+
       <varlistentry id="svn.ref.svn.sw.reverse_diff">
         <term><option>--reverse-diff</option></term>
         <listitem>
@@ -872,7 +1112,7 @@
             information.</para>
         </listitem>
       </varlistentry>
-      
+
       <varlistentry id="svn.ref.svn.sw.revprop">
         <term><option>--revprop</option></term>
         <listitem>
@@ -883,7 +1123,7 @@
             option.</para>
         </listitem>
       </varlistentry>
-      
+
       <varlistentry id="svn.ref.svn.sw.search">
         <term><option>--search</option> <replaceable>ARG</replaceable></term>
         <listitem>
@@ -991,7 +1231,7 @@
             merge from the specified source URL, respectively.</para>
         </listitem>
       </varlistentry>
-      
+
       <varlistentry id="svn.ref.svn.sw.show_updates">
         <term><option>--show-updates</option> (<option>-u</option>)</term>
         <listitem>
@@ -1002,7 +1242,7 @@
             updated if you then use <command>svn update</command>.</para>
         </listitem>
       </varlistentry>
-      
+
       <varlistentry id="svn.ref.svn.sw.stop_on_copy">
         <term><option>--stop-on-copy</option></term>
         <listitem>
@@ -1014,7 +1254,7 @@
             encountered.</para>
         </listitem>
       </varlistentry>
-      
+
       <varlistentry id="svn.ref.svn.sw.strict">
         <term><option>--strict</option></term>
         <listitem>
@@ -1023,7 +1263,7 @@
             subcommands (namely, <command>svn propget</command>).</para>
         </listitem>
       </varlistentry>
-      
+
       <varlistentry id="svn.ref.svn.sw.strip">
         <term><option>--strip</option> <replaceable>NUM</replaceable></term>
         <listitem>
@@ -1033,7 +1273,7 @@
             file.</para>
         </listitem>
       </varlistentry>
-      
+
       <varlistentry id="svn.ref.svn.sw.summarize">
         <term><option>--summarize</option></term>
         <listitem>
@@ -1041,7 +1281,7 @@
             the operation instead of its detailed output.</para>
         </listitem>
       </varlistentry>
-       
+
       <varlistentry id="svn.ref.svn.sw.targets">
         <term><option>--targets</option> <replaceable>FILENAME</replaceable></term>
         <listitem>
@@ -1054,7 +1294,7 @@
             line.</para>
         </listitem>
       </varlistentry>
-      
+
       <varlistentry id="svn.ref.svn.sw.trust_server_cert">
         <term><option>--trust-server-cert</option></term>
         <listitem>
@@ -1080,7 +1320,7 @@
             history.</para>
         </listitem>
       </varlistentry>
-      
+
       <varlistentry id="svn.ref.svn.sw.username">
         <term><option>--username</option> <replaceable>NAME</replaceable></term>
         <listitem>
@@ -1106,7 +1346,7 @@
             additional information regarding its actions.</para>
         </listitem>
       </varlistentry>
-      
+
       <varlistentry id="svn.ref.svn.sw.version">
         <term><option>--version</option></term>
         <listitem>
@@ -1118,7 +1358,7 @@
             prints only the version number in a compact form.</para>
         </listitem>
       </varlistentry>
-      
+
       <varlistentry id="svn.ref.svn.sw.with_all_revprops">
         <term><option>--with-all-revprops</option></term>
         <listitem>
@@ -1163,11 +1403,11 @@
             directory of the Subversion source tree.</para>
         </listitem>
       </varlistentry>
-      
+
     </variablelist>
-      
+
   </partintro>
-    
+
   <!-- ================================================================= -->
   <!-- ================================================================= -->
   <!-- ================================================================= -->
@@ -1191,7 +1431,7 @@
     <!-- =============================================================== -->
     <refsect1>
       <title>Description</title>
-      
+
       <para>Schedule files, directories, or symbolic links in your
         working copy for addition to the repository.  They will be
         uploaded and added to the repository on your next commit.
@@ -1199,7 +1439,7 @@
         committing, you can unschedule the addition using
         <command>svn revert</command>.</para>
     </refsect1>
-    
+
     <!-- =============================================================== -->
     <refsect1>
       <title>Options</title>
@@ -1217,16 +1457,16 @@
 </screen>
       </informalexample>
     </refsect1>
-    
+
     <!-- =============================================================== -->
     <refsect1>
       <title>Examples</title>
-      
+
       <para>To add a file to your working copy:</para>
 
       <informalexample>
         <screen>
-$ svn add foo.c 
+$ svn add foo.c
 A         foo.c
 </screen>
       </informalexample>
@@ -1305,7 +1545,7 @@
     <!-- =============================================================== -->
     <refsect1>
       <title>Description</title>
-      
+
       <para>Show author and revision information inline for the
         specified files or URLs.  Each line of text is annotated
         at the beginning with the author (username) and the
@@ -1342,7 +1582,7 @@
 $ svn blame http://svn.red-bean.com/repos/test/readme.txt
      3      sally This is a README file.
      5      harry Don't bother reading it.  The boss is a knucklehead.
-     3      sally 
+     3      sally
 …
 </screen>
       </informalexample>
@@ -1379,7 +1619,7 @@
  This is a README file.
 -Don't bother reading it. The boss is a knucklehead.
 +Don't bother reading it.  The boss is a knucklehead.
-  
+
  INSTRUCTIONS
  ============
 $
@@ -1399,7 +1639,7 @@
 $ svn blame -x -b http://svn.red-bean.com/repos/test/readme.txt
      3      sally This is a README file.
      4       jess Don't bother reading it.  The boss is a knucklehead.
-     3      sally 
+     3      sally
 …
 </screen>
       </informalexample>
@@ -1468,7 +1708,7 @@
     <!-- =============================================================== -->
     <refsect1>
       <title>Description</title>
-      
+
       <para>Output the contents of the specified files or URLs.
         For listing the contents of directories, see <command>svn
         list</command> later in this chapter.</para>
@@ -1497,7 +1737,7 @@
 $ svn cat http://svn.red-bean.com/repos/test/readme.txt
 This is a README file.
 Don't bother reading it.  The boss is a knucklehead.
- 
+
 INSTRUCTIONS
 ============
 
@@ -1514,7 +1754,7 @@
         <screen>
 $ svn cat -r 3 http://svn.red-bean.com/repos/test/readme.txt
 This is a README file.
- 
+
 INSTRUCTIONS
 ============
 
@@ -1574,7 +1814,7 @@
     <!-- =============================================================== -->
     <refsect1>
       <title>Description</title>
-      
+
       <para>Used for dividing files in a working copy into a
         changelist (logical named grouping) in order to allow
         users to easily work on multiple file collections within a
@@ -1635,7 +1875,7 @@
       <para>Note that in the previous example, only the files in
         changelist <literal>issue1729</literal> were
         committed.</para>
-      
+
     </refsect1>
   </refentry>
 
@@ -1662,7 +1902,7 @@
     <!-- =============================================================== -->
     <refsect1>
       <title>Description</title>
-      
+
       <para>Check out a working copy from a repository.  If
         <replaceable>PATH</replaceable> is omitted, the
         basename of the URL will be used as the destination.
@@ -1687,7 +1927,7 @@
 </screen>
       </informalexample>
     </refsect1>
-    
+
     <!-- =============================================================== -->
     <refsect1>
       <title>Examples</title>
@@ -2087,7 +2327,7 @@
 Committed revision 7.
 </screen>
       </informalexample>
-      
+
     </refsect1>
   </refentry>
 
@@ -2115,7 +2355,7 @@
     <!-- =============================================================== -->
     <refsect1>
       <title>Description</title>
-      
+
       <para>Copy one or more files in a working copy or in the
         repository. <replaceable>SRC</replaceable> and
         <replaceable>DST</replaceable> can each be either a
@@ -2123,7 +2363,7 @@
         sources, add the copies as immediate children
         of <replaceable>DST</replaceable> (which, of course, must
         be a directory).</para>
-        
+
         <variablelist>
 
           <varlistentry>
@@ -2361,7 +2601,7 @@
 </screen>
       </informalexample>
     </refsect1>
-    
+
     <!-- =============================================================== -->
     <refsect1>
       <title>Examples</title>
@@ -2401,12 +2641,12 @@
 
       <informalexample>
         <screen>
-$ svn delete over-there 
+$ svn delete over-there
 svn: E195006: Use --force to override this restriction (local modifications m\
 ay be lost)
 svn: E195006: '/home/sally/project/over-there' has local modifications -- com\
 mit or revert them first
-$ svn delete --force over-there 
+$ svn delete --force over-there
 D         over-there
 $
 </screen>
@@ -2445,7 +2685,7 @@
           working copies which contain them when those working
           copies are then updated.</para>
       </note>
-      
+
     </refsect1>
   </refentry>
 
@@ -2643,7 +2883,7 @@
 
       <informalexample>
         <screen>
-$ svn diff COMMITTERS 
+$ svn diff COMMITTERS
 Index: COMMITTERS
 ===================================================================
 --- COMMITTERS	(revision 4404)
@@ -2657,7 +2897,7 @@
 
       <informalexample>
         <screen>
-$ svn diff -c 9115 COMMITTERS 
+$ svn diff -c 9115 COMMITTERS
 Index: COMMITTERS
 ===================================================================
 --- COMMITTERS	(revision 3900)
@@ -2672,7 +2912,7 @@
 
       <informalexample>
         <screen>
-$ svn diff -r 3900 COMMITTERS 
+$ svn diff -r 3900 COMMITTERS
 Index: COMMITTERS
 ===================================================================
 --- COMMITTERS	(revision 3900)
@@ -2738,7 +2978,7 @@
 
       <informalexample>
         <screen>
-$ svn diff -r 3000:3500 COMMITTERS 
+$ svn diff -r 3000:3500 COMMITTERS
 Index: COMMITTERS
 ===================================================================
 --- COMMITTERS	(revision 3000)
@@ -2754,12 +2994,12 @@
 
       <informalexample>
         <screen>
-$ svn diff --diff-cmd /usr/bin/diff -x "-i -b" COMMITTERS 
+$ svn diff --diff-cmd /usr/bin/diff -x "-i -b" COMMITTERS
 Index: COMMITTERS
 ===================================================================
 0a1,2
 > This is a test
-> 
+>
 $
 </screen>
       </informalexample>
@@ -2938,7 +3178,7 @@
         Subversion and this book isn't within reach!</para>
 
     </refsect1>
-    
+
     <!-- =============================================================== -->
     <refsect1>
       <title>Options</title>
@@ -2959,7 +3199,7 @@
 
     <refnamediv>
       <refname>svn import</refname>
-      <refpurpose>Commit an unversioned file or tree into the 
+      <refpurpose>Commit an unversioned file or tree into the
         repository.</refpurpose>
     </refnamediv>
 
@@ -3047,7 +3287,7 @@
         <emphasis>not</emphasis> under version control.  To start
         working, you still need to <command>svn checkout</command>
         a fresh working copy of the tree.</para>
-      
+
     </refsect1>
   </refentry>
 
@@ -3064,7 +3304,7 @@
 
     <refnamediv>
       <refname>svn info</refname>
-      <refpurpose>Display information about a local or remote 
+      <refpurpose>Display information about a local or remote
         item.</refpurpose>
     </refnamediv>
 
@@ -3375,7 +3615,7 @@
     </indexterm>
 
     <refnamediv>
-      <refname>svn lock</refname> 
+      <refname>svn lock</refname>
         <refpurpose>Lock working copy paths or URLs in the
           repository so that no other user can commit changes to
           them.</refpurpose>
@@ -3786,7 +4026,7 @@
 
         <informalexample>
           <screen>
-$ svn log -r 20 touched.txt 
+$ svn log -r 20 touched.txt
 ------------------------------------------------------------------------
 r20 | sally | 2003-01-17 22:56:19 -0600 (Fri, 17 Jan 2003) | 1 line
 
@@ -4127,7 +4367,7 @@
 Committed revision 38.
 </screen>
       </informalexample>
-      
+
     <para>Cherry-pick merge a single change to a file:</para>
 
     <informalexample>
@@ -4648,7 +4888,7 @@
 +This is an added file.
 </programlisting>
       </informalexample>
-      
+
       <para>We can apply the previous patch file to another
         working copy from our repository using <command>svn
         patch</command>, and verify that it did the right thing by
@@ -4693,9 +4933,9 @@
 @@ -0,0 +1 @@
 +This is an added file.
 $
-</screen>             
+</screen>
       </informalexample>
-    
+
       <para>Sometimes you might need Subversion to interpret a
         patch <quote>in reverse</quote>—where added things
         get treated as removed things, and vice-versa.  Use
@@ -4717,7 +4957,7 @@
 +++ foo.c	(working copy)
 @@ -1003,7 +1003,7 @@
      return ERROR_ON_THE_G_STRING;
- 
+
    /* Do something in a loop. */
 -  for (i = 0; i < txns->nelts; i++)
 +  for (i = 0; i < txns->nelts; i--)
@@ -4728,7 +4968,7 @@
 U         foo.c
 $ svn status
 $
-</screen>             
+</screen>
       </informalexample>
 
     </refsect1>
@@ -4801,7 +5041,7 @@
 
       <informalexample>
         <screen>
-$ svn propdel --revprop -r 26 release-date 
+$ svn propdel --revprop -r 26 release-date
 property 'release-date' deleted from repository revision '26'
 </screen>
       </informalexample>
@@ -4872,7 +5112,7 @@
 
       <informalexample>
         <screen>
-$ svn propedit svn:keywords foo.c 
+$ svn propedit svn:keywords foo.c
 
     # svn will open in your favorite text editor a temporary file
     # containing the current contents of the svn:keywords property.  You
@@ -4962,7 +5202,7 @@
 
       <informalexample>
         <screen>
-$ svn propget svn:log --revprop -r 20 
+$ svn propget svn:log --revprop -r 20
 Began journal.
 </screen>
       </informalexample>
@@ -5081,7 +5321,7 @@
 </screen>
       </informalexample>
     </refsect1>
-    
+
     <!-- =============================================================== -->
     <refsect1>
       <title>Examples</title>
@@ -5140,7 +5380,7 @@
 
       <informalexample>
         <screen>
-$ svn proplist --xml 
+$ svn proplist --xml
 <?xml version="1.0"?>
 <properties>
 <target
@@ -5151,7 +5391,7 @@
 </properties>
 </screen>
       </informalexample>
-      
+
     </refsect1>
   </refentry>
 
@@ -5227,7 +5467,7 @@
 
       <informalexample>
         <screen>
-$ svn propset svn:mime-type image/jpeg foo.jpg 
+$ svn propset svn:mime-type image/jpeg foo.jpg
 property 'svn:mime-type' set on 'foo.jpg'
 </screen>
       </informalexample>
@@ -5281,7 +5521,7 @@
 
       <informalexample>
         <screen>
-$ svn propset owner-pic -F sally.jpg moo.c 
+$ svn propset owner-pic -F sally.jpg moo.c
 property 'owner-pic' set on 'moo.c'
 </screen>
       </informalexample>
@@ -5340,7 +5580,7 @@
         become forever unusable.  And fortunately, that's not the
         case.  Rather than force users to check out a new working
         copy when a repository is relocated, Subversion provides
-        the <command>svn relocate</command> command, which 
+        the <command>svn relocate</command> command, which
         <quote>rewrites</quote> the working copy's administrative
         metadata to refer to the new repository location.</para>
 
@@ -5370,7 +5610,7 @@
         <para>Users often get confused about the difference
           between <command>svn switch</command> and <command>svn
           relocate</command>.  Here's the rule of thumb:</para>
-        
+
         <itemizedlist>
           <listitem>
             <para>If the working copy needs to reflect a new
@@ -5600,11 +5840,11 @@
 </screen>
       </informalexample>
     </refsect1>
-    
+
     <!-- =============================================================== -->
     <refsect1>
       <title>Examples</title>
-      
+
       <para>Here's an example where, after a postponed conflict
         resolution during update, <command>svn resolve</command>
         replaces the all conflicts in
@@ -5686,11 +5926,11 @@
 </screen>
       </informalexample>
     </refsect1>
-    
+
     <!-- =============================================================== -->
     <refsect1>
       <title>Examples</title>
-      
+
       <para>If you get a conflict on an update, your working
         copy will sprout three new files:</para>
 
@@ -5878,12 +6118,12 @@
       <para>The first seven columns in the output are each one
         character wide, and each column gives you information
         about a different aspect of each working copy item.</para>
-      
+
       <para>The first column indicates that an item
         was added, deleted, or otherwise changed:</para>
 
       <variablelist>
-        
+
         <varlistentry>
           <term><literal>' '</literal></term>
           <listitem>
@@ -5927,7 +6167,7 @@
           <listitem>
             <para>The contents (as opposed to the properties) of
               the item conflict with updates received from the
-              repository.</para>  
+              repository.</para>
           </listitem>
         </varlistentry>
 
@@ -5941,7 +6181,7 @@
         <varlistentry>
           <term><literal>'I'</literal></term>
           <listitem>
-            <para>Item is being ignored (e.g., with the 
+            <para>Item is being ignored (e.g., with the
               <literal>svn:ignore</literal> property).</para>
           </listitem>
         </varlistentry>
@@ -5978,7 +6218,7 @@
         directory's properties:</para>
 
       <variablelist>
-        
+
         <varlistentry>
           <term><literal>' '</literal></term>
           <listitem>
@@ -6010,14 +6250,14 @@
         <xref linkend="svn.tour.cleanup"/>):</para>
 
       <variablelist>
-        
+
         <varlistentry>
           <term><literal>' '</literal></term>
           <listitem>
             <para>Item is not locked.</para>
           </listitem>
         </varlistentry>
-        
+
         <varlistentry>
           <term><literal>'L'</literal></term>
           <listitem>
@@ -6029,16 +6269,16 @@
 
       <para>The fourth column is populated only if the item is
         scheduled for addition-with-history:</para>
-      
+
       <variablelist>
-        
+
         <varlistentry>
           <term><literal>' '</literal></term>
           <listitem>
             <para>No history scheduled with commit.</para>
           </listitem>
         </varlistentry>
-        
+
         <varlistentry>
           <term><literal>'+'</literal></term>
           <listitem>
@@ -6053,14 +6293,14 @@
         linkend="svn.branchmerge.switchwc"/>):</para>
 
       <variablelist>
-        
+
         <varlistentry>
           <term><literal>' '</literal></term>
           <listitem>
             <para>Item is a child of its parent directory.</para>
           </listitem>
         </varlistentry>
-        
+
         <varlistentry>
           <term><literal>'S'</literal></term>
           <listitem>
@@ -6071,9 +6311,9 @@
       </variablelist>
 
       <para>The sixth column is populated with lock information:</para>
-      
+
       <variablelist>
-        
+
         <varlistentry>
           <term><literal>' '</literal></term>
           <listitem>
@@ -6092,7 +6332,7 @@
             <para>File is locked in this working copy.</para>
           </listitem>
         </varlistentry>
-        
+
         <varlistentry>
           <term><literal>'O'</literal></term>
           <listitem>
@@ -6156,14 +6396,14 @@
         option):</para>
 
       <variablelist>
-        
+
         <varlistentry>
           <term><literal>' '</literal></term>
           <listitem>
             <para>The item in your working copy is up to date.</para>
           </listitem>
         </varlistentry>
-        
+
         <varlistentry>
           <term><literal>'*'</literal></term>
           <listitem>
@@ -6179,12 +6419,12 @@
         the <option>--show-updates</option> (<option>-u</option>)
         or <option>--verbose</option> (<option>-v</option>) option
         is passed.</para>
-      
+
       <para>If the <option>--verbose</option>
         (<option>-v</option>) option is passed, the last committed
         revision and last committed author are displayed
         next.</para>
-      
+
       <para>The working copy path is always the final field, so
         it can include spaces.</para>
 
@@ -6405,7 +6645,7 @@
 </screen>
       </informalexample>
     </refsect1>
-    
+
     <!-- =============================================================== -->
     <refsect1>
       <title>Examples</title>
@@ -6467,7 +6707,7 @@
     </indexterm>
 
     <refnamediv>
-      <refname>svn unlock</refname> 
+      <refname>svn unlock</refname>
         <refpurpose>Unlock working copy paths or URLs.</refpurpose>
     </refnamediv>
 
@@ -6722,7 +6962,7 @@
         repository as necessary).  See
         <xref linkend="svn.advanced.sparsedirs" /> for more about
         sparse directories.</para>
-      
+
       <para>You can update multiple targets with a single
         invocation, and Subversion will not only gracefully skip
         any unversioned targets you provide it, but as of
@@ -6858,14 +7098,14 @@
           will be unusable by older versions of Subversion,
           too.</para>
       </warning>
-      
+
     </refsect1>
   </refentry>
 
 </reference>
 
 <!--
-local variables: 
+local variables:
 sgml-parent-document: ("book.xml" "reference")
 end:
 -->




More information about the svnbook-dev mailing list