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 ±180° 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>
