debian-java-policy.xml

@@ -92,7 +92,7 @@
       <para>
 	This is the Java policy for Debian. It begins with a
 	background description, continues with the real policy, some
-	issues to discuss and ends with some advices to Java packagers.
+	issues to discuss and ends with some advice to Java packagers.
       </para>
       <para>
 	The policy covers Java virtual machines, Java compilers, Java
@@ -512,11 +512,11 @@
     </itemizedlist>
   </chapter>
   
-  <chapter id="advices">
-    <title>Advices to Java packagers</title>
+  <chapter id="advice">
+    <title>Advice to Java packagers</title>
     
     <para>
-      Warning: These are just advices, they are not part of the policy.
+      Warning: These recommendations are just advisory, they are not part of the policy.
     </para>
     
     <itemizedlist>
@@ -532,8 +532,9 @@
       
       <listitem>
 	<para>
-	  Many calls in <filename>debian/rules</filename> can be removed
-	  which are meaningless for Java, like dh_strip and dh_shlibdeps.
+	  In hand-written <filename>debian/rules</filename>, a lot of calls
+	  can be removed since they are useless for Java packages, e.g.
+	  dh_strip and dh_shlibdeps.
 	</para>
       </listitem>