top of page
admin

Hiding javadoc elements with the @exclude tag

When creating html documentation with Oracle’s javadoc tool, it is often useful to be able to hide certain public elements that would usually show up in the output.


One solution is to use Android’s Doclava doclet, but it does not support all of the features of Oracle’s standard doclet.


The ExcludeDoclet, however, is a thin wrapper around Oracle’s standard doclet that introduces a new “@exclude” tag, which works just like Doclava’s “@hide” tag.


But when using ExcludeDoclet, we found that parameterized types were not output correctly, which was easily fixed by having ExcludeDoclet extend Oracle’s standard doclet.


Here is a zip file that contains the new doclet: ExcludeDoclet.zip


To compile the doclet, run the shell script “./make_doclet”.


To test the doclet, run “./test_doclet” and then load “docs/index.html” in your browser.

930 views0 comments

Comments


bottom of page