sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r1050301 - in /websites/staging/sis/trunk/content: ./ command-line.html examples/crs/WrongAxisOrder.wkt gdal.html index.html release-management.html release-notes/1.0.html
Date Thu, 19 Sep 2019 16:20:11 GMT
Author: buildbot
Date: Thu Sep 19 16:20:10 2019
New Revision: 1050301

Log:
Staging update by buildbot for sis

Modified:
    websites/staging/sis/trunk/content/   (props changed)
    websites/staging/sis/trunk/content/command-line.html
    websites/staging/sis/trunk/content/examples/crs/WrongAxisOrder.wkt
    websites/staging/sis/trunk/content/gdal.html
    websites/staging/sis/trunk/content/index.html
    websites/staging/sis/trunk/content/release-management.html
    websites/staging/sis/trunk/content/release-notes/1.0.html

Propchange: websites/staging/sis/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Sep 19 16:20:10 2019
@@ -1 +1 @@
-1867142
+1867188

Modified: websites/staging/sis/trunk/content/command-line.html
==============================================================================
--- websites/staging/sis/trunk/content/command-line.html (original)
+++ websites/staging/sis/trunk/content/command-line.html Thu Sep 19 16:20:10 2019
@@ -144,20 +144,13 @@ Example:</p>
 If not, the same examples can still be executed by replacing the <code>sis</code>
command by <code>./apache-sis-0.8/bin/sis</code>.</p>
 <h2 id="dependencies">Optional dependencies<a class="headerlink" href="#dependencies"
title="Permanent link">&para;</a></h2>
 <p>Every JAR files present in the <code>lib</code> sub-directory will be
included on the classpath during <code>sis</code> command execution.
-By default, the <code>lib</code> directory contains only the <code>sis.jar</code>
file.
+By default, the <code>lib</code> directory contains the <code>sis.jar</code>
file with only Derby and JAXB dependencies.
 However users can add other JAR files in that directory for the following optional dependencies:</p>
 <ul>
-<li>
-<p><strong>Derby driver —</strong>
-    needed only if Apache SIS can not locate a JavaDB driver in the JDK installation directory.
-    This is normally not needed on Oracle JDK6, JDK7 or JDK8 distribution.</p>
-</li>
-<li>
-<p><strong>UCAR netCDF library —</strong>
+<li><strong>UCAR netCDF library —</strong>
     by default, SIS uses its own embedded netCDF reader which supports only the classical
netCDF format, as standardized by OGC.
     If there is a need to read files encoded in GRID or HDF formats, then one can copy the
UCAR netCDF library in the <code>lib</code> sub-directory.
-    If presents, the UCAR library should be detected and used automatically.</p>
-</li>
+    If presents, the UCAR library should be detected and used automatically when SIS can
not read a netCDF file by itself.</li>
 </ul>
 <h1 id="usage">Usage<a class="headerlink" href="#usage" title="Permanent link">&para;</a></h1>
 <p>Invoking <code>sis</code> without argument shows a summary of available
commands and all options.
@@ -245,7 +238,7 @@ documented in <a href="downloads.html#ep
   Scope["Large and medium scale topographic mapping, cadastral and engineering survey."],
   Area["Japan - onshore - Honshu between approximately 137°45'E and 139°E - Niigata-ken;
Nagano-ken; Yamanashi-ken; Shizuoka-ken."],
   BBox[34.54, 137.32, 38.58, 139.91],
-  Id["EPSG", 6676, "8.9", URI["urn:ogc:def:crs:EPSG:8.9:6676"]],
+  Id["EPSG", 6676, "9.7", URI["urn:ogc:def:crs:EPSG:9.7:6676"]],
   Remark["Replaces JGD2000 / Japan Plane Rectangular CS VIII (CRS code 2450) with effect
from 21st October 2011."]]</pre>
 </details></p>
 <p>The above output is compatible with version 2 of <em>Well Known Text</em>
(WKT) format.
@@ -295,7 +288,7 @@ Executing the following command:</p>
 
 
 <p>produces an output like below:</p>
-<div class="codehilite"><pre>    urn:ogc:def:crs:EPSG:8.9:27572    | NTF (Paris)
/ Lambert zone II
+<div class="codehilite"><pre>    urn:ogc:def:crs:EPSG:9.7:27572    | NTF (Paris)
/ Lambert zone II
 </pre></div>
 
 
@@ -344,7 +337,7 @@ The next example asks the identifier of
 
 
 <p>produces an output like below:</p>
-<div class="codehilite"><pre>    urn:ogc:def:crs:EPSG:8.9:3994    | WGS 84 /
Mercator 41
+<div class="codehilite"><pre>urn:ogc:def:crs:EPSG:9.7:3994    | WGS 84 / Mercator
41
 </pre></div>
 
 

Modified: websites/staging/sis/trunk/content/examples/crs/WrongAxisOrder.wkt
==============================================================================
--- websites/staging/sis/trunk/content/examples/crs/WrongAxisOrder.wkt (original)
+++ websites/staging/sis/trunk/content/examples/crs/WrongAxisOrder.wkt Thu Sep 19 16:20:10
2019
@@ -8,5 +8,5 @@ GEODCRS["WGS 84 (longitude, latitude, he
   SCOPE["Used by the GPS satellite navigation system."],
   AREA["World."],
   BBOX[-90.00, -180.00, 90.00, 180.00],
-  ID["EPSG", 4979, "8.9", URI["urn:ogc:def:crs:EPSG:8.9:4979"]],
+  ID["EPSG", 4979, URI["urn:ogc:def:crs:EPSG::4979"]],
   REMARK["THIS IS NOT A VALID EPSG:4979 CRS! The two first axes have been intentionally swapped.
This example can be used for testing Apache SIS capability to detect wrong axis order."]]

Modified: websites/staging/sis/trunk/content/gdal.html
==============================================================================
--- websites/staging/sis/trunk/content/gdal.html (original)
+++ websites/staging/sis/trunk/content/gdal.html Thu Sep 19 16:20:10 2019
@@ -103,6 +103,7 @@ One reason may be to use map projection
 or for getting the exact same numerical results than Proj.4.
 The two libraries can coexist and can be used through the same API,
 provided that prerequisites are meet.</p>
+<p><strong>NOTE: this module has been temporarily retired in Apache SIS 1.0.
It needs to be upgraded to Proj version 5 and 6 before new release.</strong></p>
 <div class="toc">
 <ul>
 <li><a href="#prerequisites">Prerequisites</a></li>

Modified: websites/staging/sis/trunk/content/index.html
==============================================================================
--- websites/staging/sis/trunk/content/index.html (original)
+++ websites/staging/sis/trunk/content/index.html Thu Sep 19 16:20:10 2019
@@ -121,7 +121,6 @@ applicable to simple imagery as to many
   See the list of <a href="tables/CoordinateReferenceSystems.html">supported coordinate
reference systems</a>.</li>
 <li>Mercator, Transverse Mercator, Lambert Conic Conformal, stereographic and more
map projections.
   See the list of <a href="tables/CoordinateOperationMethods.html">supported operation
methods</a>.</li>
-<li>Optional <a href="gdal.html">bridge to Proj.4</a> as a complement to
Apache SIS own referencing engine.</li>
 </ul>
 </li>
 <li>Referencing by identifiers (ISO 19112:2003)<ul>

Modified: websites/staging/sis/trunk/content/release-management.html
==============================================================================
--- websites/staging/sis/trunk/content/release-management.html (original)
+++ websites/staging/sis/trunk/content/release-management.html Thu Sep 19 16:20:10 2019
@@ -185,15 +185,21 @@ in this page shall be adjusted according
 
 
 <h1 id="prepare-source">Review project status before branching<a class="headerlink"
href="#prepare-source" title="Permanent link">&para;</a></h1>
-<p>Replace the <code>$OLD_VERSION</code> number by <code>$NEW_VERSION</code>
in the following literals.
-Those changes need to be applied on the development branch and merged with all other branches
and master.</p>
+<p>Replace the <code>$OLD_VERSION</code> number by <code>$NEW_VERSION</code>
in the values of following properties on the development branch:</p>
 <ul>
 <li><code>DOWNLOAD_URL</code> in <code>application/sis-console/src/main/java/org/apache/sis/console/ResourcesDownloader.java</code>
file.</li>
 <li><code>&lt;sis.non-free.version&gt;</code> in root <code>pom.xml</code>
file.</li>
 <li>Also review the <code>README</code> and <code>NOTICE</code>
files in root directory.</li>
 </ul>
+<p>If not already done, build the C/C++ code of <code>sis-gdal</code> module:</p>
+<div class="codehilite"><pre>storage/sis-gdal/src/main/c
+make
+<span class="nb">cd</span> -
+</pre></div>
+
+
 <p>Commit and merge with other branches up to master.</p>
-<div class="codehilite"><pre>git commit --message<span class="o">=</span><span
class="s2">&quot;Set the EPSG geodetic dataset URL to its expected location after release.&quot;</span>
+<div class="codehilite"><pre>git commit --message<span class="o">=</span><span
class="s2">&quot;Set version number and the EPSG geodetic dataset URL to expected values
after release.&quot;</span>
 <span class="c"># merge with master</span>
 </pre></div>
 
@@ -202,7 +208,8 @@ Those changes need to be applied on the
 The tests described below often reveal errors that were unnoticed in daily builds.
 It is better to detect and fix them before to create the release branch.
 First, ensure that a PostgreSQL server is running and listening to the default port on local
host
-(optional but recommended for more exhaustive testing).
+(optional but recommended for more exhaustive testing —
+see <a href="./source.html#postgres">PostgreSQL testing configuration</a> for
more details).
 Then execute the following commands and fix as much warnings as practical:</p>
 <div class="codehilite"><pre>systemctl start postgresql.service        <span
class="c"># Optional — exact command depends on Linux distribution.</span>
 mvn clean install --define org.apache.sis.test.extensive<span class="o">=</span><span
class="nb">true</span>
@@ -221,20 +228,23 @@ mvn <span class="nb">test</span>
 
 
 <h2 id="update-crs-list">Update the list of supported CRS<a class="headerlink" href="#update-crs-list"
title="Permanent link">&para;</a></h2>
-<p>The following steps should have been done after SIS upgraded EPSG data,
-but it is useful to execute them again in case they have been forgotten,
-and also because failure to execute them may reveal problems.</p>
-<p>First, open the <code>CoordinateOperationMethods</code> Java class and
executes its <code>main</code> method, for example from an IDE.
-If successful, a <code>CoordinateOperationMethods.html</code> file will have
been generated in the current directory.
-Open that file in a browser and verify that information are okay, in particular the version
number in the first paragraph.
-If okay, move that file to the site checkout in the <code>content/tables/</code>
directory.</p>
-<p>Next, open the <code>CoordinateReferenceSystems</code> class. Before
to execute, we need to perform a temporary hack:
-open the <code>AuthorityCodes</code> class, search <code>DEPRECATED=0</code>
(it appears in a SQL fragment) and replace by <code>(DEPRECATED=0 OR TRUE)</code>.
-Do not commit! The intent of this hack is to include deprecated codes in the CRS list to
be generated.
-Those codes will appear with strike for making clear that they are deprecated.
-Next execute the <code>CoordinateReferenceSystems</code> main method,
-move the generated <code>CoordinateReferenceSystems.html</code> page to the <code>content/tables/</code>
directory of the site,
-and finally revert the hack in <code>AuthorityCodes</code> class.</p>
+<p>The following steps regenerate
+the <a href="./tables/CoordinateOperationMethods.html">CoordinateOperationMethods</a>
+and <a href="./tables/CoordinateReferenceSystems.html">CoordinateReferenceSystems</a>
pages.
+Those steps are also useful as additional tests, since failure to generate those pages may
reveal problems.</p>
+<ol>
+<li>Open the <code>AuthorityCodes</code> class, search <code>DEPRECATED=0</code>
(it appears in a SQL fragment) and replace by <code>(DEPRECATED=0 OR TRUE)</code>.
+     <strong>Do not commit!</strong> This is a temporary hack for including deprecated
codes in the CRS list to be generated.
+     Those codes will appear with strike for making clear that they are deprecated.</li>
+<li>Open the <code>CoordinateOperationMethods</code> Java class and execute
its <code>main</code> method, for example in an IDE.</li>
+<li>Open the <code>CoordinateReferenceSystems</code> Java class and execute
its <code>main</code> method.</li>
+<li>If successful, HTML files will be generated in the current directory.
+     Open those files in a web browser and verify that information are okay,
+     in particular the SIS and EPSG version numbers in the first paragraph.</li>
+<li>If okay, move those two HTML files to the <code>../site/content/tables/</code>
directory, overwriting previous files.</li>
+<li>Revert the hack in <code>AuthorityCodes</code> class.</li>
+<li>Commit: <code>svn commit --message="Update the list CRS and operation methods
supported by Apache SIS $NEW_VERSION."</code></li>
+</ol>
 <h2 id="release-notes">Prepare release notes<a class="headerlink" href="#release-notes"
title="Permanent link">&para;</a></h2>
 <p>We update JIRA soon because doing so is sometime a reminder of uncompleted tasks
in source code.
 Update <a href="http://issues.apache.org/jira/browse/SIS">JIRA</a> tasks and
prepare release notes as below:</p>
@@ -256,14 +266,12 @@ svn commit --message <span class="s2">&q
 
 
 <h1 id="branch">Create release branch<a class="headerlink" href="#branch" title="Permanent
link">&para;</a></h1>
-<p>Execute the following command:</p>
-<div class="codehilite"><pre>git checkout -b <span class="nv">$NEW_VERSION</span>-RC
-</pre></div>
-
-
-<p>It is okay to checkout the branch in a separated directory if desired.
+<p>Execute the following commands.
+It is okay to checkout the branch in a separated directory if desired.
 The <code>SIS_RC_DIR</code> environment variable will specify that directory.</p>
-<div class="codehilite"><pre><span class="nb">export </span><span
class="nv">SIS_RC_DIR</span><span class="o">=</span><span class="sb">`</span><span
class="nb">pwd</span><span class="sb">`</span>
+<div class="codehilite"><pre>git checkout -b <span class="nv">$NEW_VERSION</span>-RC
+<span class="nb">cd</span> <span class="nv">$NEW_VERSION</span>-RC
+<span class="nb">export </span><span class="nv">SIS_RC_DIR</span><span
class="o">=</span><span class="sb">`</span><span class="nb">pwd</span><span
class="sb">`</span>
 </pre></div>
 
 
@@ -289,6 +297,7 @@ git commit --message<span class="o">=</s
 <p>We need to update the SIS version numbers not only in the <code>pom.xml</code>
files, but also in a few Java files.
 The following command performs the replacement using Ant.</p>
 <div class="codehilite"><pre>ant -buildfile core/sis-build-helper/src/main/ant/prepare-release.xml
branch -Dsis.version<span class="o">=</span><span class="nv">$NEW_VERSION</span>
+git rm core/sis-build-helper/src/main/ant
 </pre></div>
 
 
@@ -309,6 +318,7 @@ Check first if those hacks are still nee
 <li><code>&lt;additionalOption&gt;-Xdoclint:all,-reference&lt;/additionalOption&gt;</code>
inside <code>&lt;additionalOptions&gt;</code> block.</li>
 </ul>
 </li>
+<li>Commit on the release branch only.</li>
 </ul>
 <h2 id="test-branch">Test branch extensively<a class="headerlink" href="#test-branch"
title="Permanent link">&para;</a></h2>
 <p>Build the project with the <code>apache-release</code> profile enabled.
@@ -331,6 +341,12 @@ This profile performs the following acti
 </pre></div>
 
 
+<p>More the <code>target</code> directory and execute all examples documented
in the <a href="./command-line.html">command-line interface page</a>
+with the <code>sis</code> command replaced by the following:</p>
+<div class="codehilite"><pre>java -classpath <span class="s2">&quot;binaries/*&quot;</span>
-enableassertions org.apache.sis.console.Command
+</pre></div>
+
+
 <h2 id="maven-nonfree">Prepare non-free resources<a class="headerlink" href="#maven-nonfree"
title="Permanent link">&para;</a></h2>
 <p>Go to the directory that contains a checkout of <code>https://svn.apache.org/repos/asf/sis/data/non-free/sis-epsg</code>.
 Those modules will not be part of the distribution (except on Maven), but we nevertheless
need to ensure that they work.

Modified: websites/staging/sis/trunk/content/release-notes/1.0.html
==============================================================================
--- websites/staging/sis/trunk/content/release-notes/1.0.html (original)
+++ websites/staging/sis/trunk/content/release-notes/1.0.html Thu Sep 19 16:20:10 2019
@@ -26,6 +26,9 @@
   <li><b><code>DataSet.getEnvelope()</code></b> — return
type has been changed from <code>Envelope</code> to <code>Optional&lt;Envelope&gt;</code>.</li>
   <li><b><code>TransformSeparator</code></b> — behavior
change: if the desired source dimensions were not explicitly specified,
     then the source dimensions that are not required for producing the desired target dimensions
are automatically trimmed.</li>
+  <li>The <code>sis-gdal</code> module released in Apache SIS 0.8 has been
excluded from this release.
+    That module was compiled for Proj4 and is incompatible with Proj5 or Proj6.
+    The upgrade is deferred to a future Apache SIS release.</li>
 </ul>
 <p>Changes are listed below (non-exhaustive list):</p>
 



Mime
View raw message