[commons-rng] branch master updated: Added notes about requirements for the recursive site checkout.

[aherbert]

This is an automated email from the ASF dual-hosted git repository.

aherbert pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-rng.git


The following commit(s) were added to refs/heads/master by this push:
     new 9b9534b  Added notes about requirements for the recursive site 
checkout.
9b9534b is described below

commit 9b9534b363841dff7ed94c25a3a10952cf44d67d
Author: aherbert <aherb...@apache.org>
AuthorDate: Tue Nov 12 14:22:25 2019 +0000

    Added notes about requirements for the recursive site checkout.
    
    The Maven reactor activates all profiles at start-up. Thus if the parent
    is missing the site-content directory all the child modules will also be
    configured to check out a copy using svn.
    
    The parent must have a checkout performed first:
    
    mvn -N pre-site && mavn pre-site
---
 pom.xml | 20 +++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)

diff --git a/pom.xml b/pom.xml
index 0f16bf4..4365fca 100644
--- a/pom.xml
+++ b/pom.xml
@@ -401,11 +401,25 @@
       </build>
     </profile>
     <profile>
-      <!-- Sets a property if the SVN site checkout can copy from the parent 
directory. -->
+      <!--
+        Sets a property if the SVN site checkout can copy from the parent 
directory.
+
+        Note: The Maven reactor configures all the profiles for the child 
modules at start-up.
+        Thus the parent must have the site-content folder created first for 
the copy to work:
+
+        # Optional: Remove the site-content directories
+        mvn clean -Pclean-checkout
+
+        # Checkout the parent site-content directory
+        mvn -N pre-site
+
+        # Copy the site-content for all child modules
+        mvn pre-site
+      -->
       <id>can-copy-checkout</id>
       <activation>
         <file>
-          <exists>../${commons.scmPubCheckoutDirectory}</exists>
+          <exists>${basedir}/../${commons.scmPubCheckoutDirectory}</exists>
         </file>
       </activation>
       <properties>
@@ -437,7 +451,7 @@
                 <configuration>
                   <!-- For multi-module builds, copy the checkout from the 
parent. -->
                   <target name="copy-parent-checkout" 
if="${copy.parent.scmPubCheckoutDirectory}">
-                    <copy todir="${commons.scmPubCheckoutDirectory}" 
verbose="true">
+                    <copy todir="${commons.scmPubCheckoutDirectory}">
                       <fileset dir="../${commons.scmPubCheckoutDirectory}" 
includes="**" defaultexcludes="no" />
                     </copy>
                   </target>