@header@
Developer Notes

Getting the source
Pebble is an open source project and the source code is freely available from the SourceForge CVS servers. You can get a copy of the current CVS HEAD by using the following CVS commands. When prompted for a password, just press enter (there is no password).
  cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/pebble login
  cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/pebble checkout pebble
To checkout a particular version of the codebase, simply use the -r <tag> as follows.
  cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/pebble checkout -r v1_6_0 pebble
All versions of Pebble since 1.0 have been tagged using a tag such as v1_6_0 or v1_6_1.

Building
To build Pebble, open up the setEnv.bat (Windows) or setEnv.sh (UNIX, Linux or Mac OS X) script and alter the JAVA_HOME and ANT_HOME environment variables as appropriate for your environment. The following versions of software are recommended for building Pebble.
  • JDK 1.4 or above
  • Apache Ant 1.5 or above
After running the setEnv script, to compile Pebble, simply type ant at the command line. If you wish to develop against Pebble weblog, simply point your web/application server at the pebble-web directory. During the build, code within the pebble-core/src directory is compiled and copied into the web application.

Other useful build targets are test (runs all JUnit tests within pebble-core) and dist (produces a binary distribution).

@footer@