Pendant que vous travaillez sur votre copie de travail, vous avez souvent besoin de savoir quels fichiers vous avez changé/ajouté/supprimé ou renommé, ou même quels fichiers ont été changés et livrer par les autres.
Maintenant que vous avez extrait une copie de travail à partir d'un référentiel Subversion, vous pouvez voir vos fichiers dans l'explorateur Windows avec des icônes changées. C'est une des raisons pour laquelle TortoiseSVN est si populaire. TortoiseSVN ajoute une icône de recouvrement à chaque icône de fichier chevauchant l'icône de fichier originale. Selon le statut Subversion du fichier, l'icône de recouvrement est différente.
A fresh checked out working copy has a green checkmark as overlay. That means the Subversion status is normal.
As soon as you start editing a file, the status changes to modified and the icon overlay then changes to a red exclamation mark. That way you can easily see which files were changed since you last updated your working copy and need to be committed.
If during an update a conflict occurs then the icon changes to a yellow exclamation mark.
If you have set the svn:needs-lock property on a file, Subversion makes that file read-only until you get a lock on that file. Such files have this overlay to indicate that you have to get a lock first before you can edit that file.
If you hold a lock on a file, and the Subversion status is normal, this icon overlay reminds you that you should release the lock if you are not using it to allow others to commit their changes to the file.
This icon shows you that some files or folders inside the current folder have been scheduled to be deleted from version control or a file under version control is missing in a folder.
The plus sign tells you that a file or folder has been scheduled to be added to version control.
The bar sign tells you that a file or folder is ignored for version control purposes. This overlay is optional.
This icon shows files and folders which are not under version control, but have not been ignored. This overlay is optional.
In fact, you may find that not all of these icons are used on your system. This is because the number of overlays allowed by Windows is very limited and if you are also using an old version of TortoiseCVS, then there are not enough overlay slots available. TortoiseSVN tries to be a « Good Citizen (TM) » and limits its use of overlays to give other apps a chance too.
Now that there are more Tortoise clients around (TortoiseCVS, TortoiseHG, ...) the icon limit becomes a real problem. To work around this, the TortoiseSVN project introduced a common shared icon set, loaded as a DLL, which can be used by all Tortoise clients. Check with your client provider to see if this has been integrated yet :-)
For a description of how icon overlays correspond to Subversion status and other technical details, read la section intitulée « Recouvrement d'icônes ».
Les mêmes informations, disponibles avec le recouvrement d'icônes, (et plus encore) peuvent être affichées avec des colonnes supplémentaires dans l'affichage en détail de l'explorateur Windows.
Simply right click on one of the headings of a column, choose from the context menu displayed. A dialog will appear where you can specify the columns and their order, which is displayed in the « Detailed View ». Scroll down until the entries starting with SVN come into view. Check the ones you would like to have displayed and close the dialog by pressing . The columns will be appended to the right of those currently displayed. You can reorder them by drag and drop, or resize them, so that they fit your needs.
Important
The additional columns in the Windows Explorer are not available on Vista, since Microsoft decided to not allow such columns for all files anymore but only for specific file types.
Astuce
Si vous voulez que la disposition actuelle soit affichée dans toutes vos copies de travail, vous pouvez vouloir en faire la vue par défaut.
Il est souvent très utile de savoir quels fichiers vous avez changé et aussi quels fichiers ont été changés et livrés par les autres. C'est là où la commande → devient pratique. Cette boîte de dialogue vous montrera chaque fichier changé de n'importe quelle façon dans votre copie de travail, aussi bien que les fichiers non versionnés que vous pouvez avoir.
Si vous cliquez sur alors vous pouvez aussi chercher les changements du référentiel. De cette manière vous pouvez vérifier avant une mise à jour s'il y a un conflit possible. Vous pouvez aussi mettre à jour des fichiers choisis du référentiel sans mettre à jour le dossier entier.
La boîte de dialogue utilise un code couleur pour mettre le statut en évidence .
- Bleu
Éléments modifiés localement
- Pourpre
Éléments ajoutés. Les éléments qui ont été ajoutés avec un historique ont un signe
+dans la colonne Statut du texte et une info-bulle montre d'où l'article a été copié.- Rouge foncé
Éléments supprimés ou manquants.
- Vert
Éléments modifiés localement et dans le référentiel. Les changements seront fusionnés lors de la mise à jour. Cela peut produire des conflits à la mise à jour.
- Rouge clair
Éléments modifiés localement et supprimés dans le référentiel, ou modifiés dans le référentiel et supprimés localement. Cela va produire des conflits à la mise à jour.
- Noir
Éléments inchangés et non versionnés.
C'est la combinaison de couleur par défaut, mais vous pouvez personnaliser ces couleurs en utilisant la boîte de dialogue de configuration. Lisez la section intitulée « Configuration des couleurs de TortoiseSVN » pour plus d'informations.
Les éléments qui ont été commutés vers un chemin de référentiel différent sont aussi indiqués en utilisant un marqueur (s). Vous pouvez avoir commuté quelque chose en travaillant sur une branche et avoir oublié de rebasculer sur le tronc. C'est votre signe d'alarme!
À partir du menu contextuel de la boîte de dialogue vous pouvez afficher une comparaison des changements. Vérifiez les changements locaux que vous avez fait en utilisant → . Vérifiez les changements du référentiel faits par les autres en utilisant → .
Vous pouvez aussi annuler des changements dans des fichiers individuels. Si vous avez supprimé un fichier accidentellement, il apparaitra comme Manquant et vous pourrez utiliser Revenir en arrière pour le récupérer.
Les fichiers non versionnés et les fichiers ignorés peuvent être envoyé dans la corbeille à partir d'ici en utilsant → . Si vous voulez supprimer définitevement les fichiers (sans passer par la corbeille) maintenez la touche Maj pendant que vous cliquez sur Supprimer.
Si vous voulez examiner un fichier en détail, vous pouvez le glisser d'ici vers une autre application comme un éditeur de texte ou une IDE.
The columns are customizable. If you right click on any column header you will see a context menu allowing you to select which columns are displayed. You can also change column width by using the drag handle which appears when you move the mouse over a column boundary. These customizations are preserved, so you will see the same headings next time.
If you are working on several unrelated tasks at once, you can also group files together into changelists. Read la section intitulée « Listes de changements » for more information.
At the bottom of the dialog you can see a summary of the range of repository revisions in use in your working copy. These are the commit revisions, not the update revisions; they represent the range of revisions where these files were last committed, not the revisions to which they have been updated. Note that the revision range shown applies only to the items displayed, not to the entire working copy. If you want to see that information for the whole working copy you must check the Show unmodified files checkbox.
Astuce
Si vous voulez une vue plate de votre copie de travail, c'est-à-dire qui montre tous les fichiers et des dossiers à chaque niveau de la hiérarchie des dossiers, alors la boîte de dialogue Vérifier les modifications est la façon la plus facile d'y arriver. Cochez seulement la case Afficher les fichiers non modifiés pour afficher tous les fichiers de votre copie de travail.
Repairing External Renames
Sometimes files get renamed outside of Subversion, and they show up in the file list as a missing file and an unversioned file. To avoid losing the history you need to notify Subversion about the connection. Simply select both the old name (missing) and the new name (unversioned) and use → to pair the two files as a rename.
Souvent vous voulez regarder à l'intérieur de vos fichiers, pour regarder ce que vous avez changé. Vous pouvez accomplir cela en sélectionnant un fichier qui a changé et en choisissant à partir du menu contextuel de TortoiseSVN. Cela démarre le visualisateur externe de différence , qui comparera alors le fichier actuel avec la copie primitive (la révision BASE), qui a été stockée après la dernière extraction ou la dernière mise à jour.
Astuce
Même lorsque vous ne vous trouvez pas dans une copie de travail ou quand vous avez de multiples versions du fichier ici et là, vous pouvez toujours afficher les différences :
Sélectionnez les deux fichiers vous voulez comparer dans l'explorateur (en utilisant par exemple Ctrl et la souris) et sélectionnez à partir du menu de contextuel de TortoiseSVN. Le fichier cliqué en dernier (celui avec le focus, c'est-à-dire le rectangle pointillé) sera considéré comme le plus récent.