You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@sis.apache.org by de...@apache.org on 2013/04/04 00:20:58 UTC
svn commit: r1464218 - in
/sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso:
./ acquisition/ citation/ constraint/ content/ distribution/ extent/
identification/ lineage/ maintenance/ quality/ spatial/
Author: desruisseaux
Date: Wed Apr 3 22:20:57 2013
New Revision: 1464218
URL: http://svn.apache.org/r1464218
Log:
Fixed erroneous javadoc: copy constructors do not accept null argument.
Modified:
sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/package-info.java
sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/citation/package-info.java
sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/constraint/package-info.java
sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/content/package-info.java
sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/distribution/package-info.java
sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/extent/package-info.java
sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/package-info.java
sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/lineage/package-info.java
sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/maintenance/package-info.java
sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/package-info.java
sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/quality/package-info.java
sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/spatial/package-info.java
Modified: sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/package-info.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/package-info.java?rev=1464218&r1=1464217&r2=1464218&view=diff
==============================================================================
--- sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/package-info.java [UTF-8] (original)
+++ sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/package-info.java [UTF-8] Wed Apr 3 22:20:57 2013
@@ -70,7 +70,7 @@
* </td></tr></table>
*
* {@section Collections and null values}
- * Unless otherwise noted in the Javadoc, all constructors and setter methods accept {@code null} argument.
+ * All constructors (except the <cite>copy constructor</cite>) and setter methods accept {@code null} arguments.
* A null argument value means that the metadata element can not be provided, and the reason for that is unspecified.
* Alternatively, users can specify why a metadata element is missing by providing a value created by
* {@link org.apache.sis.xml.NilReason#createNilObject NilReason.createNilObject(Class)}.
Modified: sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/citation/package-info.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/citation/package-info.java?rev=1464218&r1=1464217&r2=1464218&view=diff
==============================================================================
--- sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/citation/package-info.java [UTF-8] (original)
+++ sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/citation/package-info.java [UTF-8] Wed Apr 3 22:20:57 2013
@@ -65,7 +65,7 @@
* See {@link org.apache.sis.xml.IdentifierMap} for more information.
*
* {@section Collections and null values}
- * Unless otherwise noted in the Javadoc, all constructors and setter methods accept {@code null} argument.
+ * All constructors (except the <cite>copy constructor</cite>) and setter methods accept {@code null} arguments.
* A null argument value means that the metadata element can not be provided, and the reason for that is unspecified.
* Alternatively, users can specify why a metadata element is missing by providing a value created by
* {@link org.apache.sis.xml.NilReason#createNilObject NilReason.createNilObject(Class)}.
Modified: sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/constraint/package-info.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/constraint/package-info.java?rev=1464218&r1=1464217&r2=1464218&view=diff
==============================================================================
--- sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/constraint/package-info.java [UTF-8] (original)
+++ sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/constraint/package-info.java [UTF-8] Wed Apr 3 22:20:57 2013
@@ -44,7 +44,7 @@
* </td></tr></table>
*
* {@section Collections and null values}
- * Unless otherwise noted in the Javadoc, all constructors and setter methods accept {@code null} argument.
+ * All constructors (except the <cite>copy constructor</cite>) and setter methods accept {@code null} arguments.
* A null argument value means that the metadata element can not be provided, and the reason for that is unspecified.
* Alternatively, users can specify why a metadata element is missing by providing a value created by
* {@link org.apache.sis.xml.NilReason#createNilObject NilReason.createNilObject(Class)}.
Modified: sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/content/package-info.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/content/package-info.java?rev=1464218&r1=1464217&r2=1464218&view=diff
==============================================================================
--- sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/content/package-info.java [UTF-8] (original)
+++ sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/content/package-info.java [UTF-8] Wed Apr 3 22:20:57 2013
@@ -67,7 +67,7 @@
* {@link org.opengis.metadata.content.RangeDimension}.
*
* {@section Collections and null values}
- * Unless otherwise noted in the Javadoc, all constructors and setter methods accept {@code null} argument.
+ * All constructors (except the <cite>copy constructor</cite>) and setter methods accept {@code null} arguments.
* A null argument value means that the metadata element can not be provided, and the reason for that is unspecified.
* Alternatively, users can specify why a metadata element is missing by providing a value created by
* {@link org.apache.sis.xml.NilReason#createNilObject NilReason.createNilObject(Class)}.
Modified: sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/distribution/package-info.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/distribution/package-info.java?rev=1464218&r1=1464217&r2=1464218&view=diff
==============================================================================
--- sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/distribution/package-info.java [UTF-8] (original)
+++ sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/distribution/package-info.java [UTF-8] Wed Apr 3 22:20:57 2013
@@ -52,7 +52,7 @@
* </td></tr></table>
*
* {@section Collections and null values}
- * Unless otherwise noted in the Javadoc, all constructors and setter methods accept {@code null} argument.
+ * All constructors (except the <cite>copy constructor</cite>) and setter methods accept {@code null} arguments.
* A null argument value means that the metadata element can not be provided, and the reason for that is unspecified.
* Alternatively, users can specify why a metadata element is missing by providing a value created by
* {@link org.apache.sis.xml.NilReason#createNilObject NilReason.createNilObject(Class)}.
Modified: sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/extent/package-info.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/extent/package-info.java?rev=1464218&r1=1464217&r2=1464218&view=diff
==============================================================================
--- sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/extent/package-info.java [UTF-8] (original)
+++ sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/extent/package-info.java [UTF-8] Wed Apr 3 22:20:57 2013
@@ -89,7 +89,7 @@
* </ul>
*
* {@section Collections and null values}
- * Unless otherwise noted in the Javadoc, all constructors and setter methods accept {@code null} argument.
+ * All constructors (except the <cite>copy constructor</cite>) and setter methods accept {@code null} arguments.
* A null argument value means that the metadata element can not be provided, and the reason for that is unspecified.
* Alternatively, users can specify why a metadata element is missing by providing a value created by
* {@link org.apache.sis.xml.NilReason#createNilObject NilReason.createNilObject(Class)}.
Modified: sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/package-info.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/package-info.java?rev=1464218&r1=1464217&r2=1464218&view=diff
==============================================================================
--- sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/package-info.java [UTF-8] (original)
+++ sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/package-info.java [UTF-8] Wed Apr 3 22:20:57 2013
@@ -68,7 +68,7 @@
* </ul>
*
* {@section Collections and null values}
- * Unless otherwise noted in the Javadoc, all constructors and setter methods accept {@code null} argument.
+ * All constructors (except the <cite>copy constructor</cite>) and setter methods accept {@code null} arguments.
* A null argument value means that the metadata element can not be provided, and the reason for that is unspecified.
* Alternatively, users can specify why a metadata element is missing by providing a value created by
* {@link org.apache.sis.xml.NilReason#createNilObject NilReason.createNilObject(Class)}.
Modified: sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/lineage/package-info.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/lineage/package-info.java?rev=1464218&r1=1464217&r2=1464218&view=diff
==============================================================================
--- sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/lineage/package-info.java [UTF-8] (original)
+++ sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/lineage/package-info.java [UTF-8] Wed Apr 3 22:20:57 2013
@@ -47,7 +47,7 @@
* </td></tr></table>
*
* {@section Collections and null values}
- * Unless otherwise noted in the Javadoc, all constructors and setter methods accept {@code null} argument.
+ * All constructors (except the <cite>copy constructor</cite>) and setter methods accept {@code null} arguments.
* A null argument value means that the metadata element can not be provided, and the reason for that is unspecified.
* Alternatively, users can specify why a metadata element is missing by providing a value created by
* {@link org.apache.sis.xml.NilReason#createNilObject NilReason.createNilObject(Class)}.
Modified: sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/maintenance/package-info.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/maintenance/package-info.java?rev=1464218&r1=1464217&r2=1464218&view=diff
==============================================================================
--- sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/maintenance/package-info.java [UTF-8] (original)
+++ sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/maintenance/package-info.java [UTF-8] Wed Apr 3 22:20:57 2013
@@ -42,7 +42,7 @@
* </td></tr></table>
*
* {@section Collections and null values}
- * Unless otherwise noted in the Javadoc, all constructors and setter methods accept {@code null} argument.
+ * All constructors (except the <cite>copy constructor</cite>) and setter methods accept {@code null} arguments.
* A null argument value means that the metadata element can not be provided, and the reason for that is unspecified.
* Alternatively, users can specify why a metadata element is missing by providing a value created by
* {@link org.apache.sis.xml.NilReason#createNilObject NilReason.createNilObject(Class)}.
@@ -57,7 +57,8 @@
*
* Unless the metadata object has been marked as unmodifiable and unless otherwise noted in the Javadoc,
* all collections returned by getter methods are <cite>live</cite>: adding new elements in the collection
- * modify directly the underlying metadata object.
+ * modify directly the underlying metadata object. Noticeable exceptions to this rule are <cite>union</cite>
+ * structures, for which only one property can be non-empty in the same object.
*
* @author Martin Desruisseaux (IRD, Geomatys)
* @author Touraïvane (IRD)
Modified: sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/package-info.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/package-info.java?rev=1464218&r1=1464217&r2=1464218&view=diff
==============================================================================
--- sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/package-info.java [UTF-8] (original)
+++ sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/package-info.java [UTF-8] Wed Apr 3 22:20:57 2013
@@ -61,7 +61,7 @@
* will have precedence. The later behavior is compliant with INSPIRE rules.
*
* {@section Collections and null values}
- * Unless otherwise noted in the Javadoc, all constructors and setter methods accept {@code null} argument.
+ * All constructors (except the <cite>copy constructor</cite>) and setter methods accept {@code null} arguments.
* A null argument value means that the metadata element can not be provided, and the reason for that is unspecified.
* Alternatively, users can specify why a metadata element is missing by providing a value created by
* {@link org.apache.sis.xml.NilReason#createNilObject NilReason.createNilObject(Class)}.
Modified: sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/quality/package-info.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/quality/package-info.java?rev=1464218&r1=1464217&r2=1464218&view=diff
==============================================================================
--- sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/quality/package-info.java [UTF-8] (original)
+++ sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/quality/package-info.java [UTF-8] Wed Apr 3 22:20:57 2013
@@ -92,7 +92,7 @@
* </td></tr></table>
*
* {@section Collections and null values}
- * Unless otherwise noted in the Javadoc, all constructors and setter methods accept {@code null} argument.
+ * All constructors (except the <cite>copy constructor</cite>) and setter methods accept {@code null} arguments.
* A null argument value means that the metadata element can not be provided, and the reason for that is unspecified.
* Alternatively, users can specify why a metadata element is missing by providing a value created by
* {@link org.apache.sis.xml.NilReason#createNilObject NilReason.createNilObject(Class)}.
Modified: sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/spatial/package-info.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/spatial/package-info.java?rev=1464218&r1=1464217&r2=1464218&view=diff
==============================================================================
--- sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/spatial/package-info.java [UTF-8] (original)
+++ sis/branches/JDK7/sis-metadata/src/main/java/org/apache/sis/metadata/iso/spatial/package-info.java [UTF-8] Wed Apr 3 22:20:57 2013
@@ -55,7 +55,7 @@
* {@linkplain org.apache.sis.metadata.iso.spatial.DefaultGridSpatialRepresentation Grid spatial representation}<br>
* {@code ├─} {@linkplain org.apache.sis.metadata.iso.spatial.DefaultDimension Dimension}<br>
* {@code │ └─} {@linkplain org.opengis.metadata.spatial.DimensionNameType Dimension name type} «code list»<br>
- * {@code ├─} {@linkplain org.opengis.metadata.spatial.CellGeometry Cell geometry} «code list»<br>
+ * {@code └─} {@linkplain org.opengis.metadata.spatial.CellGeometry Cell geometry} «code list»<br>
* {@linkplain org.apache.sis.metadata.iso.spatial.DefaultGeoreferenceable Georeferenceable}<br>
* {@code └─} {@linkplain org.apache.sis.metadata.iso.spatial.AbstractGeolocationInformation Geolocation information} «abstract»<br>
* {@linkplain org.apache.sis.metadata.iso.spatial.DefaultGeorectified Georectified}<br>
@@ -66,7 +66,7 @@
* </td></tr></table>
*
* {@section Collections and null values}
- * Unless otherwise noted in the Javadoc, all constructors and setter methods accept {@code null} argument.
+ * All constructors (except the <cite>copy constructor</cite>) and setter methods accept {@code null} arguments.
* A null argument value means that the metadata element can not be provided, and the reason for that is unspecified.
* Alternatively, users can specify why a metadata element is missing by providing a value created by
* {@link org.apache.sis.xml.NilReason#createNilObject NilReason.createNilObject(Class)}.