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)}.
