CVSBUG(8)

名称
cvsbug - CVS に関する Problem Report (PR) をサポートサイトに送る

書式
cvsbug [ site ] [ -f problem-report ] [ -t mail-address ]
[ -P ] [ -L ] [ --request-id ] [ -v ]

解説
cvsbug は、サポートサイトに対して problem reports (PR) を送るために使うツールです。大抵の場合は正しい site がデフォルトとなっているはずです。この引き数は、問題を引き起こした事象 のカテゴリに対して責任をもつサポートサイトを指し示します。いくつかの サイトはデフォルトとしてローカルアドレスを使っていることでしょう。 site は、 aliases(5) を使って定義されます。

cvsbug を実行すると、エディタが起動されて用意されているテンプレートを (いくつ かのフィールドにもっともらしいデフォルトの値をあてはめてから) 読み込ま れます。エディタを終了すると、 cvsbug はサポートサイトの Problem Report Management System (GNATS) に完了した形式のレポートをメールで送ります。サポートサイトで は、PR は問題のカテゴリと submitter-id とに従って唯一の番号が 割り当てられ、GNATS データベースに保存されています。 GNATS はメールを受け取ったことを知らせるために、 問題のカテゴリの引用と PR 番号とを自動的に返送します。

PR が速やかに処理されるようにするためには、 あなた(独自)の submitter-id と、 問題分野を識別する有効なカテゴリを記入する必要があります。(カテゴリは `cvsbug -L' で見ることができます。)

あなたのサイトにある cvsbug テンプレートは、あらかじめ submitter-id をカスタマイズしておく 必要があります (そのために `install-sid submitter-id' を 実行することは cvsbug のインストール手順の一部になっています )。 もしこれがまだ設定されていなければ、 あなたのシステム管理者に submitter-id 設定をお願いするか、次のコマンド `cvsbug --request-id' を実行してあなたのサポートサイトに submitter-id を要求して下さい。 あなたのサイトがユーザサイト間で区別できない、あるいは あなたがサポートサイトと結び付きを持っていない場合は、このフィールドに `net' と指定して下さい。

より正確な問題の記述やより完全な情報があればあるほど、 サポートチームは問題をより早く解決することができます。

オプション

-f problem-report
    すでに記入した PR ファイルを problem-report に指定できます。 cvsbug はエディタを起動せずにファイルを送ります。 problem-report が `-' のときは cvsbug は、標準入力から読み込みます。

-t mail-address
    PR を送るサイトのメールアドレスを変更します。 デフォルトのメールアドレスは、 デフォルトサイトのものが使われます。特殊な状況を除き、このオプションではなく、 site を使って下さい。

-P  環境変数 PR_FORM で指定されたテンプレートを標準出力に出力します。 PR_FORM が定義されていないときは、標準のブランク PR テンプレートが使われます。 メールは送られません。

-L  使用できるカテゴリが表示されます。メールは送られません。

--request-id
    デフォルトサイトか、 site が指定されればそのサイトに submitter-id を要求します。もしユーザがそのサイトと関係なければ、 submitter-id として net を使って下さい。

-v  cvsbug のバージョンを表示します。

注釈: PR を提出するためには、PR を直接メールするのではなく、 cvsbug を使いましょう。テンプレートと cvsbug の両方を使うことによって、すべての必要な情報がサポートサイトに確実に届きます。

環境変数
EDITOR テンプレートに対して起動するエディタ
デフォルト: vi

もし PR_FORM が設定されていれば、編集する PR のテンプレートのファイル名として 使われます。 部分的に完成したテンプレートから始めるために これを使うことができます (たとえば、すでに identification フィールドを 埋めてあるテンプレートなどです)。

PR の記入方法
PR が形式に従っていれば、 プログラムは簡単に PR を扱うことができます。 以下のガイドラインを覚えておきましょう:

•   それぞれの PR には 一つの問題 だけを記述しましょう。

•   フォローアップメールには、 自動返送されて来るメールと同じサブジェクトを使いましょう。サブジェクトは、 カテゴリ、PR 番号、元の概要の行から構成されています。 これによってサポートサイト は、特定の PR を複数のメールメッセージと結びつけ、またそれらを自動的に 記録することができます。

•   サブジェクトや、概要の行はできるだけ正確するようにしましょう。

•   サブジェクトや概要の行は機密扱いではありません。 公開されるバグリストはサブジェクトと概要の行から編集するので、 機密情報はここに書かないでください。

詳しくは、GNU Info ファイルの cvsbug.info か、RP について詳しく書かれている Reporting Problems With cvsbug のドキュメントなどを参照してください。

テストケース、コード、その他の記入方法
小さなサンプルコードを送りましょう。 大きなテストケースや問題となっているソースコードを送りたい場合にには、 サポートサイトに連絡を取り、指示を受けて下さい。

関連ファイル
/tmp/p$$ 編集しているときに使う PR のコピー
/tmp/pf$$ テスト目的で使う、空の PR テンプレートコピー
/tmp/pbad$$ 捨てられた PR のファイル

インストールとコンフィギュレーション
INSTALL インストールガイドを参照してください。

関連項目
gnats(l), query-pr(1), edit-pr(1), gnats(8), queue-pr(8), at-pr(8), mkcat(8), mkdist(8).

作者
Jeffrey Osier, Brendan Kehoe, Jason Merrill, Heinz G. Seidl (Cygnus Support)

COPYING
Copyright (c) 1992, 1993 Free Software Foundation, Inc.

Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.

Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.

Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be included in translations approved by the Free Software Foundation instead of in the original English.