Author: buildbot
Date: Thu May 19 19:39:40 2016
New Revision: 988652
Log:
Staging update by buildbot for sis
Added:
websites/staging/sis/trunk/content/epsg.html
Modified:
websites/staging/sis/trunk/content/ (props changed)
websites/staging/sis/trunk/content/downloads.html
websites/staging/sis/trunk/content/release-management.html
Propchange: websites/staging/sis/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu May 19 19:39:40 2016
@@ -1 +1 @@
-1744612
+1744628
Modified: websites/staging/sis/trunk/content/downloads.html
==============================================================================
--- websites/staging/sis/trunk/content/downloads.html (original)
+++ websites/staging/sis/trunk/content/downloads.html Thu May 19 19:39:40 2016
@@ -144,7 +144,7 @@ pgpv apache-sis-X.Y.Z.zip.asc
<h1 id="maven">Download as a Maven dependency<a class="headerlink"
href="#maven" title="Permanent link">¶</a></h1>
-<p>An easy approach to integrate SIS into a Java project uses the <a
href="http://maven.apache.org/";>Apache Maven</a>
+<p>An easy approach to integrate Apache SIS into a Java project uses the <a
href="http://maven.apache.org/";>Apache Maven</a>
dependency management tool to automatically obtain the required Java Archives
(JAR) files from the network.
Below are examples of declarations in a <code>pom.xml</code> file for building
a project with the SIS core module:</p>
<div class="codehilite"><pre><span class="nt"><properties></span>
@@ -163,10 +163,11 @@ Below are examples of declarations in a
<h2 id="epsg">Using EPSG geodetic dataset<a class="headerlink" href="#epsg"
title="Permanent link">¶</a></h2>
<p>The <a href="http://www.epsg.org/";>EPSG geodetic dataset</a> is optional
but strongly recommended.
-The EPSG dataset provides <a
href="tables/CoordinateReferenceSystems.html">thousands of Coordinate Reference
System definitions</a>
+The EPSG dataset is a de-facto standard providing
+<a href="tables/CoordinateReferenceSystems.html">thousands of Coordinate
Reference System (CRS) definitions</a>
together with information about how to perform coordinate operations, their
accuracies and their domains of validity.
-However usage of EPSG dataset requires acceptation of <a
href="http://www.epsg.org/TermsOfUse";>Terms of Use</a>.
-If you accept those terms of use, the following dependency can be added:</p>
+However usage of EPSG dataset requires acceptation of <a
href="http://www.epsg.org/TermsOfUse";>EPSG terms of use</a>.
+If you accept those terms of use, then the following dependency can be
added:</p>
<div class="codehilite"><pre><span class="nt"><dependencies></span>
<span class="nt"><dependency></span>
<span class="nt"><groupId></span>org.apache.sis.non-free<span
class="nt"></groupId></span>
Added: websites/staging/sis/trunk/content/epsg.html
==============================================================================
--- websites/staging/sis/trunk/content/epsg.html (added)
+++ websites/staging/sis/trunk/content/epsg.html Thu May 19 19:39:40 2016
@@ -0,0 +1,170 @@
+<!DOCTYPE html>
+<html lang="en">
+ <head>
+ <title>How to use EPSG geodetic dataset</title>
+ <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+ <link rel="stylesheet" type="text/css" media="screen"
href="css/bootstrap.min.css">
+ <link rel="stylesheet" type="text/css" media="screen"
href="http://www.apache.org/css/code.css";>
+ <link rel="stylesheet" type="text/css" media="screen" href="css/sis.css">
+
+
+
+
+ <!-- Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with this work
for additional information regarding copyright ownership. The ASF licenses
this file to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance with the
License. You may obtain a copy of the License at .
http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law
or agreed to in writing, software distributed under the License is distributed
on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
either express or implied. See the License for the specific language governing
permissions and limitations under the License. -->
+ </head>
+
+ <body>
+ <div class="navbar navbar-inverse navbar-fixed-top">
+ <div class="navbar-inner">
+ <div class="container">
+ <a class="brand" href="/index.html"> Apache SIS™ </a>
+ <div class="nav-collapse">
+ <ul class="nav">
+ <li class="dropdown"> <a class="dropdown-toggle"
data-toggle="dropdown">About<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+ <li><a href="mail-lists.html">Mailing Lists</a></li>
+ <li><a href="license.html">Project License</a></li>
+ <li><a href="team-list.html">Project Team</a></li>
+ </ul>
+ </li>
+ <li class="dropdown"> <a class="dropdown-toggle"
data-toggle="dropdown">Project Documentation<b class="caret"></b></a>
+ <ul class="dropdown-menu">
+ <li><a href="book/en/developer-guide.html">Developer
guide</a></li>
+ <li><a href="apidocs/index.html">Online Javadoc</a></li>
+ <li><a href="downloads.html">Downloads</a></li>
+ <li><a href="source.html">Source Code</a></li>
+ <li><a href="code-patterns.html">Code patterns</a></li>
+ <li><a href="faq.html">FAQ</a></li>
+ <li><a
href="https://issues.apache.org/jira/browse/SIS";>Issue Tracker</a></li>
+ </ul>
+ </li>
+ <li class="dropdown"> <a class="dropdown-toggle"
data-toggle="dropdown">ASF <b class="caret"></b></a>
+ <ul class="dropdown-menu">
+ <li><a href="http://www.apache.org";>The Foundation</a></li>
+ <li><a
href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li>
+ <li><a
href="http://www.apache.org/foundation/sponsorship.html";>Become a
Sponsor</a></li>
+ <li><a
href="http://www.apache.org/security/";>Security</a></li>
+ </ul>
+ </li>
+ </ul>
+ </div> <!-- /.nav-collapse -->
+ </div><!-- /.container -->
+ </div><!-- /.navbar-inner -->
+ </div>
+
+ <div class="container-fluid">
+ <div class="row-fluid">
+ <div class="span2">
+ <img src="img/logo.png"/>
+ <div class="well sidebar-nav">
+ <ul class="nav nav-list">
+ <li class="active"><a href="index.html">Home</a></li>
+ <li><a href="mail-lists.html">Mailing Lists</a></li>
+ <li><a href="license.html">Project License</a></li>
+ <li><a href="team-list.html">Project Team</a></li>
+ <li class="nav-header">Project Documentation</li>
+ <li><a href="book/en/developer-guide.html">Developer
guide</a></li>
+ <li><a href="apidocs/index.html">Online Javadoc</a></li>
+ <li><a href="downloads.html">Downloads</a></li>
+ <li><a href="source.html">Source Code</a></li>
+ <li><a href="code-patterns.html">Code patterns</a></li>
+ <li><a href="faq.html">FAQ</a></li>
+ <li><a href="https://issues.apache.org/jira/browse/SIS";>Issue
Tracker</a></li>
+ <li class="nav-header">ASF</li>
+ <li><a href="http://www.apache.org";>The Foundation</a></li>
+ <li><a
href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li>
+ <li><a
href="http://www.apache.org/foundation/sponsorship.html";>Become a
Sponsor</a></li>
+ <li><a href="http://www.apache.org/security/";>Security</a></li>
+ </ul>
+ </div><!--/.well -->
+ </div><!--/span-->
+ <div class="span10">
+ <section id="content" class="row">
+ <article class="span12">
+ <p class="page-title">How to use EPSG geodetic dataset</p>
+ <style type="text/css">
+/* The following code is added by mdx_elementid.py
+ It was originally lifted from http://subversion.apache.org/style/site.css */
+/*
+ * Hide class="elementid-permalink", except when an enclosing heading
+ * has the :hover property.
+ */
+.headerlink, .elementid-permalink {
+ 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>The <a href="http://www.epsg.org/";>EPSG geodetic dataset</a> is a de-facto
standard providing
+<a href="tables/CoordinateReferenceSystems.html">thousands of Coordinate
Reference System (CRS) definitions</a>
+together with information about how to perform coordinate operations, their
accuracies and their domains of validity.
+The EPSG dataset is owned and maintained by the <a
href="http://www.iogp.org/";>International Association of Oil & Gas
producers</a>.
+Usage of EPSG dataset with Apache SIS is optional but strongly recommended:
+without that geodetic dataset, only a small subset of CRS definitions will be
available
+(basically the constants enumerated in the <code>CommonCRS</code> Java class)
+unless full definitions are provided in <em>Well Known Text</em> (WKT) or
<em>Geographic Markup Language</em> (GML) formats.
+Furthermore, coordinate operations between any given pair of CRS may be less
accurate
+and their domains of validity may be unspecified if Apache SIS can not query
EPSG.</p>
+<p>The EPSG geodetic dataset is not distributed with Apache SIS because the <a
href="http://www.epsg.org/TermsOfUse";>EPSG terms of use</a>
+are incompatible with Apache license. The following items are quoted from
those terms of use:</p>
+<ul>
+<li>The <a href="http://www.epsg.org/";>EPSG</a> Facilities are published by <a
href="http://www.iogp.org/";>IOGP</a> at no charge. Distribution for profit is
forbidden.</li>
+<li>The data may be included in any commercial package provided that any
commerciality is based on value added
+ by the provider and not on a value ascribed to the EPSG Dataset which is
made available at no charge.</li>
+<li>Ownership of the EPSG Dataset by IOGP must be acknowledged in any
publication or transmission
+ (by whatever means) thereof (including permitted modifications).</li>
+<li>Modification of parameter values is permitted as described in the table 1
to allow change to the content
+ of the information provided that numeric equivalence is achieved.</li>
+<li>No data that has been modified other than as permitted in these Terms of
Use shall be attributed to the EPSG Dataset.</li>
+</ul>
+<p>In order to use the EPSG geodetic dataset with Apache SIS, there is two
possibilities:</p>
+<h1 id="command-line">Install a local copy with command-line tool<a
class="headerlink" href="#command-line" title="Permanent link">¶</a></h1>
+<p>If the <a href="command-line.html">command-line tool</a> has been
downloaded and installed, just query any CRS.
+For example:</p>
+<div class="codehilite"><pre>sis crs EPSG:6676
+</pre></div>
+
+
+<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.7/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-<version>.jar</code> file (<a
href="http://db.apache.org/derby/derby_downloads.html";>download
lib-distribution</a>) in the <code>apache-sis-0.7/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>
+<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 to the
<code>apache-sis-0.7/data</code> directory <em>(preferred choice)</em>.</li>
+<li>Set the <code>derby.system.home</code> Java property to the path to the
<code>apache-sis-0.7/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.</p>
+<h1 id="maven">Add a Maven dependency<a class="headerlink" href="#maven"
title="Permanent link">¶</a></h1>
+<p>Maven projects can get the EPSG geodetic dataset automatically, <em>without
any prompt for terms of use agreement</em>,
+if they add a dependency to the
<code>org.apache.sis.non-free:sis-epsg:0.7</code> artifact in their project.
+We assume that developers who add this dependency explicitely in their
projects agree with the terms of use.
+The <code><dependency></code> fragment to use in the
<code>pom.xml</code> file is given in the <a
href="download.html#epsg">download</a> page.</p>
+<p>In addition, users need to apply <em>one</em> of the following choices:</p>
+<ul>
+<li>Set the <code>SIS_DATA</code> environment variable to the path of an
initially empty directory <em>(preferred choice)</em>.</li>
+<li>Set the <code>derby.system.home</code> Java property to the path of an
initially empty directory,
+ or a directory that contain other Derby databases.</li>
+</ul>
+<p>The directory references by <code>SIS_DATA</code> or
<code>derby.system.home</code> must exist.
+Sub-directories in that directory will be created as needed.</p>
+ </article>
+ </section>
+ </div><!--/span-->
+ </div><!--/row-fluid-->
+ </div><!--/container-fluid-->
+
+ <footer class="footer">
+ <div class="container">
+ <p>Copyright © 2013-2016 The Apache Software Foundation, Licensed
under the
+ <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache License,
Version 2.0</a>.<br />
+ Apache SIS, Apache, the Apache feather logo are trademarks of The
Apache Software Foundation.</p>
+ </div>
+ </footer>
+
+ <script src="js/jquery-1.9.1.min.js"></script>
+ <script src="js/bootstrap.min.js"></script>
+
+</body>
+</html>
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 May 19
19:39:40 2016
@@ -223,6 +223,7 @@ Add a new <code><release></code> b
<li><code>content/index.mdtext</code></li>
<li><code>content/downloads.mdtext</code> (need also to update
<code>$NEW_VERSION-SNAPSHOT</code> to the next snapshot version)</li>
<li><code>content/command-line.mdtext</code></li>
+<li><code>content/epsg.mdtext</code></li>
</ul>
<p>Commit:</p>
<div class="codehilite"><pre>svn add content/release-notes/<span
class="nv">$NEW_VERSION</span>.html
