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 2015/11/03 21:25:05 UTC

isis-site git commit: ISIS-1195: migration notes

Repository: isis-site
Updated Branches:
  refs/heads/asf-site fbd6a8d3f -> c96edd2da


ISIS-1195: migration notes


Project: http://git-wip-us.apache.org/repos/asf/isis-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis-site/commit/c96edd2d
Tree: http://git-wip-us.apache.org/repos/asf/isis-site/tree/c96edd2d
Diff: http://git-wip-us.apache.org/repos/asf/isis-site/diff/c96edd2d

Branch: refs/heads/asf-site
Commit: c96edd2da3942983e514c506af25ab359404cb7b
Parents: fbd6a8d
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Tue Nov 3 20:19:10 2015 +0000
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Tue Nov 3 20:19:10 2015 +0000

----------------------------------------------------------------------
 content/guides/cg.html       | 40 ++++++++++++---------------------------
 content/migration-notes.html | 31 +++++++++++++++++++++++++++++-
 2 files changed, 42 insertions(+), 29 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/isis-site/blob/c96edd2d/content/guides/cg.html
----------------------------------------------------------------------
diff --git a/content/guides/cg.html b/content/guides/cg.html
index 6971768..13b91d7 100644
--- a/content/guides/cg.html
+++ b/content/guides/cg.html
@@ -5055,51 +5055,32 @@ It is also possible to configure to use <code>.ssh</code> secure keys, and there
 </div>
 </div>
 <div class="paragraph">
-<p>Next, check that the releasable module builds independently. The build process depends on whether the artifact is of Apache Isis core or of one of its components:</p>
+<p>Next, check that the framework builds ok:</p>
 </div>
-<div class="ulist">
-<ul>
-<li>
-<p>For Apache Isis core, build using the <code>-o</code> offline flag:<br></p>
-<div class="listingblock">
-<div class="content">
-<pre class="CodeRay highlight"><code data-lang="bash">mvn clean install -o</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Confirm that the versions of the Isis artifacts now cached in your local repository are correct.</p>
-</div>
-</li>
-<li>
-<p>For an Apache Isis component, build without the offline flag; Maven should pull down the component&#8217;s dependencies from the Maven central repo:<br></p>
 <div class="listingblock">
 <div class="content">
-<pre class="CodeRay highlight"><code data-lang="bash">mvn clean install</code></pre>
+<pre class="CodeRay highlight"><code data-lang="bash">cd core
+mvn clean install -o</code></pre>
 </div>
 </div>
 <div class="paragraph">
 <p>Confirm that the versions of the Isis artifacts now cached in your local repository are correct (both those pulled down from Maven central repo, as well as those of the component built locally).</p>
 </div>
-</li>
-</ul>
-</div>
 </div>
 <div class="sect3">
-<h4 id="_deploy_all_modules">10.6.3. Deploy All Modules</h4>
+<h4 id="_deploy">10.6.3. Deploy</h4>
 <div class="paragraph">
-<p>Deploy all modules using:</p>
+<p>Deploy the framework using:</p>
 </div>
 <div class="listingblock">
 <div class="content">
-<pre class="CodeRay highlight"><code data-lang="bsah">mvn -D deploy=snapshot deploy</code></pre>
+<pre class="CodeRay highlight"><code data-lang="bsah">cd core
+mvn -D deploy=snapshot deploy</code></pre>
 </div>
 </div>
 <div class="paragraph">
 <p>This will deploy all the modules that make up a release.</p>
 </div>
-<div class="paragraph">
-<p>To confirm that they are present, browse to Apache&#8217;s <a href="https://repository.apache.org">Nexus repository manager</a> and search for "isis".</p>
-</div>
 <div class="admonitionblock tip">
 <table>
 <tr>
@@ -5108,12 +5089,15 @@ It is also possible to configure to use <code>.ssh</code> secure keys, and there
 </td>
 <td class="content">
 <div class="paragraph">
-<p>Depending on the module being released, the deploy process could take a long time. Go grab a bite of lunch.</p>
+<p>Expect this to take about 10 minutes, give or take.</p>
 </div>
 </td>
 </tr>
 </table>
 </div>
+<div class="paragraph">
+<p>To confirm that they are present, browse to Apache&#8217;s <a href="https://repository.apache.org">Nexus repository manager</a> and search for "isis".</p>
+</div>
 </div>
 </div>
 <div class="sect2">
@@ -7874,7 +7858,7 @@ xxx<br>
 <ul class="sectlevel3">
 <li><a href="#_prerequisites_3">10.6.1. Prerequisites</a></li>
 <li><a href="#_sanity_check">10.6.2. Sanity Check</a></li>
-<li><a href="#_deploy_all_modules">10.6.3. Deploy All Modules</a></li>
+<li><a href="#_deploy">10.6.3. Deploy</a></li>
 </ul>
 </li>
 <li><a href="#_cg_committers_key-generation">10.7. Key Generation</a>

http://git-wip-us.apache.org/repos/asf/isis-site/blob/c96edd2d/content/migration-notes.html
----------------------------------------------------------------------
diff --git a/content/migration-notes.html b/content/migration-notes.html
index cd77d23..6f64eae 100644
--- a/content/migration-notes.html
+++ b/content/migration-notes.html
@@ -491,11 +491,39 @@ table.CodeRay td.code>pre{padding:0}
 <h2 id="_release-notes_migration-notes_1.9.0-to-1.10.0">From v1.9.0 to 1.10.0</h2>
 <div class="sectionbody">
 <div class="paragraph">
-<p>Existing projects written against v1.9.0 should run against v1.10.0 with few if any changes.  If you <strong>do</strong> encounter
+<p>Existing projects written against v1.9.0 should run against v1.10.0 with only a few minor changes.  If you <strong>do</strong> encounter
 any difficulties then let us know via the <a href="support.html">users mailing list</a>, so we can support you and document
 issues here.</p>
 </div>
 <div class="sect2">
+<h3 id="_remove_references_to_code_isis_viewer_wicket_code_parent_pom">Remove references to <code>isis-viewer-wicket</code> parent pom.</h3>
+<div class="paragraph">
+<p>In earlier releases the Wicket viewer defined its own parent <code>pom.xml</code> for dependency management and its dependencies
+and to declare the various submodules that make up the viewer.  This <code>pom.xml</code> has now been incorporated into the
+parent <code>pom.xml</code> for the Core framework.</p>
+</div>
+<div class="paragraph">
+<p>Therefore, in the parent <code>pom.xml</code> of your own domain applications, remove:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="xml"><span class="tag">&lt;dependencyManagement&gt;</span>
+    <span class="tag">&lt;dependencies&gt;</span>
+        ...
+        <span class="tag">&lt;dependency&gt;</span>
+            <span class="tag">&lt;groupId&gt;</span>org.apache.isis.viewer<span class="tag">&lt;/groupId&gt;</span>
+            <span class="tag">&lt;artifactId&gt;</span>isis-viewer-wicket<span class="tag">&lt;/artifactId&gt;</span>
+            <span class="tag">&lt;version&gt;</span>${isis.version}<span class="tag">&lt;/version&gt;</span>
+            <span class="tag">&lt;type&gt;</span>pom<span class="tag">&lt;/type&gt;</span>
+            <span class="tag">&lt;scope&gt;</span>import<span class="tag">&lt;/scope&gt;</span>
+        <span class="tag">&lt;/dependency&gt;</span>
+        ...
+    <span class="tag">&lt;/dependencies&gt;</span>
+<span class="tag">&lt;/dependencyManagement&gt;</span></code></pre>
+</div>
+</div>
+</div>
+<div class="sect2">
 <h3 id="__code_allowlateregistration_code"><code>allowLateRegistration</code></h3>
 <div class="paragraph">
 <p>One possible issue is that (as per <a href="https://issues.apache.org/jira/browse/ISIS-830">ISIS-830</a>) the <a href="rg.html#_rg_services-api_manpage-EventBusService"><code>EventBusService</code></a> is now initialized as one of the first domain
@@ -1772,6 +1800,7 @@ into the new <code>org.isisaddons.module.settings:isis-module-settings-dom</code
                 <ul class="sectlevel1">
 <li><a href="#_release-notes_migration-notes_1.9.0-to-1.10.0">From v1.9.0 to 1.10.0</a>
 <ul class="sectlevel2">
+<li><a href="#_remove_references_to_code_isis_viewer_wicket_code_parent_pom">Remove references to <code>isis-viewer-wicket</code> parent pom.</a></li>
 <li><a href="#__code_allowlateregistration_code"><code>allowLateRegistration</code></a></li>
 </ul>
 </li>