On 05.08.2009 18:26, Picca Frédéric-Emmanuel wrote:
Le Wed, 05 Aug 2009 15:52:34 +0200,
Matthias Klose<doko@ubuntu.com> a écrit :On 05.08.2009 17:00, Picca Frédéric-Emmanuel wrote:hello as I am working on my remotetea package, I build it using the pbuilder. and it seems that depending on default-jdk is not enought to produce good documentation with javadoc. Indeed it do not find the documentation for standard classes of java. what must I add as build dependency to produce the right documentation ?the java docs built form OpenJDK can be found in openjdk-6-doc. But instead of directly depending on this package, we should create a default-jdk-doc package and make sure that generated references don't refer to the openjdk-6-doc directory.ok for the standard documentation but what about all the javadoc api provided by the java packages with a -doc. if my package provide some javadoc documentation it should be accessible to other packages during there build process. How can we deal with this. did I missed something. This is just to have all javadoc api consistant for all java packages.
we discussed this at Debconf. You generally don't want to have a libfoo-java, which includes the api docs, depend on any other -apidoc packages. It's clear that the generated docs will point to some non-existing local URLs in this case.
The alternative would be to always have a separate libfoo-java-apidoc package. For now you maybe have to build-depend on every -doc package explicitely.