[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: javadoc problem with default-jdk



On 05.08.2009 20:02, Michael Koch wrote:
On Wed, Aug 05, 2009 at 06:26:44PM +0200, 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.

Always put it into /usr/share/doc/<doc package>/api.

No, this looks wrong, because you cannot enforce this for packages where the docs are shipped in the same package. You should use /usr/share/doc/<lib package>/api, and maybe add a directory /usr/share/doc/<doc package> with an api symlink to /usr/share/doc/<lib package>/api, if the docs are in a separate package.


Reply to: