Comments (6)
Could you please provide an example of a piece of invalid JavaDoc that triggers this behavior?
from umldoclet.
With the configuration section of the javadoc plugin commented out, the following error appears in the output of mvn clean package:
[ERROR] Exit code: 1 - /home/bert/dev/other/umldocklet-issue/src/main/java/example/JavadocError.java:6: error: invalid use of @return
[ERROR] * @return some field
With the umldoclet enabled however this error is gone.
from umldoclet.
The bug that occurred in 0.1.3 has been fixed. That was a NullPointerException that could sometimes happen within the UMLDoclet itself.
So since 0.1.4 the project you uploaded does not seem to throw the meaningless error.
The error without description therefore seems to have been fixed.
However, I find the behavior weird, that the Standard doclet seems to throw the above error, while using the 0.1.5 doclet version accepts your code without any problems.
I think it too should throw the same exception as the Standard doclet throws without the UMLDoclet.
Therefore, I will not close this issue yet, but probably will also not get round to fixing it before the 'First Release' Milestone.
from umldoclet.
I still have not found a solution for this issue.
However, there is a workaround by adding option -umlSkipStandardDoclet true
to the doclet and afterwards performing another (standard) javadoc run.
In maven you can easily configure this as follows:
<build>
<plugins>
<plugin>
<artifactId>maven-javadoc-plugin</artifactId>
...
<executions>
<execution>
<!-- Call umldoclet to generate UML documentation. -->
<id>attach-uml-to-javadocs</id>
<goals>
<goal>jar</goal>
</goals>
<configuration>
<doclet>nl.talsmasoftware.umldoclet.UMLDoclet</doclet>
...
<additionalparam>
-umlSkipStandardDoclet true
...
</additionalparam>
</configuration>
</execution>
<execution>
<!-- Call standard javadoc target for HTML documentation. -->
<id>attach-javadocs</id>
<goals>
<goal>jar</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
from umldoclet.
Needs a re-test to see whether this is still an issue in real projects, using version 1.0.8 1.0.9.
Also, maybe the problem will go away finally with the improved JDK9 Doclet API (see #20).
from umldoclet.
This issue seems resolved (at least when testing with jdk 1.8 in our projects) with version 1.0.13
.
Please reopen if the issue turns out to persist.
from umldoclet.
Related Issues (20)
- Upgrading spring boot service from java 8 to java 11 gives error regarding the UMLDoclet HOT 7
- Failure to generate UML diagrams and SVG HOT 11
- Using JDK-16 package.svg graphics are not shown on package-summary pages, although graphics do get generated HOT 1
- Fix UML diagram locations for java modules HOT 1
- How to set TypeDisplay.NONE? HOT 6
- Sharing a Gradle Kotlin DSL configuration HOT 2
- Dot Executable: null on windows when GRAPHVIZ_DOT not declared HOT 8
- Override option for SVG Object Tags HOT 6
- <umlImageFormat>png</umlImageFormat> not working HOT 2
- Add support for PlantUML server HOT 3
- Document how to include custom plantuml diagrams into generated javadoc HOT 4
- Is there a way to backport the styling from v2 to v1? HOT 15
- NPE on some package level images HOT 2
- Documentation of additionalOptions HOT 7
- Regular Doclet logging turns up as warnings in maven
- Allow provide additional plantUML options(rendern with Smetana) HOT 4
- No connection is drawn for return value types HOT 2
- Enable "-link" option multiple times HOT 1
- Configure Built-In plantuml to not steal keyboard focus on MacOS X HOT 5
- Diagrams not always included in HTML
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from umldoclet.