バグデータベース
バグデータベース
このページでは、Bugzilla Apache バグデータベース を使用するブックマークを提供します。
このリンク issues.apache.org は、Apache バグデータベースシステムの完全なリストに接続します。
既に報告されていますか？
最新のナイトリービルドで問題が解決しない場合、他の人が既にその問題を報告している可能性があります。バグデータベースを確認する必要があります。このシステムは使いやすく、現在オープンになっているバグと解決済みのバグを検索して、問題が既に報告されているかどうかを確認できます。問題が報告されている場合、開発者がコメントを追加しているか、回避策を示唆しているか、バグの原因などを確認できます。追加情報がある場合は（バグレポートの作成と修正については以下を参照）、そのまま追加してください。追加情報がない場合は、このバグに投票し、バグの進捗状況を追跡するために自分のメールアドレスをCCリストに追加するだけで十分です。
優先順位順に並べられた、オープンなApache Antのバグ.
投票数順に並べられた、オープンなApache Antのバグ.
バグレポートの提出
Apache Antに未報告のバグがあると判断する前に、問題に関するドキュメントをお読みください。
いくつか選択肢があります。「user」メーリングリストにメールを送信して、他の人が同じ問題に遭遇しているかどうか、そしてどのように回避策を見つけたかを確認できます。議論の後、バグレポートを作成する必要があると感じたら、バグデータベースで簡単に操作できます。開発者がバグを解決するのを支援するために、できるだけ多くの情報を提供してください。Antのバージョン、プラットフォームなど、バグを作成する際にさまざまな入力に対して正しい値を入力してください。バグが作成されたら、バグレポートに添付ファイルを追加することもできます。
バグレポートに含めるべき情報は何ですか？最も簡単に修正できるバグは、最も簡単に再現できるバグであるため、問題を示す小さなテストケースを作成できれば非常に役立ちます。この場合、ビルドファイルと問題の再現に必要なその他のファイルをアーカイブにまとめて添付します。テストケースを作成できない場合は、ビルドファイルのスニペットとAntからの詳細またはデバッグ出力の関連セクションを含めるようにしてください。Antがバージョン、OS、VM情報などを示すヘッダー情報を必ず含めてください。デバッグ出力は非常に大きくなる可能性があるため、関連のない出力は削除することをお勧めします。バグがバグデータベースに入力されると、バグの進捗状況についてメールで通知されます。さらに情報を求めるメールを受け取った場合は、返信してください。バグの解決に役立ちます。
バグレポートを作成するには、このリンクをクリックしてください。
機能拡張のリクエスト
Antが必要なことを行わない場合があります。Antが想定どおりに動作しているので、バグではありません。まだ考えられていないタスクの追加機能であるか、まったく新しいタスクである可能性があります。このような状況では、 *機能拡張リクエスト* を行う必要があります。機能拡張リクエストは、上記で説明したのと同じApacheバグデータベースを使用して管理されます。これらは単なる別のタイプのバグレポートです。バグデータベースを見ると、バグの重大度設定の1つに「機能拡張」があることがわかります。バグレポートに記入し、バグの重大度を「機能拡張」に設定し、説明にAntをどのように強化したいかを記述してください。繰り返しますが、最初に、ニーズを満たす既存の機能拡張リクエストがあるかどうかを確認する必要があります。ある場合は、それらに投票を追加するだけです。
バグの修正
バグレポートの提出だけでは満足できない場合は、問題の原因を特定して自分で修正を試みることができます。そのためには、Subversionから最新のコードを使用するのが最適です。または、ソース配布から入手可能なソースコードを使用することもできます。このレベルで問題に取り組む場合は、最初に「dev」メーリングリストで詳細について話し合うことをお勧めします。問題の修正が完了したら、修正を「dev」メーリングリストにパッチとして送信するか、上記のようにバグデータベースに入力し、パッチをバグレポートに添付できます。バグデータベースを使用すると、パッチの進捗状況を追跡できます。
パッチを送信し、「dev」メーリングリストに送信する場合は、メッセージの件名に「[PATCH]」をプレフィックスとして付けます（これはバグデータベースの件名にも適しています）。関連するバグ番号を必ず含めてください。パッチファイルは、`diff`または`svn diff`コマンドの`-u`オプションを使用して作成する必要があります。たとえば
diff -u Javac.java.orig Javac.java > javac.diffs
または、Subversionからソースを入手した場合は
svn diff Javac.java > javac.diffs
注：パッチファイルには意味のある名前を付ける必要があります。これにより、多数の異なるパッチファイルを使用する必要がある開発者が容易になります。