IIRC, aggregating JavaDocs like that causes a mess of the build system, because
everything will be built and tests run twice. See
https://issues.jboss.org/browse/MODE-1104 for background (including the
pull-request). It's probably not easy to figure out how it works, but I could
explain it fairly quickly if you cared.
Isn't it much easier to simply have the Infinispan JavaDoc be able to link to
the Hibernate Search JavaDoc site? It's not ideal, but it's far simpler.
Perhaps the Infinispan Query JavaDocs could link back to the Hibernate Search
JavaDocs? (Yes, there would be a chicken-and-egg problem, but the links in the
first would simply not be available until the second were built.)
This is how ModeShape JavaDocs are built to link to several other JavaDoc sites:
https://github.com/ModeShape/modeshape/blob/master/modeshape-distribution/pom.xml#L427
On Jan 29, 2013, at 5:12 PM, Sanne Grinovero <[email protected]> wrote:
> The javadoc of Infinispan does not have references to the Hibernate
> Search API; this is quite uncomfortable for Infinispan Query users: I
> think we should at least import the annotations and the DSL docs.
>
> http://docs.jboss.org/infinispan/5.2/apidocs/
> http://docs.jboss.org/hibernate/search/4.2/api/
>
> Would you agree in merging the docs from hibernate-search-engine ?
>
> Also, I was looking at how this could be done [1]. I have been playing
> with the maven-javadoc-plugin configuration section under the
> distribution profile, but it seems to be ignored.
>
>> From the Infinispan source code root I'm running
>> mvn javadoc:aggregate -Pdistribution
>
> this does produce javadoc in the /target/site/apidocs but seems to
> ignore any configuration option.
> what am I missing?
>
> Cheers,
> Sanne
>
> 1 -
> http://maven.apache.org/plugins/maven-javadoc-plugin/examples/aggregate-dependency-sources.html
> _______________________________________________
> infinispan-dev mailing list
> [email protected]
> https://lists.jboss.org/mailman/listinfo/infinispan-dev
_______________________________________________
infinispan-dev mailing list
[email protected]
https://lists.jboss.org/mailman/listinfo/infinispan-dev
