Deepa Remesh wrote:
Noticed following javadoc warning in trunk:
java\engine\org\apache\derby\iapi\types\XML.java:163: warning - Tag
@return cannot be used in constructor documentation. It can only be
used in the following types of documentation: method.
[javadoc] 1 warning
Ack, keep forgetting to run javadoc before posting my patches. Attached diff
should fix it (this will have to be ported to 10.2, as well). Any committers
out there available for what should be a harmless commit?
Sorry,
Army
Index: java/engine/org/apache/derby/iapi/types/XML.java
===================================================================
--- java/engine/org/apache/derby/iapi/types/XML.java (revision 442294)
+++ java/engine/org/apache/derby/iapi/types/XML.java (working copy)
@@ -151,14 +151,14 @@
/**
* Private constructor used for the getClone() method.
+ * Returns a new instance of XML whose fields are clones
+ * of the values received.
*
* @param val A SQLChar instance to clone and use for
* this XML value.
* @param xmlType Qualified XML type for "val"
* @param seqWithAttr Whether or not "val" corresponds to
* sequence with one or more top-level attribute nodes.
- * @return A new instance of XML whose fields are clones
- * of the values received.
*/
private XML(SQLChar val, int xmlType, boolean seqWithAttr)
{