README.txt

README.txt

This file exists at the top-level of the Roller source tree.

Roller is made up of the following Maven projects:

  roller-project:         Top level project
  app:                    Roller Weblogger webapp, JSP pages, Velocity templates
  assembly-release:       Used to create official distributions of Roller
  docs:                   Roller documentation in ODT (OpenOffice/LibreOffice) format
  it-selenium             Integrated browser tests for Roller using Selenium

To pull the latest trunk sources you need a Subversion client:
  svn co https://svn.apache.org/repos/asf/roller/trunk roller_trunk

Building this version of Roller requires Apache Maven 3.0.5.
  - How to build Roller: https://cwiki.apache.org/confluence/x/EM4
  - To build and run Roller on Eclipse: https://cwiki.apache.org/confluence/x/EM4

----------------------------------------------------------
How to build the source

The normal Roller build creates a product generically suitable for use several
application containers, however see the Roller Install guide for application server
specific configuration information.

After pulling the source tree and changing directory to its top level, as
indicated above, the following command will build and run all unit tests:

   mvn clean install

After doing that, you should find the newly built Roller webapp, suitable
for use in app/target/roller. 

To build Roller, subsequently run "mvn clean install" from the assembly-release
folder.  After that, you'll find Roller distribution files in 
assembly-release/target. 

---------------------------
NOTES

Building other versions of Roller

If you wish to pull a branch other than the trunk, replace the word
"trunk" in both lines above with the appropriate branch name.  Note that
versions of Roller before 5.0 have an Ant-based build.  In general, you should
be able to follow instructions accompanying the sources that you pull in order
to build that version.