Author: desruisseaux
Date: Tue Feb 3 22:33:21 2015
New Revision: 1656937
URL: http://svn.apache.org/r1656937
Log:
Prepare documentation for the 0.5 release.
Added:
sis/site/trunk/content/release-notes/0.5.html
- copied, changed from r1656925,
sis/site/trunk/content/release-notes/0.4.html
Modified:
sis/site/trunk/content/DOAP.rdf
sis/site/trunk/content/command-line.mdtext
sis/site/trunk/content/downloads.mdtext
sis/site/trunk/content/index.mdtext
sis/site/trunk/content/release-management.mdtext
sis/site/trunk/content/release-notes/0.4.html
Modified: sis/site/trunk/content/DOAP.rdf
URL:
http://svn.apache.org/viewvc/sis/site/trunk/content/DOAP.rdf?rev=1656937&r1=1656936&r2=1656937&view=diff
==============================================================================
--- sis/site/trunk/content/DOAP.rdf (original)
+++ sis/site/trunk/content/DOAP.rdf Tue Feb 3 22:33:21 2015
@@ -103,6 +103,13 @@
</asfext:implements>
<release>
<Version>
+ <name>Apache SIS 0.5 â Metadata upgrade</name>
+ <created>2015-02-09</created>
+ <revision>0.5</revision>
+ </Version>
+ </release>
+ <release>
+ <Version>
<name>Apache SIS 0.4 â Referencing (part 1)</name>
<created>2014-04-07</created>
<revision>0.4</revision>
Modified: sis/site/trunk/content/command-line.mdtext
URL:
http://svn.apache.org/viewvc/sis/site/trunk/content/command-line.mdtext?rev=1656937&r1=1656936&r2=1656937&view=diff
==============================================================================
--- sis/site/trunk/content/command-line.mdtext [UTF-8] (original)
+++ sis/site/trunk/content/command-line.mdtext [UTF-8] Tue Feb 3 22:33:21 2015
@@ -19,7 +19,7 @@ Notice: Licensed to the Apache Software
A command-line interface is provided for extracting information from a data
file.
-As of SIS 0.4, the command line can only extract ISO 19115 metadata from a
NetCDF file.
+As of SIS 0.5, the command line can only extract ISO 19115 metadata from a
NetCDF file.
More formats and capabilities will be added in future SIS versions.
[TOC]
@@ -29,18 +29,18 @@ More formats and capabilities will be ad
Installation {#install}
==========================
-Select "Apache SIS 0.4 binary" from the [downloads page](downloads.html) an
unzip in any directory.
+Select "Apache SIS 0.5 binary" from the [downloads page](downloads.html) an
unzip in any directory.
The directory structure will be as below:
:::text
- apache-sis-0.4
+ apache-sis-0.5
├─ bin
└─ lib
The `bin` sub-directory contains a `sis` command for Unix systems (Linux or
MacOS — we have not yet done a `sis.bat` file for Windows).
The `bin` sub-directory can be added to the `PATH` environment variable for
convenience, but this is not mandatory.
The remaining of this page assumes that `bin` is on the search path.
-If not, just prepend the `sis` command by its path (e.g.
`./apache-sis-0.4/bin/sis`).
+If not, just prepend the `sis` command by its path (e.g.
`./apache-sis-0.5/bin/sis`).
Every JAR files present in the `lib` sub-directory will be included on the
classpath during the execution of `sis` command.
By default, the `lib` directory contains only the SIS archive. However users
can add other JAR files in that directory for
@@ -76,7 +76,7 @@ By default, the metadata are shown in a
But the metadata can optionally be exported as an ISO 19139 compliant XML
document.
<blockquote><b>Note:</b>
-As of SIS 0.4, only CF-compliant NetCDF files or ISO 19139 XML documents can
be given in argument to this command.
+As of SIS 0.5, only CF-compliant NetCDF files or ISO 19139 XML documents can
be given in argument to this command.
</blockquote>
The following example show the metadata of a NetCDF file accessible from the
web:
Modified: sis/site/trunk/content/downloads.mdtext
URL:
http://svn.apache.org/viewvc/sis/site/trunk/content/downloads.mdtext?rev=1656937&r1=1656936&r2=1656937&view=diff
==============================================================================
--- sis/site/trunk/content/downloads.mdtext [UTF-8] (original)
+++ sis/site/trunk/content/downloads.mdtext [UTF-8] Tue Feb 3 22:33:21 2015
@@ -30,12 +30,12 @@ See the `NOTICE` file contained in each
Download ZIP files {#bundles}
================================
-Apache SIS 0.4 is now available.
+Apache SIS 0.5 is now available.
See the `CHANGES` file for more information on the list of updates in this
initial release.
- * [Apache SIS-0.4 sources][src] [[PGP][src-PGP]]
- * [Apache SIS-0.4 javadoc][doc] [[PGP][doc-PGP]]
- * [Apache SIS 0.4 binary][bin] [[PGP][bin-PGP]]
+ * [Apache SIS-0.5 sources][src] [[PGP][src-PGP]]
+ * [Apache SIS-0.5 javadoc][doc] [[PGP][doc-PGP]]
+ * [Apache SIS 0.5 binary][bin] [[PGP][bin-PGP]]
The PGP (_Pretty Good Privacy_) signatures can be verified using any OpenPGP
implementation, for example GPG (_GNU Privacy Guard_).
First download the `[KEYS][keys]` file as well as the `.asc` signature files
for the relevant release packages.
@@ -65,7 +65,7 @@ Using PGP version 5:
Release notes {#release-notes}
---------------------------------
-See the [release notes](release-notes/0.4.html) for a list of changes since
the previous version.
+See the [release notes](release-notes/0.5.html) for a list of changes since
the previous version.
@@ -82,7 +82,7 @@ Using SIS releases {#maven-release}
:::xml
<properties>
- <sis.version>0.4</sis.version>
+ <sis.version>0.5</sis.version>
</properties>
<dependencies>
@@ -126,9 +126,9 @@ Using SIS development snapshots {#mav
[maven]: http://maven.apache.org
[keys]: http://www.apache.org/dist/sis/KEYS
[license]: http://www.apache.org/licenses/LICENSE-2.0
-[src]: http://www.apache.org/dyn/closer.cgi/sis/0.4/apache-sis-0.4-src.zip
-[doc]: http://www.apache.org/dyn/closer.cgi/sis/0.4/apache-sis-0.4-doc.zip
-[bin]: http://www.apache.org/dyn/closer.cgi/sis/0.4/apache-sis-0.4-bin.zip
-[src-PGP]: http://www.apache.org/dist/sis/0.4/apache-sis-0.4-src.zip.asc
-[doc-PGP]: http://www.apache.org/dist/sis/0.4/apache-sis-0.4-doc.zip.asc
-[bin-PGP]: http://www.apache.org/dist/sis/0.4/apache-sis-0.4-bin.zip.asc
+[src]: http://www.apache.org/dyn/closer.cgi/sis/0.5/apache-sis-0.5-src.zip
+[doc]: http://www.apache.org/dyn/closer.cgi/sis/0.5/apache-sis-0.5-doc.zip
+[bin]: http://www.apache.org/dyn/closer.cgi/sis/0.5/apache-sis-0.5-bin.zip
+[src-PGP]: http://www.apache.org/dist/sis/0.5/apache-sis-0.5-src.zip.asc
+[doc-PGP]: http://www.apache.org/dist/sis/0.5/apache-sis-0.5-doc.zip.asc
+[bin-PGP]: http://www.apache.org/dist/sis/0.5/apache-sis-0.5-bin.zip.asc
Modified: sis/site/trunk/content/index.mdtext
URL:
http://svn.apache.org/viewvc/sis/site/trunk/content/index.mdtext?rev=1656937&r1=1656936&r2=1656937&view=diff
==============================================================================
--- sis/site/trunk/content/index.mdtext [UTF-8] (original)
+++ sis/site/trunk/content/index.mdtext [UTF-8] Tue Feb 3 22:33:21 2015
@@ -34,8 +34,8 @@ simple imagery as to many dimensional da
Using SIS {#user}
--------------------
SIS requires a Java 6 Runtime Environment.
-The latest release is 0.4, released April 2014.
-The version under development is 0.5-SNAPSHOT.
+The latest release is 0.5, released February 2015.
+The version under development is 0.6-SNAPSHOT.
* [Downloads](downloads.html) as a `zip` files, or as Maven dependencies.
* Developer guide ([English](book/en/developer-guide.html) |
[French](book/fr/developer-guide.html)) — note that this is work in progress.
Modified: sis/site/trunk/content/release-management.mdtext
URL:
http://svn.apache.org/viewvc/sis/site/trunk/content/release-management.mdtext?rev=1656937&r1=1656936&r2=1656937&view=diff
==============================================================================
--- sis/site/trunk/content/release-management.mdtext [UTF-8] (original)
+++ sis/site/trunk/content/release-management.mdtext [UTF-8] Tue Feb 3
22:33:21 2015
@@ -40,11 +40,13 @@ number of the previous and the new relea
the current release attempt. Those versions shall be set on the command line
like below (Unix):
:::bash
- export OLD_VERSION=0.4
- export NEW_VERSION=0.5
+ export OLD_VERSION=0.5
+ export NEW_VERSION=0.6
export RELEASE_CANDIDATE=1
export SIGNING_KEY=<your key ID>
+Tip: to see the key IDs, execute `gpg --list-keys`.
+
Directory layout {#directory-layout}
@@ -72,6 +74,17 @@ in this page shall be adjusted according
+Prepare source code {#prepare-source}
+========================================
+
+Before to start the release process:
+
+ * Review and update the `README` file on the `trunk` source code repository.
+ * Review the `javac` and `javadoc` warnings reported by Jenkins and fix at
least the typos.
+ * Ensure that the `trunk` build is successful (including tests) with JDK6,
JDK7 and JDK8.
+
+
+
Prepare documentation {#prepare-documentation}
=================================================
@@ -87,18 +100,14 @@ Update [JIRA][JIRA] tasks and prepare re
_New Features_, then _Improvements_, then _Bug Fixes_, then _Tests_ and
finally _Tasks_.
The _Sub Tasks_ can be classified according the category of their parent
issue.
-Other files to update:
-
- * Review and update the `README` file on the `trunk` source code repository.
- * Review and update the `src/main/rdf/DOAP.rdf` file. Add a new `<release>`
- block for the new release with the estimated release date.
- * Commit any changes back to SVN.
-
Web site {#prepare-website}
------------------------------
+Review and update the `content/DOAP.rdf` file on the `site` source code
repository.
+Add a new `<release>` block for the new release with the estimated release
date.
+
Update the version numbers from the old one to `$NEW_VERSION` in the following
files.
* `content/index.mdtext`
@@ -109,7 +118,7 @@ Commit:
:::bash
svn add content/release-notes/$NEW_VERSION.html
- svn commit --message "Document the $NEW_VERSION release."
+ svn commit --message "Prepare documentation for the $NEW_VERSION release."
The new web site will be published in the [staging
area](http://sis.staging.apache.org).
It will not yet be published on `http://sis.apache.org`.
Modified: sis/site/trunk/content/release-notes/0.4.html
URL:
http://svn.apache.org/viewvc/sis/site/trunk/content/release-notes/0.4.html?rev=1656937&r1=1656936&r2=1656937&view=diff
==============================================================================
--- sis/site/trunk/content/release-notes/0.4.html (original)
+++ sis/site/trunk/content/release-notes/0.4.html Tue Feb 3 22:33:21 2015
@@ -7,7 +7,7 @@
<body>
<table style="border-style: solid; border-width: 1pt; background:
lightgray"><tr>
<td><a href="0.3.html">Previous release</a></td>
- <td style="padding-left: 9pt">Next release</td>
+ <td style="padding-left: 9pt"><a href="0.5.html">Next release</a></td>
</tr></table>
<h1>SIS 0.4 Release notes</h1>
Copied: sis/site/trunk/content/release-notes/0.5.html (from r1656925,
sis/site/trunk/content/release-notes/0.4.html)
URL:
http://svn.apache.org/viewvc/sis/site/trunk/content/release-notes/0.5.html?p2=sis/site/trunk/content/release-notes/0.5.html&p1=sis/site/trunk/content/release-notes/0.4.html&r1=1656925&r2=1656937&rev=1656937&view=diff
==============================================================================
--- sis/site/trunk/content/release-notes/0.4.html (original)
+++ sis/site/trunk/content/release-notes/0.5.html Tue Feb 3 22:33:21 2015
@@ -1,57 +1,40 @@
<!DOCTYPE html>
<html lang="en">
<head>
- <title>SIS 0.4 Release notes</title>
+ <title>SIS 0.5 Release notes</title>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
</head>
<body>
<table style="border-style: solid; border-width: 1pt; background:
lightgray"><tr>
- <td><a href="0.3.html">Previous release</a></td>
+ <td><a href="0.4.html">Previous release</a></td>
<td style="padding-left: 9pt">Next release</td>
</tr></table>
- <h1>SIS 0.4 Release notes</h1>
+ <h1>SIS 0.5 Release notes</h1>
<h2>New Features</h2>
-<ul>
- <li>Partial implementation of ISO 19111 - Referencing by coordinates.</li>
- <li>Partial implementation of ISO 19162 - Well Known Text 2.</li>
-</ul>
+<p>The initial plan for Apache SIS 0.5 was to complete the implementation of
Referencing by coordinates (ISO 19111),
+which started in SIS 0.4. However this work is not yet finished and is
re-targeted for SIS 0.6 release. Nevertheless
+this SIS 0.5 release contains an upgrade of spatial metadata (ISO 19115-1)
from the standard published in 2003 to the
+revision published in 2014 [SIS-94]. We think that this metadata upgrade,
together with the new <code>Feature</code>
+implementations [SIS-190], are worth a release.</p>
<h2>Improvements</h2>
<ul>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-68'>SIS-68</a>] -
Remove LatLon class and replace with DirectPosition</li>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-69'>SIS-69</a>] -
Remove LatLonRect and replace with Envelope class</li>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-88'>SIS-88</a>] -
Reduce size of public API</li>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-115'>SIS-115</a>] -
Ability to set NilReason on Boolean, Integer, Double and String objects</li>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-119'>SIS-119</a>] -
Support <gmx:FileName> and <gmx:MimeFileType> elements</li>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-121'>SIS-121</a>] -
AngleFormat should be able to optionally omit zero fields</li>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-143'>SIS-143</a>] -
DefaultGeographicBoundingBox should support spanning of anti-meridian</li>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-158'>SIS-158</a>] -
Complete JAXB annotations for datum objects</li>
+ <li>[<a href='https://issues.apache.org/jira/browse/SIS-79'>SIS-79</a>] -
Implement RangeSet.remove(E, E)</li>
+ <li>[<a href='https://issues.apache.org/jira/browse/SIS-94'>SIS-94</a>] -
Update SIS to revision 2014 of the ISO 19115 standard</li>
+ <li>[<a href='https://issues.apache.org/jira/browse/SIS-127'>SIS-127</a>] -
Create an implementation of Record</li>
+ <li>[<a href='https://issues.apache.org/jira/browse/SIS-190'>SIS-190</a>] -
Implement the FeatureType model derived from ISO 19109</li>
</ul>
<h2>Bug fixes</h2>
<ul>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-112'>SIS-112</a>] -
Maven site on Jenkins has broken links</li>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-122'>SIS-122</a>] -
DefaultRepresentativeFraction needs to implement IdentifiedObject</li>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-132'>SIS-132</a>] -
Better support for eclipse IDE</li>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-133'>SIS-133</a>] -
ResourceCompilerMojo should execute only when properties files are modified</li>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-134'>SIS-134</a>] -
ClassCastException in org.apache.sis.util.collection.Cache</li>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-135'>SIS-135</a>] -
[Foo]Name.compareTo(GenericName) should be case-sensitive</li>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-138'>SIS-138</a>] -
XML output ignore the --encoding argument</li>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-139'>SIS-139</a>] -
NullPointerException during unmarshalling of an empty collection</li>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-140'>SIS-140</a>] -
IndexOutOfBoundsException in LineAppender</li>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-141'>SIS-141</a>] -
MathFunctions.fractionDigitsForDelta(â¦) ignores the 'strict'
argument</li>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-142'>SIS-142</a>] -
Angle(89 + 1./60).toString() produces 89°00â²60â³ instead of
89°01â²00â³</li>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-144'>SIS-144</a>] -
Metadata properties ignore orderering declared in parent classes</li>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-151'>SIS-151</a>] -
xmlns:gml value should depend on XML.GML_VERSION value</li>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-153'>SIS-153</a>] -
XML marshalling of country codes shall use ISO 3166 alpha-2 (not alpha-3)</li>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-156'>SIS-156</a>] -
@ThreadSafe and @Immutable annotation usages are misleading</li>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-157'>SIS-157</a>] -
NullPointerException during unmarshalling of an empty codeListValue
attribute</li>
+ <li>[<a href='https://issues.apache.org/jira/browse/SIS-178'>SIS-178</a>] -
First property read in a DenseFeature returns a null value, next ones are
ok.</li>
</ul>
<h2>Tasks</h2>
<ul>
- <li>[<a href='https://issues.apache.org/jira/browse/SIS-109'>SIS-109</a>] -
Replace the boolean value of DataStore.canOpen(...) by an enum</li>
+ <li>[<a href='https://issues.apache.org/jira/browse/SIS-167'>SIS-167</a>] -
Create ChannelDataOutput class</li>
+ <li>[<a href='https://issues.apache.org/jira/browse/SIS-174'>SIS-174</a>] -
Please create a DOAP file for your TLP</li>
</ul>
</body>
</html>
