<p>Yes linking would be appropriate for some areas, but at least DSL and indexing annotations should show up in the index I think.</p>
<p>Regarding Maven what a mess!</p>
<p> Anyway I'm still missing something about the structure in Infinispan, as it ignores whatever option I change.</p>
<div class="gmail_quote">Il giorno 30/gen/2013 00:12, "Randall Hauch" <<a href="mailto:rhauch@redhat.com">rhauch@redhat.com</a>> ha scritto:<br type="attribution"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
IIRC, aggregating JavaDocs like that causes a mess of the build system, because everything will be built and tests run twice. See <a href="https://issues.jboss.org/browse/MODE-1104" target="_blank">https://issues.jboss.org/browse/MODE-1104</a> 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.<br>
<br>
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.)<br>
<br>
This is how ModeShape JavaDocs are built to link to several other JavaDoc sites:<br>
<a href="https://github.com/ModeShape/modeshape/blob/master/modeshape-distribution/pom.xml#L427" target="_blank">https://github.com/ModeShape/modeshape/blob/master/modeshape-distribution/pom.xml#L427</a><br>
<br>
On Jan 29, 2013, at 5:12 PM, Sanne Grinovero <<a href="mailto:sanne@infinispan.org">sanne@infinispan.org</a>> wrote:<br>
<br>
> The javadoc of Infinispan does not have references to the Hibernate<br>
> Search API; this is quite uncomfortable for Infinispan Query users: I<br>
> think we should at least import the annotations and the DSL docs.<br>
><br>
> <a href="http://docs.jboss.org/infinispan/5.2/apidocs/" target="_blank">http://docs.jboss.org/infinispan/5.2/apidocs/</a><br>
> <a href="http://docs.jboss.org/hibernate/search/4.2/api/" target="_blank">http://docs.jboss.org/hibernate/search/4.2/api/</a><br>
><br>
> Would you agree in merging the docs from hibernate-search-engine ?<br>
><br>
> Also, I was looking at how this could be done [1]. I have been playing<br>
> with the maven-javadoc-plugin configuration section under the<br>
> distribution profile, but it seems to be ignored.<br>
><br>
>> From the Infinispan source code root I'm running<br>
>> mvn javadoc:aggregate -Pdistribution<br>
><br>
> this does produce javadoc in the /target/site/apidocs but seems to<br>
> ignore any configuration option.<br>
> what am I missing?<br>
><br>
> Cheers,<br>
> Sanne<br>
><br>
> 1 - <a href="http://maven.apache.org/plugins/maven-javadoc-plugin/examples/aggregate-dependency-sources.html" target="_blank">http://maven.apache.org/plugins/maven-javadoc-plugin/examples/aggregate-dependency-sources.html</a><br>
> _______________________________________________<br>
> infinispan-dev mailing list<br>
> <a href="mailto:infinispan-dev@lists.jboss.org">infinispan-dev@lists.jboss.org</a><br>
> <a href="https://lists.jboss.org/mailman/listinfo/infinispan-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/infinispan-dev</a><br>
<br>
<br>
_______________________________________________<br>
infinispan-dev mailing list<br>
<a href="mailto:infinispan-dev@lists.jboss.org">infinispan-dev@lists.jboss.org</a><br>
<a href="https://lists.jboss.org/mailman/listinfo/infinispan-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/infinispan-dev</a><br>
</blockquote></div>