Nl:Korte introductie tot SVN

From Gramps
Jump to: navigation, search

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.

De stabiele versie

  • Om de broncode op te halen, kan je op twee manieren toegang krijgen tot de SVN-bibliotheek:
  1. Een http-frontend naar gramps-SVN
  2. 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/gramps4.0

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 or gramps4.0
  • 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.