Lorsque vous travaillez avec le référentiel Subversion, les modifications distantes (celles du référentiel) sont des modifications entrantes (distant → local), tandis que les modifications locales sont des modifications sortantes (local → distant).
Dans les vues qui comparent les copies locales et distantes, les modifications entrantes sont signalées par une flèche bleue orientée vers la gauche, tandis que les modifications sortantes sont signalées par une flèche grise orientée vers la droite. Ces flèches peuvent être décorées pour indiquer des opérations plus spécifiques.
La vue Explorateur de packages, quant à elle, indique l'état d'un fichier avec un ensemble différent d'icônes représentant son état local. Ces icônes sont les plus courantes, alors commençons par elles:
- Un fichier ignoré par le contrôle de version. Vous pouvez contrôler quelles ressources seront ignorées en allant dans Fenêtre → Préférences → Équipe → Ressources ignorées .
- Un fichier non sous contrôle de version. Il s'agit généralement de nouveaux fichiers que vous n'avez pas encore validés dans le référentiel.
- Un fichier versionné qui doit être ajouté au référentiel distant. Il s'agit généralement de fichiers que vous avez renommés ou déplacés vers un autre répertoire.
- Un dossier supprimé. Il s'agit de dossiers que vous avez supprimés localement sans encore valider les modifications dans le référentiel. Notez que les fichiers sont généralement supprimés de la vue lorsqu'ils sont supprimés localement, ils ne sont donc normalement pas affichés avec cette icône.
- Un fichier sans modifications locales.
- Un fichier avec des modifications locales non validées.
- UNEfichier verrouillé .
- Un fichier qui nécessite un verrou pour être édité. Ce sont généralement des fichiers qui ne peuvent pas être facilement fusionnés (c'est-à-dire des fichiers binaires), mais qui peuvent avoir de nombreux éditeurs. Un fichier a besoin d'un verrou lorsque sa svn:needs-lock
propriété est définie, et Subversion tentera de rendre ces fichiers en lecture seule dans le système de fichiers pour appliquer une négociation de verrouillage appropriée.
- Un fichier en conflit. Ce sont généralement des fichiers qui ont eu un conflit de validation / mise à jour que vous avez marqué pour être résolu ultérieurement.
- Un fichier qui a un conflit d'arborescence. Ce sont généralement des fichiers qui ont des modifications locales, mais qui ont depuis été déplacés, supprimés ou renommés dans le référentiel depuis la dernière mise à jour de la copie locale.
- Un fichier externe au projet. Les fichiers externes liés ne peuvent pas être validés dans le référentiel. - Un fichier qui a été
commuté . Ce sont des fichiers qui appartiennent à une copie de travail différente de leur répertoire parent local.
Dans une vue de synchronisation (par exemple via Synchronize with Repository ou Commit ), comme décrit précédemment, il y a des icônes qui indiquent dans quelle direction un changement se produit ainsi que des informations supplémentaires sur ce changement. Ceux-ci sont décrits ci-dessous:
Sortant
- Un fichier dont le contenu a été modifié et sera validé dans le référentiel.
- Un fichier qui sera nouvellement ajouté au référentiel. Cela peut coïncider avec une suppression de fichier dans les cas où un fichier est déplacé ou renommé.
- Un fichier qui sera supprimé du référentiel. Cela peut coïncider avec un ajout de fichier dans les cas où un fichier est déplacé ou renommé.
- Un fichier avec des changements de propriétés , dans la boîte de dialogue Valider. Dans l'onglet Synchroniser, les modifications de propriété sont actuellement reflétées comme une modification de fichier normale ( ).
Entrant
- Un fichier dont les modifications de contenu ont été validées dans le référentiel qui seront appliquées à la copie locale.
- Un nouveau fichier qui sera ajouté à la copie locale à partir du référentiel. Comme l'ajout de fichier sortant, cela peut être le résultat d'un déplacement ou d'un changement de nom.
- Un fichier qui sera supprimé de la copie locale car il a été supprimé du référentiel. Comme la suppression du fichier sortant, cela peut être le résultat d'un déplacement ou d'un changement de nom.
Conflit
- Un fichier qui a été modifié à la fois dans la copie locale et dans le référentiel indépendamment, ce qui nécessite une résolution de conflit. La résolution de cette condition implique l'ouverture de la vue de conflit ou l'écrasement forcé des modifications localement ou à distance.
- Un fichier qui a un conflit d'arborescence . Cela peut se produire lorsque de nouvelles modifications sont apportées à un fichier à une extrémité (locale ou distante) et que le fichier est déplacé, supprimé ou renommé de l'autre.
Enfin, l' option Synchroniser avec le référentiel ouvre l'onglet Synchroniser ( ) avec les boutons suivants:
- Synchronise la copie locale avec le référentiel actuellement sélectionné lorsque vous cliquez dessus. La sélection dans la liste déroulante permet de basculer entre différentes bases de code à distance.
- Affiche uniquement les modifications entrantes (distant → local).
- Affiche uniquement les changements sortants (local → distant).
- Affiche les changements entrants et sortants (distant ↔ local).
- Affiche les changements contradictoires.
- Met à jour toutes les ressources locales avec les modifications entrantes après l'invite.
- Ouvre la boîte de dialogue de validation pour valider toutes les modifications sortantes.
- Décompose les listes de modifications par révisions.
Il y a quelques autres vues qui n'ont pas été couvertes et qui ont des icônes supplémentaires, mais cela devrait, espérons-le, être un bon début. Faites-moi savoir s'il manque quelque chose d'important ou si l'une de ces descriptions semble différer de votre expérience réelle.