Afbeelding 4.11. Overlappende pictogrammen weergegeven in de verkenner

Nu je een werkkopie hebt opgehaald uit het Subversion archief, kun je de bestanden zien in de Windows verkenner met de gewijzigde pictogrammen/iconen. Dit is één van de redenen waarom TortoiseSVN zo populair is. TortoiseSVN voegt zogenaamde overlay iconen, dat zijn iconen die over de normale iconen geprojecteerd worden, toe aan de originele iconen. Afhankelijk van de status in Subversion wordt telkens een ander pictogram weergegeven.

Een verse werkkopie opgehaald uit het archief heeft een groen vinkje als overlappend pictogram. Dit betekend dat dit object de Subversion status normaal heeft.

Zodra je een bestand gewijzigd en opgeslagen hebt, wordt de status gewijzigd in gewijzigd en zal het overlappende pictogram wijzigen in een rood pictogram met een uitroepteken. Op deze manier kun je makkelijk zien welke bestanden gewijzigd zijn sinds de laatste keer dat je je werkkopie ververst hebt.

Als bij het verversen zich een conflict voordoet, dan zal er een geel pictogram met een uitroepteken te zien zijn.

Als je de svn:needs-lock eigenschap ingesteld hebt op een bestand, dan zal Subversion dat bestand als alleen-lezen instellen totdat het bestand voor jou vergrendeld is. Dergelijke bestanden krijgen deze pictogram om aan te geven dat je het bestand eerst moet vergrendelen, voordat je het kunt wijzigen.

Als je een bestand vergrendeld hebt en de Subversion status is normaal, dan herinnert dit opverlappend pictogram je eraan dat je het bestand nog vrij moet geven als je anderen de mogelijkheid wilt geven om daarin wijzigingen vast te laten leggen.

Dit pictogram geeft aan dat bestanden of mappen in de huidige map gemarkeerd zijn om te verwijderen uit het archief of dat een bestand in het archief mist in de folder van je werkkopie.

Het plusteken geeft aan dat het bestand of de map van versiebeheer voorzien moet worden en dus aan het archief toegevoegd moet worden.

Het balk-teken geeft aan dat een bestand of map genegeerd wordt voor versiebeheer. Dit pictogram is optioneel.

Dit pictogram geeft de bestanden en mappen aan die niet van versiebeheer voorzien zijn, maar ook niet genegeerd worden. Dit pictogram is optioneel.

In de praktijk zul je zien dat niet alle pictogrammen gebruikt zullen worden op jouw systeem. Dit komt doordat Windows maar een beperkt aantal overlappende pictogrammen toestaat. Als je ook nog een oude versie van TortoiseCVS gebruikt, dan zijn er niet genoeg sloten voor overlappende pictogrammen beschikbaar. TortoiseSVN probeert een goede burger (“Good Citizen (TM)”) te zijn en beperkt het gebruik van overlappende pictogrammen om andere applicaties ook een kans te geven.

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 :-)

Een beschrijving van de overlappende pictogrammen en hoe deze zich met de Subversion status en andere technische details verhouden kun je vinden in de paragraaf met de naam “Overlappende Pictogrammen”.

Afbeelding 4.12. Verkenner eigenschappen pagina, Subversion tab

In sommige gevallen wilt u meer gedetaileerde informatie over een bestand/map dan het overlappende pictogram. U kunt alle informatie welke Subversion levert verkrijgen in het eigenschappen dialoog van de verkenner. Selecteer het bestand of directorie en selecteer Windows Menu → eigenschappen in het contextmenu (noot: dit is het normale eigenschappen menu-optie welke de verkenner levert, niet degene in het TortoiseSVN submenu!). In het eigenschappen dialoogvenster heeft TortoiseSVN een nieuwe eigenschappen pagina toegevoegd, voor bestanden/folders welke onder Subversion controle vallen, waar u alle relevante informatie over het geselecteerde bestand/directorie kunt vinden.

Afbeelding 4.13. Controleer op Wijzigingen

Het is vaak handig om te weten welke bestanden anderen gewijzigd en vastgelegd hebben. Hiervoor is het commando TortoiseSVN → Kijk of er updates zijn... erg handig. Het venster zal elk bestand weergeven dat op welke manier dan ook gewijzigd is in je werkkopie en ook de bestanden zonder versiebeheer.

Als je op de Controleer Archief klikt, dan kun je ook de wijzigingen in het archief bekijken. Hiermee kun je, voordat je je wijzigingen vastlegt, nagaan of er conflicten zullen ontstaan. Je kunt ook alleen geselecteerde bestanden verversen, zonder dat de hele map ververst hoeft te worden. De Controleer Archief haalt standaard de status op van de werkkopie met de instelling van mapdiepte van de werkkopie. Als je alle bestanden in het archief wilt zien, ook degene die je niet opgehaald hebt, dan moet je de Shift ingedrukt houden als je op de knop Controleer Archief drukt.

In dit venster worden kleurcoderingen toegepast om de status weer te geven.

Dit is het standaard kleurenschema, maar je kunt deze naar je eigen wensen aanpassen in het instellingen venster. Lees voor meer informatie de paragraaf met de naam “TortoiseSVN kleurinstellingen”.

Overlay icons are used to indicate other states as well. The screenshot below shows all the possible overlays that are shown if necessary.

Overlays are shown for the following states:

Items which have been switched to a different repository path are also indicated using an (s) marker. You may have switched something while working on a branch and forgotten to switch back to trunk. This is your warning sign! The context menu allows you to switch them back to the normal path again.

Vanuit het context menu van het venster kun je de verschillen van de wijzigingen opvragen. Controleer de wijzigingen die jij lokaal gemaakt hebt door te kiezen voor Context Menu → Vergelijk met basis. Om de wijzigingen te bekijken die anderen in het archief hebben opgeslagen kies je Context Menu → Toon verschillen als unified diff.

Het is ook mogelijk om wijzigingen in individuele bestanden terug te draaien. Als je per ongeluk een bestand verwijderd hebt, dan zal deze weergegeven worden als Ontbrekend. Je kunt deze dan terughalen met Maak ongedaan.

Bestanden zonder versiebeheer of bestanden die op de negeren lijst staan, kunnen verwijderd worden (naar de prullenbak) van de lokale kopie door de optie Context Menu → Verwijderen te gebruiken. Als je bestanden permanent wilt verwijderen (zonder ze naar de prullenbak te doen), dan moet je Shift ingedruikt houden als je op Verwijderen klikt.

If you want to examine a file in detail, you can drag it from here into another application such as a text editor or IDE, or you can save a copy simply by dragging it into a folder in explorer.

Je kunt de kolommen aanpassen. Als je met rechts klikt op de koptekst van een kolom, dan krijg je een context menu te zien waarmee je kunt aangeven welke kolommen je wilt zien. De breedte van de kolommen kun je aanpassen door de kolomovergangen te verslepen. De aanpassingen worden opgeslagen, zodat deze er een volgende keer net zo uit zien.

Je kunt groepen bestanden in een wijzigingenlijst opnemen. Dit is handig als je aan meerdere taken, die niets met elkaar de maken hebben, tegelijk werkt. Lees hiervoor de paragraaf met de naam “Werksets”.

Onderaan het scherm kun je zien welke reeks van archiefrevisies er in je werkkopie gebruikt worden. Dit zijn de rivisies van de vastlegging, niet van de laatste verversing; dit geeft de reeks van revisies weer van de laatste vastleggingen, niet van de laatste verversing. Merk op dat de reeks van revisies alleen slaat op de objecten die weergegeven zijn in het venster, niet op je hele werkkopie. Als je deze informatie van je hele werkkopie wilt zien, dan moet je het selectievak Niet gewijzigde bestanden weergeven selecteren.

Vaak wil je de inhoud van bestanden even bekijken, om te bekijken wat je precies gewijzigd hebt. Dit kun je doen door een gewijzigd bestand te selecteren en Vergelijk in TortoiseSVN's context menu te selecteren. Hiermee wordt het externe vergelijk-programma gestart, waarmee het huidige bestand vergeleken zal worden met de ongewijzigde kopie (BASE revisie) die opgeslagen was na de laatste verversing.