Author: nthykier-guest Date: 2010-05-13 14:57:12 +0000 (Thu, 13 May 2010) New Revision: 12400
Modified: trunk/java-common/debian-java-faq/debian-java-faq.sgml trunk/java-common/debian/changelog Log: Synced Java FAQ. Modified: trunk/java-common/debian/changelog =================================================================== --- trunk/java-common/debian/changelog 2010-05-13 13:55:52 UTC (rev 12399) +++ trunk/java-common/debian/changelog 2010-05-13 14:57:12 UTC (rev 12400) @@ -1,6 +1,8 @@ java-common (0.37) UNRELEASED; urgency=low - * Synced the Java FAQ. + * Updated and synced the Java FAQ. + - contains a example of how to link with system javadocs. + (Closes: #577164) * Removed unused lintian overrides. -- Niels Thykier <ni...@thykier.net> Thu, 13 May 2010 15:46:11 +0200 Modified: trunk/java-common/debian-java-faq/debian-java-faq.sgml =================================================================== --- trunk/java-common/debian-java-faq/debian-java-faq.sgml 2010-05-13 13:55:52 UTC (rev 12399) +++ trunk/java-common/debian-java-faq/debian-java-faq.sgml 2010-05-13 14:57:12 UTC (rev 12400) @@ -16,7 +16,7 @@ <name>Javier Fern�ndez-Sanguino Pe�a</name> <email>j...@debian.org</email> </author> -<version>$Revision: 7333 $, $Date: 2010-05-13 15:22:31 +0200 (Thu, 13 May 2010) $ +<version>$Revision: 7336 $, $Date: 2010-05-13 16:55:09 +0200 (Thu, 13 May 2010) $ <abstract> Answers to Frequently Asked Questions on Debian and Java @@ -366,18 +366,6 @@ If it needs programs from contrib or non-free, then is <em>must</em> go into contrib or non-free, depending on the license of the program itself. -<sect1>What virtual packages could I use? -<p> -<list> -<item><package>java-common</package>. It is the Mother Of All Java -Packages, in the proposed policy. It contains the text of the Policy -(Docbook), as well as utilities -scripts (for instance to build a CLASSPATH from a list of jars -(submissions welcome). -<item><package>java-virtual-machine</package> -<item><package>java-compiler</package> -</list> - <sect1>Is there a good example Debian package? <p>There are many Debian packages of both Java applications and libraries. @@ -396,11 +384,37 @@ <sect1>What tools are available to make maintaining a Java packages easier? -<p>At this moment, there is dh_javadoc, which is a tool -in the <package>gjdoc</package> package in Debian unstable. And, there -are tools in <package>cdbs</package> which can help build packages with -<package>ant</package>. +<p>Both cdbs and debhelper (dh7) have support for ant scripts. There +are also a number of specialized tools or build helpers. Have a look +at <package>javahelper</package> +or <package>maven-debian-helper</package>. <package>gcj-jdk</package> +also has a dh_javadoc tool.</p> +<sect1>Linking package Javadoc to system javadoc. + +<p>The java-policy mandates that documentation must be linked with +with the javadoc installed on the system. This can be done by passing +javadoc the "-link" argument or by using the <link> tag in ant. +An example: + +<example> +# command line example of linking against system doc. +javadoc -link /usr/share/doc/default-jdk-doc/api [other arguments] + +<!-- Ant example of linking against system doc --> +<javadoc [attributes]> + <link href="/usr/share/doc/default-jdk-doc/api/" /> + [other tags] +</javadoc> +</example> +</p> + +<p>The documentation must be installed at the time the linking is +done; so in the example cases above the package would need a +Build-Depends or a Build-Depends-Indep on +<package>default-jdk-doc</package>. +</p> + <chapt>Java Compilers <p> <sect>What Java compilers are available in Debian?
_______________________________________________ pkg-java-commits mailing list pkg-java-comm...@lists.alioth.debian.org http://lists.alioth.debian.org/mailman/listinfo/pkg-java-commits
