sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From desruisse...@apache.org
Subject svn commit: r1779506 [2/9] - in /sis/branches/JDK8/core: sis-feature/src/main/java/org/apache/sis/feature/ sis-metadata/src/main/java/org/apache/sis/io/wkt/ sis-metadata/src/main/java/org/apache/sis/metadata/ sis-metadata/src/main/java/org/apache/sis/m...
Date Thu, 19 Jan 2017 18:46:46 GMT
Modified: sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/DefaultMetadata.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/DefaultMetadata.java?rev=1779506&r1=1779505&r2=1779506&view=diff
==============================================================================
--- sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/DefaultMetadata.java [UTF-8] (original)
+++ sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/DefaultMetadata.java [UTF-8] Thu Jan 19 18:46:44 2017
@@ -97,6 +97,7 @@ import org.apache.sis.xml.Namespaces;
  * @version 0.8
  * @module
  */
+@SuppressWarnings("CloneableClassWithoutClone")                 // ModifiableMetadata needs shallow clones.
 @XmlType(name = "MD_Metadata_Type", propOrder = {
     "fileIdentifier",
     "language",
@@ -261,9 +262,9 @@ public class DefaultMetadata extends ISO
     /**
      * Creates a meta data initialized to the specified values.
      *
-     * @param contact   Party responsible for the metadata information.
-     * @param dateStamp Date that the metadata was created.
-     * @param identificationInfo Basic information about the resource to which the metadata applies.
+     * @param contact             party responsible for the metadata information.
+     * @param dateStamp           date that the metadata was created.
+     * @param identificationInfo  basic information about the resource to which the metadata applies.
      */
     public DefaultMetadata(final Responsibility contact,
                            final Date           dateStamp,
@@ -281,7 +282,7 @@ public class DefaultMetadata extends ISO
      * This is a <cite>shallow</cite> copy constructor, since the other metadata contained in the
      * given object are not recursively copied.
      *
-     * @param object The metadata to copy values from, or {@code null} if none.
+     * @param  object  the metadata to copy values from, or {@code null} if none.
      *
      * @see #castOrCopy(Metadata)
      */
@@ -329,8 +330,8 @@ public class DefaultMetadata extends ISO
      *       metadata contained in the given object are not recursively copied.</li>
      * </ul>
      *
-     * @param  object The object to get as a SIS implementation, or {@code null} if none.
-     * @return A SIS implementation containing the values of the given object (may be the
+     * @param  object  the object to get as a SIS implementation, or {@code null} if none.
+     * @return a SIS implementation containing the values of the given object (may be the
      *         given object itself), or {@code null} if the argument was null.
      */
     public static DefaultMetadata castOrCopy(final Metadata object) {
@@ -356,7 +357,7 @@ public class DefaultMetadata extends ISO
      * of a UUID (Universal Unique Identifier) as specified by <a href="http://www.ietf.org">IETF</a>
      * to ensure identifier’s uniqueness.</div>
      *
-     * @return Unique identifier for this metadata record, or {@code null}.
+     * @return unique identifier for this metadata record, or {@code null}.
      *
      * @since 0.5
      */
@@ -368,7 +369,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets the unique identifier for this metadata record.
      *
-     * @param newValue The new identifier, or {@code null} if none.
+     * @param  newValue  the new identifier, or {@code null} if none.
      *
      * @since 0.5
      */
@@ -380,7 +381,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns the unique identifier for this metadata file.
      *
-     * @return Unique identifier for this metadata file, or {@code null}.
+     * @return unique identifier for this metadata file, or {@code null}.
      *
      * @deprecated As of ISO 19115:2014, replaced by {@link #getMetadataIdentifier()}
      *   in order to include the codespace attribute.
@@ -396,7 +397,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets the unique identifier for this metadata file.
      *
-     * @param newValue The new identifier, or {@code null} if none.
+     * @param  newValue  the new identifier, or {@code null} if none.
      *
      * @deprecated As of ISO 19115:2014, replaced by {@link #setMetadataIdentifier(Identifier)}
      */
@@ -424,7 +425,7 @@ public class DefaultMetadata extends ISO
      * for marshalling {@link org.opengis.util.InternationalString} and {@link org.opengis.util.CodeList} instances
      * in ISO 19115-2 compliant XML documents.
      *
-     * @return Language(s) used for documenting metadata.
+     * @return language(s) used for documenting metadata.
      *
      * @since 0.5
      */
@@ -438,7 +439,7 @@ public class DefaultMetadata extends ISO
      * The first element in iteration order shall be the default language.
      * All other elements, if any, are alternate language(s) used within the resource.
      *
-     * @param newValues The new languages.
+     * @param  newValues  the new languages.
      *
      * @see org.apache.sis.xml.XML#LOCALE
      *
@@ -453,7 +454,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns the default language used for documenting metadata.
      *
-     * @return Language used for documenting metadata, or {@code null}.
+     * @return language used for documenting metadata, or {@code null}.
      *
      * @deprecated As of GeoAPI 3.1, replaced by {@link #getLanguages()}.
      */
@@ -462,8 +463,10 @@ public class DefaultMetadata extends ISO
     @XmlElement(name = "language")
     public Locale getLanguage() {
         return CollectionsExt.first(getLanguages());
-        // No warning if the collection contains more than one locale, because
-        // this is allowed by the "getLanguage() + getLocales()" contract.
+        /*
+         * No warning if the collection contains more than one locale, because
+         * this is allowed by the "getLanguage() + getLocales()" contract.
+         */
     }
 
     /**
@@ -475,7 +478,7 @@ public class DefaultMetadata extends ISO
      *   <li>Otherwise the first element in the languages collection is replaced by the given {@code newValue}.</li>
      * </ul>
      *
-     * @param newValue The new language.
+     * @param  newValue  the new language.
      *
      * @deprecated As of GeoAPI 3.1, replaced by {@link #setLanguages(Collection)}.
      */
@@ -488,7 +491,7 @@ public class DefaultMetadata extends ISO
     /**
      * Provides information about an alternatively used localized character string for a linguistic extension.
      *
-     * @return Alternatively used localized character string for a linguistic extension.
+     * @return alternatively used localized character string for a linguistic extension.
      *
      * @deprecated As of GeoAPI 3.1, replaced by {@link #getLanguages()}.
      */
@@ -503,7 +506,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets information about an alternatively used localized character string for a linguistic extension.
      *
-     * @param newValues The new locales.
+     * @param  newValues  the new locales.
      *
      * @deprecated As of GeoAPI 3.1, replaced by {@link #setLanguages(Collection)}.
      */
@@ -527,7 +530,7 @@ public class DefaultMetadata extends ISO
      * {@code Big5}, {@code GB2312}.
      * </div>
      *
-     * @return Character coding standards used for the metadata.
+     * @return character coding standards used for the metadata.
      *
      * @see #getLanguages()
      * @see org.opengis.metadata.identification.DataIdentification#getCharacterSets()
@@ -543,7 +546,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets the character coding standard used for the metadata set.
      *
-     * @param newValues The new character coding standards.
+     * @param  newValues  the new character coding standards.
      *
      * @since 0.5
      */
@@ -554,7 +557,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns the character coding standard used for the metadata set.
      *
-     * @return Character coding standard used for the metadata, or {@code null}.
+     * @return character coding standard used for the metadata, or {@code null}.
      *
      * @deprecated As of GeoAPI 3.1, replaced by {@link #getCharacterSets()}.
      */
@@ -581,7 +584,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets the character coding standard used for the metadata set.
      *
-     * @param newValue The new character set.
+     * @param  newValue  the new character set.
      *
      * @deprecated As of GeoAPI 3.1, replaced by {@link #setCharacterSets(Collection)}.
      */
@@ -594,7 +597,7 @@ public class DefaultMetadata extends ISO
      * Returns an identification of the parent metadata record.
      * This is non-null if this metadata is a subset (child) of another metadata that is described elsewhere.
      *
-     * @return Identification of the parent metadata record, or {@code null} if none.
+     * @return identification of the parent metadata record, or {@code null} if none.
      *
      * @since 0.5
      */
@@ -606,7 +609,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets an identification of the parent metadata record.
      *
-     * @param newValue The new identification of the parent metadata record.
+     * @param  newValue  the new identification of the parent metadata record.
      *
      * @since 0.5
      */
@@ -618,7 +621,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns the file identifier of the metadata to which this metadata is a subset (child).
      *
-     * @return Identifier of the metadata to which this metadata is a subset, or {@code null}.
+     * @return identifier of the metadata to which this metadata is a subset, or {@code null}.
      *
      * @deprecated As of ISO 19115:2014, replaced by {@link #getParentMetadata()}.
      */
@@ -639,7 +642,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets the file identifier of the metadata to which this metadata is a subset (child).
      *
-     * @param newValue The new parent identifier.
+     * @param  newValue  the new parent identifier.
      *
      * @deprecated As of ISO 19115:2014, replaced by {@link #getParentMetadata()}.
      */
@@ -657,7 +660,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns the scope or type of resource for which metadata is provided.
      *
-     * @return Scope or type of resource for which metadata is provided.
+     * @return scope or type of resource for which metadata is provided.
      *
      * @since 0.5
      */
@@ -669,7 +672,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets the scope or type of resource for which metadata is provided.
      *
-     * @param newValues The new scope or type of resource.
+     * @param  newValues  the new scope or type of resource.
      *
      * @since 0.5
      */
@@ -680,7 +683,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns the scope to which the metadata applies.
      *
-     * @return Scope to which the metadata applies.
+     * @return scope to which the metadata applies.
      *
      * @deprecated As of ISO 19115:2014, replaced by {@link #getMetadataScopes()}
      *   followed by {@link DefaultMetadataScope#getResourceScope()}.
@@ -714,7 +717,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets the scope to which the metadata applies.
      *
-     * @param newValues The new hierarchy levels.
+     * @param  newValues  the new hierarchy levels.
      *
      * @deprecated As of ISO 19115:2014, replaced by {@link #setMetadataScopes(Collection)}
      *   and {@link DefaultMetadataScope#setResourceScope(ScopeCode)}.
@@ -728,7 +731,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns the name of the hierarchy levels for which the metadata is provided.
      *
-     * @return Hierarchy levels for which the metadata is provided.
+     * @return hierarchy levels for which the metadata is provided.
      *
      * @deprecated As of ISO 19115:2014, replaced by {@link #getMetadataScopes()}
      *   followed by {@link DefaultMetadataScope#getName()}.
@@ -763,7 +766,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets the name of the hierarchy levels for which the metadata is provided.
      *
-     * @param newValues The new hierarchy level names.
+     * @param  newValues  the new hierarchy level names.
      *
      * @deprecated As of ISO 19115:2014, replaced by {@link #setMetadataScopes(Collection)}
      *   and {@link DefaultMetadataScope#setName(InternationalString)}.
@@ -777,7 +780,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns the parties responsible for the metadata information.
      *
-     * @return Parties responsible for the metadata information.
+     * @return parties responsible for the metadata information.
      */
     @Override
     @XmlElement(name = "contact", required = true)
@@ -788,7 +791,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets the parties responsible for the metadata information.
      *
-     * @param newValues The new contacts.
+     * @param  newValues  the new contacts.
      */
     public void setContacts(final Collection<? extends Responsibility> newValues) {
         checkWritePermission();
@@ -798,7 +801,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns the date(s) associated with the metadata.
      *
-     * @return Date(s) associated with the metadata.
+     * @return date(s) associated with the metadata.
      *
      * @see Citation#getDates()
      *
@@ -813,7 +816,7 @@ public class DefaultMetadata extends ISO
      * Sets the date(s) associated with the metadata.
      * The collection should contains at least an element for {@link DateType#CREATION}.
      *
-     * @param newValues New dates associated with the metadata.
+     * @param  newValues  new dates associated with the metadata.
      *
      * @since 0.5
      */
@@ -824,7 +827,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns the date that the metadata was created.
      *
-     * @return Date that the metadata was created, or {@code null}.
+     * @return date that the metadata was created, or {@code null}.
      *
      * @deprecated As of ISO 19115:2014, replaced by {@link #getDateInfo()}.
      */
@@ -846,14 +849,14 @@ public class DefaultMetadata extends ISO
     /**
      * Sets the date that the metadata was created.
      *
-     * @param newValue The new date stamp.
+     * @param  newValue  the new date stamp.
      *
      * @deprecated As of ISO 19115:2014, replaced by {@link #setDateInfo(Collection)}.
      */
     @Deprecated
     public void setDateStamp(final Date newValue) {
         checkWritePermission();
-        Collection<CitationDate> newValues = dateInfo; // See "Note about deprecated methods implementation"
+        Collection<CitationDate> newValues = dateInfo;      // See "Note about deprecated methods implementation"
         if (newValues == null) {
             if (newValue == null) {
                 return;
@@ -886,7 +889,7 @@ public class DefaultMetadata extends ISO
      * The collection returned by this method typically contains elements from the
      * {@link org.apache.sis.metadata.iso.citation.Citations#ISO_19115} list.
      *
-     * @return The standard(s) to which the metadata conform.
+     * @return the standard(s) to which the metadata conform.
      *
      * @see #getMetadataProfiles()
      *
@@ -901,7 +904,7 @@ public class DefaultMetadata extends ISO
      * Sets the citation(s) for the standard(s) to which the metadata conform.
      * Metadata standard citations should include an identifier.
      *
-     * @param newValues The new standard(s) to which the metadata conform.
+     * @param  newValues  the new standard(s) to which the metadata conform.
      *
      * @since 0.5
      */
@@ -912,7 +915,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns the citation(s) for the profile(s) of the metadata standard to which the metadata conform.
      *
-     * @return The profile(s) to which the metadata conform.
+     * @return the profile(s) to which the metadata conform.
      *
      * @see #getMetadataStandards()
      * @see #getMetadataExtensionInfo()
@@ -928,7 +931,7 @@ public class DefaultMetadata extends ISO
      * Set the citation(s) for the profile(s) of the metadata standard to which the metadata conform.
      * Metadata profile standard citations should include an identifier.
      *
-     * @param newValues The new profile(s) to which the metadata conform.
+     * @param  newValues  the new profile(s) to which the metadata conform.
      *
      * @since 0.5
      */
@@ -939,7 +942,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns reference(s) to alternative metadata or metadata in a non-ISO standard for the same resource.
      *
-     * @return Reference(s) to alternative metadata (e.g. Dublin core, FGDC).
+     * @return reference(s) to alternative metadata (e.g. Dublin core, FGDC).
      *
      * @since 0.5
      */
@@ -951,7 +954,7 @@ public class DefaultMetadata extends ISO
     /**
      * Set reference(s) to alternative metadata or metadata in a non-ISO standard for the same resource.
      *
-     * @param newValues The new reference(s) to alternative metadata (e.g. Dublin core, FGDC).
+     * @param  newValues  the new reference(s) to alternative metadata (e.g. Dublin core, FGDC).
      *
      * @since 0.5
      */
@@ -1004,7 +1007,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns the name of the metadata standard (including profile name) used.
      *
-     * @return Name of the metadata standard used, or {@code null}.
+     * @return name of the metadata standard used, or {@code null}.
      *
      * @deprecated As of ISO 19115:2014, replaced by {@link #getMetadataStandards()}
      *   followed by {@link DefaultCitation#getTitle()}.
@@ -1019,7 +1022,7 @@ public class DefaultMetadata extends ISO
     /**
      * Name of the metadata standard (including profile name) used.
      *
-     * @param newValue The new metadata standard name.
+     * @param  newValue  the new metadata standard name.
      *
      * @deprecated As of ISO 19115:2014, replaced by {@link #getMetadataStandards()}
      *   followed by {@link DefaultCitation#setTitle(InternationalString)}.
@@ -1032,7 +1035,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns the version (profile) of the metadata standard used.
      *
-     * @return Version of the metadata standard used, or {@code null}.
+     * @return version of the metadata standard used, or {@code null}.
      *
      * @deprecated As of ISO 19115:2014, replaced by {@link #getMetadataStandards()}
      *   followed by {@link DefaultCitation#getEdition()}.
@@ -1047,7 +1050,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets the version (profile) of the metadata standard used.
      *
-     * @param newValue The new metadata standard version.
+     * @param  newValue  the new metadata standard version.
      *
      * @deprecated As of ISO 19115:2014, replaced by {@link #getMetadataStandards()}
      *   followed by {@link DefaultCitation#setEdition(InternationalString)}.
@@ -1060,7 +1063,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns the online location(s) where the metadata is available.
      *
-     * @return Online location(s) where the metadata is available.
+     * @return online location(s) where the metadata is available.
      *
      * @since 0.5
      */
@@ -1072,7 +1075,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets the online location(s) where the metadata is available.
      *
-     * @param newValues The new online location(s).
+     * @param  newValues  the new online location(s).
      *
      * @since 0.5
      */
@@ -1083,7 +1086,7 @@ public class DefaultMetadata extends ISO
     /**
      * Provides the URI of the dataset to which the metadata applies.
      *
-     * @return Uniformed Resource Identifier of the dataset, or {@code null}.
+     * @return Uniform Resource Identifier of the dataset, or {@code null}.
      *
      * @deprecated As of ISO 19115:2014, replaced by {@link #getIdentificationInfo()} followed by
      *    {@link DefaultDataIdentification#getCitation()} followed by {@link DefaultCitation#getOnlineResources()}.
@@ -1123,8 +1126,8 @@ public class DefaultMetadata extends ISO
      * Sets the URI of the dataset to which the metadata applies.
      * This method sets the linkage of the first online resource in the citation of the first identification info.
      *
-     * @param  newValue The new data set URI.
-     * @throws URISyntaxException If the given value can not be parsed as a URI.
+     * @param  newValue  the new data set URI.
+     * @throws URISyntaxException if the given value can not be parsed as a URI.
      *
      * @deprecated As of ISO 19115:2014, replaced by {@link #getIdentificationInfo()}
      *    followed by {@link DefaultDataIdentification#getCitation()}
@@ -1159,7 +1162,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns the digital representation of spatial information in the dataset.
      *
-     * @return Digital representation of spatial information in the dataset.
+     * @return digital representation of spatial information in the dataset.
      */
     @Override
     @XmlElement(name = "spatialRepresentationInfo")
@@ -1170,7 +1173,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets the digital representation of spatial information in the dataset.
      *
-     * @param newValues The new spatial representation info.
+     * @param  newValues  the new spatial representation info.
      */
     public void setSpatialRepresentationInfo(final Collection<? extends SpatialRepresentation> newValues) {
         spatialRepresentationInfo = writeCollection(newValues, spatialRepresentationInfo, SpatialRepresentation.class);
@@ -1179,7 +1182,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns the description of the spatial and temporal reference systems used in the dataset.
      *
-     * @return Spatial and temporal reference systems used in the dataset.
+     * @return spatial and temporal reference systems used in the dataset.
      */
     @Override
     @XmlElement(name = "referenceSystemInfo")
@@ -1190,7 +1193,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets the description of the spatial and temporal reference systems used in the dataset.
      *
-     * @param newValues The new reference system info.
+     * @param  newValues  the new reference system info.
      */
     public void setReferenceSystemInfo(final Collection<? extends ReferenceSystem> newValues) {
         referenceSystemInfo = writeCollection(newValues, referenceSystemInfo, ReferenceSystem.class);
@@ -1199,7 +1202,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns information describing metadata extensions.
      *
-     * @return Metadata extensions.
+     * @return metadata extensions.
      */
     @Override
     @XmlElement(name = "metadataExtensionInfo")
@@ -1210,7 +1213,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets information describing metadata extensions.
      *
-     * @param newValues The new metadata extension info.
+     * @param  newValues  the new metadata extension info.
      */
     public void setMetadataExtensionInfo(final Collection<? extends MetadataExtensionInformation> newValues) {
         metadataExtensionInfo = writeCollection(newValues, metadataExtensionInfo, MetadataExtensionInformation.class);
@@ -1219,7 +1222,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns basic information about the resource(s) to which the metadata applies.
      *
-     * @return The resource(s) to which the metadata applies.
+     * @return the resource(s) to which the metadata applies.
      */
     @Override
     @XmlElement(name = "identificationInfo", required = true)
@@ -1230,7 +1233,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets basic information about the resource(s) to which the metadata applies.
      *
-     * @param newValues The new identification info.
+     * @param  newValues  the new identification info.
      */
     public void setIdentificationInfo(final Collection<? extends Identification> newValues) {
         identificationInfo = writeCollection(newValues, identificationInfo, Identification.class);
@@ -1240,7 +1243,7 @@ public class DefaultMetadata extends ISO
      * Returns information about the feature catalogue and describes the coverage and
      * image data characteristics.
      *
-     * @return The feature catalogue, coverage descriptions and image data characteristics.
+     * @return the feature catalogue, coverage descriptions and image data characteristics.
      */
     @Override
     @XmlElement(name = "contentInfo")
@@ -1252,7 +1255,7 @@ public class DefaultMetadata extends ISO
      * Sets information about the feature catalogue and describes the coverage and
      * image data characteristics.
      *
-     * @param newValues The new content info.
+     * @param  newValues  the new content info.
      */
     public void setContentInfo(final Collection<? extends ContentInformation> newValues) {
         contentInfo = writeCollection(newValues, contentInfo, ContentInformation.class);
@@ -1261,7 +1264,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns information about the distributor of and options for obtaining the resource(s).
      *
-     * @return The distributor of and options for obtaining the resource(s).
+     * @return the distributor of and options for obtaining the resource(s).
      */
     @Override
     @XmlElement(name = "distributionInfo")
@@ -1272,7 +1275,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets information about the distributor of and options for obtaining the resource(s).
      *
-     * @param newValues The new distribution info.
+     * @param  newValues  the new distribution info.
      */
     public void setDistributionInfo(final Collection<? extends Distribution> newValues) {
         distributionInfo = writeCollection(newValues, distributionInfo, Distribution.class);
@@ -1281,7 +1284,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns overall assessment of quality of a resource(s).
      *
-     * @return Overall assessment of quality of a resource(s).
+     * @return overall assessment of quality of a resource(s).
      */
     @Override
     @XmlElement(name = "dataQualityInfo")
@@ -1292,7 +1295,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets overall assessment of quality of a resource(s).
      *
-     * @param newValues The new data quality info.
+     * @param  newValues  the new data quality info.
      */
     public void setDataQualityInfo(final Collection<? extends DataQuality> newValues) {
         dataQualityInfo = writeCollection(newValues, dataQualityInfo, DataQuality.class);
@@ -1301,7 +1304,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns information about the catalogue of rules defined for the portrayal of a resource(s).
      *
-     * @return The catalogue of rules defined for the portrayal of a resource(s).
+     * @return the catalogue of rules defined for the portrayal of a resource(s).
      */
     @Override
     @XmlElement(name = "portrayalCatalogueInfo")
@@ -1312,7 +1315,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets information about the catalogue of rules defined for the portrayal of a resource(s).
      *
-     * @param newValues The new portrayal catalog info.
+     * @param  newValues  the new portrayal catalog info.
      */
     public void setPortrayalCatalogueInfo(final Collection<? extends PortrayalCatalogueReference> newValues) {
         portrayalCatalogueInfo = writeCollection(newValues, portrayalCatalogueInfo, PortrayalCatalogueReference.class);
@@ -1321,7 +1324,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns restrictions on the access and use of data.
      *
-     * @return Restrictions on the access and use of data.
+     * @return restrictions on the access and use of data.
      */
     @Override
     @XmlElement(name = "metadataConstraints")
@@ -1332,7 +1335,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets restrictions on the access and use of data.
      *
-     * @param newValues The new metadata constraints.
+     * @param  newValues  the new metadata constraints.
      */
     public void setMetadataConstraints(final Collection<? extends Constraints> newValues) {
         metadataConstraints = writeCollection(newValues, metadataConstraints, Constraints.class);
@@ -1341,7 +1344,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns information about the conceptual schema of a dataset.
      *
-     * @return The conceptual schema of a dataset.
+     * @return the conceptual schema of a dataset.
      */
     @Override
     @XmlElement(name = "applicationSchemaInfo")
@@ -1352,7 +1355,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns information about the conceptual schema of a dataset.
      *
-     * @param newValues The new application schema info.
+     * @param  newValues  the new application schema info.
      */
     public void setApplicationSchemaInfo(final Collection<? extends ApplicationSchemaInformation> newValues) {
         applicationSchemaInfo = writeCollection(newValues, applicationSchemaInfo, ApplicationSchemaInformation.class);
@@ -1361,7 +1364,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns information about the acquisition of the data.
      *
-     * @return The acquisition of data.
+     * @return the acquisition of data.
      */
     @Override
     @XmlElement(name = "acquisitionInformation", namespace = Namespaces.GMI)
@@ -1372,7 +1375,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets information about the acquisition of the data.
      *
-     * @param newValues The new acquisition information.
+     * @param  newValues  the new acquisition information.
      */
     public void setAcquisitionInformation(final Collection<? extends AcquisitionInformation> newValues) {
         acquisitionInformation = writeCollection(newValues, acquisitionInformation, AcquisitionInformation.class);
@@ -1381,7 +1384,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns information about the frequency of metadata updates, and the scope of those updates.
      *
-     * @return The frequency of metadata updates and their scope, or {@code null}.
+     * @return the frequency of metadata updates and their scope, or {@code null}.
      */
     @Override
     @XmlElement(name = "metadataMaintenance")
@@ -1392,7 +1395,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets information about the frequency of metadata updates, and the scope of those updates.
      *
-     * @param newValue The new metadata maintenance.
+     * @param  newValue  the new metadata maintenance.
      */
     public void setMetadataMaintenance(final MaintenanceInformation newValue) {
         checkWritePermission();
@@ -1402,7 +1405,7 @@ public class DefaultMetadata extends ISO
     /**
      * Returns information about the provenance, sources and/or the production processes applied to the resource.
      *
-     * @return Information about the provenance, sources and/or the production processes.
+     * @return information about the provenance, sources and/or the production processes.
      *
      * @since 0.5
      */
@@ -1414,7 +1417,7 @@ public class DefaultMetadata extends ISO
     /**
      * Sets information about the provenance, sources and/or the production processes applied to the resource.
      *
-     * @param newValues New information about the provenance, sources and/or the production processes.
+     * @param newValues new information about the provenance, sources and/or the production processes.
      *
      * @since 0.5
      */

Modified: sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/DefaultMetadataExtensionInformation.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/DefaultMetadataExtensionInformation.java?rev=1779506&r1=1779505&r2=1779506&view=diff
==============================================================================
--- sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/DefaultMetadataExtensionInformation.java [UTF-8] (original)
+++ sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/DefaultMetadataExtensionInformation.java [UTF-8] Thu Jan 19 18:46:44 2017
@@ -44,14 +44,13 @@ import org.opengis.metadata.MetadataExte
  * @version 0.3
  * @module
  */
+@SuppressWarnings("CloneableClassWithoutClone")                 // ModifiableMetadata needs shallow clones.
 @XmlType(name = "MD_MetadataExtensionInformation_Type", propOrder = {
     "extensionOnLineResource",
     "extendedElementInformation"
 })
 @XmlRootElement(name = "MD_MetadataExtensionInformation")
-public class DefaultMetadataExtensionInformation extends ISOMetadata
-        implements MetadataExtensionInformation
-{
+public class DefaultMetadataExtensionInformation extends ISOMetadata implements MetadataExtensionInformation {
     /**
      * Serial number for compatibility with different versions.
      */
@@ -80,7 +79,7 @@ public class DefaultMetadataExtensionInf
      * This is a <cite>shallow</cite> copy constructor, since the other metadata contained in the
      * given object are not recursively copied.
      *
-     * @param object The metadata to copy values from, or {@code null} if none.
+     * @param  object  the metadata to copy values from, or {@code null} if none.
      *
      * @see #castOrCopy(MetadataExtensionInformation)
      */
@@ -106,8 +105,8 @@ public class DefaultMetadataExtensionInf
      *       metadata contained in the given object are not recursively copied.</li>
      * </ul>
      *
-     * @param  object The object to get as a SIS implementation, or {@code null} if none.
-     * @return A SIS implementation containing the values of the given object (may be the
+     * @param  object  the object to get as a SIS implementation, or {@code null} if none.
+     * @return a SIS implementation containing the values of the given object (may be the
      *         given object itself), or {@code null} if the argument was null.
      */
     public static DefaultMetadataExtensionInformation castOrCopy(final MetadataExtensionInformation object) {
@@ -121,7 +120,7 @@ public class DefaultMetadataExtensionInf
      * Information about on-line sources containing the community profile name and
      * the extended metadata elements and information for all new metadata elements.
      *
-     * @return Online sources to community profile name and extended metadata elements, or {@code null}.
+     * @return online sources to community profile name and extended metadata elements, or {@code null}.
      */
     @Override
     @XmlElement(name = "extensionOnLineResource")
@@ -132,7 +131,7 @@ public class DefaultMetadataExtensionInf
     /**
      * Sets information about on-line sources.
      *
-     * @param newValue The new extension online resource.
+     * @param  newValue  the new extension online resource.
      */
     public void setExtensionOnLineResource(final OnlineResource newValue) {
         checkWritePermission();
@@ -143,7 +142,7 @@ public class DefaultMetadataExtensionInf
      * Provides information about a new metadata element, not found in ISO 19115,
      * which is required to describe resource.
      *
-     * @return New metadata elements not found in ISO 19115.
+     * @return new metadata elements not found in ISO 19115.
      */
     @Override
     @XmlElement(name = "extendedElementInformation")
@@ -154,7 +153,7 @@ public class DefaultMetadataExtensionInf
     /**
      * Sets information about a new metadata element.
      *
-     * @param newValues The new extended element information.
+     * @param  newValues  the new extended element information.
      */
     public void setExtendedElementInformation(final Collection<? extends ExtendedElementInformation> newValues) {
         extendedElementInformation = writeCollection(newValues, extendedElementInformation, ExtendedElementInformation.class);

Modified: sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/DefaultMetadataScope.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/DefaultMetadataScope.java?rev=1779506&r1=1779505&r2=1779506&view=diff
==============================================================================
--- sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/DefaultMetadataScope.java [UTF-8] (original)
+++ sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/DefaultMetadataScope.java [UTF-8] Thu Jan 19 18:46:44 2017
@@ -43,6 +43,7 @@ import org.apache.sis.util.iso.Types;
  * @version 0.5
  * @module
  */
+@SuppressWarnings("CloneableClassWithoutClone")                 // ModifiableMetadata needs shallow clones.
 @XmlType(name = "MD_MetadataScope_Type", propOrder = {
     "resourceScope",
     "name"
@@ -74,7 +75,7 @@ public class DefaultMetadataScope extend
      * Constructs a metadata scope initialized to the given value.
      *
      * @param resourceScope  code for the scope.
-     * @param name  description of the scope, or {@code null} if none.
+     * @param name           description of the scope, or {@code null} if none.
      */
     public DefaultMetadataScope(final ScopeCode resourceScope, final CharSequence name) {
         this.resourceScope = resourceScope;

Modified: sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/DefaultPortrayalCatalogueReference.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/DefaultPortrayalCatalogueReference.java?rev=1779506&r1=1779505&r2=1779506&view=diff
==============================================================================
--- sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/DefaultPortrayalCatalogueReference.java [UTF-8] (original)
+++ sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/DefaultPortrayalCatalogueReference.java [UTF-8] Thu Jan 19 18:46:44 2017
@@ -43,11 +43,10 @@ import org.opengis.metadata.PortrayalCat
  * @version 0.3
  * @module
  */
+@SuppressWarnings("CloneableClassWithoutClone")                 // ModifiableMetadata needs shallow clones.
 @XmlType(name = "MD_PortrayalCatalogueReference_Type")
 @XmlRootElement(name = "MD_PortrayalCatalogueReference")
-public class DefaultPortrayalCatalogueReference extends ISOMetadata
-        implements PortrayalCatalogueReference
-{
+public class DefaultPortrayalCatalogueReference extends ISOMetadata implements PortrayalCatalogueReference {
     /**
      * Serial number for compatibility with different versions.
      */
@@ -67,7 +66,7 @@ public class DefaultPortrayalCatalogueRe
     /**
      * Creates a portrayal catalogue reference initialized to the given reference.
      *
-     * @param portrayalCatalogueCitation The bibliographic reference, or {@code null} if none.
+     * @param portrayalCatalogueCitation  the bibliographic reference, or {@code null} if none.
      */
     public DefaultPortrayalCatalogueReference(final Citation portrayalCatalogueCitation) {
         portrayalCatalogueCitations = singleton(portrayalCatalogueCitation, Citation.class);
@@ -78,7 +77,7 @@ public class DefaultPortrayalCatalogueRe
      * This is a <cite>shallow</cite> copy constructor, since the other metadata contained in the
      * given object are not recursively copied.
      *
-     * @param object The metadata to copy values from, or {@code null} if none.
+     * @param  object  the metadata to copy values from, or {@code null} if none.
      *
      * @see #castOrCopy(PortrayalCatalogueReference)
      */
@@ -103,8 +102,8 @@ public class DefaultPortrayalCatalogueRe
      *       metadata contained in the given object are not recursively copied.</li>
      * </ul>
      *
-     * @param  object The object to get as a SIS implementation, or {@code null} if none.
-     * @return A SIS implementation containing the values of the given object (may be the
+     * @param  object  the object to get as a SIS implementation, or {@code null} if none.
+     * @return a SIS implementation containing the values of the given object (may be the
      *         given object itself), or {@code null} if the argument was null.
      */
     public static DefaultPortrayalCatalogueReference castOrCopy(final PortrayalCatalogueReference object) {
@@ -117,7 +116,7 @@ public class DefaultPortrayalCatalogueRe
     /**
      * Bibliographic reference to the portrayal catalogue cited.
      *
-     * @return References to the portrayal catalogue cited.
+     * @return references to the portrayal catalogue cited.
      */
     @Override
     @XmlElement(name = "portrayalCatalogueCitation", required = true)
@@ -128,7 +127,7 @@ public class DefaultPortrayalCatalogueRe
     /**
      * Sets bibliographic reference to the portrayal catalogue cited.
      *
-     * @param newValues The new portrayal catalogue citations.
+     * @param  newValues  the new portrayal catalogue citations.
      */
     public void setPortrayalCatalogueCitations(Collection<? extends Citation> newValues) {
         portrayalCatalogueCitations = writeCollection(newValues, portrayalCatalogueCitations, Citation.class);

Modified: sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/ISOMetadata.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/ISOMetadata.java?rev=1779506&r1=1779505&r2=1779506&view=diff
==============================================================================
--- sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/ISOMetadata.java [UTF-8] (original)
+++ sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/ISOMetadata.java [UTF-8] Thu Jan 19 18:46:44 2017
@@ -33,6 +33,7 @@ import org.apache.sis.metadata.Modifiabl
 import org.apache.sis.internal.jaxb.IdentifierMapAdapter;
 import org.apache.sis.internal.jaxb.ModifiableIdentifierMap;
 import org.apache.sis.internal.metadata.MetadataUtilities;
+import org.apache.sis.internal.util.CollectionsExt;
 import org.apache.sis.internal.system.Modules;
 import org.apache.sis.util.collection.Containers;
 
@@ -54,10 +55,11 @@ import static org.apache.sis.util.collec
  *
  * @author  Martin Desruisseaux (Geomatys)
  * @since   0.3
- * @version 0.7
+ * @version 0.8
  * @module
  */
 @XmlTransient
+@SuppressWarnings("CloneableClassWithoutClone")     // ModifiableMetadata needs shallow clones.
 public class ISOMetadata extends ModifiableMetadata implements IdentifiedObject, Serializable {
     /**
      * Serial number for inter-operability with different versions.
@@ -124,7 +126,7 @@ public class ISOMetadata extends Modifia
 
 
     // --------------------------------------------------------------------------------------
-    // Code below this point also appears in other IdentifiedObject implementations.
+    // Identifier methods below also appear in other IdentifiedObject implementations.
     // If this code is modified, consider revisiting also the following classes:
     //
     //   * org.apache.sis.metadata.iso.identification.DefaultRepresentativeFraction
@@ -163,6 +165,34 @@ public class ISOMetadata extends Modifia
                               : new IdentifierMapAdapter(identifiers);
     }
 
+    // --------------------------------------------------------------------------------------
+    // End of identifier methods.
+    // --------------------------------------------------------------------------------------
+
+    /**
+     * Declares this metadata and all its properties as unmodifiable. Any attempt to modify a
+     * property after this method call will throw an {@link UnmodifiableMetadataException}.
+     * If this metadata is already unmodifiable, then this method does nothing.
+     *
+     * <p>Subclasses usually do not need to override this method since the default implementation
+     * performs most of its work using Java reflection.</p>
+     */
+    @Override
+    public void freeze() {
+        if (isModifiable()) {
+            final Collection<Identifier> p = identifiers;
+            super.freeze();
+            /*
+             * The 'identifiers' collection will have been replaced by an unmodifiable collection if
+             * subclass has an "identifiers" property. If this is not the case, then the collection
+             * is unchanged (or null) so we have to make it unmodifiable here.
+             */
+            if (p == identifiers) {
+                identifiers = CollectionsExt.unmodifiableOrCopy(p);                     // Null safe.
+            }
+        }
+    }
+
 
 
 
@@ -182,7 +212,7 @@ public class ISOMetadata extends Modifia
      * This method is invoked automatically by JAXB and should never be invoked explicitely.
      */
     @XmlID
-    @XmlAttribute  // Defined in "gco" as unqualified attribute.
+    @XmlAttribute                           // Defined in "gco" as unqualified attribute.
     @XmlSchemaType(name = "ID")
     @XmlJavaTypeAdapter(CollapsedStringAdapter.class)
     private String getID() {
@@ -201,7 +231,7 @@ public class ISOMetadata extends Modifia
      * Returns an unique identifier, or {@code null} if none.
      * This method is invoked automatically by JAXB and should never be invoked explicitely.
      */
-    @XmlAttribute  // Defined in "gco" as unqualified attribute.
+    @XmlAttribute                           // Defined in "gco" as unqualified attribute.
     @XmlJavaTypeAdapter(CollapsedStringAdapter.class)
     private String getUUID() {
         /*

Modified: sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/ImmutableIdentifier.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/ImmutableIdentifier.java?rev=1779506&r1=1779505&r2=1779506&view=diff
==============================================================================
--- sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/ImmutableIdentifier.java [UTF-8] (original)
+++ sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/ImmutableIdentifier.java [UTF-8] Thu Jan 19 18:46:44 2017
@@ -18,6 +18,7 @@ package org.apache.sis.metadata.iso;
 
 import java.util.Map;
 import java.util.Locale;
+import java.util.Objects;
 import java.io.Serializable;
 import javax.xml.bind.annotation.XmlType;
 import javax.xml.bind.annotation.XmlElement;
@@ -40,9 +41,6 @@ import static org.apache.sis.util.Argume
 import static org.apache.sis.util.CharSequences.trimWhitespaces;
 import static org.apache.sis.util.collection.Containers.property;
 
-// Branch-dependent imports
-import java.util.Objects;
-
 
 /**
  * Immutable value uniquely identifying an object within a namespace, together with a version.

Modified: sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/DefaultAcquisitionInformation.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/DefaultAcquisitionInformation.java?rev=1779506&r1=1779505&r2=1779506&view=diff
==============================================================================
--- sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/DefaultAcquisitionInformation.java [UTF-8] (original)
+++ sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/DefaultAcquisitionInformation.java [UTF-8] Thu Jan 19 18:46:44 2017
@@ -50,6 +50,7 @@ import org.apache.sis.metadata.iso.ISOMe
  * @version 0.3
  * @module
  */
+@SuppressWarnings("CloneableClassWithoutClone")                 // ModifiableMetadata needs shallow clones.
 @XmlType(name = "MI_AcquisitionInformation_Type", propOrder = {
     "acquisitionPlans",
     "acquisitionRequirements",
@@ -112,7 +113,7 @@ public class DefaultAcquisitionInformati
      * This is a <cite>shallow</cite> copy constructor, since the other metadata contained in the
      * given object are not recursively copied.
      *
-     * @param object The metadata to copy values from, or {@code null} if none.
+     * @param  object  the metadata to copy values from, or {@code null} if none.
      *
      * @see #castOrCopy(AcquisitionInformation)
      */
@@ -143,8 +144,8 @@ public class DefaultAcquisitionInformati
      *       metadata contained in the given object are not recursively copied.</li>
      * </ul>
      *
-     * @param  object The object to get as a SIS implementation, or {@code null} if none.
-     * @return A SIS implementation containing the values of the given object (may be the
+     * @param  object  the object to get as a SIS implementation, or {@code null} if none.
+     * @return a SIS implementation containing the values of the given object (may be the
      *         given object itself), or {@code null} if the argument was null.
      */
     public static DefaultAcquisitionInformation castOrCopy(final AcquisitionInformation object) {
@@ -157,7 +158,7 @@ public class DefaultAcquisitionInformati
     /**
      * Returns the plan as implemented by the acquisition.
      *
-     * @return Plan as implemented by the acquisition.
+     * @return plan as implemented by the acquisition.
      */
     @Override
     @XmlElement(name = "acquisitionPlan")
@@ -168,7 +169,7 @@ public class DefaultAcquisitionInformati
     /**
      * Sets the plan as implemented by the acquisition.
      *
-     * @param newValues The new plan values.
+     * @param  newValues  the new plan values.
      */
     public void setAcquisitionPlans(final Collection<? extends Plan> newValues) {
         acquisitionPlans = writeCollection(newValues, acquisitionPlans, Plan.class);
@@ -177,7 +178,7 @@ public class DefaultAcquisitionInformati
     /**
      * Returns the requirement the data acquisition intends to satisfy.
      *
-     * @return Requirement the data acquisition intends to satisfy.
+     * @return requirement the data acquisition intends to satisfy.
      */
     @Override
     @XmlElement(name = "acquisitionRequirement")
@@ -188,7 +189,7 @@ public class DefaultAcquisitionInformati
     /**
      * Sets the requirement the data acquisition intends to satisfy.
      *
-     * @param newValues The new acquisition requirements values.
+     * @param  newValues  the new acquisition requirements values.
      */
     public void setAcquisitionRequirements(final Collection<? extends Requirement> newValues) {
         acquisitionRequirements = writeCollection(newValues, acquisitionRequirements, Requirement.class);
@@ -198,7 +199,7 @@ public class DefaultAcquisitionInformati
      * Returns a record of the environmental circumstances during the data acquisition.
      * {@code null} if unspecified.
      *
-     * @return Record of the environmental circumstances, or {@code null}.
+     * @return record of the environmental circumstances, or {@code null}.
      */
     @Override
     @XmlElement(name = "environmentalConditions")
@@ -209,7 +210,7 @@ public class DefaultAcquisitionInformati
     /**
      * Sets the record of the environmental circumstances during the data acquisition.
      *
-     * @param newValue The new environmental record value.
+     * @param  newValue  the new environmental record value.
      */
     public void setEnvironmentalConditions(final EnvironmentalRecord newValue) {
         checkWritePermission();
@@ -219,7 +220,7 @@ public class DefaultAcquisitionInformati
     /**
      * Returns the general information about the instrument used in data acquisition.
      *
-     * @return Instrument used in data acquisition.
+     * @return instrument used in data acquisition.
      */
     @Override
     @XmlElement(name = "instrument")
@@ -230,7 +231,7 @@ public class DefaultAcquisitionInformati
     /**
      * Sets the general information about the instrument used in data acquisition.
      *
-     * @param newValues The new instruments values.
+     * @param  newValues  the new instruments values.
      */
     public void setInstruments(final Collection<? extends Instrument> newValues) {
         instruments = writeCollection(newValues, instruments, Instrument.class);
@@ -239,7 +240,7 @@ public class DefaultAcquisitionInformati
     /**
      * Returns the area or object to be sensed.
      *
-     * @return Area or object to be sensed.
+     * @return area or object to be sensed.
      */
     @Override
     @XmlElement(name = "objective")
@@ -250,7 +251,7 @@ public class DefaultAcquisitionInformati
     /**
      * Sets the area or object to be sensed.
      *
-     * @param newValues The new objectives values.
+     * @param  newValues  the new objectives values.
      */
     public void setObjectives(final Collection<? extends Objective> newValues) {
         objectives = writeCollection(newValues, objectives, Objective.class);
@@ -259,7 +260,7 @@ public class DefaultAcquisitionInformati
     /**
      * Returns the general information about an identifiable activity which provided the data.
      *
-     * @return Identifiable activity which provided the data.
+     * @return identifiable activity which provided the data.
      */
     @Override
     @XmlElement(name = "operation")
@@ -270,7 +271,7 @@ public class DefaultAcquisitionInformati
     /**
      * Sets the general information about an identifiable activity which provided the data.
      *
-     * @param newValues The new operations values.
+     * @param  newValues  the new operations values.
      */
     public void setOperations(final Collection<? extends Operation> newValues) {
         operations = writeCollection(newValues, operations, Operation.class);
@@ -279,7 +280,7 @@ public class DefaultAcquisitionInformati
     /**
      * Returns the general information about the platform from which the data were taken.
      *
-     * @return Platform from which the data were taken.
+     * @return platform from which the data were taken.
      */
     @Override
     @XmlElement(name = "platform")
@@ -290,7 +291,7 @@ public class DefaultAcquisitionInformati
     /**
      * Sets the general information about the platform from which the data were taken.
      *
-     * @param newValues The new platforms values.
+     * @param  newValues  the new platforms values.
      */
     public void setPlatforms(final Collection<? extends Platform> newValues) {
         platforms = writeCollection(newValues, platforms, Platform.class);

Modified: sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/DefaultEnvironmentalRecord.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/DefaultEnvironmentalRecord.java?rev=1779506&r1=1779505&r2=1779506&view=diff
==============================================================================
--- sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/DefaultEnvironmentalRecord.java [UTF-8] (original)
+++ sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/DefaultEnvironmentalRecord.java [UTF-8] Thu Jan 19 18:46:44 2017
@@ -45,6 +45,7 @@ import static org.apache.sis.internal.me
  * @version 0.5
  * @module
  */
+@SuppressWarnings("CloneableClassWithoutClone")                 // ModifiableMetadata needs shallow clones.
 @XmlType(name = "MI_EnvironmentalRecord_Type", propOrder = {
     "averageAirTemperature",
     "maxRelativeHumidity",
@@ -96,7 +97,7 @@ public class DefaultEnvironmentalRecord
      * metadata instances can also be obtained by unmarshalling an invalid XML document.
      * </div>
      *
-     * @param object The metadata to copy values from, or {@code null} if none.
+     * @param  object  the metadata to copy values from, or {@code null} if none.
      *
      * @see #castOrCopy(EnvironmentalRecord)
      */
@@ -124,8 +125,8 @@ public class DefaultEnvironmentalRecord
      *       metadata contained in the given object are not recursively copied.</li>
      * </ul>
      *
-     * @param  object The object to get as a SIS implementation, or {@code null} if none.
-     * @return A SIS implementation containing the values of the given object (may be the
+     * @param  object  the object to get as a SIS implementation, or {@code null} if none.
+     * @return a SIS implementation containing the values of the given object (may be the
      *         given object itself), or {@code null} if the argument was null.
      */
     public static DefaultEnvironmentalRecord castOrCopy(final EnvironmentalRecord object) {
@@ -138,7 +139,7 @@ public class DefaultEnvironmentalRecord
     /**
      * Returns the average air temperature along the flight pass during the photo flight.
      *
-     * @return Average air temperature along the flight pass during the photo flight, or {@code null}.
+     * @return average air temperature along the flight pass during the photo flight, or {@code null}.
      */
     @Override
     @XmlElement(name = "averageAirTemperature", required = true)
@@ -149,7 +150,7 @@ public class DefaultEnvironmentalRecord
     /**
      * Sets the average air temperature along the flight pass during the photo flight.
      *
-     * @param newValue The new average air temperature value.
+     * @param  newValue  the new average air temperature value.
      */
     public void setAverageAirTemperature(final Double newValue) {
         checkWritePermission();
@@ -159,7 +160,7 @@ public class DefaultEnvironmentalRecord
     /**
      * Returns the maximum relative humidity along the flight pass during the photo flight.
      *
-     * @return Maximum relative humidity along the flight pass during the photo flight, or {@code null}.
+     * @return maximum relative humidity along the flight pass during the photo flight, or {@code null}.
      */
     @Override
     @ValueRange(minimum = 0, maximum = 100)
@@ -171,7 +172,7 @@ public class DefaultEnvironmentalRecord
     /**
      * Sets the maximum relative humidity along the flight pass during the photo flight.
      *
-     * @param newValue The new maximum relative humidity, or {@code null}.
+     * @param  newValue  the new maximum relative humidity, or {@code null}.
      * @throws IllegalArgumentException if the given value is out of range.
      */
     public void setMaxRelativeHumidity(final Double newValue) {
@@ -184,7 +185,7 @@ public class DefaultEnvironmentalRecord
     /**
      * Returns the maximum altitude during the photo flight.
      *
-     * @return Maximum altitude during the photo flight, or {@code null}.
+     * @return maximum altitude during the photo flight, or {@code null}.
      */
     @Override
     @XmlElement(name = "maxAltitude", required = true)
@@ -195,7 +196,7 @@ public class DefaultEnvironmentalRecord
     /**
      * Sets the maximum altitude value.
      *
-     * @param newValue The new maximum altitude value.
+     * @param  newValue  the new maximum altitude value.
      */
     public void setMaxAltitude(final Double newValue) {
         checkWritePermission();
@@ -205,7 +206,7 @@ public class DefaultEnvironmentalRecord
     /**
      * Returns the meteorological conditions in the photo flight area, in particular clouds, snow and wind.
      *
-     * @return Meteorological conditions in the photo flight area, or {@code null}.
+     * @return meteorological conditions in the photo flight area, or {@code null}.
      */
     @Override
     @XmlElement(name = "meteorologicalConditions", required = true)
@@ -216,7 +217,7 @@ public class DefaultEnvironmentalRecord
     /**
      * Sets the meteorological conditions in the photo flight area, in particular clouds, snow and wind.
      *
-     * @param newValue The meteorological conditions value.
+     * @param  newValue  the meteorological conditions value.
      */
     public void setMeteorologicalConditions(final InternationalString newValue) {
         checkWritePermission();

Modified: sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/DefaultEvent.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/DefaultEvent.java?rev=1779506&r1=1779505&r2=1779506&view=diff
==============================================================================
--- sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/DefaultEvent.java [UTF-8] (original)
+++ sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/DefaultEvent.java [UTF-8] Thu Jan 19 18:46:44 2017
@@ -54,6 +54,7 @@ import static org.apache.sis.internal.me
  * @version 0.3
  * @module
  */
+@SuppressWarnings("CloneableClassWithoutClone")                 // ModifiableMetadata needs shallow clones.
 @XmlType(name = "MI_Event_Type", propOrder = {
     "identifier",
     "trigger",
@@ -117,7 +118,7 @@ public class DefaultEvent extends ISOMet
      * This is a <cite>shallow</cite> copy constructor, since the other metadata contained in the
      * given object are not recursively copied.
      *
-     * @param object The metadata to copy values from, or {@code null} if none.
+     * @param  object  the metadata to copy values from, or {@code null} if none.
      *
      * @see #castOrCopy(Event)
      */
@@ -149,8 +150,8 @@ public class DefaultEvent extends ISOMet
      *       metadata contained in the given object are not recursively copied.</li>
      * </ul>
      *
-     * @param  object The object to get as a SIS implementation, or {@code null} if none.
-     * @return A SIS implementation containing the values of the given object (may be the
+     * @param  object  the object to get as a SIS implementation, or {@code null} if none.
+     * @return a SIS implementation containing the values of the given object (may be the
      *         given object itself), or {@code null} if the argument was null.
      */
     public static DefaultEvent castOrCopy(final Event object) {
@@ -163,7 +164,7 @@ public class DefaultEvent extends ISOMet
     /**
      * Returns the event name or number.
      *
-     * @return Event name or number, or {@code null}.
+     * @return event name or number, or {@code null}.
      */
     @Override
     @XmlElement(name = "identifier", required = true)
@@ -174,7 +175,7 @@ public class DefaultEvent extends ISOMet
     /**
      * Sets the event name or number.
      *
-     * @param newValue The event identifier value.
+     * @param  newValue  the event identifier value.
      */
     public void setIdentifier(final Identifier newValue) {
         checkWritePermission();
@@ -185,7 +186,7 @@ public class DefaultEvent extends ISOMet
     /**
      * Returns the initiator of the event.
      *
-     * @return Initiator of the event, or {@code null}.
+     * @return initiator of the event, or {@code null}.
      */
     @Override
     @XmlElement(name = "trigger", required = true)
@@ -196,7 +197,7 @@ public class DefaultEvent extends ISOMet
     /**
      * Sets the initiator of the event.
      *
-     * @param newValue The new trigger value.
+     * @param  newValue  the new trigger value.
      */
     public void setTrigger(final Trigger newValue) {
         checkWritePermission();
@@ -206,7 +207,7 @@ public class DefaultEvent extends ISOMet
     /**
      * Meaning of the event.
      *
-     * @return Meaning of the event, or {@code null}.
+     * @return meaning of the event, or {@code null}.
      */
     @Override
     @XmlElement(name = "context", required = true)
@@ -217,7 +218,7 @@ public class DefaultEvent extends ISOMet
     /**
      * Sets the meaning of the event.
      *
-     * @param newValue The new context value.
+     * @param  newValue  the new context value.
      */
     public void setContext(final Context newValue) {
         checkWritePermission();
@@ -227,7 +228,7 @@ public class DefaultEvent extends ISOMet
     /**
      * Returns the relative time ordering of the event.
      *
-     * @return Relative time ordering, or {@code null}.
+     * @return relative time ordering, or {@code null}.
      */
     @Override
     @XmlElement(name = "sequence", required = true)
@@ -238,7 +239,7 @@ public class DefaultEvent extends ISOMet
     /**
      * Sets the relative time ordering of the event.
      *
-     * @param newValue The new sequence value.
+     * @param  newValue  the new sequence value.
      */
     public void setSequence(final Sequence newValue) {
         checkWritePermission();
@@ -248,7 +249,7 @@ public class DefaultEvent extends ISOMet
     /**
      * Returns the time the event occurred.
      *
-     * @return Time the event occurred, or {@code null}.
+     * @return time the event occurred, or {@code null}.
      */
     @Override
     @XmlElement(name = "time", required = true)
@@ -259,7 +260,7 @@ public class DefaultEvent extends ISOMet
     /**
      * Sets the time the event occurred.
      *
-     * @param newValue The new time value.
+     * @param  newValue  the new time value.
      */
     public void setTime(final Date newValue) {
         checkWritePermission();
@@ -269,7 +270,7 @@ public class DefaultEvent extends ISOMet
     /**
      * Returns the objective or objectives satisfied by an event.
      *
-     * @return Objectives satisfied by an event.
+     * @return objectives satisfied by an event.
      */
     @Override
     @XmlElement(name = "expectedObjective")
@@ -280,7 +281,7 @@ public class DefaultEvent extends ISOMet
     /**
      * Sets the objective or objectives satisfied by an event.
      *
-     * @param newValues The new expected objectives values.
+     * @param  newValues  the new expected objectives values.
      */
     public void setExpectedObjectives(final Collection<? extends Objective> newValues) {
         expectedObjectives = writeCollection(newValues, expectedObjectives, Objective.class);
@@ -289,7 +290,7 @@ public class DefaultEvent extends ISOMet
     /**
      * Returns the pass during which an event occurs. {@code null} if unspecified.
      *
-     * @return Pass during which an event occurs, or {@code null}.
+     * @return pass during which an event occurs, or {@code null}.
      */
     @Override
     @XmlElement(name = "relatedPass")
@@ -300,7 +301,7 @@ public class DefaultEvent extends ISOMet
     /**
      * Sets the pass during which an event occurs.
      *
-     * @param newValue The new platform pass value.
+     * @param  newValue  the new platform pass value.
      */
     public void setRelatedPass(final PlatformPass newValue) {
         relatedPass = newValue;
@@ -309,7 +310,7 @@ public class DefaultEvent extends ISOMet
     /**
      * Returns the instrument or instruments for which the event is meaningful.
      *
-     * @return Instruments for which the event is meaningful.
+     * @return instruments for which the event is meaningful.
      */
     @Override
     @XmlElement(name = "relatedSensor")
@@ -320,7 +321,7 @@ public class DefaultEvent extends ISOMet
     /**
      * Sets the instrument or instruments for which the event is meaningful.
      *
-     * @param newValues The new instrument values.
+     * @param  newValues  the new instrument values.
      */
     public void setRelatedSensors(final Collection<? extends Instrument> newValues) {
         relatedSensors = writeCollection(newValues, relatedSensors, Instrument.class);

Modified: sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/DefaultInstrument.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/DefaultInstrument.java?rev=1779506&r1=1779505&r2=1779506&view=diff
==============================================================================
--- sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/DefaultInstrument.java [UTF-8] (original)
+++ sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/DefaultInstrument.java [UTF-8] Thu Jan 19 18:46:44 2017
@@ -47,6 +47,7 @@ import org.apache.sis.internal.jaxb.NonM
  * @version 0.3
  * @module
  */
+@SuppressWarnings("CloneableClassWithoutClone")                 // ModifiableMetadata needs shallow clones.
 @XmlType(name = "MI_Instrument_Type", propOrder = {
     "citations",
     "identifier",
@@ -92,7 +93,7 @@ public class DefaultInstrument extends I
      * This is a <cite>shallow</cite> copy constructor, since the other metadata contained in the
      * given object are not recursively copied.
      *
-     * @param object The metadata to copy values from, or {@code null} if none.
+     * @param  object  the metadata to copy values from, or {@code null} if none.
      *
      * @see #castOrCopy(Instrument)
      */
@@ -121,8 +122,8 @@ public class DefaultInstrument extends I
      *       metadata contained in the given object are not recursively copied.</li>
      * </ul>
      *
-     * @param  object The object to get as a SIS implementation, or {@code null} if none.
-     * @return A SIS implementation containing the values of the given object (may be the
+     * @param  object  the object to get as a SIS implementation, or {@code null} if none.
+     * @return a SIS implementation containing the values of the given object (may be the
      *         given object itself), or {@code null} if the argument was null.
      */
     public static DefaultInstrument castOrCopy(final Instrument object) {
@@ -135,7 +136,7 @@ public class DefaultInstrument extends I
     /**
      * Returns the complete citation of the instrument.
      *
-     * @return Complete citation of the instrument.
+     * @return complete citation of the instrument.
      */
     @Override
     @XmlElement(name = "citation")
@@ -146,7 +147,7 @@ public class DefaultInstrument extends I
     /**
      * Sets the complete citation of the instrument.
      *
-     * @param newValues The new citation values.
+     * @param  newValues  the new citation values.
      */
     public void setCitations(final Collection<? extends Citation> newValues) {
         citations = writeCollection(newValues, citations, Citation.class);
@@ -155,7 +156,7 @@ public class DefaultInstrument extends I
     /**
      * Returns the unique identification of the instrument.
      *
-     * @return Unique identification of the instrument, or {@code null}.
+     * @return unique identification of the instrument, or {@code null}.
      */
     @Override
     @XmlElement(name = "identifier", required = true)
@@ -166,7 +167,7 @@ public class DefaultInstrument extends I
     /**
      * Sets the unique identification of the instrument.
      *
-     * @param newValue The new identifier value.
+     * @param  newValue  the new identifier value.
      */
     public void setIdentifier(final Identifier newValue) {
         checkWritePermission();
@@ -177,7 +178,7 @@ public class DefaultInstrument extends I
     /**
      * Returns the name of the type of instrument. Examples: framing, line-scan, push-broom, pan-frame.
      *
-     * @return Type of instrument, or {@code null}.
+     * @return type of instrument, or {@code null}.
      */
     @Override
     @XmlElement(name = "type", required = true)
@@ -188,7 +189,7 @@ public class DefaultInstrument extends I
     /**
      * Sets the name of the type of instrument. Examples: framing, line-scan, push-broom, pan-frame.
      *
-     * @param newValue The new type value.
+     * @param  newValue  the new type value.
      */
     public void setType(final InternationalString newValue) {
         checkWritePermission();
@@ -198,7 +199,7 @@ public class DefaultInstrument extends I
     /**
      * Returns the textual description of the instrument. {@code null} if unspecified.
      *
-     * @return Textual description, or {@code null}.
+     * @return textual description, or {@code null}.
      */
     @Override
     @XmlElement(name = "description")
@@ -209,7 +210,7 @@ public class DefaultInstrument extends I
     /**
      * Sets the textual description of the instrument.
      *
-     * @param newValue The new description value.
+     * @param  newValue  the new description value.
      */
     public void setDescription(final InternationalString newValue) {
         checkWritePermission();
@@ -219,7 +220,7 @@ public class DefaultInstrument extends I
     /**
      * Returns the platform on which the instrument is mounted. {@code null} if unspecified.
      *
-     * @return Platform on which the instrument is mounted, or {@code null}.
+     * @return platform on which the instrument is mounted, or {@code null}.
      */
     @Override
     @XmlElement(name = "mountedOn")
@@ -230,7 +231,7 @@ public class DefaultInstrument extends I
     /**
      * Sets the platform on which the instrument is mounted.
      *
-     * @param newValue The new platform value.
+     * @param  newValue  the new platform value.
      */
     public void setMountedOn(final Platform newValue) {
         checkWritePermission();

Modified: sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/DefaultObjective.java
URL: http://svn.apache.org/viewvc/sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/DefaultObjective.java?rev=1779506&r1=1779505&r2=1779506&view=diff
==============================================================================
--- sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/DefaultObjective.java [UTF-8] (original)
+++ sis/branches/JDK8/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/acquisition/DefaultObjective.java [UTF-8] Thu Jan 19 18:46:44 2017
@@ -51,6 +51,7 @@ import org.apache.sis.internal.jaxb.NonM
  * @version 0.7
  * @module
  */
+@SuppressWarnings("CloneableClassWithoutClone")                 // ModifiableMetadata needs shallow clones.
 @XmlType(name = "MI_Objective_Type", propOrder = {
     "identifiers",
     "priority",
@@ -115,7 +116,7 @@ public class DefaultObjective extends IS
      * This is a <cite>shallow</cite> copy constructor, since the other metadata contained in the
      * given object are not recursively copied.
      *
-     * @param object The metadata to copy values from, or {@code null} if none.
+     * @param  object  the metadata to copy values from, or {@code null} if none.
      *
      * @see #castOrCopy(Objective)
      */
@@ -147,8 +148,8 @@ public class DefaultObjective extends IS
      *       metadata contained in the given object are not recursively copied.</li>
      * </ul>
      *
-     * @param  object The object to get as a SIS implementation, or {@code null} if none.
-     * @return A SIS implementation containing the values of the given object (may be the
+     * @param  object  the object to get as a SIS implementation, or {@code null} if none.
+     * @return a SIS implementation containing the values of the given object (may be the
      *         given object itself), or {@code null} if the argument was null.
      */
     public static DefaultObjective castOrCopy(final Objective object) {
@@ -170,7 +171,7 @@ public class DefaultObjective extends IS
      * The {@code <gmd:identifier>} element marshalled to XML will exclude all the above cited identifiers,
      * for ISO 19139 compliance. Those identifiers will appear in other XML elements or attributes.</div>
      *
-     * @return Identify the objective.
+     * @return identification of the objective.
      */
     @Override
     @XmlElement(name = "identifier", required = true)
@@ -184,7 +185,7 @@ public class DefaultObjective extends IS
      * <p>XML identifiers ({@linkplain IdentifierSpace#ID ID}, {@linkplain IdentifierSpace#UUID UUID}, <i>etc.</i>),
      * are not affected by this method, unless they are explicitely provided in the given collection.</p>
      *
-     * @param newValues The new identifiers values.
+     * @param  newValues  the new identifiers values.
      */
     public void setIdentifiers(Collection<? extends Identifier> newValues) {
         newValues = NonMarshalledAuthority.setMarshallables(identifiers, newValues);
@@ -194,7 +195,7 @@ public class DefaultObjective extends IS
     /**
      * Returns the priority applied to the target. {@code null} if unspecified.
      *
-     * @return Priority applied, or {@code null}.
+     * @return priority applied, or {@code null}.
      */
     @Override
     @XmlElement(name = "priority")
@@ -205,7 +206,7 @@ public class DefaultObjective extends IS
     /**
      * Sets the priority applied to the target.
      *
-     * @param newValue The new priority value.
+     * @param  newValue  the new priority value.
      */
     public void setPriority(final InternationalString newValue) {
         checkWritePermission();
@@ -215,7 +216,7 @@ public class DefaultObjective extends IS
     /**
      * Returns the collection technique for the objective.
      *
-     * @return Collection technique for the objective.
+     * @return collection technique for the objective.
      */
     @Override
     @XmlElement(name = "type")
@@ -226,7 +227,7 @@ public class DefaultObjective extends IS
     /**
      * Sets the collection technique for the objective.
      *
-     * @param newValues The new types values.
+     * @param  newValues  the new types values.
      */
     public void setTypes(final Collection<? extends ObjectiveType> newValues) {
         types = writeCollection(newValues, types, ObjectiveType.class);
@@ -235,7 +236,7 @@ public class DefaultObjective extends IS
     /**
      * Returns the role or purpose performed by or activity performed at the objective.
      *
-     * @return Role or purpose performed by or activity performed at the objective.
+     * @return role or purpose performed by or activity performed at the objective.
      */
     @Override
     @XmlElement(name = "function")
@@ -246,7 +247,7 @@ public class DefaultObjective extends IS
     /**
      * Sets the role or purpose performed by or activity performed at the objective.
      *
-     * @param newValues The new functions values.
+     * @param  newValues  the new functions values.
      */
     public void setFunctions(final Collection<? extends InternationalString> newValues) {
         functions = writeCollection(newValues, functions, InternationalString.class);
@@ -256,7 +257,7 @@ public class DefaultObjective extends IS
      * Returns the extent information including the bounding box, bounding polygon, vertical and
      * temporal extent of the objective.
      *
-     * @return Extent information.
+     * @return extent information.
      */
     @Override
     @XmlElement(name = "extent")
@@ -268,7 +269,7 @@ public class DefaultObjective extends IS
      * Sets the extent information including the bounding box, bounding polygon, vertical and
      * temporal extent of the objective.
      *
-     * @param newValues The new extents values.
+     * @param  newValues  the new extents values.
      */
     public void setExtents(final Collection<? extends Extent> newValues) {
         extents = writeCollection(newValues, extents, Extent.class);
@@ -277,7 +278,7 @@ public class DefaultObjective extends IS
     /**
      * Returns the event or events associated with objective completion.
      *
-     * @return Events associated with objective completion.
+     * @return events associated with objective completion.
      */
     @Override
     @XmlElement(name = "objectiveOccurence", required = true)
@@ -288,7 +289,7 @@ public class DefaultObjective extends IS
     /**
      * Sets the event or events associated with objective completion.
      *
-     * @param newValues The new objective occurrences values.
+     * @param  newValues  the new objective occurrences values.
      */
     public void setObjectiveOccurences(final Collection<? extends Event> newValues) {
         objectiveOccurences = writeCollection(newValues, objectiveOccurences, Event.class);
@@ -297,7 +298,7 @@ public class DefaultObjective extends IS
     /**
      * Returns the pass of the platform over the objective.
      *
-     * @return Pass of the platform.
+     * @return pass of the platform.
      */
     @Override
     @XmlElement(name = "pass")
@@ -308,7 +309,7 @@ public class DefaultObjective extends IS
     /**
      * Sets the pass of the platform over the objective.
      *
-     * @param newValues The new pass values.
+     * @param  newValues  the new pass values.
      */
     public void setPass(final Collection<? extends PlatformPass> newValues) {
         pass = writeCollection(newValues, pass, PlatformPass.class);
@@ -317,7 +318,7 @@ public class DefaultObjective extends IS
     /**
      * Returns the instrument which senses the objective data.
      *
-     * @return Instrument which senses the objective data.
+     * @return instrument which senses the objective data.
      */
     @Override
     @XmlElement(name = "sensingInstrument")
@@ -328,7 +329,7 @@ public class DefaultObjective extends IS
     /**
      * Sets the instrument which senses the objective data.
      *
-     * @param newValues The new sensing instruments values.
+     * @param  newValues  the new sensing instruments values.
      */
     public void setSensingInstruments(final Collection<? extends Instrument> newValues) {
         sensingInstruments = writeCollection(newValues, sensingInstruments, Instrument.class);



Mime
View raw message