OLD | NEW |
1 <?xml version="1.0" encoding="UTF-8" standalone="no"?> | 1 <?xml version="1.0" encoding="UTF-8" standalone="no"?> |
2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | 2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" |
3 "../../etc/docbook/docbookx.dtd" [ | 3 "../../etc/docbook/docbookx.dtd" [ |
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 18 matching lines...) Expand all Loading... |
29 <copyright lang="en"> | 29 <copyright lang="en"> |
30 <year>2003 - 2012</year> | 30 <year>2003 - 2012</year> |
31 <holder>University of Maryland</holder> | 31 <holder>University of Maryland</holder> |
32 </copyright> | 32 </copyright> |
33 | 33 |
34 <legalnotice> | 34 <legalnotice> |
35 <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> | 35 <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> |
36 <para>名称「FindBugs」および FindBugs のロゴは、メリーランド大学の登録商標です。</para> | 36 <para>名称「FindBugs」および FindBugs のロゴは、メリーランド大学の登録商標です。</para> |
37 </legalnotice> | 37 </legalnotice> |
38 | 38 |
39 <edition>3.0.0</edition> | 39 <edition>3.0.1</edition> |
40 | 40 |
41 <pubdate>20:25:27 CDT, 06 July, 2014 (翻訳 2014年7月)</pubdate> | 41 <pubdate>12:37:51 EST, 06 March, 2015 (翻訳 2014年7月)</pubdate> |
42 | 42 |
43 </bookinfo> | 43 </bookinfo> |
44 | 44 |
45 <!-- | 45 <!-- |
46 ************************************************************************** | 46 ************************************************************************** |
47 Introduction | 47 Introduction |
48 ************************************************************************** | 48 ************************************************************************** |
49 --> | 49 --> |
50 | 50 |
51 <chapter id="introduction"> | 51 <chapter id="introduction"> |
52 <title>はじめに</title> | 52 <title>はじめに</title> |
53 | 53 |
54 <para>&FindBugs;™ は、Java プログラムの中のバグを見つけるプログラムです。このプログラムは、「バグ パターン」の実例を探します
。「バグ パターン」とは、エラーとなる可能性の高いコードの事例です。</para> | 54 <para>&FindBugs;™ は、Java プログラムの中のバグを見つけるプログラムです。このプログラムは、「バグ パターン」の実例を探します
。「バグ パターン」とは、エラーとなる可能性の高いコードの事例です。</para> |
55 | 55 |
56 <para>この文書は、&FindBugs; バージョン 3.0.0 について説明してます。私たちは、 &FindBugs; に対するフィードバックを心待ちにし
ています。どうぞ、 <ulink url="http://findbugs.sourceforge.net">&FindBugs; Web ページ</ulink
> にアクセスしてください。&FindBugs; についての最新情報、連絡先および &FindBugs; メーリングリストなどのサポート情報を入手することができ
ます。</para> | 56 <para>この文書は、&FindBugs; バージョン 3.0.1 について説明してます。私たちは、 &FindBugs; に対するフィードバックを心待ちにし
ています。どうぞ、 <ulink url="http://findbugs.sourceforge.net">&FindBugs; Web ページ</ulink
> にアクセスしてください。&FindBugs; についての最新情報、連絡先および &FindBugs; メーリングリストなどのサポート情報を入手することができ
ます。</para> |
57 | 57 |
58 <sect1> | 58 <sect1> |
59 <title>必要条件</title> | 59 <title>必要条件</title> |
60 <para>&FindBugs; を使用するには、 <ulink url="http://java.sun.com/j2se">Java 2 Standard
Edition</ulink>, バージョン 1.5 以降のバージョンと互換性のあるランタイム環境が必要です。&FindBugs; は、プラットフォーム非依存で
あり、 GNU/Linux 、 Windows 、 MacOS X プラットフォーム上で動作することが知られています。</para> | 60 <para>&FindBugs; を使用するには、 <ulink url="http://java.sun.com/j2se">Java 2 Standard
Edition</ulink>, バージョン 1.5 以降のバージョンと互換性のあるランタイム環境が必要です。&FindBugs; は、プラットフォーム非依存で
あり、 GNU/Linux 、 Windows 、 MacOS X プラットフォーム上で動作することが知られています。</para> |
61 | 61 |
62 <para>&FindBugs; を使用するためには、少なくとも 512 MB のメモリが必要です。巨大なプロジェクトを解析するためには、それより多くのメモリが
必要とされることがあります。</para> | 62 <para>&FindBugs; を使用するためには、少なくとも 512 MB のメモリが必要です。巨大なプロジェクトを解析するためには、それより多くのメモリが
必要とされることがあります。</para> |
63 </sect1> | 63 </sect1> |
64 | 64 |
65 </chapter> | 65 </chapter> |
66 | 66 |
67 <!-- | 67 <!-- |
68 ************************************************************************** | 68 ************************************************************************** |
69 Installing FindBugs | 69 Installing FindBugs |
70 ************************************************************************** | 70 ************************************************************************** |
71 --> | 71 --> |
72 | 72 |
73 <chapter id="installing"> | 73 <chapter id="installing"> |
74 <title>&FindBugs;™ のインストール</title> | 74 <title>&FindBugs;™ のインストール</title> |
75 | 75 |
76 <para>この章では、 &FindBugs; のインストール方法を説明します。</para> | 76 <para>この章では、 &FindBugs; のインストール方法を説明します。</para> |
77 | 77 |
78 <sect1> | 78 <sect1> |
79 <title>配布物の展開</title> | 79 <title>配布物の展開</title> |
80 | 80 |
81 <para>&FindBugs; をインストールする最も簡単な方法は、バイナリ配布物をダウンロードすることです。 バイナリ配布物は、 <ulink url="h
ttp://prdownloads.sourceforge.net/findbugs/findbugs-3.0.0.tar.gz?download">gzipp
ed tar 形式</ulink> および <ulink url="http://prdownloads.sourceforge.net/findbugs/fi
ndbugs-3.0.0.zip?download">zip 形式</ulink> がそれぞれ入手可能です。バイナリ配布物をダウンロードしてきたら、それを任意の
ディレクトリーに展開します。</para> | 81 <para>&FindBugs; をインストールする最も簡単な方法は、バイナリ配布物をダウンロードすることです。 バイナリ配布物は、 <ulink url="h
ttp://prdownloads.sourceforge.net/findbugs/findbugs-3.0.1.tar.gz?download">gzipp
ed tar 形式</ulink> および <ulink url="http://prdownloads.sourceforge.net/findbugs/fi
ndbugs-3.0.1.zip?download">zip 形式</ulink> がそれぞれ入手可能です。バイナリ配布物をダウンロードしてきたら、それを任意の
ディレクトリーに展開します。</para> |
82 | 82 |
83 <para>gzipped tar 形式配布物の展開方法例:<screen> | 83 <para>gzipped tar 形式配布物の展開方法例:<screen> |
84 <prompt>$ </prompt><command>gunzip -c findbugs-3.0.0.tar.gz | tar xvf -</command
> | 84 <prompt>$ </prompt><command>gunzip -c findbugs-3.0.1.tar.gz | tar xvf -</command
> |
85 </screen> | 85 </screen> |
86 </para> | 86 </para> |
87 | 87 |
88 <para>zip 形式配布物の展開方法例:<screen> | 88 <para>zip 形式配布物の展開方法例:<screen> |
89 <prompt>C:\Software></prompt><command>unzip findbugs-3.0.0.zip</command> | 89 <prompt>C:\Software></prompt><command>unzip findbugs-3.0.1.zip</command> |
90 </screen> | 90 </screen> |
91 </para> | 91 </para> |
92 | 92 |
93 <para>バイナリ配布物の展開すると、通常は <filename class="directory">findbugs-3.0.0</filename> ディ
レクトリーが作成されます。例えば、ディレクトリー <filename class="directory">C:\Software</filename> でバイナ
リ配布物を展開すると、ディレクトリー <filename class="directory">C:\Software\findbugs-3.0.0</filen
ame> に &FindBugs; は展開されます。このディレクトリーが &FindBugs; のホームディレクトリーになります。このマニュアルでは、このホーム
ディレクトリーを &FBHome; (Windowsでは &FBHomeWin;) を用いて参照します。</para> | 93 <para>バイナリ配布物の展開すると、通常は <filename class="directory">findbugs-3.0.1</filename> ディ
レクトリーが作成されます。例えば、ディレクトリー <filename class="directory">C:\Software</filename> でバイナ
リ配布物を展開すると、ディレクトリー <filename class="directory">C:\Software\findbugs-3.0.1</filen
ame> に &FindBugs; は展開されます。このディレクトリーが &FindBugs; のホームディレクトリーになります。このマニュアルでは、このホーム
ディレクトリーを &FBHome; (Windowsでは &FBHomeWin;) を用いて参照します。</para> |
94 </sect1> | 94 </sect1> |
95 | 95 |
96 </chapter> | 96 </chapter> |
97 | 97 |
98 <!-- | 98 <!-- |
99 ************************************************************************** | 99 ************************************************************************** |
100 Compiling FindBugs from Source | 100 Compiling FindBugs from Source |
101 ************************************************************************** | 101 ************************************************************************** |
102 --> | 102 --> |
103 | 103 |
104 <chapter id="building"> | 104 <chapter id="building"> |
105 <title>&FindBugs;™ のソールからのビルド</title> | 105 <title>&FindBugs;™ のソールからのビルド</title> |
106 | 106 |
107 <para>この章では、 &FindBugs; をソースコードからビルドする方法を説明します。&FindBugs; を修正することに興味がないのであれば、 <l
ink linkend="running">次の章</link> に進んでください。</para> | 107 <para>この章では、 &FindBugs; をソースコードからビルドする方法を説明します。&FindBugs; を修正することに興味がないのであれば、 <l
ink linkend="running">次の章</link> に進んでください。</para> |
108 | 108 |
109 <sect1> | 109 <sect1> |
110 <title>前提条件</title> | 110 <title>前提条件</title> |
111 | 111 |
112 <para>ソースから &FindBugs; をコンパイルするためには、以下のものが必要です。<itemizedlist> | 112 <para>ソースから &FindBugs; をコンパイルするためには、以下のものが必要です。<itemizedlist> |
113 <listitem> | 113 <listitem> |
114 <para><ulink url="http://prdownloads.sourceforge.net/findbugs/findbugs-3.0.0
-source.zip?download">&FindBugs; のソース配布物</ulink> | 114 <para><ulink url="http://prdownloads.sourceforge.net/findbugs/findbugs-3.0.1
-source.zip?download">&FindBugs; のソース配布物</ulink> |
115 </para> | 115 </para> |
116 </listitem> | 116 </listitem> |
117 <listitem> | 117 <listitem> |
118 <para> | 118 <para> |
119 <ulink url="http://java.sun.com/j2se/">JDK 1.5.0 またはそれ以降</ulink> | 119 <ulink url="http://java.sun.com/j2se/">JDK 1.5.0 またはそれ以降</ulink> |
120 </para> | 120 </para> |
121 </listitem> | 121 </listitem> |
122 <listitem> | 122 <listitem> |
123 <para> | 123 <para> |
124 <ulink url="http://ant.apache.org/">Apache &Ant;</ulink>, バージョン 1.6.3 またはそ
れ以降</para> | 124 <ulink url="http://ant.apache.org/">Apache &Ant;</ulink>, バージョン 1.6.3 またはそ
れ以降</para> |
(...skipping 19 matching lines...) Expand all Loading... |
144 </listitem> | 144 </listitem> |
145 --> | 145 --> |
146 </itemizedlist> | 146 </itemizedlist> |
147 </para> | 147 </para> |
148 | 148 |
149 </sect1> | 149 </sect1> |
150 | 150 |
151 <sect1> | 151 <sect1> |
152 <title>ソース配布物の展開</title> | 152 <title>ソース配布物の展開</title> |
153 <para>ソース配布物をダウンロードした後に、それを作業用ディレクトリーに展開する必要があります。通常は、次のようなコマンドで展開を行います:<screen> | 153 <para>ソース配布物をダウンロードした後に、それを作業用ディレクトリーに展開する必要があります。通常は、次のようなコマンドで展開を行います:<screen> |
154 <prompt>$ </prompt><command>unzip findbugs-3.0.0-source.zip</command> | 154 <prompt>$ </prompt><command>unzip findbugs-3.0.1-source.zip</command> |
155 </screen> | 155 </screen> |
156 | 156 |
157 </para> | 157 </para> |
158 </sect1> | 158 </sect1> |
159 | 159 |
160 <sect1> | 160 <sect1> |
161 <title><filename>local.properties</filename> の修正</title> | 161 <title><filename>local.properties</filename> の修正</title> |
162 <para>FindBugs のドキュメントをビルドするためには、 <filename>local.properties</filename> ファイルを修正す
る必要があります。このファイルは、 &FindBugs; をビルドする際に <ulink url="http://ant.apache.org/">&Ant;<
/ulink> <filename>build.xml</filename> ファイルが参照します。FindBugs のドキュメントをビルドしない場合は、このフ
ァイルは無視してもかまいません。</para> | 162 <para>FindBugs のドキュメントをビルドするためには、 <filename>local.properties</filename> ファイルを修正す
る必要があります。このファイルは、 &FindBugs; をビルドする際に <ulink url="http://ant.apache.org/">&Ant;<
/ulink> <filename>build.xml</filename> ファイルが参照します。FindBugs のドキュメントをビルドしない場合は、このフ
ァイルは無視してもかまいません。</para> |
163 | 163 |
164 <para><filename>local.properties</filename> での定義は、 <filename>build.properties</f
ilename> ファイルでの定義に優先します。<filename>build.properties</filename> は次のような内容です:<progra
mlisting> | 164 <para><filename>local.properties</filename> での定義は、 <filename>build.properties</f
ilename> ファイルでの定義に優先します。<filename>build.properties</filename> は次のような内容です:<progra
mlisting> |
(...skipping 950 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
1115 </varlistentry> | 1115 </varlistentry> |
1116 | 1116 |
1117 <varlistentry><term><ulink url="http://findbugs.cs.umd.edu/eclipse-daily/">h
ttp://findbugs.cs.umd.edu/eclipse-daily/</ulink></term> | 1117 <varlistentry><term><ulink url="http://findbugs.cs.umd.edu/eclipse-daily/">h
ttp://findbugs.cs.umd.edu/eclipse-daily/</ulink></term> |
1118 | 1118 |
1119 <listitem> | 1119 <listitem> |
1120 <para>FindBugsの日次ビルド物を提供します。コンパイルができること以上のテストは行われていません。</para> | 1120 <para>FindBugsの日次ビルド物を提供します。コンパイルができること以上のテストは行われていません。</para> |
1121 </listitem> | 1121 </listitem> |
1122 </varlistentry> | 1122 </varlistentry> |
1123 </variablelist> | 1123 </variablelist> |
1124 | 1124 |
1125 <para>また、次に示すリンクから手動でプラグインをダウンロードすることもできます : <ulink url="http://prdownloads.sour
ceforge.net/findbugs/edu.umd.cs.findbugs.plugin.eclipse_3.0.0.20140706.zip?downl
oad">http://prdownloads.sourceforge.net/findbugs/edu.umd.cs.findbugs.plugin.ecli
pse_3.0.0.20140706.zip?download</ulink>. 展開して Eclipse の「plugins」サブディレクトリーに入れてくださ
い。(そうすると、 <eclipse インストールディレクトリー >/plugins/edu.umd.cs.findbugs.plugin.ecli
pse_3.0.0.20140706/findbugs.png が &FindBugs; のロゴファイルへのパスになるはずです。)</para> | 1125 <para>また、次に示すリンクから手動でプラグインをダウンロードすることもできます : <ulink url="http://prdownloads.sour
ceforge.net/findbugs/edu.umd.cs.findbugs.plugin.eclipse_3.0.1.20150306.zip?downl
oad">http://prdownloads.sourceforge.net/findbugs/edu.umd.cs.findbugs.plugin.ecli
pse_3.0.1.20150306.zip?download</ulink>. 展開して Eclipse の「plugins」サブディレクトリーに入れてくださ
い。(そうすると、 <eclipse インストールディレクトリー >/plugins/edu.umd.cs.findbugs.plugin.ecli
pse_3.0.1.20150306/findbugs.png が &FindBugs; のロゴファイルへのパスになるはずです。)</para> |
1126 | 1126 |
1127 <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> | 1127 <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> |
1128 </sect1> | 1128 </sect1> |
1129 | 1129 |
1130 <sect1> | 1130 <sect1> |
1131 <title>プラグインの使用方法</title> | 1131 <title>プラグインの使用方法</title> |
1132 | 1132 |
1133 <para>実行するには、 Java プロジェクト上で右クリックして「Find Bugs」を選択します。&FindBugs; が実行されて、バグパターンの実例の
可能性があると識別されたコード箇所に問題マーカーがつきます。 (ソース画面および Eclipse 問題ビューに表示されます。)</para> | 1133 <para>実行するには、 Java プロジェクト上で右クリックして「Find Bugs」を選択します。&FindBugs; が実行されて、バグパターンの実例の
可能性があると識別されたコード箇所に問題マーカーがつきます。 (ソース画面および Eclipse 問題ビューに表示されます。)</para> |
1134 | 1134 |
1135 <para>Java プロジェクトのプロパティーダイアログを開いて「Findbugs」プロパティーページを選択することで、 &FindBugs; の動作をカスタ
マイズすることができます。選択できる項目には次のようなものがあります :</para> | 1135 <para>Java プロジェクトのプロパティーダイアログを開いて「Findbugs」プロパティーページを選択することで、 &FindBugs; の動作をカスタ
マイズすることができます。選択できる項目には次のようなものがあります :</para> |
(...skipping 1942 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
3078 </blockquote> | 3078 </blockquote> |
3079 | 3079 |
3080 </sect2> | 3080 </sect2> |
3081 | 3081 |
3082 </sect1> | 3082 </sect1> |
3083 | 3083 |
3084 </chapter> | 3084 </chapter> |
3085 | 3085 |
3086 | 3086 |
3087 </book> | 3087 </book> |
OLD | NEW |