                                -----------------------
                                Building Acegi Security
                                -----------------------


Building Acegi Security System

* Checking Out from Subversion (SVN)

    This project uses <a href="http://maven.apache.org">Maven</a> as project manager
	and build tool.	We recommend you to install Maven 2.0.4 or greater before trying
	the following.

    To checkout Acegi Security from SVN, see our {{{svn-usage.html}SVN Usage}} page.

* Quick Build

    Often people reading this document just want to see if Acegi Security will work
	for their projects. They want to deploy a sample application, and that's about it
	(after all, all the reference documentation can be read online at
	{{{http://acegisecurity.org}http://acegisecurity.org}}).
	In this case, execute:
	TODO: Update to use tutorial app and maven 2

+----------------------------------------------------------------------------------------------------------------------+
	cd $ACEGI_SECURITY/core (or cd %ACEGI_SECURITY%/core on Windows)
	mvn install
	cd $ACEGI_SECURITY/samples/contacts
	maven multiwar:multiwar
	copy $ACEGI_SECURITY/samples/contacts/target/acegi-security-sample-contacts-filter.war $YOUR_CONTAINER/webapps
+----------------------------------------------------------------------------------------------------------------------+

    Then load up your web container and visit
	{{{http://localhost:8080/acegi-security-sample-contacts-filter/}http://localhost:8080/acegi-security-sample-contacts-filter/}}
	(or whatever location is appropriate for your web container).

* Building All JARs

    Sometimes people are already using Acegi Security, and they just want to build the
	latest code from CVS. To build all artifacts (JARs) and install them into
	your local Maven repository, simply perform a SVN checkout, and then execute:

+----------------------------------------------------------------------------------------------------------------------+
	cd $ACEGI_SECURITY
	mvn install
+----------------------------------------------------------------------------------------------------------------------+

    You can then check your <<<$HOME/.m2/repository/org/acegisecurity>>>
	directory and it should contain all of the latest Acegi Security JARs.

* Building The Site

    By "site" we mean the web site you can browse at
	{{{http://acegisecurity.org}http://acegisecurity.org}},
	which includes the reference documentation and all of the Maven reports.
	If you'd like a local copy, simply execute:

+----------------------------------------------------------------------------------------------------------------------+
	cd $ACEGI_SECURITY
	mvn clean site
+----------------------------------------------------------------------------------------------------------------------+
