SVN checkout

The XP framework's sourcecode is maintained in a subversion (SVN) repository.

Anonymous

Anyone can check out the sourcecode! To check out the XP framework's sources into a directory named xp in the current working directory, use the following command:

  $ mkdir ~/devel
  $ cd ~/devel
  $ svn co svn://xpsrv.net/xp/trunk xp

This will not require credentials but will also be a read-only checkout.

Developer

If you have a developer account and would like to be able to commit to the XP framework's sources, you need to use the following command:

  $ mkdir ~/devel
  $ cd ~/devel
  $ svn co svn+ssh://{USER}@xpsrv.net/home/svn/xp/trunk xp

Runners

If you don't already have them by having installed an XP release, go get them:

Typical installation

To install a the runners in your own home directory, open a shell window and type the following:

  $ cd ~/bin  
  $ wget 'http://xp-framework.net/downloads/releases/bin/setup' -O - | php

If the directory ~/bin is not in $PATH, you can add it by editing your ~/.profile and adding a line export PATH=${HOME}/bin:${PATH}.

Use the --source

To use the development version instead of a release, change the use_xp setting in your xp.ini file (it will be located in the ~/bin directory if you followed the instructions from above):

  $ echo "use=~/devel/xp" > ~/bin/xp.ini

Switching

To quickly switch between release and development version, you can employ the USE_XP environment variable:

  $ xp -v
  XP 5.7.2-dev { PHP 5.2.8 & ZE 2.2.0 } @ Windows NT CARLA 6.0 build 6001
  Copyright (c) 2001-2009 the XP group
  [...]

  $ USE_XP=~/xp/5.7.1 xp -v
  XP 5.7.1 { PHP 5.2.8 & ZE 2.2.0 } @ Windows NT CARLA 6.0 build 6001
  Copyright (c) 2001-2009 the XP group
  [...]

The development version will always contain the suffix "-dev".