You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@sis.apache.org by de...@apache.org on 2015/02/03 23:33:21 UTC

svn commit: r1656937 - in /sis/site/trunk/content: DOAP.rdf command-line.mdtext downloads.mdtext index.mdtext release-management.mdtext release-notes/0.4.html release-notes/0.5.html

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 &lt;gmx:FileName&gt; and &lt;gmx:MimeFileType&gt; 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 &#39;strict&#39; 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>