sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From desruisse...@apache.org
Subject svn commit: r1572252 [2/2] - in /sis/branches/JDK7: core/sis-metadata/src/main/java/org/apache/sis/internal/jaxb/code/ core/sis-metadata/src/main/java/org/apache/sis/internal/jaxb/gml/ core/sis-metadata/src/main/java/org/apache/sis/io/wkt/ core/sis-met...
Date Wed, 26 Feb 2014 21:02:25 GMT
Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultCompoundCRS.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultCompoundCRS.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultCompoundCRS.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultCompoundCRS.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -52,7 +52,7 @@ import static org.apache.sis.internal.re
  * This class is often used for defining 4-dimensional (<var>x</var>,<var>y</var>,<var>z</var>,<var>t</var>)
  * coordinate reference systems as an aggregation of simpler CRS. Below is two examples of such aggregations:
  *
- * <p><table class="compact">
+ * <table class="compact">
  * <tr><th>Flat list</th><th>Hierarchical structure</th></tr>
  * <tr><td><blockquote>
  *   <code>CompoundCRS</code> — (<var>x</var>, <var>y</var>, <var>z</var>, <var>t</var>)<br>
@@ -66,7 +66,7 @@ import static org.apache.sis.internal.re
  *   <code>  │   └─VerticalCRS</code> — (<var>z</var>)<br>
  *   <code>  └─TemporalCRS</code> — (<var>t</var>)
  * </blockquote></td></tr>
- * </table></p>
+ * </table>
  *
  * Strictly speaking, only the flat list on the left side is allowed by OGC/ISO specifications.
  * However Apache SIS relaxes this rule by allowing hierarchies as shown on the right side. This
@@ -256,9 +256,10 @@ public class DefaultCompoundCRS extends 
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code CompoundCRS.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>CompoundCRS</code> sub-interface. Overriding possibility is left mostly for
-     *        implementors who wish to extend GeoAPI with their own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code CompoundCRS}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with their
+     * own set of interfaces.</div>
      *
      * @return {@code CompoundCRS.class} or a user-defined sub-interface.
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultEngineeringCRS.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultEngineeringCRS.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultEngineeringCRS.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultEngineeringCRS.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -189,9 +189,10 @@ public class DefaultEngineeringCRS exten
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code EngineeringCRS.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>EngineeringCRS</code> sub-interface. Overriding possibility is left mostly for
-     *        implementors who wish to extend GeoAPI with their own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code EngineeringCRS}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with their
+     * own set of interfaces.</div>
      *
      * @return {@code EngineeringCRS.class} or a user-defined sub-interface.
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultGeocentricCRS.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultGeocentricCRS.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultGeocentricCRS.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultGeocentricCRS.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -179,9 +179,10 @@ public class DefaultGeocentricCRS extend
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code GeocentricCRS.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>GeocentricCRS</code> sub-interface. Overriding possibility is left mostly for
-     *        implementors who wish to extend GeoAPI with their own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code GeocentricCRS}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with their
+     * own set of interfaces.</div>
      *
      * @return {@code GeocentricCRS.class} or a user-defined sub-interface.
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultGeographicCRS.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultGeographicCRS.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultGeographicCRS.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultGeographicCRS.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -150,9 +150,10 @@ public class DefaultGeographicCRS extend
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code GeographicCRS.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>GeographicCRS</code> sub-interface. Overriding possibility is left mostly for
-     *        implementors who wish to extend GeoAPI with their own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code GeographicCRS}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with their
+     * own set of interfaces.</div>
      *
      * @return {@code GeographicCRS.class} or a user-defined sub-interface.
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultImageCRS.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultImageCRS.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultImageCRS.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultImageCRS.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -171,9 +171,10 @@ public class DefaultImageCRS extends Abs
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code ImageCRS.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>ImageCRS</code> sub-interface. Overriding possibility is left mostly for
-     *        implementors who wish to extend GeoAPI with their own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code ImageCRS}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with
+     * their own set of interfaces.</div>
      *
      * @return {@code ImageCRS.class} or a user-defined sub-interface.
      */
@@ -255,7 +256,8 @@ public class DefaultImageCRS extends Abs
     /**
      * Formats this CRS as a <cite>Well Known Text</cite> {@code ImageCRS[…]} element.
      *
-     * {@note <code>ImageCRS</code> are defined in the WKT 2 specification only.}
+     * <div class="note"><b>Compatibility note:</b>
+     * {@code ImageCRS} are defined in the WKT 2 specification only.</div>
      *
      * @return {@code "ImageCRS"}.
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultTemporalCRS.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultTemporalCRS.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultTemporalCRS.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultTemporalCRS.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -192,9 +192,10 @@ public class DefaultTemporalCRS extends 
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code TemporalCRS.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>TemporalCRS</code> sub-interface. Overriding possibility is left mostly for
-     *        implementors who wish to extend GeoAPI with their own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code TemporalCRS}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with their
+     * own set of interfaces.</div>
      *
      * @return {@code TemporalCRS.class} or a user-defined sub-interface.
      */
@@ -298,7 +299,8 @@ public class DefaultTemporalCRS extends 
     /**
      * Formats this CRS as a <cite>Well Known Text</cite> {@code TimeCRS[…]} element.
      *
-     * {@note <code>TimeCRS</code> is defined in the WKT 2 specification only.}
+     * <div class="note"><b>Compatibility note:</b>
+     * {@code TimeCRS} is defined in the WKT 2 specification only.</div>
      *
      * @return {@code "TimeCRS"}.
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultVerticalCRS.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultVerticalCRS.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultVerticalCRS.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/crs/DefaultVerticalCRS.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -171,9 +171,10 @@ public class DefaultVerticalCRS extends 
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code VerticalCRS.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>VerticalCRS</code> sub-interface. Overriding possibility is left mostly for
-     *        implementors who wish to extend GeoAPI with their own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code VerticalCRS}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with their
+     * own set of interfaces.</div>
      *
      * @return {@code VerticalCRS.class} or a user-defined sub-interface.
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/AbstractCS.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/AbstractCS.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/AbstractCS.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/AbstractCS.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -429,7 +429,8 @@ public class AbstractCS extends Abstract
      * }
      * </font></blockquote>
      *
-     * {@note <code>CS</code> is defined in the WKT 2 specification only.}
+     * <div class="note"><b>Compatibility note:</b>
+     * {@code CS} is defined in the WKT 2 specification only.</div>
      *
      * @return {@code "CS"}.
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/AxesConvention.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/AxesConvention.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/AxesConvention.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/AxesConvention.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -103,8 +103,9 @@ public enum AxesConvention {
      *   <li>Temporal units are set to {@link javax.measure.unit.NonSI#DAY}.</li>
      * </ul>
      *
-     * {@note The rules for normalized coordinate systems may be adjusted in future SIS versions based on experience
-     *        gained. For more predictable results, consider using the <code>RIGHT_HANDED</code> enum instead.}
+     * <div class="note"><b>Note:</b>
+     * The rules for normalized coordinate systems may be adjusted in future SIS versions based on experience gained.
+     * For more predictable results, consider using the {@link #RIGHT_HANDED} enum instead.</div>
      *
      * @see org.apache.sis.referencing.CommonCRS#normalizedGeographic()
      */
@@ -120,22 +121,22 @@ public enum AxesConvention {
      * does not guarantee that longitude or <var>x</var> axis will be first in every cases. The most notable exception
      * is the (North, West) case.</p>
      *
-     * {@note We do not provide a "<cite>longitude or <var>x</var> axis first</cite>" enumeration value because
-     *        such criterion is hard to apply to inter-cardinal directions and has no meaning for map projections
-     *        over a pole, while the right-handed rule can apply everywhere.}
-     *
-     * {@example The following table lists some axis orientations in the first column, and
-     *           how those axes are reordered in a right-handed coordinate system (second column):
-     * <ul>
-     *   <table class="sis">
-     *     <tr><th>Left-handed</th>   <th>Right-handed</th>  <th>Remarks</th></tr>
-     *     <tr><td>(North, East)</td> <td>(East, North)</td> <td>This is the most common case.</td></tr>
-     *     <tr><td>(West, North)</td> <td>(North, West)</td> <td>This right-handed system has latitude first.</td></tr>
-     *     <tr><td>(South, West)</td> <td>(West, South)</td> <td>Used for the mapping of southern Africa.</td></tr>
-     *     <tr><td>(South along 0°,<br>South along 90° West)</td>
-     *         <td>(South along 90° West,<br>South along 0°)</td> <td>Can be used for the mapping of North pole.</td></tr>
-     *   </table>
-     * </ul>}
+     * <div class="note"><b>Note:</b>
+     * We do not provide a "<cite>longitude or <var>x</var> axis first</cite>" enumeration value because such
+     * criterion is hard to apply to inter-cardinal directions and has no meaning for map projections over a pole,
+     * while the right-handed rule can apply everywhere.</div>
+     *
+     * <div class="note"><b>Example:</b>
+     * The following table lists some axis orientations in the first column, and
+     * how those axes are reordered in a right-handed coordinate system (second column):
+     * <table class="sis">
+     *   <tr><th>Left-handed</th>   <th>Right-handed</th>  <th>Remarks</th></tr>
+     *   <tr><td>(North, East)</td> <td>(East, North)</td> <td>This is the most common case.</td></tr>
+     *   <tr><td>(West, North)</td> <td>(North, West)</td> <td>This right-handed system has latitude first.</td></tr>
+     *   <tr><td>(South, West)</td> <td>(West, South)</td> <td>Used for the mapping of southern Africa.</td></tr>
+     *   <tr><td>(South along 0°,<br>South along 90° West)</td>
+     *       <td>(South along 90° West,<br>South along 0°)</td> <td>Can be used for the mapping of North pole.</td></tr>
+     * </table></div>
      *
      * @see org.apache.sis.referencing.cs.CoordinateSystems#angle(AxisDirection, AxisDirection)
      * @see <a href="http://en.wikipedia.org/wiki/Right_hand_rule">Right-hand rule on Wikipedia</a>

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultCartesianCS.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultCartesianCS.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultCartesianCS.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultCartesianCS.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -206,9 +206,10 @@ public class DefaultCartesianCS extends 
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code CartesianCS.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>CartesianCS</code> sub-interface. Overriding possibility is left mostly for
-     *        implementors who wish to extend GeoAPI with their own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code CartesianCS}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with their
+     * own set of interfaces.</div>
      *
      * @return {@code CartesianCS.class} or a user-defined sub-interface.
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultCoordinateSystemAxis.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultCoordinateSystemAxis.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultCoordinateSystemAxis.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultCoordinateSystemAxis.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -379,9 +379,10 @@ public class DefaultCoordinateSystemAxis
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code CoordinateSystemAxis.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>CoordinateSystemAxis</code> sub-interface. Overriding possibility is left mostly
-     *        for implementors who wish to extend GeoAPI with their own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code CoordinateSystemAxis}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with their own
+     * set of interfaces.</div>
      *
      * @return {@code CoordinateSystemAxis.class} or a user-defined sub-interface.
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultCylindricalCS.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultCylindricalCS.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultCylindricalCS.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultCylindricalCS.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -177,9 +177,10 @@ public class DefaultCylindricalCS extend
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code CylindricalCS.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>CylindricalCS</code> sub-interface. Overriding possibility is left mostly for
-     *        implementors who wish to extend GeoAPI with their own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code CylindricalCS}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with their
+     * own set of interfaces.</div>
      *
      * @return {@code CylindricalCS.class} or a user-defined sub-interface.
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultEllipsoidalCS.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultEllipsoidalCS.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultEllipsoidalCS.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultEllipsoidalCS.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -202,9 +202,10 @@ public class DefaultEllipsoidalCS extend
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code EllipsoidalCS.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>EllipsoidalCS</code> sub-interface. Overriding possibility is left mostly for
-     *        implementors who wish to extend GeoAPI with their own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code EllipsoidalCS}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with their
+     * own set of interfaces.</div>
      *
      * @return {@code EllipsoidalCS.class} or a user-defined sub-interface.
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultLinearCS.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultLinearCS.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultLinearCS.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultLinearCS.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -170,9 +170,10 @@ public class DefaultLinearCS extends Abs
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code LinearCS.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>LinearCS</code> sub-interface. Overriding possibility is left mostly for
-     *        implementors who wish to extend GeoAPI with their own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code LinearCS}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with
+     * their own set of interfaces.</div>
      *
      * @return {@code LinearCS.class} or a user-defined sub-interface.
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultPolarCS.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultPolarCS.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultPolarCS.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultPolarCS.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -173,9 +173,10 @@ public class DefaultPolarCS extends Abst
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code PolarCS.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>PolarCS</code> sub-interface. Overriding possibility is left mostly for
-     *        implementors who wish to extend GeoAPI with their own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code PolarCS}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with
+     * their own set of interfaces.</div>
      *
      * @return {@code PolarCS.class} or a user-defined sub-interface.
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultSphericalCS.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultSphericalCS.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultSphericalCS.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultSphericalCS.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -177,9 +177,10 @@ public class DefaultSphericalCS extends 
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code SphericalCS.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>SphericalCS</code> sub-interface. Overriding possibility is left mostly for
-     *        implementors who wish to extend GeoAPI with their own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code SphericalCS}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with their
+     * own set of interfaces.</div>
      *
      * @return {@code SphericalCS.class} or a user-defined sub-interface.
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultTimeCS.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultTimeCS.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultTimeCS.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultTimeCS.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -170,9 +170,10 @@ public class DefaultTimeCS extends Abstr
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code TimeCS.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>TimeCS</code> sub-interface. Overriding possibility is left mostly for
-     *        implementors who wish to extend GeoAPI with their own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code TimeCS}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with
+     * their own set of interfaces.</div>
      *
      * @return {@code TimeCS.class} or a user-defined sub-interface.
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultUserDefinedCS.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultUserDefinedCS.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultUserDefinedCS.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultUserDefinedCS.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -167,9 +167,10 @@ public class DefaultUserDefinedCS extend
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code UserDefinedCS.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>UserDefinedCS</code> sub-interface. Overriding possibility is left mostly for
-     *        implementors who wish to extend GeoAPI with their own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code UserDefinedCS}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with their
+     * own set of interfaces.</div>
      *
      * @return {@code UserDefinedCS.class} or a user-defined sub-interface.
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultVerticalCS.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultVerticalCS.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultVerticalCS.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DefaultVerticalCS.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -185,9 +185,10 @@ public class DefaultVerticalCS extends A
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code VerticalCS.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>VerticalCS</code> sub-interface. Overriding possibility is left mostly for
-     *        implementors who wish to extend GeoAPI with their own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code VerticalCS}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with
+     * their own set of interfaces.</div>
      *
      * @return {@code VerticalCS.class} or a user-defined sub-interface.
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DirectionAlongMeridian.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DirectionAlongMeridian.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DirectionAlongMeridian.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/cs/DirectionAlongMeridian.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -285,7 +285,8 @@ final class DirectionAlongMeridian exten
      * This element contains the meridian value and the unit of measurement.
      * The unit is currently fixed to degrees, but this may change in any future implementation.
      *
-     * {@note <code>Meridian</code> is defined in the WKT 2 specification only.}
+     * <div class="note"><b>Compatibility note:</b>
+     * {@code Meridian} is defined in the WKT 2 specification only.</div>
      *
      * @param  formatter The formatter where to format the inner content of this WKT element.
      * @return {@code "Meridian"}.

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/BursaWolfParameters.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/BursaWolfParameters.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/BursaWolfParameters.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/BursaWolfParameters.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -50,9 +50,10 @@ import java.util.Objects;
  * where the <var>X</var> axis points towards the Greenwich Prime Meridian,
  * the <var>Y</var> axis points East, and the <var>Z</var> axis points North.</p>
  *
- * {@note The upper case letters are intentional. By convention, (<var>X</var>, <var>Y</var>, <var>Z</var>)
- *        stand for <cite>geocentric</cite> coordinates while (<var>x</var>, <var>y</var>, <var>z</var>)
- *        stand for <cite>projected</cite> coordinates.}
+ * <div class="note"><b>Note:</b>
+ * The upper case letters are intentional. By convention, (<var>X</var>, <var>Y</var>, <var>Z</var>)
+ * stand for <cite>geocentric</cite> coordinates while (<var>x</var>, <var>y</var>, <var>z</var>)
+ * stand for <cite>projected</cite> coordinates.</div>
  *
  * The "Bursa-Wolf" formula is expressed with 7 parameters, listed in the table below.
  * The <cite>code</cite>, <cite>name</cite> and <cite>abbreviation</cite> columns list EPSG identifiers,
@@ -157,8 +158,9 @@ import java.util.Objects;
  *       can been found in the EPSG database for a given pair of source and target CRS.</li>
  * </ol>
  *
- * {@note In EPSG terminology, Apache SIS gives precedence to the <cite>late-binding</cite> approach
- *        (case 1 above) over the <cite>early-binding</cite> approach (case 3 above).}
+ * <div class="note"><b>Note:</b>
+ * In EPSG terminology, Apache SIS gives precedence to the <cite>late-binding</cite> approach
+ * (case 1 above) over the <cite>early-binding</cite> approach (case 3 above).</div>
  *
  * @author  Martin Desruisseaux (IRD, Geomatys)
  * @since   0.4 (derived from geotk-1.2)
@@ -624,7 +626,8 @@ public class BursaWolfParameters extends
      * <blockquote><code>TOWGS84[{@linkplain #tX}, {@linkplain #tY}, {@linkplain #tZ}, {@linkplain #rX},
      * {@linkplain #rY}, {@linkplain #rZ}, {@linkplain #dS}]</code></blockquote>
      *
-     * {@note <code>TOWGS84</code> is defined in the WKT 1 specification only.}
+     * <div class="note"><b>Compatibility note:</b>
+     * {@code TOWGS84} is defined in the WKT 1 specification only.</div>
      *
      * The element name is {@code "ToWGS84"} in the common case where the {@linkplain #getTargetDatum() target datum}
      * is WGS 84. For other targets, the element name will be derived from the datum name.

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultEllipsoid.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultEllipsoid.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultEllipsoid.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultEllipsoid.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -373,9 +373,10 @@ public class DefaultEllipsoid extends Ab
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code Ellipsoid.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>Ellipsoid</code> sub-interface. This method may be overridden if an implementor
-     *        extended GeoAPI with his own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code Ellipsoid}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with
+     * their own set of interfaces.</div>
      *
      * @return {@code Ellipsoid.class} or a user-defined sub-interface.
      */
@@ -598,8 +599,9 @@ public class DefaultEllipsoid extends Ab
      * The orthodromic distance is the shortest distance between two points on a ellipsoid's surface.
      * The orthodromic path is always on a great circle.
      *
-     * {@note Orthodromic distances anre different than the <cite>loxodromic distance</cite>.
-     *        The later is a longer distance on a path with a constant direction on the compass.}
+     * <div class="note"><b>Note:</b>
+     * Orthodromic distances are different than the <cite>loxodromic distance</cite>.
+     * The later is a longer distance on a path with a constant direction on the compass.</div>
      *
      * @param  λ1 Longitude of first  point (in decimal degrees).
      * @param  φ1 Latitude  of first  point (in decimal degrees).

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultEngineeringDatum.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultEngineeringDatum.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultEngineeringDatum.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultEngineeringDatum.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -151,9 +151,10 @@ public class DefaultEngineeringDatum ext
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code EngineeringDatum.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>EngineeringDatum</code> sub-interface. Overriding possibility is left mostly
-     *        for implementors who wish to extend GeoAPI with their own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code EngineeringDatum}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with their
+     * own set of interfaces.</div>
      *
      * @return {@code EngineeringDatum.class} or a user-defined sub-interface.
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultGeodeticDatum.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultGeodeticDatum.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultGeodeticDatum.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultGeodeticDatum.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -294,9 +294,10 @@ public class DefaultGeodeticDatum extend
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code GeodeticDatum.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>GeodeticDatum</code> sub-interface. Overriding possibility is left mostly for
-     *        implementors who wish to extend GeoAPI with their own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code GeodeticDatum}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with their
+     * own set of interfaces.</div>
      *
      * @return {@code GeodeticDatum.class} or a user-defined sub-interface.
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultImageDatum.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultImageDatum.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultImageDatum.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultImageDatum.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -170,9 +170,10 @@ public class DefaultImageDatum extends A
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code ImageDatum.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>ImageDatum</code> sub-interface. Overriding possibility is left mostly for
-     *        implementors who wish to extend GeoAPI with their own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code ImageDatum}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with
+     * their own set of interfaces.</div>
      *
      * @return {@code ImageDatum.class} or a user-defined sub-interface.
      */
@@ -233,7 +234,8 @@ public class DefaultImageDatum extends A
     /**
      * Formats this datum as a <cite>Well Known Text</cite> {@code ImageDatum[…]} element.
      *
-     * {@note <code>ImageDatum</code> is defined in the WKT 2 specification only.}
+     * <div class="note"><b>Compatibility note:</b>
+     * {@code ImageDatum} is defined in the WKT 2 specification only.</div>
      *
      * @return {@code "ImageDatum"}.
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultPrimeMeridian.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultPrimeMeridian.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultPrimeMeridian.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultPrimeMeridian.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -201,9 +201,10 @@ public class DefaultPrimeMeridian extend
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code PrimeMeridian.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>PrimeMeridian</code> sub-interface. Overriding possibility is left mostly for
-     *        implementors who wish to extend GeoAPI with their own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code PrimeMeridian}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with their
+     * own set of interfaces.</div>
      *
      * @return {@code PrimeMeridian.class} or a user-defined sub-interface.
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultTemporalDatum.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultTemporalDatum.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultTemporalDatum.java (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultTemporalDatum.java Wed Feb 26 21:02:23 2014
@@ -203,9 +203,10 @@ public class DefaultTemporalDatum extend
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code TemporalDatum.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>TemporalDatum</code> sub-interface. Overriding possibility is left mostly for
-     *        implementors who wish to extend GeoAPI with their own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code TemporalDatum}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with their
+     * own set of interfaces.</div>
      *
      * @return {@code TemporalDatum.class} or a user-defined sub-interface.
      */
@@ -277,7 +278,8 @@ public class DefaultTemporalDatum extend
     /**
      * Formats this datum as a <cite>Well Known Text</cite> {@code TimeDatum[…]} element.
      *
-     * {@note <code>TimeDatum</code> is defined in the WKT 2 specification only.}
+     * <div class="note"><b>Compatibility note:</b>
+     * {@code TimeDatum} is defined in the WKT 2 specification only.</div>
      *
      * @return {@code "TimeDatum"}.
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultVerticalDatum.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultVerticalDatum.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultVerticalDatum.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/datum/DefaultVerticalDatum.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -203,9 +203,10 @@ public class DefaultVerticalDatum extend
      * Returns the GeoAPI interface implemented by this class.
      * The SIS implementation returns {@code VerticalDatum.class}.
      *
-     * {@note Subclasses usually do not need to override this method since GeoAPI does not define
-     *        <code>VerticalDatum</code> sub-interface. Overriding possibility is left mostly for
-     *        implementors who wish to extend GeoAPI with their own set of interfaces.}
+     * <div class="note"><b>Note for implementors:</b>
+     * Subclasses usually do not need to override this method since GeoAPI does not define {@code VerticalDatum}
+     * sub-interface. Overriding possibility is left mostly for implementors who wish to extend GeoAPI with their
+     * own set of interfaces.</div>
      *
      * @return {@code VerticalDatum.class} or a user-defined sub-interface.
      */
@@ -308,10 +309,11 @@ public class DefaultVerticalDatum extend
     /**
      * Formats this datum as a <cite>Well Known Text</cite> {@code VerticalDatum[…]} element.
      *
-     * {@note OGC 01-009 defined numerical codes for various vertical datum types, for example 2005 for geoidal height
-     *        and 2002 for ellipsoidal height. Such codes were formatted for all <code>Datum</code> subtypes in WKT 1.
-     *        Datum types became provided only for vertical datum in the ISO 19111:2003 specification, then removed
-     *        completely in ISO 19111:2007.}
+     * <div class="note"><b>Compatibility note:</b>
+     * OGC 01-009 defined numerical codes for various vertical datum types, for example 2005 for geoidal height
+     * and 2002 for ellipsoidal height. Such codes were formatted for all <code>Datum</code> subtypes in WKT 1.
+     * Datum types became provided only for vertical datum in the ISO 19111:2003 specification, then removed
+     * completely in ISO 19111:2007.</div>
      *
      * @return {@code "VerticalDatum"} (WKT 2) or {@code "Vert_Datum"} (WKT 1).
      */

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/matrix/Matrices.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/matrix/Matrices.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/matrix/Matrices.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/matrix/Matrices.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -82,11 +82,10 @@ public final class Matrices extends Stat
      * Creates a square identity matrix of size {@code size} × {@code size}.
      * Elements on the diagonal (<var>j</var> == <var>i</var>) are set to 1.
      *
-     * <blockquote><font size=-1><b>Implementation note:</b>
+     * <div class="note"><b>Implementation note:</b>
      * For sizes between {@value org.apache.sis.referencing.operation.matrix.Matrix1#SIZE} and
      * {@value org.apache.sis.referencing.operation.matrix.Matrix4#SIZE} inclusive, the matrix
-     * is guaranteed to be an instance of one of {@link Matrix1} … {@link Matrix4} subtypes.
-     * </font></blockquote>
+     * is guaranteed to be an instance of one of {@link Matrix1} … {@link Matrix4} subtypes.</div>
      *
      * @param  size Numbers of row and columns. For an affine transform matrix, this is the number of
      *         {@linkplain MathTransform#getSourceDimensions() source} and
@@ -108,12 +107,11 @@ public final class Matrices extends Stat
      * Elements on the diagonal (<var>j</var> == <var>i</var>) are set to 1.
      * The result is an identity matrix if {@code numRow} = {@code numCol}.
      *
-     * <blockquote><font size=-1><b>Implementation note:</b>
+     * <div class="note"><b>Implementation note:</b>
      * For {@code numRow} == {@code numCol} with a value between
      * {@value org.apache.sis.referencing.operation.matrix.Matrix1#SIZE} and
      * {@value org.apache.sis.referencing.operation.matrix.Matrix4#SIZE} inclusive, the matrix
-     * is guaranteed to be an instance of one of {@link Matrix1} … {@link Matrix4} subtypes.
-     * </font></blockquote>
+     * is guaranteed to be an instance of one of {@link Matrix1} … {@link Matrix4} subtypes.</div>
      *
      * @param numRow For a math transform, this is the number of {@linkplain MathTransform#getTargetDimensions() target dimensions} + 1.
      * @param numCol For a math transform, this is the number of {@linkplain MathTransform#getSourceDimensions() source dimensions} + 1.
@@ -131,12 +129,11 @@ public final class Matrices extends Stat
      * Creates a matrix of size {@code numRow} × {@code numCol} filled with zero values.
      * This constructor is convenient when the caller wants to initialize the matrix elements himself.
      *
-     * <blockquote><font size=-1><b>Implementation note:</b>
+     * <div class="note"><b>Implementation note:</b>
      * For {@code numRow} == {@code numCol} with a value between
      * {@value org.apache.sis.referencing.operation.matrix.Matrix1#SIZE} and
      * {@value org.apache.sis.referencing.operation.matrix.Matrix4#SIZE} inclusive, the matrix
-     * is guaranteed to be an instance of one of {@link Matrix1} … {@link Matrix4} subtypes.
-     * </font></blockquote>
+     * is guaranteed to be an instance of one of {@link Matrix1} … {@link Matrix4} subtypes.</div>
      *
      * @param numRow For a math transform, this is the number of {@linkplain MathTransform#getTargetDimensions() target dimensions} + 1.
      * @param numCol For a math transform, this is the number of {@linkplain MathTransform#getSourceDimensions() source dimensions} + 1.
@@ -157,12 +154,11 @@ public final class Matrices extends Stat
      * Creates a matrix of size {@code numRow} × {@code numCol} initialized to the given elements.
      * The elements array size must be equals to {@code numRow*numCol}. Column indices vary fastest.
      *
-     * <blockquote><font size=-1><b>Implementation note:</b>
+     * <div class="note"><b>Implementation note:</b>
      * For {@code numRow} == {@code numCol} with a value between
      * {@value org.apache.sis.referencing.operation.matrix.Matrix1#SIZE} and
      * {@value org.apache.sis.referencing.operation.matrix.Matrix4#SIZE} inclusive, the matrix
-     * is guaranteed to be an instance of one of {@link Matrix1} … {@link Matrix4} subtypes.
-     * </font></blockquote>
+     * is guaranteed to be an instance of one of {@link Matrix1} … {@link Matrix4} subtypes.</div>
      *
      * @param  numRow   Number of rows.
      * @param  numCol   Number of columns.
@@ -661,11 +657,10 @@ public final class Matrices extends Stat
     /**
      * Creates a new matrix which is a copy of the given matrix.
      *
-     * <blockquote><font size=-1><b>Implementation note:</b>
+     * <div class="note"><b>Implementation note:</b>
      * For square matrix with a size between {@value org.apache.sis.referencing.operation.matrix.Matrix1#SIZE}
      * and {@value org.apache.sis.referencing.operation.matrix.Matrix4#SIZE} inclusive, the returned matrix is
-     * guaranteed to be an instance of one of {@link Matrix1} … {@link Matrix4} subtypes.
-     * </font></blockquote>
+     * guaranteed to be an instance of one of {@link Matrix1} … {@link Matrix4} subtypes.</div>
      *
      * @param matrix The matrix to copy, or {@code null}.
      * @return A copy of the given matrix, or {@code null} if the given matrix was null.
@@ -877,10 +872,11 @@ public final class Matrices extends Stat
      *   └                                                       ┘
      * }
      *
-     * {@note Formatting on a per-column basis is convenient for the kind of matrices used in referencing by coordinates,
-     *        because each column is typically a displacement vector in a different dimension of the source coordinate
-     *        reference system. In addition, the last column is often a translation vector having a magnitude very
-     *        different than the other columns.}
+     * <div class="note"><b>Note:</b>
+     * Formatting on a per-column basis is convenient for the kind of matrices used in referencing by coordinates,
+     * because each column is typically a displacement vector in a different dimension of the source coordinate
+     * reference system. In addition, the last column is often a translation vector having a magnitude very
+     * different than the other columns.</div>
      *
      * @param  matrix The matrix for which to get a string representation.
      * @return A string representation of the given matrix.

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/matrix/MismatchedMatrixSizeException.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/matrix/MismatchedMatrixSizeException.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/matrix/MismatchedMatrixSizeException.java (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/matrix/MismatchedMatrixSizeException.java Wed Feb 26 21:02:23 2014
@@ -22,9 +22,10 @@ import org.opengis.geometry.MismatchedDi
 /**
  * Thrown when two matrices can not be added or multiplied because the sizes do not match.
  *
- * {@note This exception extends <code>MismatchedDimensionException</code> because the matrices in this package
- *        are used in <cite>Coordinate Operation Steps</cite>, in which case a mismatched matrix size means that
- *        the operation involves two Coordinate Reference Systems of incompatible dimensions.}
+ * <div class="note"><b>Note:</b>
+ * This exception extends {@code MismatchedDimensionException} because the matrices in this package
+ * are used in <cite>Coordinate Operation Steps</cite>, in which case a mismatched matrix size means
+ * that the operation involves two Coordinate Reference Systems of incompatible dimensions.</div>
  *
  * @author  Martin Desruisseaux (Geomatys)
  * @since   0.4

Modified: sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/matrix/NoninvertibleMatrixException.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/matrix/NoninvertibleMatrixException.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/matrix/NoninvertibleMatrixException.java (original)
+++ sis/branches/JDK7/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/matrix/NoninvertibleMatrixException.java Wed Feb 26 21:02:23 2014
@@ -23,9 +23,10 @@ import org.opengis.referencing.operation
  * Thrown when a matrix can not be inverted.
  * This may be because the matrix is singular, or because the matrix is not square.
  *
- * {@note This exception extends <code>NoninvertibleTransformException</code> because the matrices in this package
- *        are used in <cite>Coordinate Operation Steps</cite>, in which case a singular matrix means that the
- *        operation is not invertible.}
+ * <div class="note"><b>Note:</b>
+ * This exception extends {@code NoninvertibleTransformException} because the matrices in this package
+ * are used in <cite>Coordinate Operation Steps</cite>, in which case a singular matrix means that the
+ * operation is not invertible.</div>
  *
  * @author  Martin Desruisseaux (Geomatys)
  * @since   0.4

Modified: sis/branches/JDK7/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/matrix/MatricesTest.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/matrix/MatricesTest.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/matrix/MatricesTest.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/matrix/MatricesTest.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -94,8 +94,9 @@ public final strictfp class MatricesTest
      * Tests {@link Matrices#createTransform(AxisDirection[], AxisDirection[])} with the same sequence of axes.
      * The result shall be an identity matrix.
      *
-     * {@note <code>Matrices.createTransform(AxisDirection[], AxisDirection[])</code> needs to be tested with
-     *        special care, because this method will be the most frequently invoked one when building CRS.}
+     * <div class="note"><b>Note:</b>
+     * {@code Matrices.createTransform(AxisDirection[], AxisDirection[])} needs to be tested with special care,
+     * because this method will be the most frequently invoked one when building CRS.</div>
      */
     @Test
     public void testCreateTransformWithSameAxes() {
@@ -114,8 +115,9 @@ public final strictfp class MatricesTest
      * Axes are moved in different positions, and some axes will have opposite directions.
      * However the number of axes stay the same.
      *
-     * {@note <code>Matrices.createTransform(AxisDirection[], AxisDirection[])</code> needs to be tested with
-     *        special care, because this method will be the most frequently invoked one when building CRS.}
+     * <div class="note"><b>Note:</b>
+     * {@code Matrices.createTransform(AxisDirection[], AxisDirection[])} needs to be tested with special care,
+     * because this method will be the most frequently invoked one when building CRS.</div>
      */
     @Test
     @DependsOnMethod("testCreateTransformWithSameAxes")
@@ -140,8 +142,9 @@ public final strictfp class MatricesTest
      * Tests {@link Matrices#createTransform(AxisDirection[], AxisDirection[])} with less axes
      * in the destination than in the source.
      *
-     * {@note <code>Matrices.createTransform(AxisDirection[], AxisDirection[])</code> needs to be tested with
-     *        special care, because this method will be the most frequently invoked one when building CRS.}
+     * <div class="note"><b>Note:</b>
+     * {@code Matrices.createTransform(AxisDirection[], AxisDirection[])} needs to be tested with special care,
+     * because this method will be the most frequently invoked one when building CRS.</div>
      */
     @Test
     @DependsOnMethod("testCreateTransformWithDifferentAxes")
@@ -164,8 +167,9 @@ public final strictfp class MatricesTest
      * Tests {@link Matrices#createTransform(AxisDirection[], AxisDirection[])} with the axis repeated twice.
      * This unusual, but shall nevertheless be supported.
      *
-     * {@note <code>Matrices.createTransform(AxisDirection[], AxisDirection[])</code> needs to be tested with
-     *        special care, because this method will be the most frequently invoked one when building CRS.}
+     * <div class="note"><b>Note:</b>
+     * {@code Matrices.createTransform(AxisDirection[], AxisDirection[])} needs to be tested with special care,
+     * because this method will be the most frequently invoked one when building CRS.</div>
      */
     @Test
     @DependsOnMethod("testCreateTransformWithLessAxes")
@@ -188,8 +192,9 @@ public final strictfp class MatricesTest
      * Tests that {@link Matrices#createTransform(AxisDirection[], AxisDirection[])}
      * throw an exception if a destination axis is not in the source.
      *
-     * {@note <code>Matrices.createTransform(AxisDirection[], AxisDirection[])</code> needs to be tested with
-     *        special care, because this method will be the most frequently invoked one when building CRS.}
+     * <div class="note"><b>Note:</b>
+     * {@code Matrices.createTransform(AxisDirection[], AxisDirection[])} needs to be tested with special care,
+     * because this method will be the most frequently invoked one when building CRS.</div>
      */
     @Test
     public void testCreateTransformWithAxisNotInSource() {
@@ -207,8 +212,9 @@ public final strictfp class MatricesTest
      * Tests that {@link Matrices#createTransform(AxisDirection[], AxisDirection[])}
      * throw an exception if the arguments contain colinear axis directions.
      *
-     * {@note <code>Matrices.createTransform(AxisDirection[], AxisDirection[])</code> needs to be tested with
-     *        special care, because this method will be the most frequently invoked one when building CRS.}
+     * <div class="note"><b>Note:</b>
+     * {@code Matrices.createTransform(AxisDirection[], AxisDirection[])} needs to be tested with special care,
+     * because this method will be the most frequently invoked one when building CRS.</div>
      */
     @Test
     public void testCreateTransformWithColinearAxes() {

Modified: sis/branches/JDK7/core/sis-utility/src/main/java/org/apache/sis/internal/jaxb/Context.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-utility/src/main/java/org/apache/sis/internal/jaxb/Context.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-utility/src/main/java/org/apache/sis/internal/jaxb/Context.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-utility/src/main/java/org/apache/sis/internal/jaxb/Context.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -289,7 +289,8 @@ public final class Context extends Marsh
      * The valid values are documented in the {@link org.apache.sis.xml.XML#SCHEMAS} property.
      * If the returned value is not empty, then this method guarantees it ends with {@code '/'}.
      *
-     * {@note This method is static for the convenience of performing the check for null context.}
+     * <div class="note"><b>API note:</b>
+     * This method is static for the convenience of performing the check for null context.</div>
      *
      * @param  context The current context, or {@code null} if none.
      * @param  key One of the value documented in the "<cite>Map key</cite>" column of
@@ -321,7 +322,8 @@ public final class Context extends Marsh
      * If no GML version were specified, then this method returns {@code true}, i.e. newest
      * version is assumed.
      *
-     * {@note This method is static for the convenience of performing the check for null context.}
+     * <div class="note"><b>API note:</b>
+     * This method is static for the convenience of performing the check for null context.</div>
      *
      * @param  context The current context, or {@code null} if none.
      * @param  version The version to compare to.
@@ -343,7 +345,8 @@ public final class Context extends Marsh
      * Returns the reference resolver in use for the current marshalling or unmarshalling process.
      * If no resolver were explicitely set, then this method returns {@link ReferenceResolver#DEFAULT}.
      *
-     * {@note This method is static for the convenience of performing the check for null context.}
+     * <div class="note"><b>API note:</b>
+     * This method is static for the convenience of performing the check for null context.</div>
      *
      * @param  context The current context, or {@code null} if none.
      * @return The current reference resolver (never null).
@@ -362,7 +365,8 @@ public final class Context extends Marsh
      * Returns the value converter in use for the current marshalling or unmarshalling process.
      * If no converter were explicitely set, then this method returns {@link ValueConverter#DEFAULT}.
      *
-     * {@note This method is static for the convenience of performing the check for null context.}
+     * <div class="note"><b>API note:</b>
+     * This method is static for the convenience of performing the check for null context.</div>
      *
      * @param  context The current context, or {@code null} if none.
      * @return The current value converter (never null).

Modified: sis/branches/JDK7/core/sis-utility/src/main/java/org/apache/sis/util/LenientComparable.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-utility/src/main/java/org/apache/sis/util/LenientComparable.java?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/core/sis-utility/src/main/java/org/apache/sis/util/LenientComparable.java [UTF-8] (original)
+++ sis/branches/JDK7/core/sis-utility/src/main/java/org/apache/sis/util/LenientComparable.java [UTF-8] Wed Feb 26 21:02:23 2014
@@ -110,7 +110,7 @@ public interface LenientComparable {
      * The strictness level is controlled by the second argument,
      * from stricter to more permissive values:
      *
-     * <p><table class="compact" >
+     * <table class="compact" >
      *   <tr><td>{@link ComparisonMode#STRICT STRICT}:</td>
      *        <td>All attributes of the compared objects shall be strictly equal.</td></tr>
      *   <tr><td>{@link ComparisonMode#BY_CONTRACT BY_CONTRACT}:</td>
@@ -122,7 +122,7 @@ public interface LenientComparable {
      *           with some tolerance threshold on numerical values.</td></tr>
      *   <tr><td>{@link ComparisonMode#DEBUG DEBUG}:</td>
      *        <td>Special mode for figuring out why two objects expected to be equal are not.</td></tr>
-     * </table></p>
+     * </table>
      *
      * {@section Conformance to the <code>equals(Object)</code> method contract}
      * {@link ComparisonMode#STRICT} is the only mode compliant with the {@link Object#equals(Object)} contract.

Modified: sis/branches/JDK7/src/main/javadoc/stylesheet.css
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/src/main/javadoc/stylesheet.css?rev=1572252&r1=1572251&r2=1572252&view=diff
==============================================================================
--- sis/branches/JDK7/src/main/javadoc/stylesheet.css (original)
+++ sis/branches/JDK7/src/main/javadoc/stylesheet.css Wed Feb 26 21:02:23 2014
@@ -69,6 +69,8 @@
 .contentContainer .block table.compact,
 .contentContainer ul.blockList ul.blockList li.blockList table.compact
 {
+  margin-top:     6pt;
+  margin-bottom:  6pt;
   width:          auto;
   border:         none;
   border-spacing: 0pt;
@@ -134,6 +136,16 @@ div.block pre {
   font-family: Andale Mono, Courier New, monospace;
 }
 
+/*
+ * Note, examples or warnings.
+ */
+div.note {
+  font-size: small;
+  margin-left:  30pt;
+  margin-top:    9pt;
+  margin-bottom: 9pt;
+}
+
 
 
 



Mime
View raw message