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 !
Enregistrer des données dans votre dépôt
Importer des fichiers et des dossiers
Organisation conseillée d'un dépôt
Qu'y a-t-il dans un nom ?
Créer une copie de travail
Cycle de travail de base
Mettre à jour votre copie de travail
Apporter des modifications à votre copie de travail
Examiner les changements apportés
Avoir une vue d'ensemble des changements effectués
Voir en détail les modifications que vous avez effectuées localement
Annuler des changements sur la copie de travail
Résoudre les conflits
Voir les lignes en conflit de façon interactive
Résoudre les conflits en mode interactif
Remettre à plus tard la résolution d'un conflit
Résoudre les conflits à la main
Abandonner vos modifications au profit de la révision la plus récente
Revenir en arrière : utiliser svn revert
Propager vos modifications
Rechercher dans l'historique
Examiner le détail des modifications passées
Modifications locales
Comparer une copie de travail et le dépôt
Comparer des révisions du dépôt
Afficher l'historique des modifications
Naviguer dans le dépôt
Afficher le contenu d'un fichier
Afficher ligne par ligne les auteurs de modifications
Lister le contenu des dossiers suivis en versions
Retrouver d'anciennes versions au sein d'un dépôt
Parfois, il suffit de faire le ménage
Se débarrasser d'une copie de travail
Reprendre après une interruption
Gérer les 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.