api docs, java source

[Thomas Koch <thomas@koch.ro>]

Hi,

I just noticed, that junit4-doc installs api docs into /usr/share/java/junit4 
while ant-doc installs them into /usr/share/doc/ant/api.
Maybe we should add a section to java-policy about the right position?

questions:

a) 

Where to put api docs?
- /usr/share/java/PACKAGE
- /usr/share/doc/PACKAGE/api
- /usr/share/doc/PACKAGE-doc/api

b)

Shouldn't /usr/share/doc/PACKAGE-doc be a symlink to /usr/share/doc/PACKAGE

c)

When all api docs are in a standard location, shouldn't it be easy of IDEs to 
use them?

d)

Would it be useful to have PACKAGE-dev packages for java containing the source 
code, so that I can refer to it when developing on top of a library?

Best regards,

Thomas Koch, http://www.koch.ro