You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2011/06/11 14:33:29 UTC

svn commit: r1134595 - /incubator/isis/trunk/src/docbkx/guide/isis-contributors-guide.xml

Author: danhaywood
Date: Sat Jun 11 12:33:29 2011
New Revision: 1134595

URL: http://svn.apache.org/viewvc?rev=1134595&view=rev
Log:
minor updates to the contributors guide

Modified:
    incubator/isis/trunk/src/docbkx/guide/isis-contributors-guide.xml

Modified: incubator/isis/trunk/src/docbkx/guide/isis-contributors-guide.xml
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/src/docbkx/guide/isis-contributors-guide.xml?rev=1134595&r1=1134594&r2=1134595&view=diff
==============================================================================
--- incubator/isis/trunk/src/docbkx/guide/isis-contributors-guide.xml (original)
+++ incubator/isis/trunk/src/docbkx/guide/isis-contributors-guide.xml Sat Jun 11 12:33:29 2011
@@ -3680,9 +3680,9 @@ public class FooBar {
           exclusions, making this method of performing a check somewhat
           useless.</para>
 
-          <para>Instead, the tool can be run from the command-line; a JAR
-          binary of the tool has been checked into the <emphasis>Apache
-          Isis</emphasis> codebase.</para>
+          <para>Instead, the tool can be run from the command-line (though
+          you'll need to build the binary <acronym>JAR</acronym> of the tool
+          yourself).</para>
 
           <para>First, clean up any generated artifacts:</para>
 
@@ -3956,12 +3956,11 @@ licenses to remove from supplemental-mod
         <sect2 id="sec.ReleaseBranch">
           <title>Branch</title>
 
-          <para>First, create a branch and its own tags directory:</para>
+          <para>First, create a branch in the <acronym>SVN</acronym>
+          repo:</para>
 
           <programlisting>svn mkdir https://svn.apache.org/repos/asf/incubator/isis/branches/x.x.x[-RCn]-incubating \
    -m "branching to create x.x.x[-RCn]-incubating"
-svn mkdir https://svn.apache.org/repos/asf/incubator/isis/branches/x.x.x[-RCn]-incubating/tags \
-   -m "creating tags for x.x.x[-RCn]-incubating"
 svn copy https://svn.apache.org/repos/asf/incubator/isis/trunk \
     https://svn.apache.org/repos/asf/incubator/isis/branches/x.x.x[-RCn]-incubating/trunk \
     -m "copying trunk to branches/x.x.x[-RCn]-incubating"</programlisting>
@@ -4247,6 +4246,27 @@ svn: No such revision 1126567</programli
 
           <itemizedlist>
             <listitem>
+              <para>unzip the source-release <acronym>ZIP</acronym> and check
+              it compiles</para>
+
+              <para>The <acronym>ZIP</acronym> file resides in
+              <filename>isis-0.x.x[-RCn]-incubating-incubating-source-release.zip</filename>
+              in <filename>target</filename> directory of the parent
+              <package>[oai:isis]</package> module. Unzip in a new directory,
+              and build using <code>mvn clean install</code> (and <code>mvn
+              site-deploy -D deploy=local</code> if you have the time).</para>
+            </listitem>
+
+            <listitem>
+              <para>Inspect the <filename>DEPENDENCIES</filename> file.</para>
+
+              <para>This should be in the root of the extracted ZIP. In
+              particular, check that there are no <ulink
+              url="www.apache.org/legal/resolved.html#category-x">category-x</ulink>
+              dependencies.</para>
+            </listitem>
+
+            <listitem>
               <para>Use the locally built quickstart archetype to generate the
               application, and make sure that the generated application runs
               ok.</para>
@@ -4264,18 +4284,6 @@ svn: No such revision 1126567</programli
               without a <literal>-SNAPSHOT</literal> suffix), and runs as
               expected.</para>
             </listitem>
-
-            <listitem>
-              <para>unzip the source-release <acronym>ZIP</acronym> and check
-              it compiles</para>
-
-              <para>The <acronym>ZIP</acronym> file resides in
-              <filename>isis-0.x.x[-RCn]-incubating-incubating-source-release.zip</filename>
-              in <filename>target</filename> directory of the parent
-              <package>[oai:isis]</package> module. Unzip in a new directory,
-              and build using <code>mvn clean install</code> (and <code>mvn
-              site-deploy -D deploy=local</code> if you have the time).</para>
-            </listitem>
           </itemizedlist>
 
           <para>If you find problems and the release was performed on a branch