Ability to use doclet for project without any related javadocs. #46
Comments
|
I don't understand. The JAXB and JAX-RS doclets work without JPA. If you don't invoke the JPA doclet it should just work. |
|
Of course. But if I put all doclets defs in parent-project to not repeate them in each child, I'll get error. |
|
So you want the JPA doclet to not fail if there are no JPA entities? Does the javadoc doclet not fail on the absence of things to document? If the JPA doclet has a flag to not fail I'll support it. |
|
Javadoc doesn't fail if it's nothing to document. If in-class javadoc is corrupted it shows warnings as max (e. g. you have @return derictive without parameter). So, doclets shouldn't fail if there's nothing to document for them. |
|
OK, so what precisely is the error then? |
|
It doesn't throw an exception. So |
|
OK forgive me but I don't get what you want. The fact that the JPA doclet writes the docs with nothing documented in there seems fine to me. What do you want to see happen then? |
|
Then it doesn't write anything else. If I comment out JPA doclet I'll get something like this: So then JPA doclet is commented other doclets work fine, else other doclets (JAXB and JAX-RS) generate nothing. |
|
I'm even more lost here. So the JPA doclet works correctly, but Maven for some reason stops running the other doclets silently without even telling us why? Sounds like a Maven issue to me. I mean, I don't even know what the JPA doclet is doing wrong in the eyes of Maven to trigger this behaviour. |
|
Ok, I'll try to review maven-javadoc-plugin and find out who stops other doclets from running, but when I had And when doclet throws |
|
The JPA doclet doesn't read
Those you should report and we'll fix. |
Oh, that was my error, I'm writting & testing code fo #47. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
I use one parent pom with reporting for
JAXB,JAX-RSandJPA. It works fine if child project contains all these parts. But if child project doesn't contains any persistence annotations it fails to build all docs (eutherJAXBandJAX-RS).The text was updated successfully, but these errors were encountered: