Anonymous pserver CVS setup.

doc/xdocs/building.html

@@ -32,7 +32,7 @@
   <p>This project uses <a href="http://maven.apache.org">Maven</a> as project manager
 	and build tool.	We recommend you to install Maven 1.0.2 or greater before trying
 	the following. <b>Note there are workarounds at the bottom of this page.</b></p>
-  <p>To checkout Acegi Security from CVS, execute the following command on a
+  <p>To ancheckout Acegi Security from CVS, execute the following command on a
 	single line:</p>
   <ol>
     <pre>maven scm:checkout-project
@@ -77,15 +77,17 @@
 	If you'd like a local copy, simply execute:
   <ol>
 	<pre>cd $ACEGI_SECURITY/doc</pre>
+	<pre>maven -Dpassword= changelog:create-cvspass</pre>
 	<pre>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
 </pre>
   </ol>
-  <p>If you're an Acegi Security developer, you can omit the
+  <p>As per the
-	<code>maven.scm.cvs.root</code> property, as your SourceForge login will be used
+	<a href="http://maven.apache.org/reference/plugins/changelog/">Maven Changelog Plugin Documentation</a>,
-	along with CVS-over-SSH (see workaround discussion below if you have problems).</p>
+	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.</p>
 
   <h2>Memory and Clover Workarounds</h2>
   <p>If you get an <code>OutOfMemoryError</code>, simply execute the following before
@@ -109,24 +111,24 @@
 
   <p>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
+	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
+	The instructions above all relate to goals which use the default, anonymous
-	anonymously via "pserver").</p>
+	pserver CVS repository.</p>
 	
-  <p>First check your
+  <p>If you really need authenticated SSH-based access, first check your
 	<code>$ACEGI_SECURITY/build.properties</code> contains a
 	<code>maven.username</code> 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:</p>
   <ol>
 	<pre>cvs -d :ext:YOUR_SOURCEFORGE_USERNAME@cvs.sourceforge.net:/cvsroot/acegisecurity</pre>
   </ol>
   
-  <p>If this CVS command doesn't work (without requiring any interaction such as password
+  <p>If this CVS command executes without requiring any interaction such as password
-	entry), you probably need to review your CVS setup.
+	entry, you're ready to proceed. If it fails (or requires a password entry), you 
-	This will vary depending on your CVS client.</p>
+	probably need to review your CVS setup. This varies depending on your CVS client.</p>
 	
-  <p>One Windows-based command line CVS-over-SSH-with-auto-login combination that 
+  <p>One Windows-based command line CVS-over-SSH-with-auto-login setup that 
 	works very well is to install 
 	<a href="http://www.cvsnt.com/">CVSNT</a> (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 <code>plink.exe</code>, which is PuTTY's SSH command-line
 	version. The solution is to execute 
-	<code>set CVS_RSH=C:\Program Files\putty\plinkk.exe</code>
+	<code>set CVS_RSH=C:\Program Files\putty\plink.exe</code>
 	(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.</p>
 	
-  <p>If your CVS is working, try the <code>maven-changelog-plugin</code> on its
+  <p>It is worth noting that as the Maven project uses the anonymous pserver
-	own by executing the following command:</p>
+	repository for most operations, these setup instructions really only apply if
-  <ol>
+	doing something like deploying the site over SSH etc.</p>
-	<pre>cd $ACEGI_SECURITY/</pre>
-	<pre>maven maven-changelog-plugin:report</pre>
-  </ol>
 	
 </body>
 </html>

project.xml

@@ -21,7 +21,7 @@
 <project>
   <pomVersion>3</pomVersion>
   <groupId>acegisecurity</groupId>
-  <currentVersion>0.7-SNAPSHOT</currentVersion>
+  <currentVersion>0.7.0-SNAPSHOT</currentVersion>
   <package>net.sf.acegisecurity</package>
   <description>Acegi Security System for Spring</description>
   <shortDescription>Acegi Security System for Spring</shortDescription>
@@ -38,6 +38,7 @@
   <distributionSite>shell.sourceforge.net</distributionSite>
   <distributionDirectory>/home/groups/a/ac/acegisecurity/htdocs/maven</distributionDirectory>
   <repository>
+    <connection>scm:cvs:pserver:anonymous@cvs.sourceforge.net:/cvsroot/acegisecurity:acegisecurity</connection>
     <developerConnection>scm:cvs:ext:${maven.username}@cvs.sourceforge.net:/cvsroot/acegisecurity:acegisecurity</developerConnection>
     <url>http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/acegisecurity/acegisecurity/</url>
   </repository>