Nl:Korte introductie tot SVN
De ontwikkelingsbroncode van GRAMPS wordt opgeslagen in een SVN-bibliotheek. Dit is nodig om veranderingen, die verschilllende ontwikkelaars aanmaken, synchroon te laten verlopen. Je kan zo ook op een eenvoudige manier de versies van de programma-onderdelen controleren. Wanneer je dit leest, wil je waarschijnlijk slechts twee dingen doen: de llatste versie van de broncode ophalen, of je aanpassingen wegschrijven.
Contents
De stabiele versie
- Om de broncode op te halen, kan je op twee manieren toegang krijgen tot de SVN-bibliotheek:
- Een http-frontend naar gramps-SVN
- SVN-toegang
- Om je aanpassingen en veranderingen weg te kunnen schrijven naar de SVN-bibliotheek, moet je toegang krijgen als ontwikkelaar.
Om de tweede methode te kunnen gebruiken moet je eerst SVN op je systeem installeren( voor een Debian/Ubuntu systeem):
apt-get install subversion
Onder de SVN-methode, typ dan de volgende commandoregels:
svn co https://svn.sourceforge.net/svnroot/gramps/trunk/gramps2
Nu zou je in je console de vooruitgang van het ophaalproces moeten zien. Indien je na verloop van tijd je broncodeboom wil actualiseren, moet je de volgende opdrachten intypen. Let wel: dit doe je in de bovenste map van je broncodestructuur.
svn update
Om je veranderingen weg te schrijven, doe je:
svn commit
Omdat dit wegschrijven niet zonder gevaar is, moet je eerst expliciet schrijfrechten op de SVN-bibliotheek aanvragen aan Don Allingham of Alex Roitman.
De onstabiele ontwikkelingsversie
Op 2/2/2007 werd een ontwikkelingsstructuur aangemaakt. Je kan een kopij verkrijgen door:
svn co https://gramps.svn.sourceforge.net/svnroot/gramps/branches/gramps52
Enkele nuttige tips
Opdrachten van Subversion
svn help add
svn help commit
svn help log
Om bestanden te kunnen toevoegen aan programmabibliotheken, moeten eerst een aantal bestandseigenschappen ingesteld worden. Zie
svn help propset
You can use the
propget
on existing files to see how you should add it. A convenient way is to common files to your
~/.subversion/config
file, eg in my config I have:
*.py = svn:eol-style=native;svn:mime-type=text/plain;svn:keywords=Author Date Id Revision *.sh = svn:eol-style=native;svn:executable Makefile = svn:eol-style=native *.png = svn:mime-type=application/octet-stream *.svg = svn:eol-style=native;svn:mime-type=text/plain
The svnci script
A usefull script for helping you commit changes is svnci
: Download svnci
Usage:
- place svnci in your root svn directory, eg
gramps2
orgramps52
- you need to have the patchutils package installed, or svnci will throw an error (filterdiff is needed)
- do edits and commit new files
- edit the Changelog file with your edits
- to commit changes to the svn repository, go to the root directory, and do
./svnci
. This will collect all changes, and upload the change. The log message will be taken from the Changelog.
Bekijken van svn
An alternative to the command line tools to view the svn repository is the online interface.