This text is a work in progress—highly subject to change—and may not accurately describe any released version of the Apache™ Subversion® software. Bookmarking or otherwise referring others to this page is probably not such a smart idea. Please visit http://www.svnbook.com/ for stable versions of this book.

Chapitre 2. Utilisation de base

Table des matières

À l'aide !
Enregistrement de données dans le dépôt
Importation de fichiers et de dossiers
Organisation conseillée d'un dépôt
Limitations sur les noms
Création d'une copie de travail
Cycle de travail de base
Mise à jour de la copie de travail
Modifications dans la copie de travail
Revue des changements apportés
Vue d'ensemble des changements effectués
Détail des modifications effectuées localement
Annulation des changements de la copie de travail
Résolution des conflits
Traitement des lignes en conflit de façon interactive
Résolution des conflits en mode interactif
Remise à plus tard de la résolution d'un conflit
Résolution des conflits à la main
Abandon des modifications au profit de la révision la plus récente
Retour en arrière avec svn revert
Propagation des modifications
Recherche dans l'historique
Détail des modifications passées
Modifications locales
Comparaison entre la copie de travail et le dépôt
Comparaison entre des révisions du dépôt
Historique des modifications
Navigation dans le dépôt
Affichage du contenu d'un fichier
Affichage ligne par ligne des auteurs de modifications
Contenu des dossiers suivis en versions
Extraction d'anciennes versions au sein d'un dépôt
Parfois, il suffit de faire le ménage
Suppression d'une copie de travail
Reprise après une interruption
Gestion des conflits d'arborescences
Un exemple de conflit d'arborescences
Résumé

La théorie est utile, mais son application est tout simplement passionnante. Nous allons maintenant voir plus en détail l'utilisation de Subversion. Quand vous aurez terminé ce chapitre, vous serez capable d'effectuer toutes les tâches nécessaires à une utilisation quotidienne de Subversion. Nous allons commencer par enregistrer nos fichiers dans Subversion, puis extraire notre code. Ensuite, nous expliquons comment modifier des fichiers et examiner ces changements. Nous voyons aussi comment faire pour intégrer les changements venant d'autres personnes dans notre copie de travail, les examiner et résoudre les conflits qui pourraient apparaître.

Notez que ce chapitre ne doit pas être vu comme une liste complète de toutes les commandes de Subversion, mais plutôt comme une introduction conviviale aux opérations Subversion les plus courantes que vous êtes susceptible de rencontrer. Ici, nous supposons que vous avez lu et compris le Chapitre 1, Notions fondamentales et que vous êtes familier avec le modèle général de Subversion. Pour une liste complète de toutes les commandes, reportez-vous à la Partie II, « Guide de référence des commandes Subversion ».

Dans ce chapitre, nous considérons également que le lecteur cherche comment interagir de manière simple avec un dépôt Subversion existant. S'il n'y a pas de dépôt, il n'y a pas de copie de travail ; s'il n'y a pas de copie de travail, ce chapitre ne présente pas grand intérêt. Il existe de nombreux sites Internet qui propose d'héberger un dépôt Subversion gratuitement ou pour une somme modique. Sinon, si vous préférez mettre en place et administrer vos propres dépôts, référez-vous au Chapitre 5, Administration d'un dépôt. Mais n'espérez pas que les exemples de ce chapitre fonctionnent si vous n'avez pas accès à un dépôt Subversion.

Enfin, toutes les opérations Subversions qui contactent le dépôt à travers le réseau peuvent potentiellement nécessiter une authentification de l'utilisateur. Par souci de simplicité, nos exemples tout au long de ce chapitre n'abordent pas l'authentification. Soyez conscient que si vous souhaitez mettre en pratique les exemples fournis ici avec une instance Subversion du monde réel, vous serez certainement obligé de fournir un identifiant et un mot de passe au serveur. Lisez la section intitulée « Éléments d'authentification du client » pour une description détaillée de la façon dont Subversion gère l'authentification des utilisateurs et les éléments associés.