Updating Findbugs from 2.0.1 to 2.0.3

doc/manual.xml

 <?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
                     "file:../etc/docbook/docbookx.dtd" [
 <!ENTITY FindBugs "<application>FindBugs</application>">
 <!ENTITY Ant "<application>Ant</application>">
 <!ENTITY Saxon "<application>Saxon</application>">
 <!ENTITY FBHome "<replaceable>$FINDBUGS_HOME</replaceable>">
 <!ENTITY FBHomeWin "<replaceable>&#x25;FINDBUGS_HOME&#x25;</replaceable>">
 <!ENTITY nbsp "&#160;">
 ]>
@@ skipping 26 matching lines @@
 This manual is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike License.
 To view a copy of this license, visit
 <ulink url="http://creativecommons.org/licenses/by-nc-sa/1.0/">http://creativecommons.org/licenses/by-nc-sa/1.0/</ulink>
 or send a letter to Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA.
 </para>
 <para>
 The name FindBugs and the FindBugs logo are trademarked by the University of Maryland.
 </para>
 </legalnotice>
 
-<edition>2.0.1</edition>
+<edition>2.0.3</edition>
 
-<pubdate>19:56:04 EDT, 12 July, 2012</pubdate>
+<pubdate>17:16:15 EST, 22 November, 2013</pubdate>
 
 </bookinfo>
 
 <!--
    **************************************************************************
    Introduction
    **************************************************************************
 -->
 
 <chapter id="introduction">
 <title>Introduction</title>
 
 <para> &FindBugs;&trade; is a program to find bugs in Java programs.  It looks for instances
 of "bug patterns" --- code instances that are likely to be errors.</para>
 
-<para> This document describes version 2.0.1 of &FindBugs;.We
+<para> This document describes version 2.0.3 of &FindBugs;.We
 are very interested in getting your feedback on &FindBugs;. Please visit
 the <ulink url="http://findbugs.sourceforge.net">&FindBugs; web page</ulink> for
 the latest information on &FindBugs;, contact information, and support resources such
 as information about the &FindBugs; mailing lists.</para>
 
 <sect1>
 <title>Requirements</title>
 <para> To use &FindBugs;, you need a runtime environment compatible with
 <ulink url="http://java.sun.com/j2se">Java 2 Standard Edition</ulink>, version 1.5 or later.
 &FindBugs; is platform independent, and is known to run on GNU/Linux, Windows, and
@@ skipping 17 matching lines @@
 <para>
 This chapter explains how to install &FindBugs;.
 </para>
 
 <sect1>
 <title>Extracting the Distribution</title>
 
 <para>
 The easiest way to install &FindBugs; is to download a binary distribution.
 Binary distributions are available in
-<ulink url="http://prdownloads.sourceforge.net/findbugs/findbugs-2.0.1.tar.gz?download">gzipped tar format</ulink> and
-<ulink url="http://prdownloads.sourceforge.net/findbugs/findbugs-2.0.1.zip?download">zip format</ulink>.
+<ulink url="http://prdownloads.sourceforge.net/findbugs/findbugs-2.0.3.tar.gz?download">gzipped tar format</ulink> and
+<ulink url="http://prdownloads.sourceforge.net/findbugs/findbugs-2.0.3.zip?download">zip format</ulink>.
 Once you have downloaded a binary distribution, extract it into a directory of your choice.
 </para>
 
 <para>
 Extracting a gzipped tar format distribution:
 <screen>
-<prompt>$ </prompt><command>gunzip -c findbugs-2.0.1.tar.gz | tar xvf -</command>
+<prompt>$ </prompt><command>gunzip -c findbugs-2.0.3.tar.gz | tar xvf -</command>
 </screen>
 </para>
 
 <para>
 Extracting a zip format distribution:
 <screen>
-<prompt>C:\Software></prompt><command>unzip findbugs-2.0.1.zip</command>
+<prompt>C:\Software></prompt><command>unzip findbugs-2.0.3.zip</command>
 </screen>
 </para>
 
 <para>
 Usually, extracting a binary distribution will create a directory ending in
-<filename class="directory">findbugs-2.0.1</filename>. For example, if you extracted
+<filename class="directory">findbugs-2.0.3</filename>. For example, if you extracted
 the binary distribution from the <filename class="directory">C:\Software</filename>
 directory, then the &FindBugs; software will be extracted into the directory
-<filename class="directory">C:\Software\findbugs-2.0.1</filename>.
+<filename class="directory">C:\Software\findbugs-2.0.3</filename>.
 This directory is the &FindBugs; home directory.  We'll refer to it as
 &FBHome; (or &FBHomeWin; for Windows) throughout this manual.
 </para>
 </sect1>
 
 </chapter>
 
 <!--
    **************************************************************************
    Compiling FindBugs from Source
@@ skipping 10 matching lines @@
 </para>
 
 <sect1>
 <title>Prerequisites</title>
 
 <para>
 To compile &FindBugs; from source, you will need the following:
 <itemizedlist>
   <listitem>
     <para>
-      The <ulink url="http://prdownloads.sourceforge.net/findbugs/findbugs-2.0.1-source.zip?download"
+      The <ulink url="http://prdownloads.sourceforge.net/findbugs/findbugs-2.0.3-source.zip?download"
       >&FindBugs; source distribution</ulink>
     </para>
   </listitem>
   <listitem>
     <para>
       <ulink url="http://java.sun.com/j2se/">JDK 1.5.0 or later</ulink>
     </para>
   </listitem>
   <listitem>
     <para>
@@ skipping 42 matching lines @@
 
 </sect1>
 
 <sect1>
 <title>Extracting the Source Distribution</title>
 <para>
 After you download the source distribution, you'll need to extract it into
 a working directory.  A typical command to do this is:
 
 <screen>
-<prompt>$ </prompt><command>unzip findbugs-2.0.1-source.zip</command>
+<prompt>$ </prompt><command>unzip findbugs-2.0.3-source.zip</command>
 </screen>
 
 </para>
 </sect1>
 
 <sect1>
 <title>Modifying <filename>local.properties</filename></title>
 <para>
 If you intend to build the FindBugs documentation,
 you will need to modify the <filename>local.properties</filename> file
@@ skipping 699 matching lines @@
   <term><command>-auxclasspath</command> <replaceable>classpath</replaceable></term>
   <listitem>
     <para>
     Set the auxiliary classpath for analysis.  This classpath should include all
     jar files and directories containing classes that are part of the program
     being analyzed but you do not want to have analyzed for bugs.
     </para>
   </listitem>
   </varlistentry>
 
+  <varlistentry>
+  <term><command>-userPrefs</command> <replaceable>edu.umd.cs.findbugs.core.prefs</replaceable></term>
+  <listitem>
+    <para>
+    Set the path of the user preferences file to use, which might override some of the options abobe.
+    Specifying <literal>userPrefs</literal> as first argument would mean some later
+    options will override them, as last argument would mean they will override some previous options).
+    This rationale behind this option is to reuse FindBugs Eclipse project settings for command
+    line execution.
+    </para>
+  </listitem>
+  </varlistentry>
+
 <!--
   <varlistentry>
   <term><command></command> <replaceable></replaceable></term>
   <listitem>
     <para>
     </para>
   </listitem>
   </varlistentry>
 -->
 
@@ skipping 274 matching lines @@
   <varlistentry>
     <term><literal>class</literal></term>
     <listitem>
        <para>
        A optional nested element specifying which classes to analyze.  The <literal>class</literal>
        element must specify a <literal>location</literal> attribute which names the
        archive file (jar, zip, etc.), directory, or class file to be analyzed.  Multiple <literal>class</literal>
        elements may be specified as children of a single <literal>findbugs</literal> element.
        </para>
        <para>In addition to or instead of specifying a <literal>class</literal> element,
-       the  &FindBugs; task can contain one or more <literal>fileset</literal> element(s) that 
-       specify files to be analyzed. 
+       the  &FindBugs; task can contain one or more <literal>fileset</literal> element(s) that
+       specify files to be analyzed.
        For example, you might use a fileset to specify that all of the jar files in a directory
        should be analyzed.
        </para>
     </listitem>
   </varlistentry>
 
   <varlistentry>
     <term><literal>auxClasspath</literal></term>
     <listitem>
        <para>
@@ skipping 38 matching lines @@
        </para>
     </listitem>
   </varlistentry>
 
   <varlistentry>
     <term><literal>reportLevel</literal></term>
     <listitem>
        <para>
        An optional attribute.  It specifies
        the confidence/priority threshold for reporting issues.  If set to "low", confidence is not used to filter bugs.
-       If set to "medium" (the default), low confidence issues are supressed. 
+       If set to "medium" (the default), low confidence issues are supressed.
        If set to "high", only high confidence bugs are reported.
        </para>
     </listitem>
   </varlistentry>
 
   <varlistentry>
     <term><literal>output</literal></term>
     <listitem>
        <para>
        Optional attribute.
@@ skipping 200 matching lines @@
       <term><literal>warningsProperty</literal></term>
       <listitem>
           <para>
               Optional attribute which specifies the name of a property
               that will be set to "true" if any warnings are reported by
               &FindBugs; on the analyzed program.
           </para>
       </listitem>
   </varlistentry>
 
+  <varlistentry>
+      <term><literal>userPreferencesFile</literal></term>
+      <listitem>
+          <para>
+              Optional attribute. Set the path of the user preferences file to use, which might override some of the options abobe.
+              Specifying <literal>userPreferencesFile</literal> as first argument would mean some later
+              options will override them, as last argument would mean they will override some previous options).
+              This rationale behind this option is to reuse FindBugs Eclipse project settings for command
+              line execution.
+            </para>
+      </listitem>
+  </varlistentry>
+
 </variablelist>
 
 
 </para>
 
 <!--
 
 -->
 
 </sect1>
@@ skipping 58 matching lines @@
       <listitem>
         <para>
          Provides the daily build of FindBugs. No testing other than that it compiles.
         </para>
       </listitem>
     </varlistentry>
     </variablelist>
 
 <para>You can also manually
 download the plugin from the following link:
-<ulink url="http://prdownloads.sourceforge.net/findbugs/edu.umd.cs.findbugs.plugin.eclipse_2.0.1.20120712.zip?download"
->http://prdownloads.sourceforge.net/findbugs/edu.umd.cs.findbugs.plugin.eclipse_2.0.1.20120712.zip?download</ulink>.
+<ulink url="http://prdownloads.sourceforge.net/findbugs/edu.umd.cs.findbugs.plugin.eclipse_2.0.3.20131122.zip?download"
+>http://prdownloads.sourceforge.net/findbugs/edu.umd.cs.findbugs.plugin.eclipse_2.0.3.20131122.zip?download</ulink>.
 Extract it in Eclipse's "plugins" subdirectory.
-(So &lt;eclipse_install_dir&gt;/plugins/edu.umd.cs.findbugs.plugin.eclipse_2.0.1.20120712/findbugs.png
+(So &lt;eclipse_install_dir&gt;/plugins/edu.umd.cs.findbugs.plugin.eclipse_2.0.3.20131122/findbugs.png
 should be the path to the &FindBugs; logo.)
 
 </para>
 
 <para>
 Once the plugin is extracted, start Eclipse and choose
 <menuchoice>
   <guimenu>Help</guimenu>
   <guimenuitem>About Eclipse Platform</guimenuitem>
   <guimenuitem>Plug-in Details</guimenuitem>
@@ skipping 2347 matching lines @@
 </blockquote>
 
 </sect2>
 
 </sect1>
 
 </chapter>
 
 
 </book>