- caveat for -nowarn per bug 38134

- documented -warn:none, since valid and used in -nowarn

diff --git a/docs/devGuideDB/ajc.xml b/docs/devGuideDB/ajc.xml
index ffee1eb1d7cf7a92c378bfcdc26327bb2ddbbf84..a0030e53738ce6c64907c7278556c84547a0ce84 100644 (file)
--- a/docs/devGuideDB/ajc.xml
+++ b/docs/devGuideDB/ajc.xml
@@ -129,7 +129,7 @@
 
       <varlistentry>
         <term>-Xlint</term>
-        <listitem><para>Same as -Xlint:warning
+        <listitem><para>Same as -Xlint:warning (enabled by default)
         </para></listitem>
       </varlistentry>
 
@@ -244,6 +244,9 @@
       <varlistentry>
         <term>-nowarn</term>
         <listitem><para>Emit no warnings (equivalent to '-warn:none')
+        This does not suppress messages
+        generated by <literal>declare warning</literal> or
+        <literal>Xlint</literal>.
         </para></listitem>
       </varlistentry>
 
@@ -260,7 +263,11 @@
     unusedLocals           local variable never read
     unusedArguments        method argument never read
     unusedImports          import statement not used by code in file
+    none                   suppress all compiler warnings
         </programlisting>
+        <literal>-warn:none</literal> does not suppress messages
+        generated by <literal>declare warning</literal> or
+        <literal>Xlint</literal>.
         
         </para></listitem>
       </varlistentry>