summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorOla Nordmann <olapc@yahoo.no>2002-09-25 06:16:54 +0000
committerOla Nordmann <olapc@yahoo.no>2002-09-25 06:16:54 +0000
commitfd3769ae4d7c54160a3165e0a2ecca8f0132e3e5 (patch)
tree447fb829cf72558444fb2eef01bf1818e8a74049
parent4d4966483b12ade6cc63a0fe129351c09470b253 (diff)
downloadjava-common-fd3769ae4d7c54160a3165e0a2ecca8f0132e3e5.tar.gz
Documentation about -gcj and -jni, closes: #146771.
-rw-r--r--debian/changelog1
-rw-r--r--policy.xml22
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@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).