This is an automated email from the git hooks/post-receive script.

ebourg-guest pushed a commit to branch master
in repository java-policy.

commit 3af51af7322c23322426e32dd1fdb3e5d26c9fa4
Author: Niels Thykier <[email protected]>
Date:   Mon Apr 19 06:15:56 2010 +0000

    Committed policy changes.
---
 debian/changelog |  9 +++++++++
 policy.xml       | 59 ++++++++++++++++++++++++--------------------------------
 2 files changed, 34 insertions(+), 34 deletions(-)

diff --git a/debian/changelog b/debian/changelog
index 8031ced..b480f97 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -13,6 +13,15 @@ java-common (0.36) UNRELEASED; urgency=low
   * 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 <[email protected]>  Tue, 06 Apr 2010 21:45:15 +0200
 
 java-common (0.35) unstable; urgency=low
diff --git a/policy.xml b/policy.xml
index ede0247..94a853b 100644
--- a/policy.xml
+++ b/policy.xml
@@ -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 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>
-        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.
+       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/&lt;package&gt;.
       </para>
       <para>
-        Programs &must; depend on &jvm; and the needed
+        Programs &must; depend on the needed
        runtime environment (&j1r; and/or &j2r;).
       </para>
       <para>

-- 
Alioth's /usr/local/bin/git-commit-notice on 
/srv/git.debian.org/git/pkg-java/java-policy.git

_______________________________________________
pkg-java-commits mailing list
[email protected]
http://lists.alioth.debian.org/cgi-bin/mailman/listinfo/pkg-java-commits

Reply via email to