Information About

Javadoc




Javadoc is the industry standard for documenting Java classes. Most IDE s will automatically generate Javadoc HTML .

Javadoc also provides an API for creating Doclets and Taglets , which allows you to analyze the structure of a Java application. This is how JDiff can generate reports of what changed between two versions of an API.


EXAMPLE


An example of using Javadoc to document a method follows. Notice that spacing and quantity of characters in this example are as conventions state.

  • ---

  • Validates a chess move.


  • @param theFromFile file from which a piece is being moved

  • @param theFromRank rank from which a piece is being moved

  • @param theToFile file to which a piece is being moved

  • @param theToRank rank to which a piece is being moved

  • @return true if the chess move is valid, otherwise false

  • @author John Doe

  • /

  • boolean isValidMove(int theFromFile, int theFromRank, int theToFile, int theToRank)

{
...
}


SEE ALSO




EXTERNAL LINKS