This patch enables replacement of xerces specific javadoc tags in jdk < 1.4.
Also contains fixes to javadoc in some files.
Ankit Pasricha
XML Parser Development
IBM Toronto Lab
8200 Warden Avenue, Ontario L6G 1C7
Phone: (905) 413 4941
Index: build.xml
===================================================================
RCS file: /home/cvspublic/xml-xerces/java/build.xml,v
retrieving revision 1.175
diff -u -r1.175 build.xml
--- build.xml 4 Oct 2004 21:17:22 -0000 1.175
+++ build.xml 13 Oct 2004 14:24:46 -0000
@@ -53,7 +53,7 @@
<echo message= "---------------- ${parser.Name} ${parser.Version} [${year}]
---------------"/>
<!-- changed made to synchronize with a patch from Sam Ruby (<[EMAIL PROTECTED]>)
to Xerces1
<property name="build.compiler" value="classic"/> -->
- <property name="debug" value="off"/>
+ <property name="debug" value="on"/>
<property name="optimize" value="on"/>
<property name="deprecation" value="off"/>
@@ -364,19 +364,32 @@
</target>
+
+ <target name="javadoc-replace" unless="additional.param">
+ <replace token="@xerces.internal" dir="${build.src}">
+ <replacevalue><![CDATA[<DT><H1
style="font-size:110%">INTERNAL:</H1><DD>This type should not be directly used by the
user. The methods/fields defined can be altered or removed at any
time.]]></replacevalue>
+ </replace>
+
+ <replace token="@xerces.experimental" dir="${build.src}">
+ <replacevalue><![CDATA[<DT><H1
style="font-size:150%">EXPERIMENTAL:</H1><DD>This interface should not be considered
stable. It is likely to be altered or replaced in the future.]]></replacevalue>
+ </replace>
+ </target>
+
<!-- =================================================================== -->
<!-- Creates the API documentation -->
<!-- =================================================================== -->
<target name="javadocs" depends="prepare-src">
-
+
+ <condition property="additional.param" value="
@${tools.dir}\bin\xerces2taglets.opt -tagletpath ${tools.dir}\bin\xerces2taglets.jar">
+ <available classname="com.sun.tools.doclets.Taglet"/>
+ </condition>
+
+ <antcall target="javadoc-replace" />
+
<condition property="additional.param" value="">
<not>
<available classname="com.sun.tools.doclets.Taglet"/>
</not>
- </condition>
-
- <condition property="additional.param" value="
@${tools.dir}\bin\xerces2taglets.opt -tagletpath ${tools.dir}\bin\xerces2taglets.jar">
- <available classname="com.sun.tools.doclets.Taglet"/>
</condition>
<mkdir dir='${build.dir}/docs/javadocs/api'/>
Index: src/org/apache/xerces/dom/AttrImpl.java
===================================================================
RCS file: /home/cvspublic/xml-xerces/java/src/org/apache/xerces/dom/AttrImpl.java,v
retrieving revision 1.60
diff -u -r1.60 AttrImpl.java
--- src/org/apache/xerces/dom/AttrImpl.java 5 Oct 2004 17:12:51 -0000 1.60
+++ src/org/apache/xerces/dom/AttrImpl.java 13 Oct 2004 14:24:47 -0000
@@ -98,9 +98,9 @@
* <p><b>WARNING</b>: Some of the code here is partially duplicated in
* ParentNode, be careful to keep these two classes in sync!
*
- * @see AttrNSImpl
- *
- * @xerces.internal
+ * @xerces.internal
+ *
+ * @see AttrNSImpl
*
* @author Arnaud Le Hors, IBM
* @author Joe Kesselman, IBM
Index: src/org/apache/xerces/dom/DeferredElementNSImpl.java
===================================================================
RCS file:
/home/cvspublic/xml-xerces/java/src/org/apache/xerces/dom/DeferredElementNSImpl.java,v
retrieving revision 1.19
diff -u -r1.19 DeferredElementNSImpl.java
--- src/org/apache/xerces/dom/DeferredElementNSImpl.java 5 Oct 2004 17:12:50
-0000 1.19
+++ src/org/apache/xerces/dom/DeferredElementNSImpl.java 13 Oct 2004 14:24:47
-0000
@@ -31,9 +31,10 @@
/**
* DeferredElementNSImpl is to ElementNSImpl, what DeferredElementImpl is to
* ElementImpl.
- * @see DeferredElementImpl
*
* @xerces.internal
+ *
+ * @see DeferredElementImpl
*/
public class DeferredElementNSImpl
extends ElementNSImpl
Index: src/org/apache/xerces/impl/xs/XSDDescription.java
===================================================================
RCS file:
/home/cvspublic/xml-xerces/java/src/org/apache/xerces/impl/xs/XSDDescription.java,v
retrieving revision 1.12
diff -u -r1.12 XSDDescription.java
--- src/org/apache/xerces/impl/xs/XSDDescription.java 6 Oct 2004 15:14:54 -0000
1.12
+++ src/org/apache/xerces/impl/xs/XSDDescription.java 13 Oct 2004 14:24:49 -0000
@@ -22,7 +22,7 @@
import org.apache.xerces.xni.grammars.XMLGrammarDescription;
import org.apache.xerces.xni.grammars.XMLSchemaDescription;
-/*
+/**
* All information specific to XML Schema grammars.
*
* @xerces.internal
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
