sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r890929 - in /websites/staging/sis/trunk/content: ./ branches.html
Date Wed, 18 Dec 2013 18:15:40 GMT
Author: buildbot
Date: Wed Dec 18 18:15:39 2013
New Revision: 890929

Staging update by buildbot for sis

    websites/staging/sis/trunk/content/   (props changed)

Propchange: websites/staging/sis/trunk/content/
--- cms:source-revision (original)
+++ cms:source-revision Wed Dec 18 18:15:39 2013
@@ -1 +1 @@

Modified: websites/staging/sis/trunk/content/branches.html
--- websites/staging/sis/trunk/content/branches.html (original)
+++ websites/staging/sis/trunk/content/branches.html Wed Dec 18 18:15:39 2013
@@ -99,6 +99,7 @@ for making merges easier, then provides 
 <li><a href="#trunk">trunk</a></li>
+<li><a href="#behavior">Behavioral differences between the branches</a></li>
 <li><a href="#recommendations">Coding recommendations</a><ul>
 <li><a href="#formatting">Formatting</a></li>
 <li><a href="#imports">Import statements</a></li>
@@ -147,6 +148,29 @@ necessary for implementing an older vers
 <li>Usages of non-existent GeoAPI interfaces are replaced by direct usages of the
     corresponding Apache SIS implementation.</li>
+<h1 id="behavior">Behavioral differences between the branches</h1>
+<p>Some JDK7-specific features are reproduced on the JDK6 branch in an approximative
+which may cause some differences in the behavior:</p>
+<p>JDK7 branch creates <code>java.util.Locale</code> instances using <code>Locale.Builder</code>
inner class while the JDK6 branch
+    uses the <code>Locale</code> constructor. Since the former performs more
rigorous syntax checks than the later,
+    some language strings accepted by the JDK6 branch may be rejected by the JDK7 branch.
For example the
+    "<code>en_US_WIN</code>" string will be rejected on the JDK7 branch because
"<code>WIN</code>" is not a valid locale variant.</p>
+<p>Some exception types do not exist on the JDK6 branch, for instance <code>java.util.IllformedLocaleException</code>.
+    The JDK6 branch replaces those types by their nearest parent, which may be <code>java.lang.RuntimeException</code>.</p>
+<p>Some verbose <em>multi-catches</em> are replaced by a single catch of
a broad type like <code>Exception</code>.
+    Consequently some exceptions that would be propagated on the JDK7 branch are caught on
the JDK6 branch.
+    Since such propagated exceptions are expected to be bugs, the broad exception handling
on JDK6 branch
+    may make some potential SIS bugs slightly more difficult to identify.</p>
+<p>Generally speaking, the JDK7 branch is slightly stricter than the JDK6 branch is.
+Regarding all above points, the trunk is identical to the JDK6 branch.</p>
 <h1 id="recommendations">Coding recommendations</h1>
 <p>The following recommendations aim to make the merges easier by reducing the extend
of potential conflicts.</p>
 <h2 id="formatting">Formatting</h2>

View raw message