まず初めに、バグ報告はユーザから通常の電子メールとして
submit@bugs.debian.org に提出されます。
このバグ報告は通し番号が与えられ、
ユーザには受領通知が送られ、debian-bugs-dist
メーリングリストに転送されます。報告者が Package
行にメンテナのいるパッケージ名を指定した場合は、
該当するメンテナにもその写しが送られます。
Subject 行には Bug#nnn:
が追加されます。Reply-To には、そのバグ報告の提出者と
nnn@bugs.debian.org が設定されます。
X-Debian-PR: quiet 機能は廃止Debian のバグ報告はその問題が解決したときクローズ (解決) しなければなりません。パッケージ中の問題はそのバグの修正を含むパッケージが Debian アーカイブに入ったときのみ解決したとみなされます。
ふつう、バグ報告をクローズすべきなのはそのバグの報告者と そのバグが報告されたパッケージのメンテナだけです。この規則には例外があります。 たとえば、不明なパッケージや一般的な擬似パッケージに対するバグなどです。 よく分からないなら、バグ報告をクローズするのではなく、まず debian-devel メーリングリストで助言を求めましょう。
バグ報告は nnn-done@bugs.debian.org
に電子メールを送ることによってクローズしなければなりません。
メッセージの本文はそのバグがどのように修正されたのかの説明を含む必要があります。
バグ追跡システムから受けとった電子メールがあるなら、
そのバグ報告をクローズするにはメールリーダプログラムで返信を作り、To
欄を編集して、たとえば nnn@bugs.debian.org
のかわりに nnn-done@bugs.debian.org
を使うだけでいいです (nnn-close
は、nnn-done のエイリアスとして用意されています)。
可能なら、
バグ追跡システムがどのリリースのパッケージにその修正が含まれるのか分かるように、
バグを閉じる際のメッセージの疑似ヘッダ内に Version
行を書いておいてください。
バグ報告をクローズしようとしている人、それを提出した人および
debian-bugs-closed
メーリングリストにそのバグ報告のステータスが変更されたことが通知されます。
報告の提出者とこのメーリングリストには nnn-done
へ送られたメッセージの内容も送られます。
バグ追跡システムはバグ報告をフォワードする時に、Reply-To
ヘッダに報告者のメールアドレスとそのバグのメールアドレス
(nnn@bugs.debian.org)
を含めます。これらは別個のメールアドレスであることに注意してください。
クローズされていないバグ報告に開発者が返信したい時は、単にそのバグ報告に返信します。
Reply-To ヘッダをそのまま使うわけです。
これはバグ報告をクローズしません。
バグ追跡システムは、nnn@bugs.debian.org
として受け取ったメッセージをパッケージメンテナに転送し、バグ報告の追加情報として記録して
debian-bugs-dist に転送します。
nnn-submitter@bugs.debian.org
にメッセージを送ると、そのバグの報告者に明示的にメールを送り、
コピーをバグ追跡システムに置くことができます。
この場合、パッケージメンテナにはメッセージが送られません。
debian-bugs-dist
には適当でないフォローメッセージを送りたい場合、nnn-quiet@bugs.debian.org
や nnn-maintonly@bugs.debian.org
を送信に使うことができます。nnn-quiet@bugs.debian.org
へのメールは、バグ追跡システムに記録されますが特定の人やメーリングリストには配送されません。
nnn-maintonly@bugs.debian.org
へのメールは、バグ追跡システムに記録されてパッケージメンテナだけに配送されます。
もし確固とした受取人変更の意図がないのであれば、メーラーの
reply to all recipients (すべての受取人に返事をする)
や
followup (フォローする)
の機能を使ってはいけません。特にフォローメッセージを
submit@bugs.debian.org に送らないように注意してください。
受信通知メッセージを抑制するためのヘッダに関する情報や、 バグ追跡システムを使ってカーボンコピーを送る方法については、バグ報告の説明を見てください。
バグシステムは、それぞれのバグ報告について severity (重要度)
レベルを記録します。デフォルトでは normal (通常)
に設定されますが、バグ報告の際に疑似ヘッダに Severity
行を入れる (Debian にバグを報告する方法を参照)
か、コントロールリクエストサーバに
severity コマンドを送ることで変更できます。
複数のタグを指定する場合は、コンマ、スペース、またはその両方を使って区切ってください。
severity レベルには以下のものがあります。
critical (致命的)grave (重大)serious (深刻)mustや
requiredの要件に違反している)、またはパッケージメンテナあるいはリリースマネージャの意見として そのパッケージがリリースに適していないと判断された場合。
important (重要)normal (通常)minor (軽度)wishlist (要望)リリースクリティカル とみなされる重要度があります。これはそのバグがそのパッケージを Debian の安定版でリリースするのに影響があるという意味です。 現在、critical、grave そして serious がこれに該当します。 これらの深刻度がもたらすいかなる問題についての完全で正式なルールは、Lenny のリリースクリティカル問題のリストを見てください。
それぞれのバグ報告は規定されたタグをつけることができます。 これらのタグは、パッケージのページやすべてのバグの記録を閲覧したときに、 バグ報告のリストのなかに表示されます。
タグは、バグの報告時に擬似ヘッダに Tags 行を指定すること
(バグ報告の勧め (使用説明書) を参照)
や、コントロールリクエストサーバに対して
tags コマンドを用いることで設定することができます。
現在のバグのタグは以下のものがあります。
patch (パッチ)wontfix (修正予定無)moreinfo (追加情報)動きませんというようなバグ報告のためにあります。 何が動かないのでしょう?
unreproducible (再現不可能)help (助けを求む)pending (保留)fixed (修正済)fixedという severity (重要度) はこのタグに置き換えられました。
security (セキュリティ)upstream (上流)confirmed (確認済)fixed-upstream (上流で解決済)fixed-in-experimental (experimental で解決済)d-i (インストーラ)ipv6lfs (巨大ファイルサポート)l10npotatowoodysargesarge-ignore (sarge では無視)etchetch-ignorelennylenny-ignoresidexperimental最後の 8 つのタグの意味は最近変わりました。ignore タグは、 パッケージをテスト版 (testing) に移行できるよう、そのバグを無視します。 リリースタグは、 以前はどのバグがどのリリースに影響するかを意味するだけのものでしたが、 現在ではバグをいつアーカイブできるのかを意味するようになり、 アーカイブできない場合は BTS によって無視されます。 しかし、これらのタグは、テスト版 (testing) への移行スクリプトなど、BTS 以外のツールで利用される可能性があります。
Debian パッケージの元である上流ソースパッケージの開発者に Debian パッケージ開発者からバグ報告を転送する際は、 バグ追跡システムに次のようにして記録しなければなりません。
あなたのメッセージの To
フィールドには原作者達のアドレスのみが書かれていることを確認すること。
そして、CC フィールドにはバグを報告した人と
nnn-forwarded@bugs.debian.org
そして nnn@bugs.debian.org を入れること。
原作者が返信をする際に、CC に
nnn-forwarded@bugs.debian.org を残すように依頼すること。
バグ追跡システムはこの返信を元々のバグ報告とともに保存します。
この場合、メッセージの保存はしますが送信はしません。
通常のようにメッセージを送信するには
nnn@bugs.debian.org に送ってください。
バグがすでに転送済であると記録されていない場合、バグ追跡システムが
nnn-forwarded
でメッセージを受け取ると、そのメッセージは To
フィールドにあるアドレスに転送済であることを該当するバグに記録します。
control@bugs.debian.org
にメッセージを送ることで、forwarded to
情報を操作することができます。
バグを修正する責任を持った人が、関連するパッケージのメンテナには割り当てられていない場合 (例えば該当するパッケージがチームでメンテナンスされている場合など)、 このことをバグ追跡システムに記録しておくと役に立つでしょう。 そのため、それぞれのバグは任意に所有者を持てるようになっています。
バグの所有者は、バグ報告時に疑似ヘッダに Owner
行を付けたり (バグ報告の説明を参照)、
コントロールリクエストサーバに owner
や noowner のコマンドを使って設定できます。
パッケージメンテナが間違っている場合、
多くの原因は最近メンテナが交替されていて、新メンテナが
control ファイルの Maintainer
フィールドを更新した新しいパッケージをアップロードしていないためです。
これは、パッケージをアップロードすることにより修正されます。
これ以外に、アーカイブメンテナが
パッケージに記録されているメンテナを無視するように設定することが可能です。
これは例えば、すぐにパッケージの再構築、再アップロードの必要がないと思われる場合に利用します。
override file を変更するには
override-change@debian.org に連絡してください。
別のパッケージにバグ報告を再指定 (reassign)
する事や、誤ってクローズしてしまったバグを再オープン (reopen)
する事、バグ報告が転送されている送付先について述べている情報を修正する事、バグ報告の severity
(重要度) やタイトルを変更する事、バグの所有者を設定する事、バグ報告のマージ
(merge)・マージ解除 (unmerge) をする事、
バグが発見された・修正されたパッケージのバージョンを記録する事ができます。
これらの操作は、control@bugs.debian.org
にメールを送ることにより行います。
これらのメッセージの書式 は
WWW 上で利用できる別の文書や bug-maint-mailcontrol.txt
ファイルに記述されています。テキストバージョンは、上記のアドレスのサーバに
help と書いたメールを送ることで入手することも可能です。
バグ追跡システムでは、バグの報告者、開発者およびそれに関心のある第三者が、
個々のバグ報告を購読できます。あるバグに注意を払い続けたい場合、PTS を通してパッケージの購読をしなくても、
この機能を利用できます。nnn@bugs.debian.org
に届いたすべてのメッセージは購読者に送られます。
nnn のバグ報告を購読するには、nnn-subscribe@bugs.debian.org
にメールを送ります。メールの件名、本文は BTS によって無視されます。
このメールが処理されると、そのバグに関するメッセージを受け取れるようにしたい場合は
これに返信してください、という内容の確認メッセージがユーザに届きます。
購読を停止することも可能です。購読を止めるには
nnn-unsubscribe@bugs.debian.org へメールを送ります。
この場合も、メールの件名、本文は BTS によって無視されます。
購読を止めるための確認メッセージが届きますので、それに返信する必要があります。
通常、購読に使用されるメールアドレスは
From ヘッダに書かれているものになります。別のメールアドレスで購読したいなら、
購読に使用するメールアドレスを符号化して購読メッセージの宛先に埋め込む必要があります。
nnn-subscribe-localpart=example.com@bugs.debian.org
という形式になります。
この例では、バグ nnn の購読メッセージを localpart@example.com
へ送ります。@ 記号を =
記号に置き換えて符号化しなければなりません。同様に、購読を止める場合も、
nnn-unsubscribe-localpart=example.com@bugs.debian.org
という形式になります。
どちらのケースでも、メールの件名と本文は確認のリクエストに含めて、
そのメールアドレスに転送されます
サブジェクトが Bug#nnn で始まるメッセージが
submit や bugs に到着した場合、このメッセージは
nnn@bugs.debian.org に送信されたものとして扱われます。
これは、昔のアドレスから転送されたメールと互換性を残すためと、誤って
(例えば、全ての受取人へ返信をしてしまうことにより)
submit に送られたフォローメールを捕えるためです。
maintonly、done、quiet、forwarded
についても同様に扱われます。これらのアドレスでは、サブジェクトタグのあるメールは、
nnn-whatever@bugs.debian.org (whatever は maintonly、done、quiet、forwarded のうち対応するもの)
というアドレスに送信されたものとして扱われます。
forwarded と done
に届いたタグのないメッセージ (例えばアドレスにバグ番号がないもの)
で、サブジェクトにバグ番号がついていないメッセージは
junk
として記録され数週間保存はされますが、それ以外の処理は無効となります。
X-Debian-PR: quiet 機能は廃止バグ追跡システムが debian-bugs
で受け取ったメッセージをどこにも転送させないようにするためには、
従来は実際のメールヘッダに X-Debian-PR: quiet 行を入れていました。
現在、このヘッダ行は無視されます。代わりに、
quiet や nnn-quiet
(もしくは、maintonly や nnn-maintonly)
にメッセージを送ってください。
その他の BTS ページ:
Debian bug tracking system
Copyright © 1999 Darren O. Benham, 1997, 2003 nCipher Corporation Ltd,
1994-1997 Ian Jackson.