sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r1050326 - in /websites/staging/sis/trunk/content: ./ command-line.html downloads.html epsg.html index.html
Date Fri, 20 Sep 2019 09:52:01 GMT
Author: buildbot
Date: Fri Sep 20 09:52:01 2019
New Revision: 1050326

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/downloads.html
    websites/staging/sis/trunk/content/epsg.html
    websites/staging/sis/trunk/content/index.html

Propchange: websites/staging/sis/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Sep 20 09:52:01 2019
@@ -1 +1 @@
-1867209
+1867210

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 Fri Sep 20 09:52:01 2019
@@ -122,9 +122,9 @@ in their own application.</p>
 </ul>
 </div>
 <h1 id="install">Installation<a class="headerlink" href="#install" title="Permanent
link">&para;</a></h1>
-<p>Select "Apache SIS 0.8 binary" from the <a href="downloads.html">downloads
page</a> an unzip in any directory.
+<p>Select "Apache SIS 1.0 binary" from the <a href="downloads.html">downloads
page</a> an unzip in any directory.
 The directory structure will be as below:</p>
-<div class="codehilite"><pre>apache-sis-0.8
+<div class="codehilite"><pre>apache-sis-1.0
 ├─ bin
 ├─ conf
 ├─ data
@@ -136,12 +136,12 @@ The directory structure will be as below
 <p>The <code>bin</code> sub-directory contains a <code>sis</code>
command for Unix systems (Linux or MacOS — we have not yet done a <code>sis.bat</code>
file for Windows).
 The <code>bin</code> sub-directory can be added to the <code>PATH</code>
environment variable for convenience, but this is not mandatory.
 Example:</p>
-<div class="codehilite"><pre><span class="nb">export </span><span
class="nv">PATH</span><span class="o">=</span><span class="nv">$PWD</span>/apache-sis-0.8/bin:<span
class="nv">$PATH</span>
+<div class="codehilite"><pre><span class="nb">export </span><span
class="nv">PATH</span><span class="o">=</span><span class="nv">$PWD</span>/apache-sis-1.0/bin:<span
class="nv">$PATH</span>
 </pre></div>
 
 
 <p>The remaining of this page assumes that the <code>bin</code> directory
is on the search path.
-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>
+If not, the same examples can still be executed by replacing the <code>sis</code>
command by <code>./apache-sis-1.0/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 the <code>sis.jar</code>
file with only Derby and JAXB dependencies.
@@ -435,7 +435,7 @@ The data file given in argument can be a
 By default, the metadata are shown in a relatively compact tree-table format.
 But the metadata can optionally be exported as an ISO 19139 compliant XML document.</p>
 <blockquote><b>Note:</b>
-As of SIS 0.8, only ISO 19139 XML documents, CF-compliant netCDF files, GeoTIFF files, GPX
files
+As of SIS 1.0, only ISO 19139 XML documents, CF-compliant netCDF files, GeoTIFF files, GPX
files
 or Moving Features CSV files can be given in argument to this command.
 </blockquote>
 

Modified: websites/staging/sis/trunk/content/downloads.html
==============================================================================
--- websites/staging/sis/trunk/content/downloads.html (original)
+++ websites/staging/sis/trunk/content/downloads.html Fri Sep 20 09:52:01 2019
@@ -98,8 +98,8 @@
   visibility: hidden;
 }
 h2:hover > .headerlink, h3:hover > .headerlink, h1:hover > .headerlink, h6:hover
> .headerlink, h4:hover > .headerlink, h5:hover > .headerlink, dt:hover > .elementid-permalink
{ visibility: visible }</style>
-<p>Apache SIS 0.8 is now available.
-See the <a href="release-notes/0.8.html">release notes</a> for a list of changes
since the previous version.</p>
+<p>Apache SIS 1.0 is now available.
+See the <a href="release-notes/1.0.html">release notes</a> for a list of changes
since the previous version.</p>
 <p>Apache SIS releases are available under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache
License, Version 2.0</a>.
 See the <code>NOTICE</code> file contained in each release artifact for applicable
copyright attribution notices.</p>
 <div class="toc">
@@ -120,9 +120,9 @@ For convenience, an aggregated Javadoc a
 The precompiled JAR file contains most modules and dependencies in a single archive for easier
inclusion
 in a classpath.</p>
 <ul>
-<li><a href="http://www.apache.org/dyn/closer.cgi/sis/0.8/apache-sis-0.8-src.zip">Apache
SIS 0.8 sources</a> [<a href="http://www.apache.org/dist/sis/0.8/apache-sis-0.8-src.zip.asc">PGP</a>]</li>
-<li><a href="http://www.apache.org/dyn/closer.cgi/sis/0.8/apache-sis-0.8-doc.zip">Apache
SIS 0.8 javadoc</a> [<a href="http://www.apache.org/dist/sis/0.8/apache-sis-0.8-doc.zip.asc">PGP</a>]</li>
-<li><a href="http://www.apache.org/dyn/closer.cgi/sis/0.8/apache-sis-0.8-bin.zip">Apache
SIS 0.8 binary</a> [<a href="http://www.apache.org/dist/sis/0.8/apache-sis-0.8-bin.zip.asc">PGP</a>]</li>
+<li><a href="http://www.apache.org/dyn/closer.cgi/sis/1.0/apache-sis-1.0-src.zip">Apache
SIS 1.0 sources</a> [<a href="http://www.apache.org/dist/sis/1.0/apache-sis-1.0-src.zip.asc">PGP</a>]</li>
+<li><a href="http://www.apache.org/dyn/closer.cgi/sis/1.0/apache-sis-1.0-doc.zip">Apache
SIS 1.0 javadoc</a> [<a href="http://www.apache.org/dist/sis/1.0/apache-sis-1.0-doc.zip.asc">PGP</a>]</li>
+<li><a href="http://www.apache.org/dyn/closer.cgi/sis/1.0/apache-sis-1.0-bin.zip">Apache
SIS 1.0 binary</a>  [<a href="http://www.apache.org/dist/sis/1.0/apache-sis-1.0-bin.zip.asc">PGP</a>]</li>
 </ul>
 <h2 id="release-gpg">Verify signatures<a class="headerlink" href="#release-gpg"
title="Permanent link">&para;</a></h2>
 <p>All downloads can be verified using the Apache SIS code signing <a href="http://www.apache.org/dist/sis/KEYS">KEYS</a>.
@@ -154,7 +154,7 @@ dependency management tool to automatica
 Below are examples of declarations in a <code>pom.xml</code> file for building
a project with a SIS core module.
 If running on Java 11 or higher, at least one of the two next dependencies is also required:</p>
 <div class="codehilite"><pre><span class="nt">&lt;properties&gt;</span>
-  <span class="nt">&lt;sis.version&gt;</span>0.8<span class="nt">&lt;/sis.version&gt;</span>
+  <span class="nt">&lt;sis.version&gt;</span>1.0<span class="nt">&lt;/sis.version&gt;</span>
 <span class="nt">&lt;/properties&gt;</span>
 
 <span class="nt">&lt;dependencies&gt;</span>

Modified: websites/staging/sis/trunk/content/epsg.html
==============================================================================
--- websites/staging/sis/trunk/content/epsg.html (original)
+++ websites/staging/sis/trunk/content/epsg.html Fri Sep 20 09:52:01 2019
@@ -148,27 +148,32 @@ For example:</p>
 
 <p>The first time that the command-line tool needs to query EPSG, it will prompt the
user for authorization
 to download EPSG geodetic dataset from Maven Central. If the user accepts EPSG terms of use,
then a local
-copy of the EPSG geodetic dataset will be created and stored in the <code>apache-sis-0.8/data</code>
sub-directory.</p>
+copy of the EPSG geodetic dataset will be created and stored in the <code>apache-sis-1.0/data</code>
sub-directory.</p>
 <p>If the command-line tool does not offer to download the EPSG geodetic dataset,
-try adding a <code>derby-&lt;version&gt;.jar</code> file (download lib-distribution
from <a href="http://db.apache.org/derby/derby_downloads.html">Derby project</a>)
in the <code>apache-sis-0.8/lib</code> sub-directory.
-This is normally not needed with Oracle JDK6, JDK7 or JDK8 because Apache SIS tries to use
the JavaDB embedded
-in those distributions, but may be necessary with other distributions or in security-constrained
environments.</p>
+try adding a <code>derby-&lt;version&gt;.jar</code> file (download lib-distribution
from <a href="http://db.apache.org/derby/derby_downloads.html">Derby project</a>)
in the <code>apache-sis-1.0/lib</code> sub-directory.
+This is normally not needed with Oracle JDK8 because Apache SIS tries to use the JavaDB embedded
+in those distributions, but may be necessary with other distributions or in security-constrained
environments:</p>
+<div class="codehilite"><pre><span class="nb">cd </span>apache-sis-1.0/lib
+wget http://repo1.maven.org/maven2/org/apache/derby/derby/10.14.2.0/derby-10.14.2.0.jar
+</pre></div>
+
+
 <h2 id="use-local">Use the local copy in other applications<a class="headerlink"
href="#use-local" title="Permanent link">&para;</a></h2>
 <p>For using the installed EPSG geodetic dataset in your own application, apply <em>one</em>
of the following choices:</p>
 <ul>
-<li>Set the <code>SIS_DATA</code> environment variable to the path of <code>apache-sis-0.8/data</code>
directory <em>(preferred choice)</em>.</li>
-<li>Set the <code>derby.system.home</code> Java property to the path of
<code>apache-sis-0.8/data/Databases</code> directory.</li>
+<li>Set the <code>SIS_DATA</code> environment variable to the path of <code>apache-sis-1.0/data</code>
directory <em>(preferred choice)</em>.</li>
+<li>Set the <code>derby.system.home</code> Java property to the path of
<code>apache-sis-1.0/data/Databases</code> directory.</li>
 </ul>
 <p>Alternatively <code>SIS_DATA</code> or <code>derby.system.home</code>
can be set to the path of any other directory which contain the same files.
-Examples are shown below for Unix systems, assuming that the current directory is the directory
where <code>apache-sis-0.8-bin.zip</code>
+Examples are shown below for Unix systems, assuming that the current directory is the directory
where <code>apache-sis-1.0-bin.zip</code>
 has been unzipped:</p>
-<div class="codehilite"><pre><span class="nb">export </span><span
class="nv">SIS_DATA</span><span class="o">=</span>apache-sis-0.8/data
-java -classpath apache-sis-0.8/lib/sis.jar:myApp.jar myMainClass
+<div class="codehilite"><pre><span class="nb">export </span><span
class="nv">SIS_DATA</span><span class="o">=</span>apache-sis-1.0/data
+java -classpath apache-sis-1.0/lib/sis.jar:myApp.jar myMainClass
 </pre></div>
 
 
 <p>If the <code>SIS_DATA</code> environment variable can not be set, Java
property can be used as a fallback:</p>
-<div class="codehilite"><pre><span class="n">java</span> <span
class="o">-</span><span class="n">Dderby</span><span class="p">.</span><span
class="n">system</span><span class="p">.</span><span class="n">home</span><span
class="p">=</span><span class="n">apache</span><span class="o">-</span><span
class="n">sis</span><span class="o">-</span>0<span class="p">.</span>8<span
class="o">/</span><span class="n">data</span><span class="o">/</span><span
class="n">Databases</span> <span class="o">-</span><span class="n">classpath</span>
<span class="n">apache</span><span class="o">-</span><span class="n">sis</span><span
class="o">-</span>0<span class="p">.</span>8<span class="o">/</span><span
class="n">lib</span><span class="o">/</span><span class="n">sis</span><span
class="p">.</span><span class="n">jar</span><span class="p">:</span><span
class="n">myApp</span><span class="p">.</span><span class="n">jar</span>
<span class="n">myMainClass</span>
+<div class="codehilite"><pre><span class="n">java</span> <span
class="o">-</span><span class="n">Dderby</span><span class="p">.</span><span
class="n">system</span><span class="p">.</span><span class="n">home</span><span
class="p">=</span><span class="n">apache</span><span class="o">-</span><span
class="n">sis</span><span class="o">-</span>1<span class="p">.</span>0<span
class="o">/</span><span class="n">data</span><span class="o">/</span><span
class="n">Databases</span> <span class="o">-</span><span class="n">classpath</span>
<span class="n">apache</span><span class="o">-</span><span class="n">sis</span><span
class="o">-</span>1<span class="p">.</span>0<span class="o">/</span><span
class="n">lib</span><span class="o">/</span><span class="n">sis</span><span
class="p">.</span><span class="n">jar</span><span class="p">:</span><span
class="n">myApp</span><span class="p">.</span><span class="n">jar</span>
<span class="n">myMainClass</span>
 </pre></div>
 
 
@@ -188,6 +193,7 @@ The target database must be specified by
     or a directory that contain other Derby databases. The specified directory must exist.</li>
 <li>Register a <code>DataSource</code> under the <code>java:comp/env/jdbc/SpatialMetadata</code>
name in a JNDI directory
     (see <a href="#jndi">next section</a>). The database must exist but can be
initially empty.</li>
+<li>Set a <code>DataSource</code> <a href="./apidocs/org/apache/sis/setup/Configuration.html">from
Java code</a>.</li>
 </ul>
 <p>The Maven dependency is as below (the Derby dependency can be replaced by another
database driver
 if that database is specified by JNDI):</p>
@@ -195,12 +201,12 @@ if that database is specified by JNDI):<
   <span class="nt">&lt;dependency&gt;</span>
     <span class="nt">&lt;groupId&gt;</span>org.apache.sis.non-free<span
class="nt">&lt;/groupId&gt;</span>
     <span class="nt">&lt;artifactId&gt;</span>sis-epsg<span class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span>0.8<span class="nt">&lt;/version&gt;</span>
+    <span class="nt">&lt;version&gt;</span>1.0<span class="nt">&lt;/version&gt;</span>
     <span class="nt">&lt;scope&gt;</span>runtime<span class="nt">&lt;/scope&gt;</span>
   <span class="nt">&lt;/dependency&gt;</span>
 
-  <span class="c">&lt;!-- Following dependency can be omitted on Oracle JDK6, JDK7
or JDK8</span>
-<span class="c">       since those Java distributions contain Derby (a.k.a JavaDB).
--&gt;</span>
+  <span class="c">&lt;!-- Following dependency can be omitted on Oracle JDK8</span>
+<span class="c">       since that Java distributions contain Derby (a.k.a JavaDB).
--&gt;</span>
   <span class="nt">&lt;dependency&gt;</span>
     <span class="nt">&lt;groupId&gt;</span>org.apache.derby<span class="nt">&lt;/groupId&gt;</span>
     <span class="nt">&lt;artifactId&gt;</span>derby<span class="nt">&lt;/artifactId&gt;</span>
@@ -229,7 +235,7 @@ Note that <code>sis-epsg</code> and <cod
   <span class="nt">&lt;dependency&gt;</span>
     <span class="nt">&lt;groupId&gt;</span>org.apache.sis.non-free<span
class="nt">&lt;/groupId&gt;</span>
     <span class="nt">&lt;artifactId&gt;</span>sis-embedded-data<span
class="nt">&lt;/artifactId&gt;</span>
-    <span class="nt">&lt;version&gt;</span>0.8<span class="nt">&lt;/version&gt;</span>
+    <span class="nt">&lt;version&gt;</span>1.0<span class="nt">&lt;/version&gt;</span>
     <span class="nt">&lt;scope&gt;</span>runtime<span class="nt">&lt;/scope&gt;</span>
   <span class="nt">&lt;/dependency&gt;</span>
 <span class="nt">&lt;/dependencies&gt;</span>
@@ -248,7 +254,7 @@ or by uncompressing the <code>sis-embedd
 For using an arbitrary database, register a <code>javax.sql.DataSource</code>
instance through the Java Naming and Directory Interface (JNDI).
 That registration can be done programmatically (by Java code) or by configuring XML files
in some environments.
 The database must exist but can be empty, in which case it will be populated with an EPSG
schema when first needed
-if the <code style="white-space:normal">org.apache.sis.non-free:​sis-epsg:​0.8</code>
dependency is on the classpath
+if the <code style="white-space:normal">org.apache.sis.non-free:​sis-epsg:​1.0</code>
dependency is on the classpath
 (see <a href="#maven-epsg">above section</a>).</p>
 <h2 id="jndi-java">Registration by Java code<a class="headerlink" href="#jndi-java"
title="Permanent link">&para;</a></h2>
 <p>Registration can be done by the following Java code, provided that a JNDI implementation
is available on the classpath:</p>
@@ -263,6 +269,12 @@ if the <code style="white-space:normal">
 </pre></div>
 
 
+<p>If there is no JNDI environment, the <code>org.apache.sis.setup.Configuration</code>
class can be used as a fallback:</p>
+<div class="codehilite"><pre><span class="c1">// Fallback if no JNDI environment
is available.</span>
+<span class="n">Configuration</span><span class="o">.</span><span
class="na">current</span><span class="o">().</span><span class="na">setDatabase</span><span
class="o">(()</span> <span class="o">-&gt;</span> <span class="n">ds</span><span
class="o">);</span>
+</pre></div>
+
+
 <h2 id="jndi-webapp">Registration in web application containers<a class="headerlink"
href="#jndi-webapp" title="Permanent link">&para;</a></h2>
 <p>JNDI implementations are provided by web application containers like Apache Tomcat.
 When Apache SIS is used in a JavaEE container, the data source can be configured as below:</p>

Modified: websites/staging/sis/trunk/content/index.html
==============================================================================
--- websites/staging/sis/trunk/content/index.html (original)
+++ websites/staging/sis/trunk/content/index.html Fri Sep 20 09:52:01 2019
@@ -135,7 +135,7 @@ applicable to simple imagery as to many
 </li>
 </ul>
 <h2 id="user">Using Apache SIS<a class="headerlink" href="#user" title="Permanent
link">&para;</a></h2>
-<p>The latest SIS release is 0.8, released November 2017.
+<p>The latest SIS release is 1.0, released September 2019.
 Apache SIS requires Java 10 or higher for building, but can be executed on Java 8 or higher.
 If using Java 8 Runtime Environment, nothing else is needed since Java 8 includes JAXB.
 If using Java 9 or higher, one of the following configurations is needed



Mime
View raw message