Author: desruisseaux
Date: Wed Jul 31 08:06:33 2013
New Revision: 1508761
URL: http://svn.apache.org/r1508761
Log:
Minor documentation clarification.
Modified:
sis/branches/JDK7/core/sis-metadata/src/main/java/org/apache/sis/metadata/TreeNodeChildren.java
sis/branches/JDK7/core/sis-utility/src/main/java/org/apache/sis/xml/NilReason.java
Modified:
sis/branches/JDK7/core/sis-metadata/src/main/java/org/apache/sis/metadata/TreeNodeChildren.java
URL:
http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-metadata/src/main/java/org/apache/sis/metadata/TreeNodeChildren.java?rev=1508761&r1=1508760&r2=1508761&view=diff
==============================================================================
---
sis/branches/JDK7/core/sis-metadata/src/main/java/org/apache/sis/metadata/TreeNodeChildren.java
[UTF-8] (original)
+++
sis/branches/JDK7/core/sis-metadata/src/main/java/org/apache/sis/metadata/TreeNodeChildren.java
[UTF-8] Wed Jul 31 08:06:33 2013
@@ -473,7 +473,8 @@ final class TreeNodeChildren extends Abs
* are ignored.
*
* <p>If the identified property is a collection, then this method adds
the value to that collection.
- * Otherwise the new value will be set only if the previous value is null
or empty.</p>
+ * Otherwise the new value will be set only if the previous value is null,
+ * {@linkplain org.apache.sis.xml.NilObject nil} or empty.</p>
*
* <p>This method does not iterate explicitly through the children list,
because adding a metadata
* object implicitly adds all its children.</p>
Modified:
sis/branches/JDK7/core/sis-utility/src/main/java/org/apache/sis/xml/NilReason.java
URL:
http://svn.apache.org/viewvc/sis/branches/JDK7/core/sis-utility/src/main/java/org/apache/sis/xml/NilReason.java?rev=1508761&r1=1508760&r2=1508761&view=diff
==============================================================================
---
sis/branches/JDK7/core/sis-utility/src/main/java/org/apache/sis/xml/NilReason.java
[UTF-8] (original)
+++
sis/branches/JDK7/core/sis-utility/src/main/java/org/apache/sis/xml/NilReason.java
[UTF-8] Wed Jul 31 08:06:33 2013
@@ -431,6 +431,12 @@ public final class NilReason implements
* <p><b>REMINDER:<b> If more special cases are added, do not forget to
update the {@link #mayBeNil(Object)}
* method and to update the {@link #createNilObject(Class)} and {@link
#forObject(Object)} javadoc.</p>
*
+ * {@note There is no special case for <code>Character</code> because Java
<code>char</code>s are not really
+ * full Unicode characters. They are parts of UTF-16 encoding
instead. If there is a need to represent
+ * a single Unicode character, we should probably still use a
<code>String</code> where the string may
+ * contain up to 2 Java characters. This may also facilitate the
encoding in the XML files, since many
+ * files use an other encoding than UTF-16 anyway.}
+ *
* @throws IllegalArgumentException If the given type is not a supported
type.
*/
private static Object createNilPrimitive(final Class<?> type) {
