CodeVocabJavadoc

From VoCamp Wiki
Jump to: navigation, search

JavaDoc tool Doclets homepage JavaDoc class

Classes in com.sun.javadoc:

  1. ClassDoc Represents a java class or interface and provides access to information about the class, the class's comment and tags, and the members of the class.
  2. ConstructorDoc Represents a constructor of a java class.
  3. Doc Represents Java language constructs (package, class, constructor, method, field) which have comments and have been processed by this run of javadoc.
  4. DocErrorReporter This interface provides error, warning and notice printing.
  5. ExecutableMemberDoc Represents a method or constructor of a java class.
  6. FieldDoc Represents a field in a java class.
  7. MemberDoc Represents a member of a java class: field, constructor, or method.
  8. MethodDoc Represents a method of a java class.
  9. PackageDoc Represents a java package.
  10. Parameter Parameter information.
  11. ParamTag Represents an @param documentation tag.
  12. ProgramElementDoc Represents a java program element: class, interface, field, constructor, or method.
  13. RootDoc Represents the root of the program structure information for one run of javadoc.
  14. SeeTag Represents a user-defined cross-reference to related documentation.
  15. SerialFieldTag Documents a Serializable field defined by an ObjectStreamField.
  16. SourcePosition This interface describes a source position: filename, line number, and column number.
  17. Tag Represents a simple documentation tag, such as @since, @author, @version.
  18. ThrowsTag Represents a @throws or @exception documentation tag.
  19. Type Represents a java type.

Tags:

  1. @param
  2. @return (reference page)
  3. @throws (@exception was the original tag) (reference page)
  4. @author (reference page)
  5. @version (reference page)
  6. @serial
  7. @serialField
  8. @serialData
  9. @deprecated (reference page)
  10. {@link} (Added in Javadoc 1.2) (reference page)


HTML documentation:

Package:

  1. Package name
  2. Package short description
  3. For each interface: name and description
  4. For each class: name and description
  5. Package long description

Interface:

  1. Package name
  2. Interface name
  3. All super and subinterfaces
  4. Description
  5. Tags: SeeAlso, Since etc.
  6. For each method: return type and description, method name, method description, parameter type, name and description
  7. Methods inherited from super-interfaces

Class:

  1. Package name
  2. Class name
  3. Superclass
  4. Description
  5. For each constructor and method: return type and description, method name, method description, parameter type, name and description

Standard Doclet produces completely unsemantic HTML