The JBossRemoting source code resides in the JBoss CVS repository under the CVS module JBossRemoting. To check out the source using the anonymous account, use the following command:
cvs -d:pserver:email@example.com:/cvsroot/jboss checkout JBossRemoting
To check out the source using a committer user id, use the following:
cvs -d:ext:firstname.lastname@example.org:/cvsroot/jboss checkout JBossRemoting
This should checkout the entire remoting project, including doc, tests, libs, etc.
See http://www.jboss.org/wiki/Wiki.jsp?page=CVSRepository for more information on how to access the JBoss CVS repository.
The build process for JBossRemoting is based on a standard ant build file (build.xml). The version of ant that is supported is ant 1.6.2, but should work with earlier versions as there are no special ant features being used.
The main ant build targets are as follows:
compile - compiles all the core JBossRemoting classes.
jars - creates the jboss-remoting.jar file from the compiled classes
dist.jars - creates the subsystem jar files (jboss-remoting-core.jar, jboss-remoting-socket.jar, etc.) from the compiled classes
javadoc - creates the javadoc html files for JBossRemoting
tests.compile - compiles the JBossRemoting test files
tests.jars - creates the jboss-remoting-tests.jar and jboss-remoting-loading-tests.jar files.
tests.quick - runs the functional unit tests for JBossRemoting.
tests - runs all the tests for JBossRemoting, including functional and performance tests for all the different transports.
clean - removes all the build artifacts and directories.
most - calls clean then jars targets.
dist - builds the full JBossRemoting distribution including running the full test suite.
dist.quick - builds the full JBossRemoting distribution, but does not run the test suite.
The root directory for all build output is the output directory. Under this directory will be:
classes - compiled core classes
etc - deployment and JMX XMBean xml files
lib - all the jars and war file produced by the build
tests - contains the compiled test classes and test results
For most development, the most target can be used. Please run the tests.quick target before checking anything in to ensure that code changes did not break any previously functioning test.