FroMage / jax-doclets

Set of JavaDoc doclets for modern Java annotations APIs
http://www.lunatech-labs.com/open-source/jax-doclets
GNU Lesser General Public License v3.0
26 stars 23 forks source link

example for how to generate jax-rs doc with jaxb links #64

Open nogece opened 9 years ago

nogece commented 9 years ago

I am trying to get maven to generate a jax-rs api doc with links to generated jaxb docs. I configured it according to the wiki, but for some reason, the jaxb docs are generated, the jax-rs task is not run. Does anyone has an working example or can point out what is wrong in the below pom-exerpt?

<reporting>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <version>2.7</version>
            <reportSets>
                <reportSet>
                    <id>jaxb</id>
                    <configuration>
                        <doclet>com.lunatech.doclets.jax.jaxb.JAXBDoclet</doclet>
                        <docletArtifacts>
                            <docletArtifact>
                                <groupId>com.lunatech.jax-doclets</groupId>
                                <artifactId>doclets</artifactId>
                                <version>0.10.0</version>
                            </docletArtifact>
                        </docletArtifacts>
                    </configuration>
                    <reports>
                        <report>javadoc</report>
                    </reports>
                </reportSet>
                <reportSet>
                    <id>jaxrs</id>
                    <configuration>
                        <doclet>com.lunatech.doclets.jax.jaxrs.JAXRSDoclet</doclet>
                        <docletArtifacts>
                            <docletArtifact>
                                <groupId>com.lunatech.jax-doclets</groupId>
                                <artifactId>doclets</artifactId>
                                <version>0.10.0</version>
                            </docletArtifact>
                        </docletArtifacts>
                             <additionalparam>-link ${project.build.directory}/site/spidocs</additionalparam>
                    </configuration>
                    <reports>
                        <report>javadoc</report>
                    </reports>
                </reportSet>
            </reportSets>
        </plugin>
    </plugins>
</reporting>
nogece commented 9 years ago

alors? Acune idee?

matsli commented 9 years ago

If I remember correctly, I had to use <executions> in the <build> section to make it work.

FroMage commented 9 years ago

No idea, in my tests I do like you do with multiple reportsets and it works…

matsli commented 9 years ago

It's probably related to this bug: http://jira.codehaus.org/browse/MSHARED-271