[java-policy] 115/198: Whitespace and markup changes to the policy.

Emmanuel Bourg ebourg-guest at moszumanska.debian.org
Wed Sep 23 07:49:36 UTC 2015


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 46c25d0d7cc0256fba602e5a628aa739b42c9de9
Author: Niels Thykier <nthykier at debian.org>
Date:   Mon Apr 19 06:58:32 2010 +0000

    Whitespace and markup changes to the policy.
---
 policy.xml | 65 +++++++++++++++++++++++++++++---------------------------------
 1 file changed, 30 insertions(+), 35 deletions(-)

diff --git a/policy.xml b/policy.xml
index 94a853b..43db488 100644
--- a/policy.xml
+++ b/policy.xml
@@ -14,6 +14,7 @@
 <!ENTITY JVM "<acronym>JVM</acronym>">
 <!ENTITY JIT "<acronym>JIT</acronym>">
 <!ENTITY debpol "http://www.debian.org/doc/debian-policy">
+<!ENTITY djmail "<email>debian-java at lists.debian.org</email>">
 ]>
 
 <book>
@@ -61,7 +62,7 @@
 	<authorblurb>
 	  <para>
 	    Most issues of the java policy have been discussed on the
-	    <email>debian-java at lists.debian.org</email> mailinglist.
+	    &djmail; mailinglist.
 	  </para>
 	</authorblurb>
       </author>
@@ -85,12 +86,10 @@
     
     <para>
       There are several "subpolicies" in Debian. They all want to make
-      the
-      <ulink url="http://www.debian.org/doc/debian-policy/">Debian
-	Policy</ulink>
-      more precise when it comes to a specific subject. See
-      the Emacs subpolicy in package emacsen-common for instance.  As far as
-      I know, the only subpolicy for a programming language, is that of
+      the <ulink url="&debpol;">Debian Policy</ulink> more precise when
+      it comes to a specific subject. See the Emacs subpolicy in package
+      emacsen-common for instance.  As far as I know, the only subpolicy
+      for a programming language, is that of
       <ulink
 	url="http://non-us.debian.org/~hertzog/perl-policy.html/">Perl</ulink>.
     </para>
@@ -98,9 +97,8 @@
     <para>
       Feel free to report comments, suggestions and/or disagreements to the
       java-common package (<email>java-common at packages.debian.org</email>)
-      or the Debian Java mailing list
-      <email>debian-java at lists.debian.org</email>. Change requests should
-      be sent as a bug to the java-common package.
+      or the Debian Java mailing list &djmail;. Change requests should be
+      sent as a bug to the java-common package.
     </para>
 
   </chapter>
@@ -123,7 +121,7 @@
       files, packaged in a <filename>*.jar</filename> archive) and with
       an "Architecture: all". There are rare exceptions to this such as Eclipse
       SWT. Exceptions to this rule can only be granted by the Java Team.
-      Requests &must; be sent to <email>debian-java at lists.debian.org</email>.
+      Requests &must; be sent to &djmail;.
     </para>
 
     <para>
@@ -140,11 +138,10 @@
       <title>Virtual machines</title>
       
       <para>
-	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
-	environment.
+	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 environment.
       </para>
 
       <para>
@@ -190,9 +187,9 @@
 	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 instance CLASSPATH. They &must; respect the Policy
-	rules for executables (for instance a manual page per executable, see
+	<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="&debpol;/ch-docs.html#s13.1">
 	  Policy 13.1</ulink>).
       </para>
@@ -214,8 +211,8 @@
 	/usr/share/<package>.
       </para>
       <para>
-        Programs &must; depend on the needed
-	runtime environment (&j1r; and/or &j2r;).
+        Programs &must; depend on the needed runtime environment (&j1r; and/or
+	&j2r;).
       </para>
       <para>
         There is no naming rules for programs, they are ordinary programs,
@@ -241,8 +238,7 @@
       
       <para>
 	Their classes &must; be in <filename>jar</filename> archive(s) in
-	the directory <filename>/usr/share/java</filename>,
-	with the name
+	the directory <filename>/usr/share/java</filename>, with the name
 	<filename>packagename[-extraname]-fullversion.jar</filename>.
 	The extraname is optional and used internally within the package to
 	separate the different jars provided by the package. The fullversion
@@ -328,10 +324,9 @@
 
       <para>
  	Packages &mustnot; ship gcj-code without the permission of
- 	the Java team (<email>debian-java at lists.debian.org</email>).
-	Source packages that shipped gcj-packages as of March 22nd,
-	2010, have been given this permission through the
-	ratification of this policy.
+ 	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>
@@ -418,8 +413,8 @@
 
       <listitem>
 	<para>
-	  The symbolic links in /usr/share/java be made by a script
-	  instead, similar to the c-libraries.
+	  The symbolic links in <filename>/usr/share/java</filename> be
+	  made by a script instead, similar to the c-libraries.
 	</para>
       </listitem>
 
@@ -460,14 +455,15 @@
       </listitem>      
 
       <listitem>
-	<para>How to check for a good enough jvm, and to select a
-	  proper one to use. Are /etc/alternatives not good enough?
+	<para>How to check for a good enough &JVM;, and to select a
+	  proper one to use. Are <filename>/etc/alternatives</filename>
+	  not good enough?
 	</para>
       </listitem>
       
       <listitem>
 	<para>
-	  Should the jvm internal classes be possible to
+	  Should the &JVM; internal classes be possible to
 	  override entirely and how?
 	</para>
       </listitem>
@@ -494,9 +490,8 @@
       
       <listitem>
 	<para>
-	  You can suppress many calls in
-	  <filename>debian/rules</filename> which are meaningless for Java,
-	  like dh_strip and dh_shlibdeps.
+	  You can suppress many calls in <filename>debian/rules</filename>
+	  which are meaningless for Java, like dh_strip and dh_shlibdeps.
 	</para>
       </listitem>
       

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



More information about the pkg-java-commits mailing list