[pkg-java] r12173 - in trunk/java-common: . debian
Niels Thykier
nthykier-guest at alioth.debian.org
Mon Apr 19 06:16:00 UTC 2010
Author: nthykier-guest
Date: 2010-04-19 06:15:56 +0000 (Mon, 19 Apr 2010)
New Revision: 12173
Modified:
trunk/java-common/debian/changelog
trunk/java-common/policy.xml
Log:
Committed policy changes.
Modified: trunk/java-common/debian/changelog
===================================================================
--- trunk/java-common/debian/changelog 2010-04-18 19:37:14 UTC (rev 12172)
+++ trunk/java-common/debian/changelog 2010-04-19 06:15:56 UTC (rev 12173)
@@ -13,6 +13,15 @@
* Removed useless commands from debian/rules and removed B-D on
dpsyco-devel.
+ * Policy Changes:
+ - Removed section "Java Compilers".
+ - Retired the virtual packages java-virtual-machine, java-compiler
+ and java2-compiler
+ - Relax program installation locations (Closes: #395372)
+ - Specified installation location for private program jars.
+ - Removed mention of binfmt_misc in favor of jarwrapper.
+ (Closes: #227594)
+
-- Niels Thykier <niels at thykier.net> Tue, 06 Apr 2010 21:45:15 +0200
java-common (0.35) unstable; urgency=low
Modified: trunk/java-common/policy.xml
===================================================================
--- trunk/java-common/policy.xml 2010-04-18 19:37:14 UTC (rev 12172)
+++ trunk/java-common/policy.xml 2010-04-19 06:15:56 UTC (rev 12173)
@@ -6,16 +6,14 @@
<!ENTITY mustnot "<emphasis>must not</emphasis>">
<!ENTITY may "<emphasis>may</emphasis>">
<!ENTITY should "<emphasis>should</emphasis>">
-<!ENTITY jvm "<emphasis>java-virtual-machine</emphasis>">
<!ENTITY j1r "<emphasis>java1-runtime</emphasis>">
<!ENTITY j2r "<emphasis>java2-runtime</emphasis>">
-<!ENTITY jc "<emphasis>java-compiler</emphasis>">
-<!ENTITY j2c "<emphasis>java2-compiler</emphasis>">
<!ENTITY d-jdk "<emphasis>default-jdk</emphasis>">
<!ENTITY d-jbdep "<emphasis>default-jdk-builddep</emphasis>">
<!ENTITY d-jdoc "<emphasis>default-jdk-doc</emphasis>">
<!ENTITY JVM "<acronym>JVM</acronym>">
<!ENTITY JIT "<acronym>JIT</acronym>">
+<!ENTITY debpol "http://www.debian.org/doc/debian-policy">
]>
<book>
@@ -111,8 +109,7 @@
<title>Policy</title>
<para>
- Virtual packages are created: &jc;, &j2c;,
- &jvm;, &j1r; and &j2r;.
+ Virtual packages are created: &j1r; and &j2r;.
</para>
<para>
@@ -143,7 +140,7 @@
<title>Virtual machines</title>
<para>
- Java virtual machines &must; provide &jvm; and
+ 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
@@ -184,46 +181,40 @@
</para>
</sect1>
- <sect1 id="policy-compiler">
- <title>Java compilers</title>
-
- <para>
- Java compilers &must; provide &jc; and/or &j2c; and depend on
- java-common. They &must; also depend on the needed runtime environment
- (&j1r; and/or &j2r;).
- </para>
-
- <para>
- They &should; use <filename>/etc/alternatives</filename>
- for the name 'javac' if they are command-line compatible
- with Sun's JDK javac. They &should; have a CLASSPATH predefined to
- include the java core classes need for the compiler.
- </para>
-
- </sect1>
-
<sect1 id="policy-programs">
<title>Java programs</title>
<para>
- Programs &must; have executable(s) in
- <filename>/usr/bin</filename> and be executable. They can be Java
- classes (using binfmt_misc) or wrappers. In any case, they &must; run
+ Programs &must; have one or more executables in one or more of
+ the directories defined by <ulink url="&debpol;/ch-opersys.html#s9.1">
+ 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="http://www.debian.org/doc/debian-policy/ch-opersys.html#s10.9">Policy
+ <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="http://www.debian.org/doc/debian-policy/ch-docs.html#s13.1">
+ <ulink url="&debpol;/ch-docs.html#s13.1">
Policy 13.1</ulink>).
</para>
+
<para>
- If they have their own auxiliary classes, they
- &must; be in a jar file in <filename>/usr/share/java</filename>. The
- name of the jar &should; follow the same naming conventions as for
- libraries.
+ If the package installs a jar (or a symlink to a jar) as an executable
+ the package &must; have an absolute dependency on jarwrapper or an
+ equivalent package, which allows jar files to be executed directly
+ from PATH like a normal program. The package &must; also ensure that
+ the correct class is used as main-class. As an example jarwrapper
+ uses the Main-Class attribute from the main part of the Manifest of the
+ jar file to determine this.
</para>
+
<para>
- Programs &must; depend on &jvm; and the needed
+ Additional classes in the package must be packaged in one or more JARs
+ which can be put into /usr/share/java (if they are intended to be used
+ by other programs) or into a private directory in
+ /usr/share/<package>.
+ </para>
+ <para>
+ Programs &must; depend on the needed
runtime environment (&j1r; and/or &j2r;).
</para>
<para>
More information about the pkg-java-commits
mailing list