This plugin is used to generate JavaDoc style documentation for JSF tag libraries! It uses OmniFaces Vdldoc for this job. To generate documentation for all .taglib.xml files found in the current project, you have two possibilities.
Declare the plugin in your pom.xml as follows:
<project> ... <reporting> <plugins> <plugin> <groupId>com.github.matinh.vdldoc</groupId> <artifactId>vdldoc-maven-plugin</artifactId> <version>2.0</version> </plugin> </plugins> </reporting> ... </project>
To generate the site including the documentation execute
mvn site
The generated report will be included in the site and a link to it will be created.
To execute only the Vdldoc generation standalong, declare the plugin in your pom.xml in the build section instead of the reporting section:
<project> ... <build> <plugins> <plugin> <groupId>com.github.matinh.vdldoc</groupId> <artifactId>vdldoc-maven-plugin</artifactId> <version>2.0</version> </plugin> </plugins> </build> ... </project>
And execute the command
mvn vdldoc:vdldoc
The generated documentation can be found in the projects build directory (usually named target) in a newly created folder site/vdldoc.