123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254 |
- <!-- ===================================================================
-
- Apache JavaDoc DTD (version 0.4-draft)
-
- PURPOSE:
- This DTD is designed to capture the output of JavaDoc as an XML document
- through the use of the JavaDocXML Doclet. The hope is that by having the
- JavaDoc documentation in an XML format, it will be easier for application
- developers working with XML to treat their java source documentation in the
- same way they treat any other XML document within their publication framework.
-
- This DTD should reflect the information contained within the RootDoc object
- passed to the JavaDocXML Doclet by JavaDoc. The RootDoc object and the rest
- of the javaDoc Doclet API is specified at
-
- http://java.sun.com/products/jdk/1.2/docs/tooldocs/javadoc/doclet/index.html
-
- The only information that appears to be difficult to derive from this DTD
- that is easy to obtain from the RootDoc object is the information about
- serialization. However, this information should be derivable by manually
- looking for the correct serialization methods and other related structures.
-
- TYPICAL INVOCATION:
-
- <!DOCTYPE document PUBLIC
- "-//APACHE//DTD JavaDoc Vx.yz//EN"
- "http://xml.apache.org/DTD/javadoc-vxyz.dtd">
-
- where
-
- x := major version
- y := minor version
- z := status identifier (optional)
-
- NOTES:
- The authors would like to thank the Cocoon's mail list subscribers for
- providing such great support and feedback for this DTD.
-
- AUTHORS:
- Kenneth Murphy <murphyk@umsystem.edu>
-
- FIXME:
-
- CHANGE HISTORY:
- 199909?? Original idea of XML doclet. (KM)
- 199910?? Initial version of this DTD. (KM)
- 19991129 Cleaned up DTD. (SM)
-
- COPYRIGHT:
- Copyright (c) @year@ The Apache Software Foundation.
-
- Permission to copy in any form is granted provided this notice is
- included in all copies. Permission to redistribute is granted
- provided this file is distributed untouched in all its parts and
- included files.
-
- ==================================================================== -->
-
- <!-- =============================================================== -->
- <!-- Common Attribute Entities -->
- <!-- =============================================================== -->
-
- <!ENTITY % name 'name CDATA #REQUIRED'>
- <!ENTITY % dimension 'dimension CDATA #REQUIRED'>
-
- <!ENTITY % abstract 'abstract (true | false) "false"'>
- <!ENTITY % anonymous 'anonymous (true | false) "false"'>
- <!ENTITY % synthetic 'synthetic (true | false) "false"'>
- <!ENTITY % static 'static (true | false) "false"'>
- <!ENTITY % final 'final (true | false) "false"'>
- <!ENTITY % transient 'transient (true | false) "false"'>
- <!ENTITY % volatile 'volatile (true | false) "false"'>
- <!ENTITY % native 'native (true | false) "false"'>
- <!ENTITY % synchronized 'synchronized (true | false) "false"'>
-
- <!ENTITY % access 'access (private | package | protected | public) "package"'>
- <!ENTITY % class.access 'access (package | public) "package"'>
-
- <!ENTITY % extensibility 'extensibility (abstract | final | default) "default"'>
-
-
- <!-- =============================================================== -->
- <!-- Javadoc -->
- <!-- =============================================================== -->
-
- <!ELEMENT javadoc (package*, class*, interface*)>
-
- <!-- =============================================================== -->
- <!-- Package -->
- <!-- =============================================================== -->
-
- <!ELEMENT package (doc?, package*, class*, interface*)>
- <!ATTLIST package %name;>
-
- <!-- =============================================================== -->
- <!-- Class -->
- <!-- =============================================================== -->
-
- <!ELEMENT class (doc?,
- extends_class?,
- implements?,
- field*,
- constructor*,
- method*,
- innerclass*)>
- <!ATTLIST class
- %name;
- %extensibility;
- %class.access;>
-
- <!ELEMENT extends_class (classref+)>
-
- <!ELEMENT innerclass (doc?,
- extends?,
- implements?,
- field*,
- constructor*,
- method*)>
- <!ATTLIST innerclass
- %name;
- %access;
- %abstract;
- %anonymous;
- %final;
- %static;>
-
- <!-- =============================================================== -->
- <!-- Interface -->
- <!-- =============================================================== -->
-
- <!ELEMENT interface (doc?,
- extends_interface?,
- field*,
- method*)>
- <!ATTLIST interface
- %name;
- %access;>
-
- <!ELEMENT extends_interface (interfaceref+)>
-
- <!-- =============================================================== -->
- <!-- Elements -->
- <!-- =============================================================== -->
-
- <!ELEMENT implements (interfaceref+)>
-
- <!ELEMENT throws (classref)+>
-
- <!ELEMENT classref EMPTY>
- <!ATTLIST classref %name;>
-
- <!ELEMENT interfaceref EMPTY>
- <!ATTLIST interfaceref %name;>
-
- <!ELEMENT methodref EMPTY>
- <!ATTLIST methodref %name;>
-
- <!ELEMENT packageref EMPTY>
- <!ATTLIST packageref %name;>
-
- <!ELEMENT primitive EMPTY>
- <!ATTLIST primitive
- type (void | boolean | int | long | byte | short | double | float | char) #REQUIRED>
-
- <!ELEMENT field (doc?, (classref | interfaceref | primitive))>
- <!ATTLIST field
- %name;
- %access;
- %dimension;
- %synthetic;
- %static;
- %final;
- %transient;
- %volatile;>
-
- <!ELEMENT constructor (doc?, parameter*, throws*)>
- <!ATTLIST constructor
- %name;
- %access;
- %synthetic;>
-
- <!ELEMENT method (doc?, returns, parameter*, throws*)>
- <!ATTLIST method
- %name;
- %access;
- %extensibility;
- %native;
- %synthetic;
- %static;
- %synchronized;>
-
- <!ELEMENT returns (classref | interfaceref | primitive)>
- <!ATTLIST returns %dimension;>
-
- <!ELEMENT parameter (classref | interfaceref | primitive)>
- <!ATTLIST parameter
- %name;
- %final;
- %dimension;>
-
- <!ELEMENT dimension (#PCDATA)>
-
- <!ELEMENT doc (#PCDATA |
- linktag |
- authortag |
- versiontag |
- paramtag |
- returntag |
- exceptiontag |
- throwstag |
- seetag |
- sincetag |
- deprecatedtag |
- serialtag |
- serialfieldtag |
- serialdatatag)*>
-
- <!ELEMENT linktag (#PCDATA)>
- <!ATTLIST linktag
- src CDATA #REQUIRED>
-
- <!ELEMENT authortag (#PCDATA | linktag)*>
-
- <!ELEMENT versiontag (#PCDATA | linktag)*>
-
- <!ELEMENT paramtag (#PCDATA | linktag)*>
- <!ATTLIST paramtag %name;>
-
- <!ELEMENT returntag (#PCDATA | linktag)*>
-
- <!ELEMENT exceptiontag (#PCDATA | classref | linktag)*>
-
- <!ELEMENT throwstag (#PCDATA | classref | linktag)*>
-
- <!ELEMENT seetag (#PCDATA | linktag)*>
- <!ATTLIST seetag
- src CDATA #REQUIRED>
-
- <!ELEMENT sincetag (#PCDATA | linktag)*>
-
- <!ELEMENT deprecatedtag (#PCDATA | linktag)*>
-
- <!ELEMENT serialtag (#PCDATA | linktag)*>
-
- <!ELEMENT serialfieldtag (#PCDATA | linktag)*>
- <!ATTLIST serialfieldtag
- fieldname CDATA #REQUIRED
- fieldtype CDATA #REQUIRED>
-
- <!ELEMENT serialdatatag (#PCDATA | linktag)*>
-
- <!-- =============================================================== -->
- <!-- End of DTD -->
- <!-- =============================================================== -->
|