diff options
| -rw-r--r-- | policy.xml | 65 |
1 files changed, 30 insertions, 35 deletions
@@ -14,6 +14,7 @@ <!ENTITY JVM "<acronym>JVM</acronym>"> <!ENTITY JIT "<acronym>JIT</acronym>"> <!ENTITY debpol "http://www.debian.org/doc/debian-policy"> +<!ENTITY djmail "<email>debian-java@lists.debian.org</email>"> ]> <book> @@ -61,7 +62,7 @@ <authorblurb> <para> Most issues of the java policy have been discussed on the - <email>debian-java@lists.debian.org</email> mailinglist. + &djmail; mailinglist. </para> </authorblurb> </author> @@ -85,12 +86,10 @@ <para> There are several "subpolicies" in Debian. They all want to make - the - <ulink url="http://www.debian.org/doc/debian-policy/">Debian - Policy</ulink> - more precise when it comes to a specific subject. See - the Emacs subpolicy in package emacsen-common for instance. As far as - I know, the only subpolicy for a programming language, is that of + the <ulink url="&debpol;">Debian Policy</ulink> more precise when + it comes to a specific subject. See the Emacs subpolicy in package + emacsen-common for instance. As far as I know, the only subpolicy + for a programming language, is that of <ulink url="http://non-us.debian.org/~hertzog/perl-policy.html/">Perl</ulink>. </para> @@ -98,9 +97,8 @@ <para> Feel free to report comments, suggestions and/or disagreements to the java-common package (<email>java-common@packages.debian.org</email>) - or the Debian Java mailing list - <email>debian-java@lists.debian.org</email>. Change requests should - be sent as a bug to the java-common package. + or the Debian Java mailing list &djmail;. Change requests should be + sent as a bug to the java-common package. </para> </chapter> @@ -123,7 +121,7 @@ files, packaged in a <filename>*.jar</filename> archive) and with an "Architecture: all". There are rare exceptions to this such as Eclipse SWT. Exceptions to this rule can only be granted by the Java Team. - Requests &must; be sent to <email>debian-java@lists.debian.org</email>. + Requests &must; be sent to &djmail;. </para> <para> @@ -140,11 +138,10 @@ <title>Virtual machines</title> <para> - Java virtual machines &must; - depend on java-common. They can also provide the runtime environment - that the package contains (&j1r; and/or &j2r;). If it does not - provide the files itself it &must; depend on the needed runtime - environment. + Java virtual machines &must; depend on java-common. They can also + provide the runtime environment that the package contains (&j1r; + and/or &j2r;). If it does not provide the files itself it &must; + depend on the needed runtime environment. </para> <para> @@ -190,9 +187,9 @@ 9.1</ulink> of the Debian Policy. These &must; either be a wrapper script or a symlink to an executable jar. In any case, they &must; run without specific environment variables (see - <ulink url="&debpol;/ch-opersys.html#s10.9">Policy - 10.9</ulink>), for instance CLASSPATH. They &must; respect the Policy - rules for executables (for instance a manual page per executable, see + <ulink url="&debpol;/ch-opersys.html#s10.9">Policy 10.9</ulink>), for + instance CLASSPATH. They &must; respect the Policy rules for + executables (for instance a manual page per executable, see <ulink url="&debpol;/ch-docs.html#s13.1"> Policy 13.1</ulink>). </para> @@ -214,8 +211,8 @@ /usr/share/<package>. </para> <para> - Programs &must; depend on the needed - runtime environment (&j1r; and/or &j2r;). + Programs &must; depend on the needed runtime environment (&j1r; and/or + &j2r;). </para> <para> There is no naming rules for programs, they are ordinary programs, @@ -241,8 +238,7 @@ <para> Their classes &must; be in <filename>jar</filename> archive(s) in - the directory <filename>/usr/share/java</filename>, - with the name + the directory <filename>/usr/share/java</filename>, with the name <filename>packagename[-extraname]-fullversion.jar</filename>. The extraname is optional and used internally within the package to separate the different jars provided by the package. The fullversion @@ -328,10 +324,9 @@ <para> Packages &mustnot; ship gcj-code without the permission of - the Java team (<email>debian-java@lists.debian.org</email>). - Source packages that shipped gcj-packages as of March 22nd, - 2010, have been given this permission through the - ratification of this policy. + the Java team (&djmail;). Source packages that shipped + gcj-packages as of March 22nd,2010, have been given this + permission through the ratification of this policy. </para> <para> @@ -418,8 +413,8 @@ <listitem> <para> - The symbolic links in /usr/share/java be made by a script - instead, similar to the c-libraries. + The symbolic links in <filename>/usr/share/java</filename> be + made by a script instead, similar to the c-libraries. </para> </listitem> @@ -460,14 +455,15 @@ </listitem> <listitem> - <para>How to check for a good enough jvm, and to select a - proper one to use. Are /etc/alternatives not good enough? + <para>How to check for a good enough &JVM;, and to select a + proper one to use. Are <filename>/etc/alternatives</filename> + not good enough? </para> </listitem> <listitem> <para> - Should the jvm internal classes be possible to + Should the &JVM; internal classes be possible to override entirely and how? </para> </listitem> @@ -494,9 +490,8 @@ <listitem> <para> - You can suppress many calls in - <filename>debian/rules</filename> which are meaningless for Java, - like dh_strip and dh_shlibdeps. + You can suppress many calls in <filename>debian/rules</filename> + which are meaningless for Java, like dh_strip and dh_shlibdeps. </para> </listitem> |