svn commit: r839828 - in /websites/staging/isis/trunk: cgi-bin/ content/ content/contributors/release-process-rat-exclusions.html content/contributors/release-process.html

[bu...@apache.org]

Author: buildbot
Date: Wed Nov 28 00:13:13 2012
New Revision: 839828

Log:
Staging update by buildbot for isis

Modified:
    websites/staging/isis/trunk/cgi-bin/   (props changed)
    websites/staging/isis/trunk/content/   (props changed)
    websites/staging/isis/trunk/content/contributors/release-process-rat-exclusions.html
    websites/staging/isis/trunk/content/contributors/release-process.html

Propchange: websites/staging/isis/trunk/cgi-bin/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Nov 28 00:13:13 2012
@@ -1 +1 @@
-1414466
+1414477

Propchange: websites/staging/isis/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Nov 28 00:13:13 2012
@@ -1 +1 @@
-1414466
+1414477

Modified: websites/staging/isis/trunk/content/contributors/release-process-rat-exclusions.html
==============================================================================
--- websites/staging/isis/trunk/content/contributors/release-process-rat-exclusions.html (original)
+++ websites/staging/isis/trunk/content/contributors/release-process-rat-exclusions.html Wed Nov 28 00:13:13 2012
@@ -206,9 +206,11 @@
 <tr><td>&nbsp;</td><td>**/*.pdn</td><td>Paint.NET format</td></tr>
 <tr><td>Data files</td><td>**/*.json</td><td>JSON (test) data</td></tr>
 <tr><td>&nbsp;</td><td>**/isis.log</td><td>Isis' log file (byproduct of tests)</td></tr>
+<tr><td>&nbsp;</td><td>**/datanucleus.log</td><td>DataNucleus' log file (byproduct of bytecode enhancement during compilation)</td></tr>
 <tr><td>&nbsp;</td><td>**/rat.txt</td><td>RAT's own audit file</td></tr>
 <tr><td>&nbsp;</td><td>**/fixture-data</td><td>SQL Object Store fixture data</td></tr>
 <tr><td>&nbsp;</td><td>**/test.data</td><td>SQL Object Store fixture data</td></tr>
+<tr><td>&nbsp;</td><td>**/hsql-db/**</td><td>SQL Object Store test database</td></tr>
 <tr><td>&nbsp;</td><td>**/xml/**/*.xml</td><td>XML Object Store fixture data</td></tr>
 <tr><td>&nbsp;</td><td>tmp/tests/*.xml</td><td>XML Object Store fixture data</td></tr>
 <tr><td>&nbsp;</td><td>tmp/ldap-conf/**</td><td>LDAP Security fixture data</td></tr>

Modified: websites/staging/isis/trunk/content/contributors/release-process.html
==============================================================================
--- websites/staging/isis/trunk/content/contributors/release-process.html (original)
+++ websites/staging/isis/trunk/content/contributors/release-process.html Wed Nov 28 00:13:13 2012
@@ -301,20 +301,23 @@ The move to git will need to reproduce t
 <p>To run the RAT tool, first clean up any generated artifacts:</p>
 
 <pre>
-mvn clean -P integration-tests
+mvn clean          # clean up target directory
+mvn clean -P m2e   # clean up target-ide directory
 </pre>
 
 <p>Then, run the tool using:</p>
 
 <pre>
-mvn org.apache.rat:apache-rat-plugin:check
+mvn org.apache.rat:apache-rat-plugin:check -D rat.num=50
 </pre>
 
+<p>where <code>rat.num</code> property is set to a high figure, temporarily overriding the default value of 0.  (If this isn't overridden and there are licenses, then the command will simply fail).</p>
+
 <p><div class="note">
 Do <em>not</em> use <code>mvn rat:check</code>; depending on your local Maven configuratoin this may bring down the obsolete mvn-rat-plugin from Codehaus repo.
 </div></p>
 
-<p>All being well the command should succeed.  If it does not, then review the <code>rat.txt</code> file in the failing module's <code>target</code> directory.  Missing license notes are indicated using the key:</p>
+<p>All being well the command should succeed.  If it does not, then review the <code>rat.txt</code> files in the failing module's <code>target</code> directory.  Missing license notes are indicated using the key:</p>
 
 <ul>
 <li><code>!???</code> identifies those files that are missing license notes</li>
@@ -322,14 +325,28 @@ Do <em>not</em> use <code>mvn rat:check<
 <li><code>hsql-db</code> are generated HSQLDB directories</li>
 </ul>
 
+<p>You can collate these together using something like:</p>
+
+<pre>
+for a in `find . -name rat.txt -print`; do grep -H '!???' $a; done
+</pre>
+
 <p>Investigate and fix any reported violations.</p>
 
-<p>You can use the groovy script <code>addmissinglicenses.groovy</code> to automatically insert missing headers:</p>
+<p>You can use the groovy script <code>addmissinglicenses.groovy</code> to automatically insert missing headers</p>
+
+<p>Dry run:</p>
 
 <pre>
 groovy addmissinglicenses.groovy
 </pre>
 
+<p>or actually execute:</p>
+
+<pre>
+groovy addmissinglicenses.groovy -x
+</pre>
+
 <p>The actual files checked are those with extensions specified in the line:</p>
 
 <pre>