sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From desruisse...@apache.org
Subject svn commit: r1650087 - in /sis/branches/JDK8: ./ core/sis-referencing/src/main/java/org/apache/sis/geometry/ core/sis-referencing/src/main/java/org/apache/sis/parameter/ core/sis-utility/src/main/java/org/apache/sis/util/iso/
Date Wed, 07 Jan 2015 15:36:53 GMT
Author: desruisseaux
Date: Wed Jan  7 15:36:53 2015
New Revision: 1650087

URL: http://svn.apache.org/r1650087
Log:
Re-enable custom doclet and fix more javadoc warnings.

Modified:
    sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/geometry/Envelopes.java
    sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/parameter/DefaultParameterDescriptor.java
    sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/parameter/DefaultParameterDescriptorGroup.java
    sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/Types.java
    sis/branches/JDK8/pom.xml

Modified: sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/geometry/Envelopes.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/geometry/Envelopes.java?rev=1650087&r1=1650086&r2=1650087&view=diff
==============================================================================
--- sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/geometry/Envelopes.java
[UTF-8] (original)
+++ sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/geometry/Envelopes.java
[UTF-8] Wed Jan  7 15:36:53 2015
@@ -420,16 +420,16 @@ public final class Envelopes extends Sta
      * Transforms an envelope using the given {@linkplain CoordinateOperation coordinate
operation}.
      * The transformation is only approximative: the returned envelope may be bigger than
the
      * smallest possible bounding box, but should not be smaller in most cases.
-     * <p>
-     * This method can handle the case where the envelope contains the North or South pole,
-     * or when it cross the &plusmn;180&deg; longitude.
      *
-     * {@note If the envelope CRS is non-null, then the caller should ensure that the operation
-     * source CRS is the same than the envelope CRS. In case of mismatch, this method transforms
-     * the envelope to the operation source CRS before to apply the operation. This extra
step
-     * may cause a lost of accuracy. In order to prevent this method from performing such
-     * pre-transformation (if not desired), callers can ensure that the envelope CRS is
-     * <code>null</code> before to call this method.}
+     * <p>This method can handle the case where the envelope contains the North or
South pole,
+     * or when it cross the ±180° longitude.</p>
+     *
+     * <div class="note"><b>Note:</b>
+     * If the envelope CRS is non-null, then the caller should ensure that the operation
source CRS
+     * is the same than the envelope CRS. In case of mismatch, this method transforms the
envelope
+     * to the operation source CRS before to apply the operation. This extra step may cause
a lost
+     * of accuracy. In order to prevent this method from performing such pre-transformation
(if not desired),
+     * callers can ensure that the envelope CRS is {@code null} before to call this method.</div>
      *
      * @param  operation The operation to use.
      * @param  envelope Envelope to transform, or {@code null}. This envelope will not be
modified.

Modified: sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/parameter/DefaultParameterDescriptor.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/parameter/DefaultParameterDescriptor.java?rev=1650087&r1=1650086&r2=1650087&view=diff
==============================================================================
--- sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/parameter/DefaultParameterDescriptor.java
[UTF-8] (original)
+++ sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/parameter/DefaultParameterDescriptor.java
[UTF-8] Wed Jan  7 15:36:53 2015
@@ -115,7 +115,7 @@ public class DefaultParameterDescriptor<
 
     /**
      * Constructs a descriptor from the given properties. The properties map is given unchanged
to the
-     * {@linkplain AbstractParameterDescriptor#AbstractParameterDescriptor(Map) super-class
constructor}.
+     * {@linkplain AbstractParameterDescriptor#AbstractParameterDescriptor(Map, int, int)
super-class constructor}.
      * The following table is a reminder of main (not all) properties:
      *
      * <table class="sis">
@@ -141,7 +141,7 @@ public class DefaultParameterDescriptor<
      *     <td>{@link #getIdentifiers()}</td>
      *   </tr>
      *   <tr>
-     *     <td>{@value org.apache.sis.parameter.AbstractParameterDescriptor#DESCRIPTION_KEY}</td>
+     *     <td>{@value org.opengis.metadata.Identifier#DESCRIPTION_KEY}</td>
      *     <td>{@link org.opengis.util.InternationalString} or {@link String}</td>
      *     <td>{@link #getDescription()}</td>
      *   </tr>

Modified: sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/parameter/DefaultParameterDescriptorGroup.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/parameter/DefaultParameterDescriptorGroup.java?rev=1650087&r1=1650086&r2=1650087&view=diff
==============================================================================
--- sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/parameter/DefaultParameterDescriptorGroup.java
[UTF-8] (original)
+++ sis/branches/JDK8/core/sis-referencing/src/main/java/org/apache/sis/parameter/DefaultParameterDescriptorGroup.java
[UTF-8] Wed Jan  7 15:36:53 2015
@@ -103,7 +103,7 @@ public class DefaultParameterDescriptorG
 
     /**
      * Constructs a parameter group from a set of properties. The properties map is given
unchanged to the
-     * {@linkplain AbstractParameterDescriptor#AbstractParameterDescriptor(Map) super-class
constructor}.
+     * {@linkplain AbstractParameterDescriptor#AbstractParameterDescriptor(Map, int, int)
super-class constructor}.
      * The following table is a reminder of main (not all) properties:
      *
      * <table class="sis">
@@ -129,7 +129,7 @@ public class DefaultParameterDescriptorG
      *     <td>{@link #getIdentifiers()}</td>
      *   </tr>
      *   <tr>
-     *     <td>{@value org.apache.sis.parameter.AbstractParameterDescriptor#DESCRIPTION_KEY}</td>
+     *     <td>{@value org.opengis.metadata.Identifier#DESCRIPTION_KEY}</td>
      *     <td>{@link org.opengis.util.InternationalString} or {@link String}</td>
      *     <td>{@link #getDescription()}</td>
      *   </tr>

Modified: sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/Types.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/Types.java?rev=1650087&r1=1650086&r2=1650087&view=diff
==============================================================================
--- sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/Types.java [UTF-8]
(original)
+++ sis/branches/JDK8/core/sis-utility/src/main/java/org/apache/sis/util/iso/Types.java [UTF-8]
Wed Jan  7 15:36:53 2015
@@ -436,9 +436,9 @@ public final class Types extends Static
      * Note that the size of the returned array may growth between different invocations
of this method,
      * since users can add their own codes to an existing list.
      *
-     * {@note This method works with both <code>Enum</code> and <code>CodeList</code>.
However if the type
-     *        is known to be an <code>Enum</code>, then the standard <code>Class.getEnumConstants()</code>
-     *        method is more efficient.}
+     * <div class="note"><b>Note:</b>
+     * This method works with both {@link Enum} and {@link CodeList}. However if the type
is known to be an
+     * {@code Enum}, then the standard {@link Class#getEnumConstants()} method is more efficient.</div>
      *
      * @param <T> The compile-time type given as the {@code codeType} parameter.
      * @param codeType The type of code list or enumeration.

Modified: sis/branches/JDK8/pom.xml
URL: http://svn.apache.org/viewvc/sis/branches/JDK8/pom.xml?rev=1650087&r1=1650086&r2=1650087&view=diff
==============================================================================
--- sis/branches/JDK8/pom.xml (original)
+++ sis/branches/JDK8/pom.xml Wed Jan  7 15:36:53 2015
@@ -587,7 +587,6 @@ Apache SIS is a free software, Java lang
           <excludePackageNames>org.apache.sis.internal:org.apache.sis.util.resources:org.apache.sis.referencing.operation.provider:com</excludePackageNames>
 
           <!-- Custom taglets, some of them implemented in Java. -->
-<!--
           <tags>
             <tag><placement>t</placement> <name>goal</name>
    <head>Maven goal:</head></tag>
             <tag><placement>t</placement> <name>phase</name>
   <head>Maven phase:</head></tag>
@@ -611,7 +610,6 @@ Apache SIS is a free software, Java lang
             <artifactId>sis-build-helper</artifactId>
             <version>${sis.plugin.version}</version>
           </docletArtifact>
--->
         </configuration>
       </plugin>
 



Mime
View raw message