Difference between revisions of "Nl:Korte introductie tot SVN"

From Gramps
Jump to: navigation, search
(Opdrachten van Subversion)
m
(One intermediate revision by one other user not shown)
Line 1: Line 1:
[[Category:Developers/General]]
 
 
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 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 2.2.x ==
+
== De stabiele versie==
 
* Om de broncode op te halen, kan je op twee manieren toegang krijgen tot de SVN-bibliotheek:
 
* Om de broncode op te halen, kan je op twee manieren toegang krijgen tot de SVN-bibliotheek:
 
# Een http-frontend naar gramps-SVN
 
# Een http-frontend naar gramps-SVN
Line 35: Line 34:
 
Omdat dit wegschrijven niet zonder gevaar is, moet je eerst expliciet schrijfrechten op de SVN-bibliotheek aanvragen aan Don Allingham of Alex Roitman.
 
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 2.3 ==
+
== De onstabiele ontwikkelingsversie==
  
 
Op 2/2/2007 werd een ontwikkelingsstructuur aangemaakt. Je kan een kopij verkrijgen door:
 
Op 2/2/2007 werd een ontwikkelingsstructuur aangemaakt. Je kan een kopij verkrijgen door:
  
 
<code>
 
<code>
   svn co https://gramps.svn.sourceforge.net/svnroot/gramps/branches/gramps23
+
   svn co https://gramps.svn.sourceforge.net/svnroot/gramps/branches/gramps{{stable_branch}}
 
</code>
 
</code>
  
Line 76: Line 75:
  
 
Usage:
 
Usage:
*place svnci in your root svn directory, eg <code>gramps2</code> or <code>gramps23</code>
+
*place svnci in your root svn directory, eg <code>gramps2</code> or <code>gramps{{stable_branch}}</code>
 
*you '''need''' to have the ''patchutils'' package installed, or svnci will throw an error (''filterdiff'' is needed)
 
*you '''need''' to have the ''patchutils'' package installed, or svnci will throw an error (''filterdiff'' is needed)
 
*do edits and commit new files
 
*do edits and commit new files
Line 84: Line 83:
 
=== Bekijken van svn ===
 
=== Bekijken van svn ===
  
An alternative to the command line tools to view the svn repository is
+
An alternative to the command line tools to view the svn repository is the [http://gramps.svn.sourceforge.net/viewvc/gramps/ online interface].
the [http://gramps.svn.sourceforge.net/viewvc/gramps/ online interface].
+
 
 +
[[Category:Developers/General]]

Revision as of 17:35, 20 April 2012

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/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 or gramps52
  • 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.