Developer's Reference chap.10

[Yoshizumi Endo <y-endo@xxxxxxxxxxxxxxx>]

遠藤です。

Debian デベロッパーズリファレンス第 10 章の翻訳です。
チェックお願いします。

|     <chapt id="bug-handling">Handling Bugs
| 
|       <sect>Monitoring bugs
| 	<p>
| If you want to be a good maintainer, you should periodically check the
| <url id="&url-bts;" name="Debian bug tracking system (BTS)"> for your
| packages.  The BTS contains all the open bugs against your packages.

    <chapt id="bug-handling">バグの扱い

      <sect>バグを監視する
	<p>
優れた開発者であるためには、定期的に
<url id="&url-bts;" name="Debian バグ追跡システム (BTS)"> 
でご自分のパッケージをチェックするとよいでしょう。
BTS には、あなたのパッケージに対してオープンされた
全バグ報告が登録されています。

| 	<p>
| Maintainers interact with the BTS via email addresses at
| <tt>bugs.debian.org</tt>.  Documentation on available commands can be
| found at <url id="http://www.debian.org/Bugs/";>, or, if you have
| installed the <package>debian-doc</package> package, you can look at
| the local files <file>/usr/doc/debian/bug-*</file>.

	<p>
開発者は、<tt>bugs.debian.org</tt> 宛てに
電子メールを出すことによって BTS を利用することもできます。
その際に利用できるコマンドに関するドキュメントは
<url id="http://www.debian.org/Bugs/";> にあります。
また <package>debian-doc</package> パッケージがインストール済みならば、
ローカルにある <file>/usr/doc/debian/bug-*</file> 
ファイルをご覧になることもできます。

| 	<p>
| Some find it useful to get periodic reports on open bugs.  You can add
| a cron job such as the following if you want to get a weekly email
| outlining all the open bugs against your packages:
| <example>
| # ask for weekly reports of bugs in my packages
| 0 17 * * fri   echo "index maint <var>maintainer-address</var>" | mail request@bugs.debian.org
| </example>
| Replace <var>maintainer-address</var> with you official Debian
| maintainer address.

	<p>
また、オープンされたバグ報告を定期的に取り込むことも有益です。
また、ご自分のパッケージに対してオープンされたバグ報告の概略を
毎週電子メールで受け取りたいならば、
cron ジョブに以下の行を追加してもよいでしょう。
<example>
# 毎週自分のパッケージに対するバグ報告を調べる
0 17 * * fri   echo "index maint <var>maintainer-address</var>" | mail request@bugs.debian.org
</example>
<var>maintainer-address</var> の箇所には、ご自分の
Debian 公式開発者としての電子メールアドレスを当てはめてください。

|       <sect id="submit-bug">Submitting Bugs
| 	<p>
| Often as a package maintainer, you find bugs in other packages or else
| have bugs reported to your packages which need to be reassigned.  The
| <url id="&url-bts-control;" name="BTS instructions"> can tell you how
| to do this.

      <sect id="submit-bug">バグを報告する
	<p>
パッケージ開発者として、他のパッケージのバグを発見したり、
あるいはご自分のパッケージに対してバグ報告を受けたりすることがあるでしょう。
これらのバグは記録しておく必要があります。
こちらをどのように行なうかについての説明は、
<url id="&url-bts-control;" name="バグコントロールメールサーバ入門">
にあります。

| 	<p>
| We encourage you to file bugs when there are problems.  Try to submit
| the bug from a normal user account at which you are likely to receive
| mail.  Do not submit bugs as root.

	<p>
問題があった場合、そのバグを記録することが奨励されています。
電子メールを受け取るときに用いている通常のユーザアカウントから、
バグを報告してください。
root アカウントからバグを報告してはいけません。

| 	<p>
| Make sure the bug is not already filed against a package.  Try to do a
| good job reporting a bug and redirecting it to the proper location.
| For extra credit, you can go through other packages, merging bugs
| which are reported more than once, or setting bug severities to
| `fixed' when they have already been fixed.  Note that when you are
| neither the bug submitter nor the package maintainer, you are should
| not actually close the bug (unless you secure permission from the
| maintainer).

	<p>
そのパッケージに対するバグが、
まだ報告されていないことを確認してください。
その上で、そのバグを適切なところへ報告してください。
特別に許可を得ている場合、他のパッケージに対しても、
何度も報告を受けているバグをマージし、その修正が完了した際、
そのバグの重要度を `fixed' に設定することもできます。
なお、バグ報告者かそのパッケージの開発者でなければ、
(開発者から権限を付与されていない限り、)
そのバグを実際にクローズすることはできません。

|       <sect>Responding to Bugs
| 	<p>
| Make sure that any discussions you have about bugs are sent both to
| the original submitter of the bug, and the bug itself (e.g.,
| <email>123@bugs.debian.org</email>).

      <sect>バグ報告に返信する
	<p>
バグ報告に対する返信は、必ずそのバグの元の報告者と、
バグ報告そのもの (例えば <email>123@bugs.debian.org</email>) 
の両者に送付されなければなりません。

| 	<p>
| You should <em>never</em> close bugs via the bug server `close'
| command sent to &email-bts-control;.  If you do so, the original
| submitter will not receive any feedback on why the bug was closed.

	<p>
バグサーバ経由で &email-bts-control; に `close' コマンドを送って
バグをクローズすることは<em>決して</em>しないでください。
そうしてしまうと、元の報告者は、そのバグがクローズされた理由に関して
何のフィードバックも得ることができません。

|       <sect id="upload-bugfix">When bugs are closed by new uploads
| 	<p>
| If you fix a bug in your packages, it is your responsibility as the
| package maintainer to close the bug when it has been fixed.  However,
| you should not close the bug until the package which fixes the bug has
| been accepted into the Debian archive.  Therefore, once you get
| notification that your updated package has been installed into the
| archive, you can and should close the bug in the BTS.

      <sect id="upload-bugfix">新規アップロードによってバグをクローズする場合には
	<p>
ご自分のパッケージのバグを修正する場合、
その修正が完了した際にバグをクローズすることは、
パッケージ開発者としての義務です。
しかしながら、修正されたパッケージが Debian アーカイブに収められるまでは、
そのバグをクローズしてはいけません。
そのため、アップロードしたパッケージがアーカイブにインストールされたとの
通知を受けてから、BTS に登録されているバグをクローズしてください。

| 	<p>
| If you are using a new version of <package>dpkg-dev</package> and you
| do your changelog entry properly, <prgn>dinstall</prgn> will close the
| bugs automatically.  All you have to do is follow a certain syntax
| in your <file>debian/changelog</file> file:
| 

	<p>
<package>dpkg-dev</package> の新しいバージョンを利用し、
changelog エントリを適切に設定していれば、
<prgn>dinstall</prgn> は自動的にそのバグをクローズします。
そのためには、以下のように <file>debian/changelog</file> 
ファイルの記述が正しい文法にしたがっていなければなりません。

| <example>
| acme-cannon (3.1415) unstable; urgency=low
| 
|   * Frobbed with options (closes: Bug#98339)
|   * Added safety to prevent operator dismemberment, closes: bug #98765,
|     bug #98713, #98714.
|   * Added manpage. closes: #98725.
| </example>
| 
| Technically speaking, the following Perl regular expression is what is
| used:
| <example>
|   /closes:\s*(bug)?\#\d+(,\s*(bug)?\#\d+)*/gi
| </example>

<example>
acme-cannon (3.1415) unstable; urgency=low

  * Frobbed with options (closes: Bug#98339)
  * Added safety to prevent operator dismemberment, closes: bug #98765,
    bug #98713, #98714.
  * Added manpage. closes: #98725.
</example>
技術的な観点からいえば、以下の Perl 正規表現が用いられます。
<example>
  /closes:\s*(bug)?\#\d+(,\s*(bug)?\#\d+)*/gi
</example>

| The author prefers the <tt>(closes: Bug#<var>XXX</var>)</tt> syntax,
| since it stands out from the rest of the changelog entries.

このパッケージの開発者は、他の changelog エントリと区別しやすいことから、
<tt>(closes: Bug#<var>XXX</var>)</tt> という文法を好んで使っているようです。

| 	<p>
| If you want to close bugs the old fashioned, manual way, it is usually
| sufficient to mail the <tt>.changes</tt> file to
| <email>XXX-done@bugs.debian.org</email>, where <var>XXX</var> is your
| bug number.

	<p>
バグのクローズを手動という古い流儀で行ないたい場合は、
<tt>.changes</tt> ファイルを
<email>XXX-done@bugs.debian.org</email> 宛てに送れば結構です。
その際こちらの <var>XXX</var> の箇所にはバグ番号を当てはめてください。

|       <sect id="lintian-reports">Lintian reports
| 	<p>
| You should periodically get the new <package>lintian</package> from
| `unstable' and check over all your packages.  Alternatively you can
| check for your maintainer email address at the <url id="&url-lintian;"
| name="online lintian report">.  That report, which is updated
| automatically, contains <prgn>lintian</prgn> reports against the
| latest version of the distribution (usually from 'unstable') using the
| latest <package>lintian</package>.

      <sect id="lintian-reports">Lintian による報告
	<p>
パッケージ開発者は、定期的に最新の <package>lintian</package> を 
`unstable' ディストリビューションから入手し、
自らのパッケージすべてをチェックすべきです。
あるいは、<url id="&url-lintian;" name="オンライン lintian 報告">上で、
自分が開発者として登録している電子メールアドレスの箇所を
チェックしてもよいでしょう。
こちらの報告は自動的に更新されますが、
最新の <package>lintian</package> を利用して、
ディストリビューションの最新バージョン (通常は 'unstable') に対する
<prgn>lintian</prgn> 報告を収録しています。

|       <sect>Reporting lots of bugs at once
| 	<p>
| Reporting a great number of bugs for the same problem on a great
| number of different packages -- i.e., more than 10 -- is a deprecated
| practice.  Take all possible steps to avoid submitting bulk bugs at
| all.  For instance, if checking for the problem can be automated, add
| a new check to <package>lintian</package> so that an error or warning
| is emitted.

      <sect>一度にたくさんのバグ報告を行なう
	<p>
たくさんの異なるパッケージ上にある同一の問題に対して、
たくさんのバグ報告を -- つまり 10 以上も -- 
行なうことは、勘弁願いたい作業です。
ただ、ともあれ一度にたくさんのバグ報告をしなくて済むように、
できうることは行なってください。
例えば、その問題のチェックが自動化できるものならば、
エラーや警告を発行するように
<package>lintian</package> に新たなチェックを付け加えてください。

| 	<p>
| If you report more than 10 bugs on the same topic at once, it is
| recommended that you send a message to &email-debian-devel; describing
| your intention before submitting the report. This will allow other
| developers to verify that the bug is a real problem. In addition, it
| will help prevent a situation in which several maintainers start
| filing the same bug report simultaneously.

	<p>
同じ問題に関する 10 個以上のバグを一度に報告する場合は、
そのバグを報告する前に、その意図するところを添えて
&email-debian-devel; 宛てにメッセージを送ることが推奨されています。
このことによって、他の開発者はそのバグが本当に問題のあるものなのかどうかを
確かめることができます。
さらに、このことは、
複数の開発者が同じバグを同時に報告するという事態も防ぎます。

| 	<p>
| Note that when sending lots of bugs on the same subject, you should
| send the bug report to <email>maintonly@bugs.debian.org</email> so
| that the bug report is not forwarded to the bug distribution mailing
| list.

	<p>
なお、たくさんのバグを同一のサブジェクトで報告する際には、
バグ報告が配送されるメーリングリストに転送されないよう、
そのバグ報告は <email>maintonly@bugs.debian.org</email> へ送ってください。

-- 
Yoshizumi Endo <y-endo@xxxxxxxxxxxxxxx>