Roll FindBugs from 2.0.3 to 3.0.0

doc/manual_ja.xml

-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://findbugs.googlecode.com/svn/trunk/findbugs/etc/docbook/docbookx.dtd"
-[
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                    "../../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;">
 ]>
 <book lang="ja" id="findbugs-manual">
 
 <bookinfo>
 <title>&FindBugs;&trade; マニュアル</title>
 
-<authorgroup>
+<authorgroup lang="en">
   <author>
     <firstname>David</firstname>
     <othername>H.</othername>
     <surname>Hovemeyer</surname>
   </author>
     <author>
         <firstname>William</firstname>
         <othername>W.</othername>
         <surname>Pugh</surname>
     </author>
 </authorgroup>
 
-<copyright>
-  <year>2003</year>
-  <year>2004</year>
-  <year>2005</year>
-  <year>2006</year>
-  <year>2008</year>
+<copyright lang="en">
+  <year>2003 - 2012</year>
   <holder>University of Maryland</holder>
 </copyright>
 
 <legalnotice>
 <para>このマニュアルは、クリエイティブ・コモンズ表示-非営利-継承に基づく使用許諾がなされています。使用許諾書をご覧になる場合は、 <ulink url="http://creativecommons.org/licenses/by-nc-sa/1.0/deed.ja">http://creativecommons.org/licenses/by-nc-sa/1.0/</ulink> にアクセスするか、クリエイティブ・コモンズ(559 Nathan Abbott Way, Stanford, California 94305, USA)に書簡を送付してください。</para>
 <para>名称「FindBugs」および FindBugs のロゴは、メリーランド大学の登録商標です。</para>
 </legalnotice>
 
-<edition>2.0.3</edition>
+<edition>3.0.0</edition>
 
-<pubdate>17:16:15 EST, 22 November, 2013</pubdate>
+<pubdate>20:25:27 CDT, 06 July, 2014 (翻訳 2014年7月)</pubdate>
 
 </bookinfo>
 
 <!--
    **************************************************************************
    Introduction
    **************************************************************************
 -->
 
 <chapter id="introduction">
 <title>はじめに</title>
 
 <para>&FindBugs;&trade; は、Java プログラムの中のバグを見つけるプログラムです。このプログラムは、「バグ パターン」の実例を探します。「バグ パターン」とは、エラーとなる可能性の高いコードの事例です。</para>
 
-<para>この文書は、&FindBugs; バージョン 2.0.3 について説明してます。私たちは、 &FindBugs; に対するフィードバックを心待ちにしています。どうぞ、 <ulink url="http://findbugs.sourceforge.net">&FindBugs; Web ページ</ulink> にアクセスしてください。&FindBugs; についての最新情報、連絡先および &FindBugs; メーリングリストなどのサポート情報を入手することができます。</para>
+<para>この文書は、&FindBugs; バージョン 3.0.0 について説明してます。私たちは、 &FindBugs; に対するフィードバックを心待ちにしています。どうぞ、 <ulink url="http://findbugs.sourceforge.net">&FindBugs; Web ページ</ulink> にアクセスしてください。&FindBugs; についての最新情報、連絡先および &FindBugs; メーリングリストなどのサポート情報を入手することができます。</para>
 
 <sect1>
 <title>必要条件</title>
 <para>&FindBugs; を使用するには、 <ulink url="http://java.sun.com/j2se">Java 2 Standard Edition</ulink>, バージョン 1.5 以降のバージョンと互換性のあるランタイム環境が必要です。&FindBugs; は、プラットフォーム非依存であり、 GNU/Linux 、 Windows 、 MacOS X プラットフォーム上で動作することが知られています。</para>
 
 <para>&FindBugs; を使用するためには、少なくとも 512 MB のメモリが必要です。巨大なプロジェクトを解析するためには、それより多くのメモリが必要とされることがあります。</para>
 </sect1>
 
 </chapter>
 
 <!--
    **************************************************************************
    Installing FindBugs
    **************************************************************************
 -->
 
 <chapter id="installing">
 <title>&FindBugs;&trade; のインストール</title>
 
 <para>この章では、 &FindBugs; のインストール方法を説明します。</para>
 
 <sect1>
 <title>配布物の展開</title>
 
-<para>&FindBugs; をインストールする最も簡単な方法は、バイナリ配布物をダウンロードすることです。 バイナリ配布物は、 <ulink url="http://prdownloads.sourceforge.net/findbugs/findbugs-2.0.3.tar.gz?download">gzipped tar 形式</ulink> および <ulink url="http://prdownloads.sourceforge.net/findbugs/findbugs-2.0.3.zip?download">zip 形式</ulink> がそれぞれ入手可能です。バイナリ配布物をダウンロードしてきたら、それを任意のディレクトリーに展開します。</para>
+<para>&FindBugs; をインストールする最も簡単な方法は、バイナリ配布物をダウンロードすることです。 バイナリ配布物は、 <ulink url="http://prdownloads.sourceforge.net/findbugs/findbugs-3.0.0.tar.gz?download">gzipped tar 形式</ulink> および <ulink url="http://prdownloads.sourceforge.net/findbugs/findbugs-3.0.0.zip?download">zip 形式</ulink> がそれぞれ入手可能です。バイナリ配布物をダウンロードしてきたら、それを任意のディレクトリーに展開します。</para>
 
 <para>gzipped tar 形式配布物の展開方法例:<screen>
-<prompt>$ </prompt><command>gunzip -c findbugs-2.0.3.tar.gz | tar xvf -</command>
+<prompt>$ </prompt><command>gunzip -c findbugs-3.0.0.tar.gz | tar xvf -</command>
 </screen>
 </para>
 
 <para>zip 形式配布物の展開方法例:<screen>
-<prompt>C:\Software&gt;</prompt><command>unzip findbugs-2.0.3.zip</command>
+<prompt>C:\Software&gt;</prompt><command>unzip findbugs-3.0.0.zip</command>
 </screen>
 </para>
 
-<para>バイナリ配布物の展開すると、通常は <filename class="directory">findbugs-2.0.3</filename> ディレクトリーが作成されます。例えば、ディレクトリー <filename class="directory">C:\Software</filename> でバイナリ配布物を展開すると、ディレクトリー <filename class="directory">C:\Software\findbugs-2.0.3</filename> に &FindBugs; は展開されます。このディレクトリーが &FindBugs; のホームディレクトリーになります。このマニュアルでは、このホームディレクトリーを &FBHome; (Windowsでは &FBHomeWin;) を用いて参照します。</para>
+<para>バイナリ配布物の展開すると、通常は <filename class="directory">findbugs-3.0.0</filename> ディレクトリーが作成されます。例えば、ディレクトリー <filename class="directory">C:\Software</filename> でバイナリ配布物を展開すると、ディレクトリー <filename class="directory">C:\Software\findbugs-3.0.0</filename> に &FindBugs; は展開されます。このディレクトリーが &FindBugs; のホームディレクトリーになります。このマニュアルでは、このホームディレクトリーを &FBHome; (Windowsでは &FBHomeWin;) を用いて参照します。</para>
 </sect1>
 
 </chapter>
 
 <!--
    **************************************************************************
    Compiling FindBugs from Source
    **************************************************************************
 -->
 
 <chapter id="building">
 <title>&FindBugs;&trade; のソールからのビルド</title>
 
 <para>この章では、 &FindBugs; をソースコードからビルドする方法を説明します。&FindBugs; を修正することに興味がないのであれば、 <link linkend="running">次の章</link> に進んでください。</para>
 
 <sect1>
 <title>前提条件</title>
 
 <para>ソースから &FindBugs; をコンパイルするためには、以下のものが必要です。<itemizedlist>
   <listitem>
-    <para><ulink url="http://prdownloads.sourceforge.net/findbugs/findbugs-2.0.3-source.zip?download">&FindBugs; のソース配布物</ulink>
+    <para><ulink url="http://prdownloads.sourceforge.net/findbugs/findbugs-3.0.0-source.zip?download">&FindBugs; のソース配布物</ulink>
     </para>
   </listitem>
   <listitem>
     <para>
-      <ulink url="http://java.sun.com/j2se/">JDK 1.5.0 ベータ またはそれ以降</ulink>
+      <ulink url="http://java.sun.com/j2se/">JDK 1.5.0 またはそれ以降</ulink>
     </para>
   </listitem>
   <listitem>
     <para>
       <ulink url="http://ant.apache.org/">Apache &Ant;</ulink>, バージョン 1.6.3 またはそれ以降</para>
   </listitem>
 </itemizedlist>
 </para>
 
 <warning>
@@ skipping 14 matching lines @@
   </listitem>
 -->
 </itemizedlist>
 </para>
 
 </sect1>
 
 <sect1>
 <title>ソース配布物の展開</title>
 <para>ソース配布物をダウンロードした後に、それを作業用ディレクトリーに展開する必要があります。通常は、次のようなコマンドで展開を行います:<screen>
-<prompt>$ </prompt><command>unzip findbugs-2.0.3-source.zip</command>
+<prompt>$ </prompt><command>unzip findbugs-3.0.0-source.zip</command>
 </screen>
 
 </para>
 </sect1>
 
 <sect1>
 <title><filename>local.properties</filename> の修正</title>
 <para>FindBugs のドキュメントをビルドするためには、 <filename>local.properties</filename> ファイルを修正する必要があります。このファイルは、 &FindBugs; をビルドする際に <ulink url="http://ant.apache.org/">&Ant;</ulink> <filename>build.xml</filename> ファイルが参照します。FindBugs のドキュメントをビルドしない場合は、このファイルは無視してもかまいません。</para>
 
 <para><filename>local.properties</filename> での定義は、 <filename>build.properties</filename> ファイルでの定義に優先します。<filename>build.properties</filename> は次のような内容です:<programlisting>
@@ skipping 460 matching lines @@
   </listitem>
   </varlistentry>
 
   <varlistentry>
   <term><command>-auxclasspath</command> <replaceable>クラスパス</replaceable></term>
   <listitem>
     <para>分析時に使用する補助クラスパスを設定します。分析するプログラムで使用するjarファイルやクラスディレクトリーをすべて指定してください。補助クラスパスに指定したクラスは分析の対象にはなりません。</para>
   </listitem>
   </varlistentry>
 
+  <varlistentry>
+  <term><command>-auxclasspathFromInput</command> </term>
+  <listitem>
+    <para>分析時に使用する補助クラスパスを標準入力から読み込みます。標準入力の各行が分析時に使用する補助クラスパスに追加されます。</para>
+  </listitem>
+  </varlistentry>
+
+  <varlistentry>
+  <term><command>-auxclasspathFromFile</command> <replaceable>ファイルパス</replaceable></term>
+  <listitem>
+    <para>分析時に使用する補助クラスパスをファイルから読み込みます。ファイルの各行が分析時に使用する補助クラスパスに追加されます。</para>
+  </listitem>
+  </varlistentry>
+
+  <varlistentry>
+  <term><command>-analyzeFromFile</command> <replaceable>ファイルパス</replaceable></term>
+  <listitem>
+    <para>分析対象ファイルをファイルから読み込みます。ファイルの各行が分析対象クラスパスに追加されます。</para>
+  </listitem>
+  </varlistentry>
+
+  <varlistentry>
+  <term><command>-userPrefs</command> <replaceable>edu.umd.cs.findbugs.core.prefs</replaceable></term>
+  <listitem>
+    <para>ユーザー設定ファイルのパスを設定します。ユーザー設定ファイルの内容で、他のオプションの一部を上書きすることができます。 
+    <literal>userPrefs</literal> を一番目の引数に指定した場合は、後続のオプションの方がユーザー設定ファイルの内容に優先します。
+    <literal>userPrefs</literal> を最後の引数に指定した場合は、ユーザー設定ファイルの内容の方が前に指定したオプションに優先します。
+    このオプションを設けた背景・理由は、 Eclipse プロジェクトの FindBugs の設定をコマンドライン実行で再利用するためです。</para>
+  </listitem>
+  </varlistentry>
+
 <!--
   <varlistentry>
   <term><command></command> <replaceable></replaceable></term>
   <listitem>
     <para>
     </para>
   </listitem>
   </varlistentry>
 -->
 
@@ skipping 12 matching lines @@
 
 <sect1>
 <title>プロジェクトの作成</title>
 <para><command>findbugs</command>  コマンドで &FindBugs; を起動してから、メニューで <menuchoice><guimenu>File</guimenu><guimenuitem>New Project</guimenuitem></menuchoice> を選択してください。そうすると、次のようなダイアログが表示されます:<mediaobject>
 <imageobject>
 <imagedata fileref="project-dialog.png"/>
 </imageobject>
 </mediaobject>
 </para>
 
-<para>「Class archives and directories to analyze」テキストフィールドの横にある 「Add」ボタンを押すと、バグを分析する java クラスを含んでいる Java アーカイブファイル (zip, jar, ear, or war file) を選択して指定できます。複数の アーカイブ/ディレクトリーを追加することが可能です。</para>
+<para>「Classpath to analyze」の横にある 「Add」ボタンを押すと、バグを分析する java クラスを含んでいる Java アーカイブファイル (zip, jar, ear, or war file) を選択して指定できます。複数の アーカイブ/ディレクトリーを追加することが可能です。</para>
 
 <para>また、分析を行う Java アーカイブのソースコードを含んだソースディレクトリーを指定することもできます。そうすると、バグの可能性があるソースコードの場所が、&FindBugs; 上でハイライトして表示されます。ソースディレクトリーは、Java パッケージ階層のルートディレクトリーを指定する必要があります。例えば、ユーザのアプリケーションが <varname>org.foobar.myapp</varname> パッケージの中にある場合は、 <filename class="directory">org</filename> ディレクトリーの親ディレクトリーをソースディレクトリーリストに指定する必要があります。</para>
 
 <para>もうひとつ、任意指定の手順があります。それは、補助用の Jar ファイルおよびディレクトリーを 「Auxiliary classpath locations」のエントリーに追加することです。分析するアーカイブ/ディレクトリーにも標準の実行時クラスパスにも含まれていないクラスを、分析するアーカイブ/ディレクトリーが参照している場合は、この項目を設定した方がいいでしょう。クラス階層に関する情報を使用するバグディテクタが、 &FindBugs; にはいくつかあります。したがって、&FindBugs; が分析を行うクラスの完全なクラス階層を参照できれば、より正確な分析結果を取得することができます。</para>
 
 </sect1>
 
 <sect1>
 <title>分析の実行</title>
-<para>アーカイブ、ディレクトリーおよびソースディレクトリーの指定ができれば、「Finish」ボタンを押して Jar ファイルに含まれるクラスに対する分析を実行します。巨大なプロジェクトを古いコンピュータ上で実行すると、かなりの時間(数十分)がかかることに注意してください。大容量メモリである最近のコンピュータなら、大きなプログラムであっても数分程度で分析できます。</para>
+<para>アーカイブ、ディレクトリーおよびソースディレクトリーの指定ができれば、「Analyze」ボタンを押して Jar ファイルに含まれるクラスに対する分析を実行します。巨大なプロジェクトを古いコンピュータ上で実行すると、かなりの時間(数十分)がかかることに注意してください。大容量メモリである最近のコンピュータなら、大きなプログラムであっても数分程度で分析できます。</para>
 </sect1>
 
 <sect1>
 <title>結果の閲覧</title>
 
 <para>分析が完了すると、次のような画面が表示されます :<mediaobject>
   <imageobject>
     <imagedata fileref="example-details.png"/>
   </imageobject>
 </mediaobject>
@@ skipping 104 matching lines @@
 
   BUILD SUCCESSFUL
   Total time: 35 seconds
 </screen>この事例においては、XML ファイルでバグ検索結果を保存しているので、 &FindBugs; GUI を使って結果を参照することができます。 <xref linkend="running"/> を参照してください。</para>
 
 </sect1>
 
 <sect1>
 <title>パラメーター</title>
 
-<para>このセクションでは、 &FindBugs; タスクを使用する際に、指定することができるパラメーターについて説明します。<variablelist> <varlistentry> <term><literal>class</literal></term>
+<para>このセクションでは、 &FindBugs; タスクを使用する際に、指定することができるパラメーターについて説明します。
+
+<variablelist>
+
+  <varlistentry>
+    <term><literal>class</literal></term>
     <listitem>
-       <para>分析の対象となるクラス群を指定するためのネストされる要素です。<literal>class</literal> 要素には <literal>location</literal> 属性の指定が必須です。分析対象となるアーカイブファイル (jar, zip, 他)、ディレクトリーまたはクラスファイルの名前を記述します。1 つの <literal>findbugs</literal> 要素に対して、複数の <literal>class</literal> 子要素を指定することができます。</para>
+       <para>任意指定のネストされる要素です。分析の対象となるクラス群を指定します。
+       <literal>class</literal> 要素には <literal>location</literal> 属性の指定が必須です。
+       分析対象となるアーカイブファイル (jar, zip, 他)、ディレクトリーまたはクラスファイルの名前を記述します。
+       1 つの <literal>findbugs</literal> 要素に対して、複数の <literal>class</literal> 子要素を指定することができます。
+       </para>
+       <para><literal>class</literal> 要素の指定を置き換えるまたは追加する形で、 &FindBugs; タスクに1個以上の <literal>fileset</literal> 要素を記述することで
+       分析するファイル群を指定することができます。
+       例えば、 fileset において特定のディレクトリにある全ての jar ファイルを分析対象に指定することができます。
+       </para>
     </listitem>
   </varlistentry>
 
   <varlistentry>
     <term><literal>auxClasspath</literal></term>
     <listitem>
        <para>任意指定のネストされる要素です。分析対象のライブラリーまたはアプリケーションによって使用されているが分析の対象にはしたくないクラスを含んでいるクラスパス (Jar ファイルまたはディレクトリー) を指定します。  &Ant; の Java タスクにある <literal>classpath</literal> 要素 と同じ方法で指定することができます。</para>
     </listitem>
   </varlistentry>
 
@@ skipping 14 matching lines @@
   <varlistentry>
     <term><literal>quietErrors</literal></term>
     <listitem>
        <para>任意指定のブール値属性です。true を設定すると、深刻な分析エラー発生やクラスがみつからないといった情報が &FindBugs; 出力に記録されません。デフォルトは、 false です。</para>
     </listitem>
   </varlistentry>
 
   <varlistentry>
     <term><literal>reportLevel</literal></term>
     <listitem>
-       <para>任意指定の属性です。報告されるバグの優先度のしきい値を指定します。「low」に設定すると、すべてのバグが報告されます。「medium」 (デフォルト) に設定すると、優先度 (中)および優先度 (高)のバグが報告されます。「high」に設定すると、優先度 (高) のバグのみが報告されます。</para>
+       <para>
+       任意指定の属性です。報告される問題の信頼度・優先度のしきい値を指定します。
+       「low」に設定すると、バグ報告が信頼度により除外されることはありません。
+       「medium」 (デフォルト) に設定すると、信頼度(低)の問題が除外されます。
+       「high」に設定すると、信頼度(高) のバグのみが報告されます。
+       </para>
     </listitem>
   </varlistentry>
 
   <varlistentry>
     <term><literal>output</literal></term>
     <listitem>
        <para>任意指定の属性です。出力形式を指定します。「xml」 (デフォルト) に設定すると、出力は XML 形式になります。「xml:withMessages」 に設定すると、出力は人間が読めるメッセージ が追加された XML 形式になります。(XSL スタイルシートを使ってレポートを作成することを計画している場合はこの形式を使用してください。) 「html」に設定すると、出力は HTML 形式(デフォルトのスタイルシートは default.xsl) になります。 「text」に設定すると、出力は特別なテキスト形式になります。「emacs」に設定すると、出力は <ulink url="http://www.gnu.org/software/emacs/">Emacs</ulink> エラーメッセージ形式になります。「xdocs」に設定すると、出力は Apache Maven で使用できる xdoc XML になります。</para>
     </listitem>
   </varlistentry>
  <varlistentry>
@@ skipping 48 matching lines @@
   <varlistentry>
     <term><literal>visitors</literal></term>
     <listitem>
        <para>任意指定の属性です。どのバグディテクタを実行するかをコンマ区切りのリストで指定します。バグディテクタはパッケージ指定なしのクラス名で指定します。省略時、デフォルトで無効化されているものを除くすべてのディテクタが実行されます。</para>
     </listitem>
   </varlistentry>
 
   <varlistentry>
     <term><literal>omitVisitors</literal></term>
     <listitem>
-       <para>任意指定の属性です。<literal>visitors</literal> 属性と似ていますが、こちらは <emphasis>実行されない</emphasis> ディテクタを指定します。</para>
+       <para>
+       任意指定の属性です。
+       バグディテクタをコンマ区切りのリストで指定します。
+       <literal>visitors</literal> 属性と似ていますが、こちらは <emphasis>実行されない</emphasis> ディテクタを指定します。
+       </para>
     </listitem>
   </varlistentry>
 
+  <varlistentry>
+    <term><literal>chooseVisitors</literal></term>
+    <listitem>
+       <para>
+       任意指定の属性です。
+       頭に「+」または「-」を付け加えたバグディテクタをコンマ区切りのリストで指定します。
+       「+」を付け加えたバグディテクタは有効に、「-」を付け加えたバグディテクタは無効になります。
+       </para>
+    </listitem>
+  </varlistentry>
+
   <varlistentry>
     <term><literal>excludeFilter</literal></term>
     <listitem>
        <para>任意指定の属性です。フィルターファイル名を指定します。報告から除外されるバグを指定します。<xref linkend="filter"/> を参照してください。</para>
     </listitem>
   </varlistentry>
 
   <varlistentry>
     <term><literal>includeFilter</literal></term>
     <listitem>
@@ skipping 43 matching lines @@
     </listitem>
   </varlistentry>
 
   <varlistentry>
       <term><literal>warningsProperty</literal></term>
       <listitem>
           <para>任意指定の属性です。&FindBugs; が分析したプログラムにバグ報告が 1 件でもある場合に、「true」が設定されるプロパティーの名前を指定します。</para>
       </listitem>
   </varlistentry>
 
+  <varlistentry>
+      <term><literal>userPreferencesFile</literal></term>
+      <listitem>
+          <para>
+              任意指定の属性です。
+              ユーザー設定ファイルのパスを設定します。ユーザー設定ファイルの内容で、他のオプションの一部を上書きすることができます。 
+              <literal>userPreferencesFile</literal> を一番目の引数に指定した場合は、後続のオプションの方がユーザー設定ファイルの内容に優先します。
+              <literal>userPreferencesFile</literal> を最後の引数に指定した場合は、ユーザー設定ファイルの内容の方が前に指定したオプションに優先します。
+              このオプションを設けた背景・理由は、 Eclipse プロジェクトの FindBugs の設定をコマンドライン実行で再利用するためです。
+            </para>
+      </listitem>
+  </varlistentry>
+
+  <varlistentry>
+      <term><literal>nested</literal></term>
+      <listitem>
+          <para>
+              任意指定の属性です。分析対象のファイル・ディレクトリーリストにあるファイル内にネストされた jar および zip ファイルに対する分析を有効化・無効化します。
+              デフォルトでは、ネストされた jar/zip の分析は有効です。
+          </para>
+      </listitem>
+  </varlistentry>
+
 </variablelist>
 
 
 </para>
 
 <!--
 
 -->
 
 </sect1>
 
 </chapter>
 
 <!--
    **************************************************************************
    Using the FindBugs Eclipse plugin
    **************************************************************************
 -->
 
 <chapter id="eclipse">
 <title>&FindBugs;&trade; Eclipse プラグインの使用方法</title>
 
-<para>FindBugs Eclipse プラグインを使用することによって、 &FindBugs; を <ulink url="http://www.eclipse.org/">Eclipse</ulink> IDE で使用することができるようになります。このFindBugs Eclipse プラグインは、 Peter Friese 氏の多大な貢献によるものです。Phil Crosby 氏 と Andrei Loskutov 氏は、プラグインの重要な改良に貢献しました。</para>
+<para>
+FindBugs Eclipse プラグインを使用することによって、 &FindBugs; を <ulink url="http://www.eclipse.org/">Eclipse</ulink> IDE で使用することができるようになります。
+このFindBugs Eclipse プラグインは、 Peter Friese 氏の多大な貢献によるものです。
+Phil Crosby 氏 と Andrey Loskutov 氏は、プラグインの重要な改良に貢献しました。
+</para>
 
 <sect1>
 <title>必要条件</title>
 
 <para>&FindBugs; Eclipse Plugin を使用するためには、 Eclipse 3.3 あるいはそれ以降のバージョン、また、 JRE/JDK 1.5 あるいはそれ以降のバージョンが必要です。</para>
 
 </sect1>
 
 <sect1>
 <title>インストール</title>
 
 <para>更新サイトが提供されています。更新サイトを利用して、機械的に FindBugs を Eclipse にインストールできます。また自動的に、最新版のアップデートを照会してインストールすることもできます。内容の異なる 3 つの更新サイトが存在します。</para>
 
   <variablelist><title>FindBugs Eclipse 更新サイト一覧</title>
     <varlistentry><term><ulink url="http://findbugs.cs.umd.edu/eclipse/">http://findbugs.cs.umd.edu/eclipse/</ulink></term>
 
     <listitem>
       <para>FindBugs の公式リリース物を提供します。</para>
     </listitem>
     </varlistentry>
 
-    <varlistentry><term><ulink url="http://findbugs.cs.umd.edu/eclipse-candidate/">http://findbugs.cs.umd.edu/eclips-candidate/</ulink></term>
+    <varlistentry><term><ulink url="http://findbugs.cs.umd.edu/eclipse-candidate/">http://findbugs.cs.umd.edu/eclipse-candidate/</ulink></term>
 
       <listitem>
         <para>FindBugsの公式リリース物に加えて、公式リリース候補版を提供します。</para>
       </listitem>
     </varlistentry>
 
     <varlistentry><term><ulink url="http://findbugs.cs.umd.edu/eclipse-daily/">http://findbugs.cs.umd.edu/eclipse-daily/</ulink></term>
 
       <listitem>
         <para>FindBugsの日次ビルド物を提供します。コンパイルができること以上のテストは行われていません。</para>
       </listitem>
     </varlistentry>
     </variablelist>
 
-<para>また、次に示すリンクから手動でプラグインをダウンロードすることもできます : <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>. 展開して Eclipse の「plugins」サブディレクトリーに入れてください。(そうすると、 &lt;eclipse インストールディレクトリー &gt;/plugins/edu.umd.cs.findbugs.plugin.eclipse_2.0.3.20131122/findbugs.png が &FindBugs; のロゴファイルへのパスになるはずです。)</para>
+<para>また、次に示すリンクから手動でプラグインをダウンロードすることもできます : <ulink url="http://prdownloads.sourceforge.net/findbugs/edu.umd.cs.findbugs.plugin.eclipse_3.0.0.20140706.zip?download">http://prdownloads.sourceforge.net/findbugs/edu.umd.cs.findbugs.plugin.eclipse_3.0.0.20140706.zip?download</ulink>. 展開して Eclipse の「plugins」サブディレクトリーに入れてください。(そうすると、 &lt;eclipse インストールディレクトリー &gt;/plugins/edu.umd.cs.findbugs.plugin.eclipse_3.0.0.20140706/findbugs.png が &FindBugs; のロゴファイルへのパスになるはずです。)</para>
 
 <para>プラグインの展開ができたら、 Eclipse を起動して <menuchoice> <guimenu>Help</guimenu> <guimenuitem>About Eclipse Platform</guimenuitem> <guimenuitem>Plug-in Details</guimenuitem> </menuchoice> を選択してください。「FindBugs Project」から提供された「FindBugs Plug-in」というプラグインがあることを確認してください。</para>
 </sect1>
 
 <sect1>
 <title>プラグインの使用方法</title>
 
 <para>実行するには、 Java プロジェクト上で右クリックして「Find Bugs」を選択します。&FindBugs; が実行されて、バグパターンの実例の可能性があると識別されたコード箇所に問題マーカーがつきます。 (ソース画面および Eclipse 問題ビューに表示されます。)</para>
 
 <para>Java プロジェクトのプロパティーダイアログを開いて「Findbugs」プロパティーページを選択することで、 &FindBugs; の動作をカスタマイズすることができます。選択できる項目には次のようなものがあります :</para>
 
 <itemizedlist>
   <listitem>
     <para>「Run FindBugs Automatically」チェックボックスの設定。チェックすると、プロジェクト内の Java クラスが修正されるたびに FindBugs が実行されます。</para>
   </listitem>
 
   <listitem>
     <para>優先度とバグカテゴリーの選択。これらのオプションは、どの警告を表示するかを選択します。例えば、優先度で 「Medium」 を選択すると、優先度 (中) および優先度 (高) の警告のみが表示されます。同様に、「Style」チェックボックスのチェックマークを外すと、Style カテゴリーに属する警告は表示されません。</para>
   </listitem>
 
   <listitem>
     <para>ディテクタの選択。表からプロジェクトで有効にしたいディテクタを選択することができます。</para>
   </listitem>
 </itemizedlist>
 
 </sect1>
 
 <sect1>
+<title>Eclipse プラグインの拡張方法 (2.0.0 以降)</title>
+<para>
+Eclipse プラグインでは、 独自の &FindBugs; ディテクタを追加することができます。
+(詳しく知りたい方は、
+<ulink url="http://code.google.com/p/findbugs/source/browse/findbugs/src/doc/AddingDetectors.txt">AddingDetectors.txt</ulink>
+もご覧ください)。 
+独自のプラグインを Eclipse に追加するには以下の2通りの方法があります。
+</para>
+<itemizedlist>
+  <listitem>
+    <para>
+    既存の標準 &FindBugs; ディテクタパッケージは以下で設定できます。 
+    <menuchoice>
+        <guimenu>Window</guimenu>
+        <guimenuitem>Preferences</guimenuitem>
+        <guimenuitem>Java</guimenuitem>
+        <guimenuitem>FindBugs</guimenuitem>
+        <guimenuitem>Misc. Settings</guimenuitem>
+        <guimenuitem>Custom Detectors</guimenuitem>
+    </menuchoice>。
+    ここで追加するプラグインライブラリの場所を指定するだけです。
+    </para>
+
+    <para>
+    この方法の利点は、既存のディテクタパッケージは「そのまま」で、サードパーティーディテクタの品質をすばやく検証できることです。
+    欠点としては、この設定は Eclipse ワークスペース毎に適用する必要があり、この設定をチームメンバー間で共有することができないことです。
+    </para>
+  </listitem>
+
+  <listitem>
+    <para>
+    Eclipse 標準の拡張機構を使って独自のディテクタを追加することができます。
+    </para>
+
+    <para>
+    <ulink url="http://code.google.com/p/findbugs/source/browse/eclipsePlugin/schema/detectorPlugins.exsd">
+    findBugsEclipsePlugin/schema/detectorPlugins.exsd</ulink> の documentation で plugin.xml の更新方法を確認してください。
+    既存の &FindBugs; ディテクタプラグイン を簡単に「拡張」して強力な &FindBugs; Eclipse ディテクタプラグイン にすることができます。
+    通常必要なのは、 META-INF/MANIFEST.MF および plugin.xml を jar に追加してかつ、 MANIFEST.MF がビルド時に上書きされないようにビルドスクリプトを更新するだけです。
+    </para>
+
+    <para>
+    この方法の利点は、  Eclipse インストールを共有しさえすれば、チームメンバー同士で正確に同じディテクタ設定を使用できることです。
+    前提条件は現在使用しているディテクタパッケージを Eclipse プラグインに変換しておくことです。
+    これはサードパーティのディテクタパッケージも同様です。
+    もうひとつの主な差別化要因は、 FindBugs のデフォルト実行時クラスパス に当該サードパーティライブラリーを追加することが必要なことです(くわしくは
+    <ulink url="http://code.google.com/p/findbugs/source/browse/findbugs/src/doc/AddingDetectors.txt">AddingDetectors.txt</ulink>
+    をご覧ください)。
+    </para>
+  </listitem>
+
+</itemizedlist>
+
+</sect1>
+
+<sect1>
 <title>トラブルシューティング</title>
 
-<para>&FindBugs; Eclipse プラグインは、まだ実験段階です。このセクションでは、プラグインに関する一般的な問題と (判明していれば) それらの問題の解決方法を記述します。</para>
+<para>
+このセクションでは、プラグインに関する一般的な問題と (判明していれば) それらの問題の解決方法を記述します。
+</para>
 
 <itemizedlist>
   <listitem>
-    <para>&FindBugs; 問題マーカーが (ソース画面および問題ビューに) 表示されない場合は、問題ビューのフィルター設定を変更してください。詳細情報は <ulink url="http://findbugs.sourceforge.net/FAQ.html#q7">http://findbugs.sourceforge.net/FAQ.html#q7</ulink> を参照してください。</para>
+    <para>
+    Eclipse において &FindBugs; の分析開始後に OutOfMemory エラーダイアログが 出た場合は、
+    JVM の使用メモリを増やしてください。すなわち、 eclipse.ini の末尾に以下の記述を追加してください。
+    <programlisting>
+    -vmargs
+    -Xmx1000m
+    </programlisting>
+    重要：「-vmargs」で始まる設定引数は  eclipse.ini ファイルの末尾に記述する必要があります。
+    また、各行には引数を一つだけしか書くことができません！
+    </para>
+  </listitem>
+  <listitem>
+    <para>
+    &FindBugs; 問題マーカーが (ソース画面および問題ビューに) 表示されない場合は、問題ビューのフィルター設定を変更してください。
+    詳細情報は <ulink url="http://findbugs.sourceforge.net/FAQ.html#q7">http://findbugs.sourceforge.net/FAQ.html#q7</ulink> を参照してください。
+    </para>
   </listitem>
 
 </itemizedlist>
 
 </sect1>
 
 
 </chapter>
 
 
@@ skipping 33 matching lines @@
 <sect1>
 <title>マッチング条件の種類</title>
 
 <variablelist>
  <varlistentry>
    <term><literal>&lt;Bug&gt;</literal></term>
    <listitem><para>この要素は、バグパターンを指定して照合します。<literal>pattern</literal> 属性には、コンマ区切りでバグパターン類型のリストを指定します。どの警告がどのバグパターン類型にあたるかは、 <command>-xml</command> オプションをつかって出力されたもの (<literal>BugInstance</literal> 要素の <literal>type</literal> 属性) を見るか、または、 <ulink url="../../bugDescriptions.html">バグ解説ドキュメント</ulink>を参照してください。</para><para>もっと粒度の粗い照合を行いたいときは、 <literal>code</literal> 属性を使用してください。バグ略称のコンマ区切りのリストで指定できます。さらに粒度の粗い照合を行いたいときは、 <literal>category</literal> 属性を使用してください。次に示す、バグカテゴリー名のコンマ区切りのリストで指定できます : <literal>CORRECTNESS</literal>, <literal>MT_CORRECTNESS</literal>, <literal>BAD_PRACTICICE</literal>, <literal>PERFORMANCE</literal>, <literal>STYLE</literal>.</para><para>同じ <literal>&lt;Bug&gt;</literal> 要素に上記の属性を複数指定した場合は、バグパターン名、バグ略称、バグカテゴリーのいずれか1つでも該当すれば、バグパターンは合致すると判定されます。</para><para>下位互換性を持たせたい場合は、 <literal>&lt;Bug&gt;</literal> 要素の代わりに <literal>&lt;BugPattern&gt;</literal> 要素および <literal>&lt;BugCode&gt;</literal> 要素を使用してください。これらの要素はそれぞれ、 <literal>name</literal> 属性で値のリストを指定します。これらの要素は、将来サポートされなくなる可能性があります。</para></listitem>
  </varlistentry>
 
  <varlistentry>
+    <term><literal>&lt;Confidence&gt;</literal></term>
+    <listitem>
+        <para>
+            この要素は、特定のバグ信頼度をもつ警告を照合します。
+            <literal>value</literal> 属性には、整数値を指定します。すなわち 1 は信頼度(高) 、また、 2 は信頼度(中) 、 3 は信頼度(低) を示します。
+            &lt;Confidence&gt; は 2.0.0 リリースから &lt;Priority&gt; の後継として取って代わりました。
+        </para>
+    </listitem>
+ </varlistentry>
+
+ <varlistentry>
     <term><literal>&lt;Priority&gt;</literal></term>
     <listitem>
-        <para>この要素は、特定の優先度をもつ警告を照合します。<literal>value</literal> 属性には、整数値を指定します : 1 は優先度(高)、また、 2  は優先度(中) 、 3 は優先度(低) を示します。</para>
+        <para>
+            <literal>&lt;Confidence&gt;</literal> と同一です。下位互換性を保つため残されています。
+        </para>
     </listitem>
  </varlistentry>
 
+ <varlistentry>
+    <term><literal>&lt;Rank&gt;</literal></term>
+    <listitem>
+        <para>
+            この要素は、特定のバグランクをもつ警告を照合します。
+            <literal>value</literal> 属性には、 1 から 20 の整数値を指定します。
+            1 から 4 は最も恐ろしいバグ、 5 から 9 は恐ろしいバグ、 10 から 14 は厄介なバグ,
+            そして 15 から 20 は不安なバグを示します。
+        </para>
+    </listitem>
+ </varlistentry>
 
  <varlistentry>
    <term><literal>&lt;Package&gt;</literal></term>
     <listitem>
         <para>この要素は、 <literal>name</literal> 属性で指定した特定のパッケージ内にあるクラスに関連した警告を照合します。入れ子のパッケージは含まれません (Java import 文に従っています) 。しかしながら、正規表現を使うと複数パッケージにマッチさせることは簡単にできます。</para>
     </listitem>
   </varlistentry>
 
  <varlistentry>
    <term><literal>&lt;Class&gt;</literal></term>
     <listitem>
         <para>この要素は、特定のクラスに関連した警告を照合します。<literal>name</literal> 属性を使用して、照合するクラス名をクラス名そのものか、または、正規表現で指定します。</para>
 
         <para>下位互換性を持たせたい場合は、この要素の代わりに <literal>Match</literal> 要素を使用してください。クラス名そのものの指定は <literal>class</literal> 属性を、クラス名を正規表現で指定する場合は <literal>classregex</literal> 属性をそれぞれ使用してください</para>
 
         <para>もし <literal>Match</literal> 要素に <literal>Class</literal> 要素が無かったり、 <literal>class</literal> / <literal>classregex</literal> 属性が無かったりした場合は、すべてのクラスに適用されます。その場合、想定外に多くのバグ検索結果が一致してしまうことがあり得ます。その場合は、適当なメソッドやフィールドで絞り込んでください。</para>
     </listitem>
  </varlistentry>
 
  <varlistentry>
+   <term><literal>&lt;Source&gt;</literal></term>
+    <listitem>
+        <para>
+            この要素は、特定のソースファイルに関連した警告を照合します。
+            <literal>name</literal> 属性を使用して、照合するソースファイル名をソースファイル名そのものか、または、正規表現で指定します。
+        </para>
+    </listitem>
+ </varlistentry>
+
+ <varlistentry>
    <term><literal>&lt;Method&gt;</literal></term>
 
    <listitem><para>この要素は、メソッドを指定します。<literal>name</literal> 属性を使用して、照合するメソッド名をメソッド名そのものか、または、正規表現で指定します。<literal>params</literal> 属性には、コンマ区切りでメソッド引数の型のリストを指定します。<literal>returns</literal> 属性にはメソッドの戻り値の型を指定します。<literal>params</literal> および <literal>returns</literal> においては、クラス名は完全修飾名である必要があります。(例えば、単に &quot;String&quot; ではなく &quot;java.lang.String&quot; としてください。) <literal>params</literal> <literal>returns</literal> のどちらか一方を指定した場合は、もう一方の属性の指定も必須です。なぜならば、メソッドシグニチャーを構築のために必要だからです。<literal>name</literal> 属性、<literal>params</literal> 属性 および <literal>returns</literal> 属性または 3 つの 属性すべて、のどれかを条件とすることできることを意味しています。このように、名前とシグニチャーに基づく様々な種類の条件を規定できます。</para></listitem>
  </varlistentry>
 
  <varlistentry>
    <term><literal>&lt;Field&gt;</literal></term>
 
    <listitem><para>この要素は、フィールドを指定します。<literal>name</literal> 属性を使用して、照合するフィールド名をフィールド名そのものか、または、正規表現で指定します。また、フィールドのシグニチャーに照らしたフィルタリングをすることができます。 <literal>type</literal> 属性を使用して、フィールドの型を完全修飾名で指定してください。名前とシグニチャーに基づく条件を規定するために、その2つの属性を両方とも指定することができます。</para></listitem>
  </varlistentry>
 
    <varlistentry>
    <term><literal>&lt;Local&gt;</literal></term>
 
    <listitem><para>この要素は、ローカル変数を指定します。<literal>name</literal> 属性を使用して、照合するローカル変数名をローカル変数名そのものか、または、正規表現で指定します。ローカル変数とは、メソッド内で定義した変数です。</para></listitem>
  </varlistentry>
 
  <varlistentry>
    <term><literal>&lt;Or&gt;</literal></term>
     <listitem><para>この要素は、論理和として <literal>Match</literal> 条項を結合します。すなわち、2つの <literal>Method</literal> 要素を <literal>Or</literal> 条項に入れることで、どちらか一方のメソッドでマッチさせることができます。</para></listitem>
  </varlistentry>
+ <varlistentry>
+   <term><literal>&lt;And&gt;</literal></term>
+    <listitem><para>
+   この要素は、論理積として <literal>Match</literal> 条項を結合します。 
+   すなわち、  <literal>Bug</literal> および <literal>Confidence</literal> 要素を <literal>And</literal> 条項内に指定することで
+   特定の信頼度の特定のバグのみ照合することができます。
+   </para></listitem>
+ </varlistentry>
+ <varlistentry>
+   <term><literal>&lt;Not&gt;</literal></term>
+    <listitem><para>
+   この要素は、内包する子 <literal>Match</literal> を反転します。
+   すなわち、 <literal>Bug</literal> 要素を <literal>Not</literal> 条項内に指定することで指定したバグ以外のすべてのバグと照合します。
+   </para></listitem>
+ </varlistentry>
 </variablelist>
 
 </sect1>
 
 <sect1>
 <title>Java 要素名マッチング</title>
 
-<para><literal>Class</literal> 、 <literal>Method</literal> または <literal>Field</literal> の <literal>name</literal> 属性が文字 ~ で始まっている場合は、属性値の残りの部分を Java の正規表現として解釈します。そうして、当該 Java 要素の名前に対しての照合が行われます。</para>
+<para>
+<literal>Class</literal> 、 <literal>Source</literal> 、 <literal>Method</literal> または <literal>Field</literal> の <literal>name</literal> 属性が文字 ~ で始まっている場合は、
+属性値の残りの部分を Java の正規表現として解釈します。
+そうして、当該 Java 要素の名前に対しての照合が行われます。
+</para>
 
 <para>パターンの照合は要素の名前全体に対して行われることに注意してください。そのため、部分一致照合を行いたい場合はパターン文字列の前後に .* を付加して使用する必要があります。</para>
 
 <para>パターンの構文規則に関しては、 <ulink url="http://java.sun.com/j2se/1.5.0/ja/docs/ja/api/java/util/regex/Pattern.html"><literal>java.util.regex.Pattern</literal></ulink> のドキュメントを参照してください。</para>
 </sect1>
 
 <sect1>
 <title>留意事項</title>
 
 <para>
@@ skipping 138 matching lines @@
       <Method returns="void" name="main" params="java.lang.String[]" />
       <Method pattern="DM_EXIT" />
     </Match>
     <!-- すべてのクラスの com.foobar.DebugInfo 型のフィールドに対する UuF 警告に一致。 -->
     <Match>
       <Field type="com.foobar.DebugInfo" />
       <Bug code="UuF" />
     </Match>
 ]]>
 </programlisting>
+</para>
 
+
+<para>
+    11. Not フィルター演算子を使用してバグに一致させます。
+<programlisting>
+<![CDATA[
+<!-- テストクラスのバグは無視する。ただし、 JUnit テスト特有のバグは例外とする。 -->
+<!-- i.e. filter bug if ( classIsJUnitTest && ! bugIsRelatedToJUnit ) -->
+<Match>
+  <!-- Match フィルタは論理和と同等 -->
+
+  <Class name="~.*\.*Test" />
+  <!-- テストクラスは末尾に「Test」 -->
+
+  <Not>
+      <Bug code="IJU" /> <!-- 「IJU」は JUnit テストコード関連のバグコード -->
+  </Not>
+</Match>
+]]>
+</programlisting>
+</para>
+
+<para>
+  12. 完全な除外フィルター。 Groovy ソースファイルから生成された全クラスを除外します。
+
+<programlisting>
+<![CDATA[
+<?xml version="1.0" encoding="UTF-8"?>
+<FindBugsFilter>
+<Match>
+    <Source name="~.*\.groovy" />
+</Match>
+</FindBugsFilter>
+]]>
+</programlisting>
 </para>
 
 </sect1>
 
 <sect1>
 <title>完全な例</title>
 
 <programlisting>
 <![CDATA[
 <FindBugsFilter>
@@ skipping 22 matching lines @@
        <Bug code="DC" />
      </Match>
 
      <!-- dead local store (優先度 (中)) に関する誤検出があるメソッド。-->
      <Match>
        <Class name="com.foobar.MyClass" />
        <Method name="someMethod" />
        <Bug pattern="DLS_DEAD_LOCAL_STORE" />
        <Priority value="2" />
      </Match>
+
+     <!-- テストクラスのバグすべて。 JUnit 特有のバグは除く。 -->
+     <Match>
+      <Class name="~.*\.*Test" />
+      <Not>
+          <Bug code="IJU" />
+      </Not>
+     </Match>
+
 </FindBugsFilter>
 ]]>
 </programlisting>
 
 </sect1>
 
 
 </chapter>
 
 
@@ skipping 89 matching lines @@
 
 <chapter id="annotations">
 <title>アノテーション</title>
 
 <para>&FindBugs; はいくつかのアノテーションをサポートしています。開発者の意図を明確にすることで、 FindBugs はより的確に警告を発行することができます。アノテーションを使用するためには Java 5 が必要であり、 annotations.jar および jsr305.jar ファイルをコンパイル時のクラスパスに含める必要があります。</para>
 
 <variablelist>
   <varlistentry>
     <term><command>edu.umd.cs.findbugs.annotations.CheckForNull</command></term>
     <listitem>
-<command>[Target]</command> Field, Method, Parameter
+    <para>
+        <command>[Target]</command> Field, Method, Parameter
+    </para>
     </listitem>
     <listitem>
       <para>アノテーションをつけた要素は、 null である可能性があります。したがって、当該要素を使用する際は null チェックをするべきです。このアノテーションをメソッドに適用すると、メソッドの戻り値に適用されます。</para>
     </listitem>
   </varlistentry>
 
   <varlistentry>
     <term><command>edu.umd.cs.findbugs.annotations.CheckReturnValue</command></term>
     <listitem>
+    <para>
       <command>[Target]</command> Method, Constructor
+    </para>
     </listitem>
     <listitem>
       <variablelist>
         <varlistentry>
           <term><command>[Parameter]</command></term>
           <listitem>
             <para>
               <command>priority:</command> 警告の優先度を指定します (HIGH, MEDIUM, LOW, IGNORE) 。デフォルト値 :MEDIUM。</para>
           </listitem>
           <listitem>
             <para>
               <command>explanation:</command>戻り値をチェックしなけばならない理由をテキストで説明します。デフォルト値 :&quot;&quot;。</para>
           </listitem>
         </varlistentry>
       </variablelist>
     </listitem>
     <listitem>
       <para>このアノテーションを使用して、呼出し後に戻り値をチェックすべきメソッドを表すことができます。</para>
     </listitem>
   </varlistentry>
 
   <varlistentry>
     <term><command>edu.umd.cs.findbugs.annotations.DefaultAnnotation</command></term>
     <listitem>
+    <para>
       <command>[Target]</command> Type, Package
+    </para>
     </listitem>
     <listitem>
       <variablelist>
         <varlistentry>
           <term><command>[Parameter]</command></term>
           <listitem>
             <para>
               <command>value:</command>アノテーションクラスのclassオブジェクト。複数のクラスを指定することができます。</para>
           </listitem>
           <listitem>
             <para>
               <command>priority:</command>省略時の優先度を指定します (HIGH, MEDIUM, LOW, IGNORE) 。デフォルト値 :MEDIUM。</para>
           </listitem>
         </varlistentry>
       </variablelist>
     </listitem>
     <listitem>
       <para>
-Indicates that all members of the class or package should be annotated with the default
-value of the supplied annotation classes. This would be used for behavior annotations
-such as @NonNull, @CheckForNull, or @CheckReturnValue. In particular, you can use
-@DefaultAnnotation(NonNull.class) on a class or package, and then use @Nullable only
-on those parameters, methods or fields that you want to allow to be null.
+クラスまたはパッケージのすべてのメンバーが指定されたアノテーションクラスのデフォルト値でアノテートされることを指定することができます。
+この指定は @NonNull 、 @CheckForNull 、または @CheckReturnValueなどに使用する想定です。
+具体的には、 クラスまたはパッケージに @DefaultAnnotation(NonNull.class) を指定した上で、 
+null を許容したいパラメーター、メソッドまたはフィールドにのみ @Nullable を指定するという使用方法があります。
       </para>
     </listitem>
   </varlistentry>
 
   <varlistentry>
     <term><command>edu.umd.cs.findbugs.annotations.DefaultAnnotationForFields</command></term>
     <listitem>
+    <para>
       <command>[Target]</command> Type, Package
+    </para>
     </listitem>
     <listitem>
       <variablelist>
         <varlistentry>
           <term><command>[Parameter]</command></term>
           <listitem>
             <para>
               <command>value:</command>アノテーションクラスのclassオブジェクト。複数のクラスを指定することができます。</para>
           </listitem>
           <listitem>
             <para>
               <command>priority:</command>省略時の優先度を指定します (HIGH, MEDIUM, LOW, IGNORE) 。デフォルト値 :MEDIUM。</para>
           </listitem>
         </varlistentry>
       </variablelist>
     </listitem>
     <listitem>
       <para>
-This is same as the DefaultAnnotation except it only applys to fields.
+フィールドのみに適用されること以外は DefaultAnnotation と同様です。
       </para>
     </listitem>
   </varlistentry>
 
   <varlistentry>
     <term><command>edu.umd.cs.findbugs.annotations.DefaultAnnotationForMethods</command></term>
     <listitem>
+    <para>
       <command>[Target]</command> Type, Package
+    </para>
     </listitem>
     <listitem>
       <variablelist>
         <varlistentry>
           <term><command>[Parameter]</command></term>
           <listitem>
             <para>
               <command>value:</command>アノテーションクラスのclassオブジェクト。複数のクラスを指定することができます。</para>
           </listitem>
           <listitem>
             <para>
               <command>priority:</command>省略時の優先度を指定します (HIGH, MEDIUM, LOW, IGNORE) 。デフォルト値 :MEDIUM。</para>
           </listitem>
         </varlistentry>
       </variablelist>
     </listitem>
     <listitem>
       <para>
-This is same as the DefaultAnnotation except it only applys to methods.
+メソッドのみに適用されること以外は DefaultAnnotation と同様です。
       </para>
     </listitem>
   </varlistentry>
 
   <varlistentry>
     <term><command>edu.umd.cs.findbugs.annotations.DefaultAnnotationForParameters</command></term>
     <listitem>
+    <para>
       <command>[Target]</command> Type, Package
+    </para>
     </listitem>
     <listitem>
       <variablelist>
         <varlistentry>
           <term><command>[Parameter]</command></term>
           <listitem>
             <para>
               <command>value:</command>アノテーションクラスのclassオブジェクト。複数のクラスを指定することができます。</para>
           </listitem>
           <listitem>
             <para>
               <command>priority:</command>省略時の優先度を指定します (HIGH, MEDIUM, LOW, IGNORE) 。デフォルト値 :MEDIUM。</para>
           </listitem>
         </varlistentry>
       </variablelist>
     </listitem>
     <listitem>
       <para>
-This is same as the DefaultAnnotation except it only applys to method parameters.
+パラメーターのみに適用されること以外は DefaultAnnotation と同様です。
       </para>
     </listitem>
   </varlistentry>
 
   <varlistentry>
     <term><command>edu.umd.cs.findbugs.annotations.NonNull</command></term>
     <listitem>
+    <para>
       <command>[Target]</command> Field, Method, Parameter
+    </para>
     </listitem>
     <listitem>
       <para>アノテーションをつけた要素は、 null であってはいけません。アノテーションをつけたフィールドは、構築完了後 null であってはいけません。アノテーションをつけたメソッドは、 null ではない値を戻り値としなければなりません。</para>
     </listitem>
   </varlistentry>
 
   <varlistentry>
     <term><command>edu.umd.cs.findbugs.annotations.Nullable</command></term>
     <listitem>
+    <para>
       <command>[Target]</command> Field, Method, Parameter
+    </para>
     </listitem>
     <listitem>
-      <para>アノテーションをつけた要素は、 null であってはいけません。In general, this means developers will have to read the documentation to determine when a null value is acceptable and whether it is neccessary to check for a null value. FindBugs will treat the annotated items as though they had no annotation.</para>
       <para>
-In pratice this annotation is useful only for overriding an overarching NonNull
-annotation.
+アノテーションをつけた要素は、 条件により null である可能性があります。
+一般に、開発者はドキュメントを読んで null 値を許容するかどうかまたは null 値をチェックするかどうかを決定する必要があります。
+FindBugs はこのアノテーションをつけた要素を、アノテーションがついていないものと同様に扱います。
+      </para>
+      <para>
+実際には、このアノテーションは NonNull をつけた要素をオーバーライドする場合に有用です。
       </para>
     </listitem>
   </varlistentry>
 
   <varlistentry>
     <term><command>edu.umd.cs.findbugs.annotations.OverrideMustInvoke</command></term>
     <listitem>
+    <para>
       <command>[Target]</command> Method
+    </para>
     </listitem>
     <listitem>
       <variablelist>
         <varlistentry>
           <term><command>[Parameter]</command></term>
           <listitem>
             <para>
-              <command>value:</command>Specify when the super invocation should be
-              performed (FIRST, ANYTIME, LAST). Default value:ANYTIME.
+              <command>value:</command>super の呼び出し箇所を指定します (FIRST, ANYTIME, LAST)。 デフォルト値 :ANYTIME。
             </para>
           </listitem>
         </varlistentry>
       </variablelist>
     </listitem>
     <listitem>
       <para>
-Used to annotate a method that, if overridden, must (or should) be invoke super
-in the overriding method. Examples of such methods include finalize() and clone().
-The argument to the method indicates when the super invocation should occur:
-at any time, at the beginning of the overriding method, or at the end of the overriding method.
-(This anotation is not implmemented in FindBugs as of September 8, 2006).
+オーバーライドされた場合にオーバーライドメソッド内で super を呼び出すべきメソッドにアノテートします。
+例えば、 finalize() や clone() がそのようなメソッドに該当します。
+引数は、 super の呼び出し箇所を指定します。すなわち、随時、メソッドの最初またはメソッドの最後です。
       </para>
     </listitem>
   </varlistentry>
 
   <varlistentry>
     <term><command>edu.umd.cs.findbugs.annotations.PossiblyNull</command></term>
     <listitem>
       <para>
-This annotation is deprecated. Use CheckForNull instead.
+非推奨です。 CheckForNull を使用してください。
       </para>
     </listitem>
   </varlistentry>
 
   <varlistentry>
     <term><command>edu.umd.cs.findbugs.annotations.SuppressWarnings</command></term>
     <listitem>
+    <para>
       <command>[Target]</command> Type, Field, Method, Parameter, Constructor, Package
+    </para>
     </listitem>
     <listitem>
       <variablelist>
         <varlistentry>
           <term><command>[Parameter]</command></term>
           <listitem>
             <para>
-              <command>value:</command>The name of the warning. More than one name can be specified.
+              <command>value:</command>警告の名称。複数の名称を指定することができます。
             </para>
           </listitem>
           <listitem>
             <para>
-              <command>justification:</command>Reason why the warning should be ignored. デフォルト値 :&quot;&quot;。</para>
+              <command>justification:</command>警告を無視する理由。 デフォルト値 :&quot;&quot;。</para>
           </listitem>
         </varlistentry>
       </variablelist>
     </listitem>
     <listitem>
       <para>
 The set of warnings that are to be suppressed by the compiler in the annotated element.
 Duplicate names are permitted.  The second and successive occurrences of a name are ignored.
 The presence of unrecognized warning names is <emphasis>not</emphasis> an error: Compilers
 must ignore any warning names they do not recognize. They are, however, free to emit a
 warning if an annotation contains an unrecognized warning name. Compiler vendors should
 document the warning names they support in conjunction with this annotation type. They
 are encouraged to cooperate to ensure that the same names work across multiple compilers.
       </para>
     </listitem>
   </varlistentry>
 
   <varlistentry>
     <term><command>edu.umd.cs.findbugs.annotations.UnknownNullness</command></term>
     <listitem>
+    <para>
       <command>[Target]</command> Field, Method, Parameter
+    </para>
     </listitem>
     <listitem>
       <para>
 Used to indicate that the nullness of the target is unknown, or my vary in unknown ways in subclasses.
       </para>
     </listitem>
   </varlistentry>
 
   <varlistentry>
     <term><command>edu.umd.cs.findbugs.annotations.UnknownNullness</command></term>
     <listitem>
+    <para>
       <command>[Target]</command> Field, Method, Parameter
+    </para>
     </listitem>
     <listitem>
       <para>
 Used to indicate that the nullness of the target is unknown, or my vary in unknown ways in subclasses.
       </para>
     </listitem>
   </varlistentry>
 </variablelist>
 
 <para>また、 &FindBugs; 次に示すアノテーションもサポートしています。 :<itemizedlist>
-  <listitem>net.jcip.annotations.GuardedBy</listitem>
-  <listitem>net.jcip.annotations.Immutable</listitem>
-  <listitem>net.jcip.annotations.NotThreadSafe</listitem>
-  <listitem>net.jcip.annotations.ThreadSafe</listitem>
+  <listitem><para>net.jcip.annotations.GuardedBy</para></listitem>
+  <listitem><para>net.jcip.annotations.Immutable</para></listitem>
+  <listitem><para>net.jcip.annotations.NotThreadSafe</para></listitem>
+  <listitem><para>net.jcip.annotations.ThreadSafe</para></listitem>
 </itemizedlist>
 </para>
 <para><ulink url="http://jcip.net/">Java Concurrency in Practice</ulink> の <ulink url="http://jcip.net/annotations/doc/index.html"> API ドキュメント</ulink> を参照してください。</para>
 </chapter>
 
 <!--
    **************************************************************************
    Using rejarForAnalysis
    **************************************************************************
 -->
@@ skipping 237 matching lines @@
 <row><entry>-last &lt;when&gt;</entry>          <entry>last=&quot;&lt;when&gt;&quot;</entry>              <entry>指定したバージョンが出現した最後である警告のみ出力されます。</entry></row>
 <row><entry>-fixed &lt;when&gt;</entry>         <entry>fixed=&quot;&lt;when&gt;&quot;</entry>             <entry>指定したバージョンの前回のバージョンが出現した最後である警告のみ出力されます。 (<option>-last</option> に優先します)。</entry></row>
 <row><entry>-present &lt;when&gt;</entry>       <entry>present=&quot;&lt;when&gt;&quot;</entry>           <entry>指定したバージョンに存在する警告のみ出力されます。</entry></row>
 <row><entry>-absent &lt;when&gt;</entry>        <entry>absent=&quot;&lt;when&gt;&quot;</entry>            <entry>指定したバージョンに存在しない警告のみ出力されます。</entry></row>
 <row><entry>-active[:truth]</entry>             <entry>active=&quot;[true|false]&quot;</entry>            <entry>最終通番に存在する警告のみ出力されます。</entry></row>
 <row><entry>-introducedByChange[:truth]</entry> <entry>introducedByChange=&quot;[true|false]&quot;</entry><entry>存在するクラスの変更によってもたらされた警告のみ出力されます。</entry></row>
 <row><entry>-removedByChange[:truth]</entry>    <entry>removedByChange=&quot;[true|false]&quot;</entry>   <entry>存在するクラスの変更によって除去された警告のみ出力されます。</entry></row>
 <row><entry>-newCode[:truth]</entry>            <entry>newCode=&quot;[true|false]&quot;</entry>           <entry>新クラスの追加によってもたらされた警告のみ出力されます。</entry></row>
 <row><entry>-removedCode[:truth]</entry>        <entry>removedCode=&quot;[true|false]&quot;</entry>       <entry>クラスの削除によって除去された警告のみ出力されます。</entry></row>
 <row><entry>-priority &lt;level&gt;</entry>     <entry>priority=&quot;&lt;level&gt;&quot;</entry>         <entry>指定した優先度以上の優先度をもつ警告のみ出力されます。</entry></row>
+<row><entry>-maxRank &lt;rank&gt;</entry>       <entry>rank="[1..20]"</entry>                   <entry>allow only warnings with this rank or lower</entry></row>
 <row><entry>-class &lt;pattern&gt;</entry>      <entry>class=&quot;&lt;class&gt;&quot;</entry>            <entry>指定したパターンに一致する主クラスをもつ警告のみ出力されます。</entry></row>
 <row><entry>-bugPattern &lt;pattern&gt;</entry> <entry>bugPattern=&quot;&lt;pattern&gt;&quot;</entry>     <entry>指定したパターンに一致するバグ種別をもつ警告のみ出力されます。</entry></row>
 <row><entry>-category &lt;category&gt;</entry>  <entry>category=&quot;&lt;category&gt;&quot;</entry>      <entry>指定した文字列で始まるカテゴリーの警告のみ出力されます。</entry></row>
 <row><entry>-designation &lt;designation&gt;</entry> <entry>designation=&quot;&lt;designation&gt;&quot;</entry> <entry>指定したバグ分類指定をもつ警告のみ出力されます。 (例、 -designation SHOULD_FIX)</entry></row>
 <row><entry>-withMessages[:truth] </entry>      <entry>withMessages=&quot;[true|false]&quot;</entry>      <entry>テキストメッセージを含んだ XML が生成されます。</entry></row>
                 </tbody>
             </tgroup>
         </table>
 
         </sect2>
@@ skipping 547 matching lines @@
 <para>Phil Crosby enhanced the Eclipse plugin to add a view
 to display the bug details.</para>
 
 <para>Dave Brosius fixed a number of bugs, added user preferences
 to the Swing GUI, improved several bug detectors, and
 contributed the string concatenation detector.</para>
 
 <para>Thomas Klaeger contributed a number of bug fixes and
 bug detector improvements.</para>
 
-<para>Andrei Loskutov made a number of improvements to the
-Eclipse plugin.</para>
+<para>Andrey Loskutov made a number of bug fixes and
+bug detector improvements. He is maintainer of the Eclipse plugin.</para>
 
 <para>Brian Goetz contributed a major refactoring of the
 visitor classes to improve readability and understandability.</para>
 
 <para> Pete Angstadt fixed several problems in the Swing GUI.</para>
 
 <para>Francis Lalonde provided a task resource file for the
 FindBugs Ant task.</para>
 
 <para>Garvin LeClaire contributed support for output in
@@ skipping 199 matching lines @@
 </blockquote>
 
 </sect2>
 
 </sect1>
 
 </chapter>
 
 
 </book>