Quick SVN guide

Subversion (SVN) is the version control system used by emesene. Users can checkout svn copies to get the latest changes, improvements, bugfixes, etc. If you don't like or don't know how to deal with the console, svn is not for you

You have to install the "subversion" package with your package manager to make the svn command available. On debian / ubuntu it's: sudo apt-get install subversion)

Checkout

To download a svn working copy, you have to choose a "branch" first. The following branches are available:

  • Trunk (Unstable)
    • Latest features
    • May have bugs, crash, kill your cat, etc. and it won't let you complain since it's unstable
    • Recommended if you like bleeding-edge features or you don't care about losing your job/girlfriend because emesene decided to discard random messages.
    • Checkout command: 
      svn co https://emesene.svn.sourceforge.net/svnroot/emesene/trunk/emesene emesene
  • emesene-1.0 branch (Stable)
    • Same features as the 1.0 release
    • A few extra bugfixes that didn't fit in the release date
    • Future 1.0.1
    • Recommended to all users but developers, since we won't accept new features in this branch.
    • Checkout command: 
      svn co https://emesene.svn.sourceforge.net/svnroot/emesene/branches/emesene-1.0 emesene

After choosing which branch to checkout, svn will download everything and create a directory called "emesene", which is called "working copy". That's all, just remember the location. To start it from console, type ./emesene/emesene.

You may create a shortcut on your desktop environment, the icons are in a "misc" directory inside your svn copy.

Switch

Switch to stable: 

svn switch https://emesene.svn.sourceforge.net/svnroot/emesene/branches/emesene-1.0

Switch to unstable: 

svn switch https://emesene.svn.sourceforge.net/svnroot/emesene/trunk/emesene

Updates

To update your svn copy to the latest version, type svn up

If it shows a file list, you may want to know about the changes: svn log | less shows the latest log entries

Downgrades

You are having problems with certain revision, and can't use emesene. Or you want to find who wrote the buggy code. Downgrade to a previous version 

svn up -r ###

where ### is a previous revision number. So, if you just upgraded to rev. 1300, and you want to downgrade to rev. 1299, type svn up -r 1299

For example, if you want to try the first svn version, try svn up -r 1 (but this shouldn't work in most copies)