Introductie

De server beheert een centraal "archief", wat de hoofd database is die alle algemene code bevat van het project. Individuele ontwikkelaars hebben hun eigen "werkende kopieën". Dit zijn lokale kopieën van de database, gemaakt op een specifieke tijd, welke ook de aanpassingen bevatten van de ontwikkelaar die nog niet geupload zijn naar de server. Wanneer een ontwikkelaar zijn veranderingen wil delen met de rest van het team, "commit" hij deze naar de server via een client programma. Deze verzorgd het uploaden van de veranderingen en voegt ze toe aan de veranderingen van andere gebruikers.

De software

Inloggen op de server

Anders dan bij CVS, hoeft u niet steeds in te loggen op de server. In plaats daarvan vraagt SVN wanneer uw login en paswoord nodig zijn.

De AROS broncode ophalen

Om een kopie van de AROS broncode te verkrijgen moet u het "checkout" commando gebruiken, op de volgende manier:

> svn checkout https://svn.aros.org/svn/aros/trunk/AROS

Dit zal een map met de naam AROS creëren en deze vullen met alle sources. Dit kan enige tijd duren als u een langzame netwerk verbinding heeft. De aparte "contrib" module bevat programma's van derden die naar AROS overgezet zijn. U moet ook hier een checkout toepassen mocht u alle AROS soorten willen bouwen:

> cd AROS
> svn checkout https://svn.aros.org/svn/aros/trunk/contrib

De extra broncode ophalen

Behalve de AROS hoofd broncode, die we zojuist met "checkout" ophaalden, bevat het AROS archief ook zaken die niet direct gerelateerd zijn aan het besturingssysteem. Bijvoorbeeld de "binaries" module, die o.a. afbeeldingen bevat zoals screenshots en achtergronden, of de "documentation" module die de bronnen van de website bevat.

U kunt een lijst met alle modules opvragen met:

> svn ls https://svn.aros.org/svn/aros/trunk/

Uw lokale archief updaten

Nadat u de broncode hebt opgehaald, wilt u deze misschien periodiek updaten om de nieuwste wijzigingen te ontvangen van andere ontwikkelaars. Hiervoor moet u het "update" commando gebruiken:

> cd AROS
> svn update

Dit zal de veranderingen van andere ontwikkelaars toevoegen aan uw lokale kopie, samen met eventuele nieuwe bestanden en mappen die toegevoegd zijn. Als iemand veranderingen "commit" die u ook lokaal hebt gemaakt, dan zal SVN proberen deze veranderingen automatisch samen te voegen. Hebt u beiden echter dezelfde regels aangepast dan kan dit samenvoegingsproces falen. Mocht dit gebeuren dan zal SVN dit opmerken en beide versies in het bestand plaatsen, gescheiden door <<<<. U zult daarna handmatig het bestand moeten aanpassen om het conflict op te lossen.

Veranderingen doorsturen

Als u veranderingen hebt gemaakt waarvan u oordeelt dat u deze wil delen met andere ontwikkelaars, gebruik dan het "commit" commando om deze aan het archief toe te voegen:

> svn commit

U kunt ook een lijst specificeren met bestanden voor de commit; anders zal SVN recursief afdalen vanaf het begin van de huidige map, alle bestanden zoekend die veranderd zijn en deze bij de commit versturen. Voordat SVN de veranderingen doorstuurt, zal het u vragen om een "log boodschap" in te voeren. Deze log boodschap bevat typisch een korte samenvatting van wat u veranderd heeft, met in sommige gevallen ook de redenatie daarachter. Goed geschreven log boodschappen zijn erg belangrijk, omdat deze het makkelijker maken voor andere ontwikkelaars om snel te zien wat u hebt gedaan - en misschien ook waarom. Alle log boodschappen worden per dag verzameld en gemaild naar de ontwikkelaars mailing lijst, zodat iedereen op de hoogte kan blijven van de ontwikkelingen in het code archief.

Voordat u de veranderingen in een map commit, is het beter om eerst een update uit te voeren. U kunt dan zien of iemand tussentijds nog aan de betreffende bestanden heeft gewerkt. Mocht dit gebeurd zijn, dan zult u mogelijke conflicten in het bestand op moeten lossen voordat u deze aanpassingen commit. Test a.u.b. ook eerst uw veranderingen voor een commit; om te voorkomen dat deze het build proces onderbreken.

Toevoegen van nieuwe bestanden en mappen

Om nieuwe bestanden en mappen aan het archief toe te voegen, gebruik het "add" commando:

> svn add file.c
> svn add dir

SVN zoekt niet automatisch naar nieuw toegevoegde bestanden en mappen; u moet dat zelf doen. Nadat u het bestand heeft toegevoegd, moet het "commit" commando gebruikt worden om deze ook daadwerkelijk aan het archief toe te voegen.

Eigenschappen instellen

Besturingssystemen verschillen met welke code ze gebruiken voor regeleindes. Om er zeker van te zijn dat text-bestanden die niet zijn gegenereerd voor Linux, dezelfde regeleindes hebben is het nodig het volgende commando uit te voeren:

svn propset svn:eol-style native <source.c>

Subversion kan ook speciale sleutelwoorden invoegen in source bestanden. Om dit in te stellen moet u het volgende commando uitvoeren op het bestand:

svn propset svn:keywords Author Date Id Revision <main.c>

Importeren

Als u een grote collectie bestanden toevoegt, bijv. de broncode van een bestaande applicatie, wordt het gebruik van "svn add" snel vervelend. Voor dit soort acties kunt u daarom beter "svn import" gebruiken. Helaas is het SVN handleiding onderdeel over het import commando nogal slecht geschreven; een aanvulling is daarom op zijn plaats:

1. Zet de bestanden en mappen die u wilt importeren waar u ook wilt, zolang dit niet binnen uw lokale werkende kopie is. Het draaien van het "import" commando op een map die zich bevind binnen een bestaande lokale SVN kopie kan tot enkele heel vreemde resultaten leiden; beter dus om zulke problemen te ontwijken.

2. Ga naar de map die de bestanden bevat die u wilt importeren:

   > cd map-1.2.3
   

3. Importeer de bestanden met het "svn import" commando:

   > svn import -m <logMessage> <destinationPath>
   > svn import -m <logboodschap> <doelpad>
   

   Dit zal recursief alle bestanden naar het archief importeren, vanuit de huidige map en lagere mappen, naar het doelpad en met de log boodschap die u opgegeven heeft. In werkelijkheid worden niet alle bestanden toegevoegd: SVN zal sommige bestandsnamen negeren, zoals de gebruikelijke namen van back-ups en verborgen bestanden, zoals #?.bak, .#? en #?~.

   Desondanks kunt u beter eerst alle bestanden verwijderen die u niet in het archief zou willen hebben. Onderbreek SVN overigens niet tijdens een import als u ziet dat een verkeerd bestand toegevoegd wordt. Vermeld het en verwijder het bestand later zelf.

   Als voorbeeld: stel u wilt de SVN 1.1.3 broncode in de "contrib/development/versioning/svn" map importeren:

   > cd subversion-1.1.3
   > svn import -m "Begin import van SVN 1.11.12"
   \ https://svn.aros.org/svn/aros/trunk/contrib/development/versioning/svn
   

Aanvullende informatie

Aanvullende en gedetailleerdere informatie over SVN kan natuurlijk gevonden worden in de handleiding en informatie bestanden die meegeleverd worden met SVN zelf. Ook zijn er veel sites die handige uitleg en gidsen bevatten die misschien nog wel makkelijker te lezen zijn. De volgende (Engelstalige) pagina's worden aangeraden:

• Versie Controle met Subversion (Engels)
• Subversion Home (Engels)