[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