diff --git a/doc/xdocs/building.html b/doc/xdocs/building.html index c177f5d626..3b21911b01 100644 --- a/doc/xdocs/building.html +++ b/doc/xdocs/building.html @@ -32,7 +32,7 @@

This project uses Maven as project manager and build tool. We recommend you to install Maven 1.0.2 or greater before trying the following. Note there are workarounds at the bottom of this page.

-

To checkout Acegi Security from CVS, execute the following command on a +

To ancheckout Acegi Security from CVS, execute the following command on a single line:

    maven scm:checkout-project
    @@ -77,15 +77,17 @@
     	If you'd like a local copy, simply execute:
       
      cd $ACEGI_SECURITY/doc
      +
      maven -Dpassword= changelog:create-cvspass
      maven    multiproject:clean multiproject:site
       	-Dmaven.jar.override=on 
       	-Dmaven.jar.clover-ant=1.3.3_01 
      -	-Dmaven.scm.cvs.root=:pserver:anonymous@cvs.sourceforge.net:/cvsroot/acegisecurity
       
    -

    If you're an Acegi Security developer, you can omit the - maven.scm.cvs.root property, as your SourceForge login will be used - along with CVS-over-SSH (see workaround discussion below if you have problems).

    +

    As per the + Maven Changelog Plugin Documentation, + you must tell the plugin the "anonymous CVS pserver" password is blank. This is + why there is the "create-cvspass" command shown above. You should only need to + do this once.

    Memory and Clover Workarounds

    If you get an OutOfMemoryError, simply execute the following before @@ -109,24 +111,24 @@

    Another possible problem is related to CVS-over-SSH ("ext" in CVSROOT) appearing to freeze. The following instructions assume you're an Acegi Security developer who has CVS access - to the project, as if you're not then you shouldn't be trying to use CVS-over-SSH - (the instructions above detail how to execute the "site" and "checkout" commands - anonymously via "pserver").

    + to the project, as if you're not then you shouldn't be trying to use CVS-over-SSH. + The instructions above all relate to goals which use the default, anonymous + pserver CVS repository.

    -

    First check your +

    If you really need authenticated SSH-based access, first check your $ACEGI_SECURITY/build.properties contains a maven.username equal to your SourceForge username. If your Maven CVS - commands still don't work, test you have automatic CVS-over-SSH access operational + or SSH commands still don't work, test you have automatic CVS-over-SSH access operational by executing the following command:

      cvs -d :ext:YOUR_SOURCEFORGE_USERNAME@cvs.sourceforge.net:/cvsroot/acegisecurity
    -

    If this CVS command doesn't work (without requiring any interaction such as password - entry), you probably need to review your CVS setup. - This will vary depending on your CVS client.

    +

    If this CVS command executes without requiring any interaction such as password + entry, you're ready to proceed. If it fails (or requires a password entry), you + probably need to review your CVS setup. This varies depending on your CVS client.

    -

    One Windows-based command line CVS-over-SSH-with-auto-login combination that +

    One Windows-based command line CVS-over-SSH-with-auto-login setup that works very well is to install CVSNT (which has a CVS client console utility) and @@ -139,17 +141,14 @@ One issue with the SourceForge instructions is they forget to mention how to tell the CVS command-line client to use plink.exe, which is PuTTY's SSH command-line version. The solution is to execute - set CVS_RSH=C:\Program Files\putty\plinkk.exe + set CVS_RSH=C:\Program Files\putty\plink.exe (or whatever path is appropriate to plink) before running the CVS command line. In fairness, the SourceForge instructions target the Windows front-end to CVS, whilst we need the command-line version to work.

    -

    If your CVS is working, try the maven-changelog-plugin on its - own by executing the following command:

    -
      -
      cd $ACEGI_SECURITY/
      -
      maven maven-changelog-plugin:report
      -
    +

    It is worth noting that as the Maven project uses the anonymous pserver + repository for most operations, these setup instructions really only apply if + doing something like deploying the site over SSH etc.

    diff --git a/project.xml b/project.xml index 9496499dbe..f2a6f725e0 100644 --- a/project.xml +++ b/project.xml @@ -21,7 +21,7 @@ 3 acegisecurity - 0.7-SNAPSHOT + 0.7.0-SNAPSHOT net.sf.acegisecurity Acegi Security System for Spring Acegi Security System for Spring @@ -38,6 +38,7 @@ shell.sourceforge.net /home/groups/a/ac/acegisecurity/htdocs/maven + scm:cvs:pserver:anonymous@cvs.sourceforge.net:/cvsroot/acegisecurity:acegisecurity scm:cvs:ext:${maven.username}@cvs.sourceforge.net:/cvsroot/acegisecurity:acegisecurity http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/acegisecurity/acegisecurity/