[Git][java-team/java-policy][master] 7 commits: Redirect the discussions and bug reports to the java-policy package
Emmanuel Bourg
gitlab at salsa.debian.org
Mon Jul 27 13:07:19 BST 2020
Emmanuel Bourg pushed to branch master at Debian Java Maintainers / java-policy
Commits:
ef2e2946 by Emmanuel Bourg at 2020-07-27T11:56:15+02:00
Redirect the discussions and bug reports to the java-policy package
- - - - -
9d74e910 by Emmanuel Bourg at 2020-07-27T11:56:23+02:00
Standards-Version updated to 4.5.0
- - - - -
236d917f by Emmanuel Bourg at 2020-07-27T11:56:30+02:00
Switch to debhelper level 13
- - - - -
531a088d by Emmanuel Bourg at 2020-07-27T12:28:45+02:00
Updated the references to the Debian Policy (Closes: #966303)
- - - - -
665381c6 by Emmanuel Bourg at 2020-07-27T13:08:10+02:00
Switched the URLs to https
- - - - -
b94367cb by Emmanuel Bourg at 2020-07-27T14:04:48+02:00
Removed the references to GCJ
- - - - -
74166a18 by Emmanuel Bourg at 2020-07-27T14:05:04+02:00
Upload to unstable
- - - - -
6 changed files:
- debian-java-faq.xml
- debian-java-policy.xml
- debian/changelog
- − debian/compat
- debian/control
- debian/copyright
Changes:
=====================================
debian-java-faq.xml
=====================================
@@ -75,9 +75,9 @@ non-Debian-specific problems.
<section id="s1.2"><title>Location of this FAQ</title>
<para>
This FAQ is published under the Debian Documentation Project at <ulink
-url="http://www.debian.org/doc/manuals/debian-java-faq/">http://www.debian.org/doc/manuals/debian-java-faq/</ulink>.
-The <systemitem role="package">java-common</systemitem> (available at <ulink
-url="http://packages.debian.org/java-common">http://packages.debian.org/java-common</ulink>)
+url="https://www.debian.org/doc/manuals/debian-java-faq/">https://www.debian.org/doc/manuals/debian-java-faq/</ulink>.
+The <systemitem role="package">java-policy</systemitem> (available at <ulink
+url="https://packages.debian.org/java-policy">https://packages.debian.org/java-policy</ulink>)
provides an HTML version for offline reading. The package version does not
provide Text and PDF versions currently (if you want them please submit a bug
'wishlist' to the package). Also, the web version might be more up-to-date
@@ -90,12 +90,12 @@ than the package's offline version.
Please note that this FAQ is still outdated but gets updated step by step.
</para>
<para>
-Please file bug reports against the java-common package if you find errors or
+Please file bug reports against the java-policy package if you find errors or
have suggestions on how to improve this document. However, make sure you have
read the latest online version of the english text available at <ulink
-url="http://www.debian.org/doc/manuals/debian-java-faq/index.html">http://www.debian.org/doc/manuals/debian-java-faq/index.html</ulink>
+url="https://www.debian.org/doc/manuals/debian-java-faq/index.html">https://www.debian.org/doc/manuals/debian-java-faq/index.html</ulink>
before filing a bug report. Translations, if available, and the offline
-version in the java-common package might be out of date.
+version in the java-policy package might be out of date.
</para>
</section>
@@ -107,7 +107,7 @@ Microsystems (which is now a subsidiary of Oracle Corporation) and released in
Sun/Oracle with some partners like Red Hat provide a free implementation
released under the GNU GPL called OpenJDK. More information can be found at
<ulink
-url="http://en.wikipedia.org/wiki/Java_%28programming_language%29">Wikipedia</ulink>.
+url="https://en.wikipedia.org/wiki/Java_%28programming_language%29">Wikipedia</ulink>.
</para>
</section>
@@ -115,7 +115,7 @@ url="http://en.wikipedia.org/wiki/Java_%28programming_language%29">Wikipedia</ul
<para>
The appropriate place to ask such questions is <email>debian-java at
lists.debian.org</email>. You can subscribe at the <ulink
-url="http://lists.debian.org/debian-java/">Debian Mailing Lists</ulink> page.
+url="https://lists.debian.org/debian-java/">Debian Mailing Lists</ulink> page.
</para>
</section>
@@ -123,7 +123,7 @@ url="http://lists.debian.org/debian-java/">Debian Mailing Lists</ulink> page.
<para>
Users might want to access some online sources to complement the information
available in this FAQ which might be, sometimes, too out of date. The main
-source of information is the <ulink url="http://wiki.debian.org/Java">Java
+source of information is the <ulink url="https://wiki.debian.org/Java">Java
entry</ulink> at the Debian's wiki.
</para>
<para>
@@ -178,17 +178,10 @@ Oracle's OpenJDK 8, available since the Debian 9.0 <emphasis>Strech</emphasis>
release in the <emphasis>main</emphasis> section.
</para>
</listitem>
-<listitem>
-<para>
-The combination GCJ, GIJ, and Classpath in the <emphasis>main</emphasis>
-section.
-</para>
-</listitem>
</itemizedlist>
<para>
It is recommended to install one of the default-jdk or default-jre meta
-packages which either installs OpenJDK or GCJ depending on the architecture and
-Debian version.
+packages which installs the default version of OpenJDK for the current Debian version.
</para>
</section>
@@ -200,21 +193,17 @@ Debian. There are a lot of projects that you can choose from:
<itemizedlist>
<listitem>
<para>
-openjdk: <ulink url="http://openjdk.java.net/">http://openjdk.java.net/</ulink>
+openjdk: <ulink url="https://openjdk.java.net/">https://openjdk.java.net/</ulink>
</para>
</listitem>
<listitem>
<para>
Mauve <ulink
-url="http://sources.redhat.com/mauve/">http://sources.redhat.com/mauve/</ulink>
+url="https://sources.redhat.com/mauve/">https://sources.redhat.com/mauve/</ulink>
is a free suite to test if these tools are 'compliant'.
</para>
</listitem>
</itemizedlist>
-<para>
-Most free Java development is grouped under the <ulink
-url="http://www.gnu.org/software/java/">Free Java Project</ulink>.
-</para>
</section>
<section id="license-concerns"><title>Questions on platforms and license concerns</title>
@@ -271,7 +260,7 @@ quality.
However, some users might want to use the Oracle JVM for the proprietary
extensions (for example: the browser plugin). For such need, Debian provides a
tool called <ulink
-url="http://packages.debian.org/sid/java-package">java-package</ulink>. The
+url="https://packages.debian.org/sid/java-package">java-package</ulink>. The
program make-jpkg will take an upstream archive and convert it to a Debian
package. For example:
</para>
@@ -280,7 +269,7 @@ package. For example:
</screen>
<para>
For more information see <ulink
-url="http://www.oracle.com/technetwork/java/index.html">Oracle Technology
+url="https://www.oracle.com/technetwork/java/index.html">Oracle Technology
Network Java</ulink>.
</para>
</section>
@@ -448,23 +437,23 @@ certainly not implemented correctly.
<para>
Yes, there are. Some of these are reported as Debian bugs. You can look up
the bugs for a specific Debian package at the <ulink
-url="http://www.debian.org/Bugs/">Debian Bug Tracking System</ulink>. As a
+url="https://www.debian.org/Bugs/">Debian Bug Tracking System</ulink>. As a
quick link, here are some packages:
</para>
<itemizedlist>
<listitem>
<para>
-<ulink url="http://bugs.debian.org/java-common">java-common</ulink>
+<ulink url="https://bugs.debian.org/java-common">java-common</ulink>
</para>
</listitem>
<listitem>
<para>
-<ulink url="http://bugs.debian.org/src:openjdk-7">openjdk-7</ulink>
+<ulink url="https://bugs.debian.org/src:openjdk-7">openjdk-7</ulink>
</para>
</listitem>
<listitem>
<para>
-<ulink url="http://bugs.debian.org/src:openjdk-8">openjdk-8</ulink>
+<ulink url="https://bugs.debian.org/src:openjdk-8">openjdk-8</ulink>
</para>
</listitem>
</itemizedlist>
@@ -480,7 +469,7 @@ is <systemitem role="package">reportbug</systemitem>.
<section id="s4.5"><title>How can I use the proprietary version of the JDK/JRE from Oracle as a Debian package?</title>
<para>
The package <ulink
-url="http://packages.debian.org/wheezy/java-package/">java-package</ulink>
+url="https://packages.debian.org/wheezy/java-package/">java-package</ulink>
provides an easy way to convert an upstream installer into a Debian package.
It should be as easy as:
</para>
@@ -489,7 +478,7 @@ make-jpkg ~/Downloads/jdk-6u31-linux-x64.bin
</screen>
<para>
For more information, see this <ulink
-url="http://sylvestre.ledru.info/blog/2012/02/29/java_package_replacement_of_sun_java6">Blog
+url="https://sylvestre.ledru.info/blog/2012/02/29/java_package_replacement_of_sun_java6">Blog
article</ulink>
</para>
</section>
@@ -523,13 +512,13 @@ You can use:
<listitem>
<para>
Apache <systemitem role="package">tomcat7</systemitem> from <ulink
-url="http://tomcat.apache.org">http://tomcat.apache.org</ulink>.
+url="https://tomcat.apache.org">https://tomcat.apache.org</ulink>.
</para>
</listitem>
<listitem>
<para>
Eclipse <systemitem role="package">jetty</systemitem> from <ulink
-url="http://www.eclipse.org/jetty/">http://www.eclipse.org/jetty/</ulink>.
+url="https://www.eclipse.org/jetty/">https://www.eclipse.org/jetty/</ulink>.
</para>
</listitem>
</itemizedlist>
@@ -543,16 +532,16 @@ url="http://www.eclipse.org/jetty/">http://www.eclipse.org/jetty/</ulink>.
It is still in the works. The current policy addresses
<emphasis>some</emphasis> of the problems. It has not been officially
released. You can find it at <ulink
-url="http://www.debian.org/doc/packaging-manuals/java-policy/">http://www.debian.org/doc/packaging-manuals/java-policy/</ulink>.
+url="https://www.debian.org/doc/packaging-manuals/java-policy/">https://www.debian.org/doc/packaging-manuals/java-policy/</ulink>.
The Java Policy can also be found in the <systemitem
-role="package">java-common</systemitem> package.
+role="package">java-policy</systemitem> package.
</para>
</section>
<section id="s7.2"><title>Are there holes in the Java Policy?</title>
<para>
Yes, some until under discussion. Please check out the <ulink
-url="http://bugs.debian.org/java-common">bugs against the java-common
+url="https://bugs.debian.org/java-policy">bugs against the java-policy
package</ulink>. Thus it is <emphasis>very</emphasis> inconvenient to use
several compilers of virtual machines since there is not one CLASSPATH setting
for all of them.
@@ -585,7 +574,7 @@ there an installer. There are quite a lot Java programs out there.
</para>
<para>
A list of missing packages is maintained on the <ulink
-url="http://wiki.debian.org/Java/RequestedPackages">Debian Wiki - Java
+url="https://wiki.debian.org/Java/RequestedPackages">Debian Wiki - Java
Packaging Wishlist</ulink>.
</para>
</section>
=====================================
debian-java-policy.xml
=====================================
@@ -21,10 +21,9 @@
<!ENTITY d-jre-h "<emphasis>default-jre-headless</emphasis>">
<!ENTITY d-jbdep "<emphasis>default-jdk-builddep</emphasis>">
<!ENTITY d-jdoc "<emphasis>default-jdk-doc</emphasis>">
-<!ENTITY g-n-h "<emphasis>gcj-native-helper</emphasis>">
<!ENTITY JVM "<acronym>JVM</acronym>">
<!ENTITY JIT "<acronym>JIT</acronym>">
-<!ENTITY debpol "http://www.debian.org/doc/debian-policy">
+<!ENTITY debpol "https://www.debian.org/doc/debian-policy">
<!ENTITY djmail "<email>debian-java at lists.debian.org</email>">
]>
@@ -116,14 +115,14 @@
emacsen-common for instance. As far as I know, the only subpolicy
for a programming language, is that of
<ulink
- url="http://pkg-perl.alioth.debian.org/policy.html">Perl</ulink>.
+ url="https://pkg-perl.alioth.debian.org/policy.html">Perl</ulink>.
</para>
<para>
Feel free to report comments, suggestions and/or disagreements to the
- java-common package (<email>java-common at packages.debian.org</email>)
+ java-policy package (<email>java-policy at packages.debian.org</email>)
or the Debian Java mailing list &djmail;. Change requests should be
- sent as a bug to the java-common package.
+ sent as a bug to the java-policy package.
</para>
</chapter>
@@ -213,13 +212,13 @@
</para>
<para>
- The <ulink url="http://packages.debian.org/sid/javahelper">javahelper package</ulink>
+ The <ulink url="https://packages.debian.org/sid/javahelper">javahelper package</ulink>
provides helper to build either with CDBS or dh. They are strongly
recommended for Java packaging.
</para>
<para>
- For Maven based packages, the usage of <ulink url="http://packages.debian.org/sid/maven-debian-helper">maven-debian-helper</ulink>
+ For Maven based packages, the usage of <ulink url="https://packages.debian.org/sid/maven-debian-helper">maven-debian-helper</ulink>
is recommended.
</para>
</sect1>
@@ -229,15 +228,14 @@
<para>
Programs &must; have one or more executables in one or more of
- the directories defined by <ulink url="&debpol;/ch-opersys.html#s9.1">
+ the directories defined by <ulink url="&debpol;/ch-opersys.html#file-system-hierarchy">
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
+ <ulink url="&debpol;/ch-opersys.html#environment-variables">Policy 9.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>).
+ <ulink url="&debpol;/ch-docs.html#manual-pages">Policy 12.1</ulink>).
</para>
<para>
@@ -362,63 +360,6 @@
</para>
</sect1>
- <sect1 id="policy-gcj-native">
- <title>Native Java Bytecode (gcj packages)</title>
-
- <para>
- Java bytecode compiled into native code is referred to as
- gcj-code and packages containing gcj-code as gcj-packages.
- </para>
-
- <para>
- gcj-packages has been added in order to improve
- performance of Java libraries and programs. This is
- particularly useful on architectures where the JVM
- does not have a &JIT;. However, this performance comes
- at the cost of size, extra compilation time and
- creates architecture dependent packages.
- </para>
-
- <para>
- Packages &mustnot; ship gcj-code without the permission of
- 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>
- A request for permission to add gcj should convince
- the Java Team that the performance boost of adding
- the gcj-packages out-weights the disadvantages.
- </para>
-
- <para>
- Source packages compiling gcj-packages &must; Build-Depend on
- &g-n-h; (formerly known as &d-jbdep;). The gcj-code &should;
- only be shipped for a selected set of architectures.
- </para>
-
- <para>
- The gcj-code &must; be installed in <filename>/usr/lib/gcj/</filename>
- and shipped separately from the original jar file. The gcj-package
- &must; also install the classmap file generated by aot-compile in
- <filename>/usr/share/gcj/classmap.d/</filename>.
- </para>
-
- <para>
- The gcj-package &must; call rebuild-gcj-db in the postinst and
- postrm script, if rebuild-gcj-db is present.
- </para>
-
- <para>
- The gcj-package &must; depend on the package providing the jar
- file, it is a native compilation.
- The package containing the jar file &must; declare either a
- Suggests or a Recommends relationship on the gcj-package.
- </para>
-
- </sect1>
-
<sect1 id="policy-politics">
<title>Main, contrib or non-free</title>
=====================================
debian/changelog
=====================================
@@ -1,3 +1,14 @@
+java-policy (0.57) unstable; urgency=medium
+
+ * Updated the references to the Debian Policy (Closes: #966303)
+ * Removed the references to GCJ
+ * Redirect the discussions and bug reports to the java-policy package
+ * Switched the URLs to https
+ * Standards-Version updated to 4.5.0
+ * Switch to debhelper level 13
+
+ -- Emmanuel Bourg <ebourg at apache.org> Mon, 27 Jul 2020 14:04:58 +0200
+
java-policy (0.56) unstable; urgency=medium
* Team upload.
=====================================
debian/compat deleted
=====================================
@@ -1 +0,0 @@
-11
=====================================
debian/control
=====================================
@@ -3,8 +3,8 @@ Section: java
Priority: optional
Maintainer: Debian Java Mailing List <debian-java at lists.debian.org>
Uploaders: Emmanuel Bourg <ebourg at apache.org>
-Build-Depends: debhelper (>= 11~), docbook-xml, docbook-xsl, w3m, xsltproc,
-Standards-Version: 4.2.1
+Build-Depends: debhelper-compat (= 13), docbook-xml, docbook-xsl, w3m, xsltproc,
+Standards-Version: 4.5.0
Vcs-Git: https://salsa.debian.org/java-team/java-policy.git
Vcs-Browser: https://salsa.debian.org/java-team/java-policy
Homepage: https://wiki.debian.org/Java/
=====================================
debian/copyright
=====================================
@@ -1,4 +1,4 @@
-Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: Debian Java Policy
Upstream-Contact: Debian Java Team <debian-java at lists.debian.org>
View it on GitLab: https://salsa.debian.org/java-team/java-policy/-/compare/b44eb4b17a80f973a7f5f1dabf538b4eb5d6d27a...74166a18b356e562cf706618b4809ea676052c84
--
View it on GitLab: https://salsa.debian.org/java-team/java-policy/-/compare/b44eb4b17a80f973a7f5f1dabf538b4eb5d6d27a...74166a18b356e562cf706618b4809ea676052c84
You're receiving this email because of your account on salsa.debian.org.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://alioth-lists.debian.net/pipermail/pkg-java-commits/attachments/20200727/7405cf70/attachment.html>
More information about the pkg-java-commits
mailing list