Hackers guide to Lybniz

This document is designed to help you get started hacking on Lybniz

Requirements

For Lybniz version 2 you will also need Glade.

In Debian or Ubuntu you can make sure you have all you need by running apt-get install python python-gtk2 subversion python-glade glade-3 or use synaptic package manager to install them.

For other distributions, please see their documentation for installing packages.

Getting the latest code

If you want to help with development you will need to be running the latest code, as there may have been progress since the past release. The code is store in a Subversion repository at sourceforge.net. You can browse this online.

To download all of the the source code use Subversion svn co https://lybniz2.svn.sourceforge.net/svnroot/lybniz2 lybniz

Often you will only want to get the trunk, so use svn co https://lybniz2.svn.sourceforge.net/svnroot/lybniz2/trunk lybniz or to get the version 2 development branch svn co https://lybniz2.svn.sourceforge.net/svnroot/lybniz2/branches/ver2 lybniz2

(the "ver2" branch will become the trunk at some point before version 2 is released)

Making changes

Now that you have the code you can open up the source files in you text editor and make modifications. Subversion will keep track of the modifications you have made relative to the version you checked out. For example to see the changes you have made: svn diff

To revert back to the original version do svn revert .

For more information on subversion see the excellent Subversion Book (it is free).

Submitting changes

The best way to get your changes into Lybniz is to email me a patch file. This can be made with the diff command above, like so: svn diff > my_fantastic_patch.diff

Send the patch along with a description of what it does to samtygier at yahoo dot co dot uk. If I think it might be useful to other users I will include it.


SourceForge.net Logo