OLD | NEW |
1 <?xml version="1.0" encoding="UTF-8"?> | 1 <?xml version="1.0" encoding="UTF-8"?> |
2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://findbugs.goog
lecode.com/svn/trunk/findbugs/etc/docbook/docbookx.dtd" | 2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://findbugs.goog
lecode.com/svn/trunk/findbugs/etc/docbook/docbookx.dtd" |
3 [ | 3 [ |
4 <!ENTITY FindBugs "<application>FindBugs</application>"> | 4 <!ENTITY FindBugs "<application>FindBugs</application>"> |
5 <!ENTITY Ant "<application>Ant</application>"> | 5 <!ENTITY Ant "<application>Ant</application>"> |
6 <!ENTITY Saxon "<application>Saxon</application>"> | 6 <!ENTITY Saxon "<application>Saxon</application>"> |
7 <!ENTITY FBHome "<replaceable>$FINDBUGS_HOME</replaceable>"> | 7 <!ENTITY FBHome "<replaceable>$FINDBUGS_HOME</replaceable>"> |
8 <!ENTITY FBHomeWin "<replaceable>%FINDBUGS_HOME%</replaceable>"> | 8 <!ENTITY FBHomeWin "<replaceable>%FINDBUGS_HOME%</replaceable>"> |
9 <!ENTITY nbsp " "> | 9 <!ENTITY nbsp " "> |
10 ]> | 10 ]> |
(...skipping 22 matching lines...) Expand all Loading... |
33 <year>2006</year> | 33 <year>2006</year> |
34 <year>2008</year> | 34 <year>2008</year> |
35 <holder>University of Maryland</holder> | 35 <holder>University of Maryland</holder> |
36 </copyright> | 36 </copyright> |
37 | 37 |
38 <legalnotice> | 38 <legalnotice> |
39 <para>このマニュアルは、クリエイティブ・コモンズ表示-非営利-継承に基づく使用許諾がなされています。使用許諾書をご覧になる場合は、 <ulink url=
"http://creativecommons.org/licenses/by-nc-sa/1.0/deed.ja">http://creativecommon
s.org/licenses/by-nc-sa/1.0/</ulink> にアクセスするか、クリエイティブ・コモンズ(559 Nathan Abbott Way
, Stanford, California 94305, USA)に書簡を送付してください。</para> | 39 <para>このマニュアルは、クリエイティブ・コモンズ表示-非営利-継承に基づく使用許諾がなされています。使用許諾書をご覧になる場合は、 <ulink url=
"http://creativecommons.org/licenses/by-nc-sa/1.0/deed.ja">http://creativecommon
s.org/licenses/by-nc-sa/1.0/</ulink> にアクセスするか、クリエイティブ・コモンズ(559 Nathan Abbott Way
, Stanford, California 94305, USA)に書簡を送付してください。</para> |
40 <para>名称「FindBugs」および FindBugs のロゴは、メリーランド大学の登録商標です。</para> | 40 <para>名称「FindBugs」および FindBugs のロゴは、メリーランド大学の登録商標です。</para> |
41 </legalnotice> | 41 </legalnotice> |
42 | 42 |
43 <edition>2.0.1</edition> | 43 <edition>2.0.3</edition> |
44 | 44 |
45 <pubdate>19:56:04 EDT, 12 July, 2012</pubdate> | 45 <pubdate>17:16:15 EST, 22 November, 2013</pubdate> |
46 | 46 |
47 </bookinfo> | 47 </bookinfo> |
48 | 48 |
49 <!-- | 49 <!-- |
50 ************************************************************************** | 50 ************************************************************************** |
51 Introduction | 51 Introduction |
52 ************************************************************************** | 52 ************************************************************************** |
53 --> | 53 --> |
54 | 54 |
55 <chapter id="introduction"> | 55 <chapter id="introduction"> |
56 <title>はじめに</title> | 56 <title>はじめに</title> |
57 | 57 |
58 <para>&FindBugs;™ は、Java プログラムの中のバグを見つけるプログラムです。このプログラムは、「バグ パターン」の実例を探します
。「バグ パターン」とは、エラーとなる可能性の高いコードの事例です。</para> | 58 <para>&FindBugs;™ は、Java プログラムの中のバグを見つけるプログラムです。このプログラムは、「バグ パターン」の実例を探します
。「バグ パターン」とは、エラーとなる可能性の高いコードの事例です。</para> |
59 | 59 |
60 <para>この文書は、&FindBugs; バージョン 2.0.1 について説明してます。私たちは、 &FindBugs; に対するフィードバックを心待ちにし
ています。どうぞ、 <ulink url="http://findbugs.sourceforge.net">&FindBugs; Web ページ</ulink
> にアクセスしてください。&FindBugs; についての最新情報、連絡先および &FindBugs; メーリングリストなどのサポート情報を入手することができ
ます。</para> | 60 <para>この文書は、&FindBugs; バージョン 2.0.3 について説明してます。私たちは、 &FindBugs; に対するフィードバックを心待ちにし
ています。どうぞ、 <ulink url="http://findbugs.sourceforge.net">&FindBugs; Web ページ</ulink
> にアクセスしてください。&FindBugs; についての最新情報、連絡先および &FindBugs; メーリングリストなどのサポート情報を入手することができ
ます。</para> |
61 | 61 |
62 <sect1> | 62 <sect1> |
63 <title>必要条件</title> | 63 <title>必要条件</title> |
64 <para>&FindBugs; を使用するには、 <ulink url="http://java.sun.com/j2se">Java 2 Standard
Edition</ulink>, バージョン 1.5 以降のバージョンと互換性のあるランタイム環境が必要です。&FindBugs; は、プラットフォーム非依存で
あり、 GNU/Linux 、 Windows 、 MacOS X プラットフォーム上で動作することが知られています。</para> | 64 <para>&FindBugs; を使用するには、 <ulink url="http://java.sun.com/j2se">Java 2 Standard
Edition</ulink>, バージョン 1.5 以降のバージョンと互換性のあるランタイム環境が必要です。&FindBugs; は、プラットフォーム非依存で
あり、 GNU/Linux 、 Windows 、 MacOS X プラットフォーム上で動作することが知られています。</para> |
65 | 65 |
66 <para>&FindBugs; を使用するためには、少なくとも 512 MB のメモリが必要です。巨大なプロジェクトを解析するためには、それより多くのメモリが
必要とされることがあります。</para> | 66 <para>&FindBugs; を使用するためには、少なくとも 512 MB のメモリが必要です。巨大なプロジェクトを解析するためには、それより多くのメモリが
必要とされることがあります。</para> |
67 </sect1> | 67 </sect1> |
68 | 68 |
69 </chapter> | 69 </chapter> |
70 | 70 |
71 <!-- | 71 <!-- |
72 ************************************************************************** | 72 ************************************************************************** |
73 Installing FindBugs | 73 Installing FindBugs |
74 ************************************************************************** | 74 ************************************************************************** |
75 --> | 75 --> |
76 | 76 |
77 <chapter id="installing"> | 77 <chapter id="installing"> |
78 <title>&FindBugs;™ のインストール</title> | 78 <title>&FindBugs;™ のインストール</title> |
79 | 79 |
80 <para>この章では、 &FindBugs; のインストール方法を説明します。</para> | 80 <para>この章では、 &FindBugs; のインストール方法を説明します。</para> |
81 | 81 |
82 <sect1> | 82 <sect1> |
83 <title>配布物の展開</title> | 83 <title>配布物の展開</title> |
84 | 84 |
85 <para>&FindBugs; をインストールする最も簡単な方法は、バイナリ配布物をダウンロードすることです。 バイナリ配布物は、 <ulink url="h
ttp://prdownloads.sourceforge.net/findbugs/findbugs-2.0.1.tar.gz?download">gzipp
ed tar 形式</ulink> および <ulink url="http://prdownloads.sourceforge.net/findbugs/fi
ndbugs-2.0.1.zip?download">zip 形式</ulink> がそれぞれ入手可能です。バイナリ配布物をダウンロードしてきたら、それを任意の
ディレクトリーに展開します。</para> | 85 <para>&FindBugs; をインストールする最も簡単な方法は、バイナリ配布物をダウンロードすることです。 バイナリ配布物は、 <ulink url="h
ttp://prdownloads.sourceforge.net/findbugs/findbugs-2.0.3.tar.gz?download">gzipp
ed tar 形式</ulink> および <ulink url="http://prdownloads.sourceforge.net/findbugs/fi
ndbugs-2.0.3.zip?download">zip 形式</ulink> がそれぞれ入手可能です。バイナリ配布物をダウンロードしてきたら、それを任意の
ディレクトリーに展開します。</para> |
86 | 86 |
87 <para>gzipped tar 形式配布物の展開方法例:<screen> | 87 <para>gzipped tar 形式配布物の展開方法例:<screen> |
88 <prompt>$ </prompt><command>gunzip -c findbugs-2.0.1.tar.gz | tar xvf -</command
> | 88 <prompt>$ </prompt><command>gunzip -c findbugs-2.0.3.tar.gz | tar xvf -</command
> |
89 </screen> | 89 </screen> |
90 </para> | 90 </para> |
91 | 91 |
92 <para>zip 形式配布物の展開方法例:<screen> | 92 <para>zip 形式配布物の展開方法例:<screen> |
93 <prompt>C:\Software></prompt><command>unzip findbugs-2.0.1.zip</command> | 93 <prompt>C:\Software></prompt><command>unzip findbugs-2.0.3.zip</command> |
94 </screen> | 94 </screen> |
95 </para> | 95 </para> |
96 | 96 |
97 <para>バイナリ配布物の展開すると、通常は <filename class="directory">findbugs-2.0.1</filename> ディ
レクトリーが作成されます。例えば、ディレクトリー <filename class="directory">C:\Software</filename> でバイナ
リ配布物を展開すると、ディレクトリー <filename class="directory">C:\Software\findbugs-2.0.1</filen
ame> に &FindBugs; は展開されます。このディレクトリーが &FindBugs; のホームディレクトリーになります。このマニュアルでは、このホーム
ディレクトリーを &FBHome; (Windowsでは &FBHomeWin;) を用いて参照します。</para> | 97 <para>バイナリ配布物の展開すると、通常は <filename class="directory">findbugs-2.0.3</filename> ディ
レクトリーが作成されます。例えば、ディレクトリー <filename class="directory">C:\Software</filename> でバイナ
リ配布物を展開すると、ディレクトリー <filename class="directory">C:\Software\findbugs-2.0.3</filen
ame> に &FindBugs; は展開されます。このディレクトリーが &FindBugs; のホームディレクトリーになります。このマニュアルでは、このホーム
ディレクトリーを &FBHome; (Windowsでは &FBHomeWin;) を用いて参照します。</para> |
98 </sect1> | 98 </sect1> |
99 | 99 |
100 </chapter> | 100 </chapter> |
101 | 101 |
102 <!-- | 102 <!-- |
103 ************************************************************************** | 103 ************************************************************************** |
104 Compiling FindBugs from Source | 104 Compiling FindBugs from Source |
105 ************************************************************************** | 105 ************************************************************************** |
106 --> | 106 --> |
107 | 107 |
108 <chapter id="building"> | 108 <chapter id="building"> |
109 <title>&FindBugs;™ のソールからのビルド</title> | 109 <title>&FindBugs;™ のソールからのビルド</title> |
110 | 110 |
111 <para>この章では、 &FindBugs; をソースコードからビルドする方法を説明します。&FindBugs; を修正することに興味がないのであれば、 <l
ink linkend="running">次の章</link> に進んでください。</para> | 111 <para>この章では、 &FindBugs; をソースコードからビルドする方法を説明します。&FindBugs; を修正することに興味がないのであれば、 <l
ink linkend="running">次の章</link> に進んでください。</para> |
112 | 112 |
113 <sect1> | 113 <sect1> |
114 <title>前提条件</title> | 114 <title>前提条件</title> |
115 | 115 |
116 <para>ソースから &FindBugs; をコンパイルするためには、以下のものが必要です。<itemizedlist> | 116 <para>ソースから &FindBugs; をコンパイルするためには、以下のものが必要です。<itemizedlist> |
117 <listitem> | 117 <listitem> |
118 <para><ulink url="http://prdownloads.sourceforge.net/findbugs/findbugs-2.0.1
-source.zip?download">&FindBugs; のソース配布物</ulink> | 118 <para><ulink url="http://prdownloads.sourceforge.net/findbugs/findbugs-2.0.3
-source.zip?download">&FindBugs; のソース配布物</ulink> |
119 </para> | 119 </para> |
120 </listitem> | 120 </listitem> |
121 <listitem> | 121 <listitem> |
122 <para> | 122 <para> |
123 <ulink url="http://java.sun.com/j2se/">JDK 1.5.0 ベータ またはそれ以降</ulink> | 123 <ulink url="http://java.sun.com/j2se/">JDK 1.5.0 ベータ またはそれ以降</ulink> |
124 </para> | 124 </para> |
125 </listitem> | 125 </listitem> |
126 <listitem> | 126 <listitem> |
127 <para> | 127 <para> |
128 <ulink url="http://ant.apache.org/">Apache &Ant;</ulink>, バージョン 1.6.3 またはそ
れ以降</para> | 128 <ulink url="http://ant.apache.org/">Apache &Ant;</ulink>, バージョン 1.6.3 またはそ
れ以降</para> |
(...skipping 19 matching lines...) Expand all Loading... |
148 </listitem> | 148 </listitem> |
149 --> | 149 --> |
150 </itemizedlist> | 150 </itemizedlist> |
151 </para> | 151 </para> |
152 | 152 |
153 </sect1> | 153 </sect1> |
154 | 154 |
155 <sect1> | 155 <sect1> |
156 <title>ソース配布物の展開</title> | 156 <title>ソース配布物の展開</title> |
157 <para>ソース配布物をダウンロードした後に、それを作業用ディレクトリーに展開する必要があります。通常は、次のようなコマンドで展開を行います:<screen> | 157 <para>ソース配布物をダウンロードした後に、それを作業用ディレクトリーに展開する必要があります。通常は、次のようなコマンドで展開を行います:<screen> |
158 <prompt>$ </prompt><command>unzip findbugs-2.0.1-source.zip</command> | 158 <prompt>$ </prompt><command>unzip findbugs-2.0.3-source.zip</command> |
159 </screen> | 159 </screen> |
160 | 160 |
161 </para> | 161 </para> |
162 </sect1> | 162 </sect1> |
163 | 163 |
164 <sect1> | 164 <sect1> |
165 <title><filename>local.properties</filename> の修正</title> | 165 <title><filename>local.properties</filename> の修正</title> |
166 <para>FindBugs のドキュメントをビルドするためには、 <filename>local.properties</filename> ファイルを修正す
る必要があります。このファイルは、 &FindBugs; をビルドする際に <ulink url="http://ant.apache.org/">&Ant;<
/ulink> <filename>build.xml</filename> ファイルが参照します。FindBugs のドキュメントをビルドしない場合は、このフ
ァイルは無視してもかまいません。</para> | 166 <para>FindBugs のドキュメントをビルドするためには、 <filename>local.properties</filename> ファイルを修正す
る必要があります。このファイルは、 &FindBugs; をビルドする際に <ulink url="http://ant.apache.org/">&Ant;<
/ulink> <filename>build.xml</filename> ファイルが参照します。FindBugs のドキュメントをビルドしない場合は、このフ
ァイルは無視してもかまいません。</para> |
167 | 167 |
168 <para><filename>local.properties</filename> での定義は、 <filename>build.properties</f
ilename> ファイルでの定義に優先します。<filename>build.properties</filename> は次のような内容です:<progra
mlisting> | 168 <para><filename>local.properties</filename> での定義は、 <filename>build.properties</f
ilename> ファイルでの定義に優先します。<filename>build.properties</filename> は次のような内容です:<progra
mlisting> |
(...skipping 859 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
1028 </varlistentry> | 1028 </varlistentry> |
1029 | 1029 |
1030 <varlistentry><term><ulink url="http://findbugs.cs.umd.edu/eclipse-daily/">h
ttp://findbugs.cs.umd.edu/eclipse-daily/</ulink></term> | 1030 <varlistentry><term><ulink url="http://findbugs.cs.umd.edu/eclipse-daily/">h
ttp://findbugs.cs.umd.edu/eclipse-daily/</ulink></term> |
1031 | 1031 |
1032 <listitem> | 1032 <listitem> |
1033 <para>FindBugsの日次ビルド物を提供します。コンパイルができること以上のテストは行われていません。</para> | 1033 <para>FindBugsの日次ビルド物を提供します。コンパイルができること以上のテストは行われていません。</para> |
1034 </listitem> | 1034 </listitem> |
1035 </varlistentry> | 1035 </varlistentry> |
1036 </variablelist> | 1036 </variablelist> |
1037 | 1037 |
1038 <para>また、次に示すリンクから手動でプラグインをダウンロードすることもできます : <ulink url="http://prdownloads.sour
ceforge.net/findbugs/edu.umd.cs.findbugs.plugin.eclipse_2.0.1.20120712.zip?downl
oad">http://prdownloads.sourceforge.net/findbugs/edu.umd.cs.findbugs.plugin.ecli
pse_2.0.1.20120712.zip?download</ulink>. 展開して Eclipse の「plugins」サブディレクトリーに入れてくださ
い。(そうすると、 <eclipse インストールディレクトリー >/plugins/edu.umd.cs.findbugs.plugin.ecli
pse_2.0.1.20120712/findbugs.png が &FindBugs; のロゴファイルへのパスになるはずです。)</para> | 1038 <para>また、次に示すリンクから手動でプラグインをダウンロードすることもできます : <ulink url="http://prdownloads.sour
ceforge.net/findbugs/edu.umd.cs.findbugs.plugin.eclipse_2.0.3.20131122.zip?downl
oad">http://prdownloads.sourceforge.net/findbugs/edu.umd.cs.findbugs.plugin.ecli
pse_2.0.3.20131122.zip?download</ulink>. 展開して Eclipse の「plugins」サブディレクトリーに入れてくださ
い。(そうすると、 <eclipse インストールディレクトリー >/plugins/edu.umd.cs.findbugs.plugin.ecli
pse_2.0.3.20131122/findbugs.png が &FindBugs; のロゴファイルへのパスになるはずです。)</para> |
1039 | 1039 |
1040 <para>プラグインの展開ができたら、 Eclipse を起動して <menuchoice> <guimenu>Help</guimenu> <guimenu
item>About Eclipse Platform</guimenuitem> <guimenuitem>Plug-in Details</guimenui
tem> </menuchoice> を選択してください。「FindBugs Project」から提供された「FindBugs Plug-in」というプラグイン
があることを確認してください。</para> | 1040 <para>プラグインの展開ができたら、 Eclipse を起動して <menuchoice> <guimenu>Help</guimenu> <guimenu
item>About Eclipse Platform</guimenuitem> <guimenuitem>Plug-in Details</guimenui
tem> </menuchoice> を選択してください。「FindBugs Project」から提供された「FindBugs Plug-in」というプラグイン
があることを確認してください。</para> |
1041 </sect1> | 1041 </sect1> |
1042 | 1042 |
1043 <sect1> | 1043 <sect1> |
1044 <title>プラグインの使用方法</title> | 1044 <title>プラグインの使用方法</title> |
1045 | 1045 |
1046 <para>実行するには、 Java プロジェクト上で右クリックして「Find Bugs」を選択します。&FindBugs; が実行されて、バグパターンの実例の
可能性があると識別されたコード箇所に問題マーカーがつきます。 (ソース画面および Eclipse 問題ビューに表示されます。)</para> | 1046 <para>実行するには、 Java プロジェクト上で右クリックして「Find Bugs」を選択します。&FindBugs; が実行されて、バグパターンの実例の
可能性があると識別されたコード箇所に問題マーカーがつきます。 (ソース画面および Eclipse 問題ビューに表示されます。)</para> |
1047 | 1047 |
1048 <para>Java プロジェクトのプロパティーダイアログを開いて「Findbugs」プロパティーページを選択することで、 &FindBugs; の動作をカスタ
マイズすることができます。選択できる項目には次のようなものがあります :</para> | 1048 <para>Java プロジェクトのプロパティーダイアログを開いて「Findbugs」プロパティーページを選択することで、 &FindBugs; の動作をカスタ
マイズすることができます。選択できる項目には次のようなものがあります :</para> |
(...skipping 1748 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
2797 </blockquote> | 2797 </blockquote> |
2798 | 2798 |
2799 </sect2> | 2799 </sect2> |
2800 | 2800 |
2801 </sect1> | 2801 </sect1> |
2802 | 2802 |
2803 </chapter> | 2803 </chapter> |
2804 | 2804 |
2805 | 2805 |
2806 </book> | 2806 </book> |
OLD | NEW |