Attachment 205436 Details for Bug 359721 – proposed doc update

[patch] proposed doc update

Bug_359721_doc.patch (text/plain), 5.13 KB, created by Stephan Herrmann

on 2011-10-18 11:58:06 EDT

(hide)

Description:

Filename:

MIME Type:

Creator: Stephan Herrmann

Created: 2011-10-18 11:58:06 EDT

Size: 5.13 KB

patch

obsolete

>diff --git a/bundles/org.eclipse.jdt.doc.user/tasks/task-suppress_warnings.htm b/bundles/org.eclipse.jdt.doc.user/tasks/task-suppress_warnings.htm
>index 90541a7..d1125f1 100644
>--- a/bundles/org.eclipse.jdt.doc.user/tasks/task-suppress_warnings.htm
>+++ b/bundles/org.eclipse.jdt.doc.user/tasks/task-suppress_warnings.htm
>@@ -40,6 +40,7 @@
> <li>nls to suppress warnings relative to non-nls string literals</li>
> <li>null to suppress warnings relative to null analysis</li>
> <li>rawtypes to suppress warnings relative to usage of raw types</li>
>+<li>resource to suppress warnings relative to usage of resources of type Closeable</li>
> <li>restriction to suppress warnings relative to usage of discouraged or forbidden references</li>
> 
> <li>serial to suppress warnings relative to missing serialVersionUID field for a serializable class</li>
>diff --git a/bundles/org.eclipse.jdt.doc.user/tasks/task-using_batch_compiler.htm b/bundles/org.eclipse.jdt.doc.user/tasks/task-using_batch_compiler.htm
>index a258dad..34e0d96 100644
>--- a/bundles/org.eclipse.jdt.doc.user/tasks/task-using_batch_compiler.htm
>+++ b/bundles/org.eclipse.jdt.doc.user/tasks/task-using_batch_compiler.htm
>@@ -216,7 +216,7 @@
> <td colspan="3">Display advanced warning options</td>
> </tr>
> <tr>
>-<td valign="top" width="250" rowspan="70">-warn:...</td>
>+<td valign="top" width="250" rowspan="72">-warn:...</td>
> 
> <td valign="top" colspan="3">Specify the set of enabled warnings. 
> e.g. -warn:unusedLocal,deprecation 
>@@ -239,6 +239,9 @@
> <td>disable specific warnings</td>
> </tr>
> </table>
>+In the column Default below, a mark "+/-" indicates that an option covers several fine grained warning variants,
>+some of which are enabled by default, others disabled. This means that specifying the given option with "+"
>+will enable more warnings than the default, and specifying "-" disables some that are enabled by default. 
> </td>
> </tr>
> <tr>
>@@ -247,13 +250,13 @@
> <th align="left">Description</th>
> </tr>
> <tr>
>-<td align="center" valign="top">-</td>
>+<td align="center" valign="top">+/-</td>
> <td align="left" valign="top">allDeadCode</td>
> <td valign="top">dead code including trivial if(DEBUG) check</td>
> </tr>
> 
> <tr>
>-<td align="center" valign="top">-</td>
>+<td align="center" valign="top">+/-</td>
> <td align="left" valign="top">allDeprecation</td>
> <td valign="top">deprecation even inside deprecated code</td>
> </tr>
>@@ -267,6 +270,11 @@
> <td align="center" valign="top">-</td>
> <td align="left" valign="top">allOver-ann</td>
> <td valign="top">all missing @Override annotations (superclass and superinterfaces)</td>
>+</tr>
>+<tr>
>+<td align="center" valign="top">-</td>
>+<td align="left" valign="top">all-static-method</td>
>+<td valign="top">all method can be declared as static warnings</td>
> </tr>
> <tr>
> <td align="center" valign="top">+</td>
>@@ -313,7 +321,7 @@
> <td valign="top">missing @Deprecated annotation</td>
> </tr>
> <tr>
>-<td align="center" valign="top">+</td>
>+<td align="center" valign="top">+/-</td>
> <td align="left" valign="top">deprecation</td>
> <td valign="top">usage of deprecated type or member outside deprecated code</td>
> </tr>
>@@ -373,7 +381,7 @@
> <td valign="top">missing hashCode() method when overriding equals()</td>
> </tr>
> <tr>
>-<td align="center" valign="top">-</td>
>+<td align="center" valign="top">+/-</td>
> <td align="left" valign="top">hiding</td>
> <td valign="top">macro for fieldHiding, localHiding, typeHiding and maskedCatchBlock</td>
> </tr>
>@@ -432,7 +440,7 @@
> </tr>
> 
> <tr>
>-<td align="center" valign="top">-</td>
>+<td align="center" valign="top">+/-</td>
> <td align="left" valign="top">null</td>
> <td valign="top">potential missing or redundant null check</td>
> </tr>
>@@ -464,6 +472,12 @@
> <td valign="top">usage a of raw type (instead of a parameterized type)</td>
> </tr>
> <tr>
>+<td align="center" valign="top">+/-</td>
>+<td align="left" valign="top">resource</td>
>+<td valign="top">(potentially) unsafe usage of resource of type Closeable</td>
>+</tr>
>+
>+<tr>
> <td align="center" valign="top">-</td>
> <td align="left" valign="top">semicolon</td>
> 
>@@ -481,7 +495,7 @@
> 
> </tr>
> <tr>
>-<td align="center" valign="top">-</td>
>+<td align="center" valign="top">+/-</td>
> <td align="left" valign="top">static-access</td>
> <td valign="top">macro for indirectStatic and staticReceiver</td>
> </tr>
>@@ -549,7 +563,7 @@
> 
> </tr>
> <tr>
>-<td align="center" valign="top">-</td>
>+<td align="center" valign="top">+/-</td>
> <td align="left" valign="top">unused</td>
> <td valign="top">macro for unusedAllocation, unusedArgument, unusedImport, unusedLabel, unusedLocal, unusedPrivate, unusedThrown and unusedTypeArgs</td>
> </tr>
>@@ -605,9 +619,9 @@
> <td valign="top">varargs argument need explicit cast</td>
> </tr>
> <tr>
>-<td align="center" valign="top">+</td>
>+<td align="center" valign="top">+/-</td>
> <td align="left" valign="top">warningToken</td>
>-<td valign="top">unhandled warning token in @SuppressWarnings</td>
>+<td valign="top">unhandled or unused warning token in @SuppressWarnings</td>
> </tr>
> <tr>
> <td valign="top">-nowarn</td>

Actions: View | Diff

Attachments on bug 359721: 204459 | 205436