[java-policy] 41/198: Documentation about -gcj and -jni, closes: #146771.

[Emmanuel Bourg]

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 fd3769ae4d7c54160a3165e0a2ecca8f0132e3e5
Author: Ola Nordmann <olapc at yahoo.no>
Date:   Wed Sep 25 06:16:54 2002 +0000

    Documentation about -gcj and -jni, closes: #146771.
---
 debian/changelog |  1 +
 policy.xml       | 22 +++++++++++++++++++---
 2 files changed, 20 insertions(+), 3 deletions(-)

diff --git a/debian/changelog b/debian/changelog
index b70d77c..3d0df68 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -5,6 +5,7 @@ java-common (0.15) unstable; urgency=low
   * Some editorial changes.
   * Java libraries should now only suggest java-virtual-machine,
     closes: #159448.
+  * Documentation about -gcj and -jni, closes: #146771.
 
  -- Ola Lundqvist <opal at debian.org>  Wed, 25 Sep 2002 07:41:45 +0200
 
diff --git a/policy.xml b/policy.xml
index d423c66..c497f85 100644
--- a/policy.xml
+++ b/policy.xml
@@ -96,19 +96,35 @@
       Virtual packages are created: &jc;, &j2c;,
       &jvm;, &j1r; and &j2r;.
     </para>
-    
+
+    <para>
+      All Java code must be shipped as Java bytecode (*.class files, packaged
+      in a *.jar archive) and with <quote>Architecture: all</quote>.
+    </para>
+
     <para>
       Packages written in Java are separated in two categories: programs
       and libraries. Programs are intended to be run by end-users. Libraries
       are intended to help programs to run and to be used by developers.
     </para>
-    
+
     <para>
       Both are shipped as Java bytecode (<filename>*.class</filename>
       files, packaged in a <filename>*.jar</filename> archive) and with
       an "Architecture: all" since Java bytecode is supposed to be portable.
+      It may additionally be shipped as machine code, as produced for example
+      by the GNU Compiler for Java, in a separate architecture-specific
+      package.
     </para>
-    
+
+    <para>
+      If the Java code depends on code written in a "native" language,
+      for example Java Native Interface code, the compiled native code
+      &should; be shipped in a separate architecture-specific package.
+      The package containing Java bytecode should depend on this
+      package.
+    </para>
+
     <para>
       This policy does not yet address the issue of documentation (for instance
       HTML pages made with javadoc).

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