Skip to content

JamesGreen31/demo-javadoc-8-tags

 
 

Repository files navigation

Javadoc 8 Tags

This project provides the code samples for the CodeFX blog post about the new Javadoc tags @apiNote, @implSpec and @implNote, which are first used in Java 8.

This includes:

  • an interface Lottery which uses them
  • implementing classes which show how to inherit the tags:
    • OldLottery does not implement the default method ~> the method has no documentation block in the class comment
    • PrivateLottery provides no Javadoc for its implementation ~> the documentation from the default method is copied (and a remark added) without the new tags
    • StateLottery uses {@inheritDoc} ~> inherits the documentation without the new tags
    • UselessLottery uses, e.g., @apiNote {@inheritDoc} ~> inherits those specific tags
  • the pom.xml needed to let Maven parameterize Javadoc so that it process the tags
  • the created Javadoc to make things a little easier for the Maven averse

About

Demonstrates the new Javadoc tags used in Java 8

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • CSS 71.9%
  • Java 23.5%
  • JavaScript 4.6%