Where should I send bug reports?
バグレポートはどこへ送ればよいですか?
本ページは Cygwin 本家サイトの 「Where should I send problem reports?」を翻訳したものです。
まず最初に、Cygwin FAQ (日本語訳) や メーリングリストのアーカイブ を読んで、あなたが遭遇した潜在的なバグが既に報告されていないかどうかを調べる必要があります。 それでもあなたの問題が解決しないのであれば、Cygwin メーリングリストにその問題について気軽に書いて下さい。
解決方法を提示できるのであれば、自分自身でその問題についてよく調査し、そしてパッチを送って下さい。解決方法がないバグレポートも勿論歓迎します -- バグレポートのガイドラインを読んだ後、詳細な説明(可能であればテストケースも)を Cygwin メーリングリストへ送って下さい。 メーリングリストの流通量は多いので、我々はメーリングリストに送られた個別のバグについて常に返答することは出来ませんが、それらの報告には常に注意を払っています。
Eric S. Raymond は、如何にしてスマートな質問を書くかということに関する素晴らしい論文を書いています。 彼のガイドラインに忠実に従えば、貴方が見つけたバグに対して大変良質な反応を得られることでしょう。
バグレポートのガイドライン
Subject: 行で、その問題について適切に説明する:
良い例:
「1.1.8: select のバグ (NT 及び 95)」("1.1.8: select bug (NT and 95)")
「1.1.6: perl のコンパイルの問題」("1.1.6: problem building perl")
「1.1.8: bash 上でのバイナリファイルの cat に関する質問」("1.1.8: question about catting binary files in bash")悪い例:
「どうして?」("question?")
「バグ」("bug")
「移植上の問題」("porting problem")
「助けて!!!」("help!!!!")
「bash の質問」("bash question")
「初心者です助けて」("newbie needs help")これは一般的な議論に対しても適用されます。 似たような Subject: 行であふれ返っている場合、メーリングリストを読むのは非常に大変です。
説明の中で、その問題を再現させる方法を記述して下さい。 これは、可能であればテストケースを含めるということを意味します。
最低でも、常に使用している Cygwin ベータリリースと使用しているオペレーティングシステム、 そしてそれらのバージョン番号を含めておいて下さい。 例えば「NT 4.0 上の Cygwin バージョン 1.1.9(cygwin v1.1.9 under NT 4.0)」のように。
cygcheck -s -v -r > cygcheck.outを実行し、ファイル cygcheck.out の内容をレポートに含めて下さい。メーリングリストには 1,500 人もの人々がいることを覚えておいて下さい。 「私もです」といった反応を返すことや、既に報告されている問題に対するレポートを出すことは避けるようにして下さい。 そのような質問の塊についていくことは大変なのです…。
可能であれば、その問題を修正するパッチを含めて下さい。 更なる情報については、協力の仕方を参照して下さい。
