> Samuel Lucas Vaz de Mello wrote: >>>> It seems we don't need default-jdk-doc nor libjna-java-doc. >>> ---end quoted text--- >>> >>> I remember reading on that list to link the API documentation against >>> default-jdk-doc & API documentation of other java libs that the package >>> depends on. >>> >>> Also, it was mentioned that those doc packages should be in Recommends >>> field of the API documentation package. >> >> Sorry, I didn't know that. >> >> Is this a new standard? I went to packages.debian.org and randomly >> picked some java-doc packages [1-5] to see how they implement this, >> but I found no package that depends on other -doc packages. >> > > Yes, it is rather new[1] and I suspect that the only a handful of > packages currently do this. Also we have very little tool support for > it, which does not help. > >> Also, I didn't understand how the other -doc packages will affect the >> javadoc compilation. Do we need to tell the javadoc compiler where the >> documentation for other libraries are located? >> > > I was asked the same question and figured it would fit good in our > FAQ[2]. If you want a "live example", have a look at libfreemarker-java[3]. > The short version is that you will need to B-D(-I) on the doc packages > and tell javadoc where to find them. > > The result of it is that freemarker's javadoc has functional links to > the other doc packages (assuming you have those installed of course). >
Thank you for the information. It was really helpful. I have just uploaded the new package to mentors.debian.net with the changes. Can someone review it? Thanks, - Samuel -- To UNSUBSCRIBE, email to debian-java-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org Archive: http://lists.debian.org/aanlktik4ghgqowls-w9ef6fje9esdd3ctdvjgzmit...@mail.gmail.com
