You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@maven.apache.org by "Hudson (Jira)" <ji...@apache.org> on 2021/05/16 18:23:00 UTC
[jira] [Commented] (MJAVADOC-453) Using Alternate Doclet
documentation example snippet is out of date and does not work
[ https://issues.apache.org/jira/browse/MJAVADOC-453?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17345770#comment-17345770 ]
Hudson commented on MJAVADOC-453:
---------------------------------
Build failed in Jenkins: Maven » Maven TLP » maven-javadoc-plugin » master #64
See https://ci-builds.apache.org/job/Maven/job/maven-box/job/maven-javadoc-plugin/job/master/64/
> Using Alternate Doclet documentation example snippet is out of date and does not work
> -------------------------------------------------------------------------------------
>
> Key: MJAVADOC-453
> URL: https://issues.apache.org/jira/browse/MJAVADOC-453
> Project: Maven Javadoc Plugin
> Issue Type: Bug
> Reporter: Ljuba
> Assignee: Robert Scholte
> Priority: Minor
> Labels: documentation
> Fix For: 3.3.0
>
> Original Estimate: 1h
> Remaining Estimate: 1h
>
> Please, update documentation example on page [Using Alternate Doclet|http://maven.apache.org/plugins/maven-javadoc-plugin/examples/alternate-doclet.html] with following snippet that works:
> {code:xml}
> <build>
> <plugins>
> <plugin>
> <groupId>org.apache.maven.plugins</groupId>
> <artifactId>maven-javadoc-plugin</artifactId>
> <version>2.10.3</version>
> <configuration>
> <doclet>org.umlgraph.doclet.UmlGraphDoc</doclet>
> <!-- <docletPath>/path/to/UmlGraph.jar</docletPath> -->
> <docletArtifact>
> <groupId>org.umlgraph</groupId>
> <artifactId>umlgraph</artifactId>
> <version>5.6.6</version>
> </docletArtifact>
> <additionalparam>-views</additionalparam>
> <useStandardDocletOptions>true</useStandardDocletOptions>
> <additionalparam>-Xdoclint:none</additionalparam> <!-- for java 1.8 -->
> </configuration>
> </plugin>
> </plugins>
> </build>
> {code}
> This is current documentation example snippet:
> {code:xml}
> <project>
> ...
> <reporting> (or <build>)
> <plugins>
> <plugin>
> <groupId>org.apache.maven.plugins</groupId>
> <artifactId>maven-javadoc-plugin</artifactId>
> <version>2.10.3</version>
> <configuration>
> <doclet>org.umlgraph.doclet.UmlGraphDoc</doclet>
> <!-- <docletPath>/path/to/UmlGraph.jar</docletPath> -->
> <docletArtifact>
> <groupId>org.umlgraph</groupId>
> <artifactId>doclet</artifactId>
> <version>5.1</version>
> </docletArtifact>
> <additionalparam>-views</additionalparam>
> <useStandardDocletOptions>true</useStandardDocletOptions>
> </configuration>
> </plugin>
> ...
> </plugins>
> </reporting> (or </build>)
> ...
> </project>
> {code}
> Current documentation example snippet yields this error:
> {noformat}
> UmlGraphDoc version 5.1, altering javadocs
> Building Package view for package ...
> Warning, could not find a line that matches the pattern '</H2>'.
> Class diagram reference not inserted
> {noformat}
--
This message was sent by Atlassian Jira
(v8.3.4#803005)