os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

- Merge the following from the English version:

Browse source 
r51348 -> r52112	head/ja_JP.eucJP/articles/problem-reports/article.xml
This commit is contained in:
Ryusuke SUZUKI 2019-06-14 10:40:39 +00:00
parent 76ff1ac1da
commit 92db38eb07
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=53151
1 changed files with 38 additions and 317 deletions
Download patch file Download diff file Expand all files Collapse all files

355
ja_JP.eucJP/articles/problem-reports/article.xml
View file

@ -3,7 +3,7 @@
"http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd">
<!--
The FreeBSD Japanese Documentation Project
Original revision: r51348
Original revision: r52112
$FreeBSD$
-->
<article xmlns="http://docbook.org/ns/docbook"
@ -17,7 +17,6 @@
&tm-attrib.freebsd;
&tm-attrib.ibm;
&tm-attrib.intel;
&tm-attrib.sparc;
&tm-attrib.sun;
&tm-attrib.general;
</legalnotice>
@ -326,7 +325,7 @@
<itemizedlist>
<listitem>
<para><emphasis><quote>Synopsis</quote>(概要)
<para><emphasis><quote>Summary</quote>(概要)
行を空のままにしないでください。</emphasis>
障害報告は、世界中に配布されるメーリングリストに送られる
(そこでは、<quote>Synopsis</quote> (概要) は
@ -402,14 +401,13 @@
</listitem>
<listitem>
<para><filename>make.conf</filename>
に、どのグローバルオプションを指定したか書いてください。
注意: &man.gcc.1; に <literal>-O2</literal>
以上を設定するのは、多くの場合にバグがあることが分かっています。
&os; 開発者はパッチを受け取るでしょうが、
単純に時間とボランティアが少ないため、
そのような問題は通常調査したがらず、
ただ対応していないだけだと答える可能性があります。</para>
<para><filename>make.conf</filename>,
<filename>src.conf</filename>,
および <filename>src-env.conf</filename>
に、指定したグローバルオプションの情報を記述してください。
数多くのオプションを設定できるため、
すべての組み合わせについて、
完全に対応しているわけではありません。</para>
</listitem>
<listitem>
@ -608,81 +606,23 @@
</section>
<section xml:id="pr-writing-filling-template">
<title>テンプレートに記入する</title>
<para>電子メールの雛型には、次の
2 つの一行フィールドがあります。</para>
<title>フォームを記入する</title>
<note>
<title>訳注</title>
<para>フィールドの意味が分かり易いように
フィールド名を訳していますが、
フィールドの値も含めて
実際のフィールド名は英文字でなければなりません。</para>
<para>指定した電子メールアドレスは公開情報となり、
スパマーに利用されるかもしれません。
スパム対策を使えるようにしておくか、
一時的なメールアカウントを利用してください。
有効な電子メールアドレスを書いていただかないと、
わたしたちは障害報告に対する質問をあなたに対してできないので、
ご留意ください。</para>
</note>
<itemizedlist>
<listitem>
<para><emphasis>Submitter-Id (提出者-Id):</emphasis>
これは変更しないでください。
あなたが &os.stable; を動かしている場合でも、既定値である
<literal>current-users</literal> が正しいのです。</para>
</listitem>
<listitem>
<para><emphasis>Confidential (機密):</emphasis>
これは <literal>no</literal> で既に埋められています。
機密扱いの &os; 障害報告というものはないため、
変更することに意味はありません。&mdash;
障害報告データベースは、世界的に配布されています。</para>
</listitem>
</itemizedlist>
<para>次の節では、電子メールインタフェースと
<link xlink:href="https://bugs.freebsd.org/bugzilla/enter_bug.cgi">web
インタフェース</link>
の両方に共通なフィールドについて説明します。</para>
<para>バグの申請には、以下のフィールドを使ってください。</para>
<itemizedlist>
<listitem>
<para><emphasis>Originator (あなたの名前):</emphasis>
あなたの本名を指定してください。
お好みで、名前の後ろに電子メールアドレスを
山括弧 (&lt; と &gt; のこと) で閉じて付けることができます。
電子メールインタフェースでは、
これは普通、現在ログインしているユーザの
<literal>gecos</literal>
フィールドを使って既に埋められています。</para>
<note>
<para>指定した電子メールアドレスは公開情報となり、
スパマーに利用されるかもしれません。
スパム対策を使えるようにしておくか、
一時的なメールアカウントを利用してください。
しかし、あなたが有効な電子メールアドレスを書かないと、
わたしたちはあなたの障害報告に対して質問できなくなります。</para>
</note>
<note>
<title>訳注</title>
<para>たとえば、以下のように書くことができます。</para>
<screen>From: <userinput>FreeBSD Taro &lt;FreeBSD-Taro@example.org&gt;</userinput></screen>
</note>
</listitem>
<listitem>
<para><emphasis>Organization (所属組織):</emphasis>
あなたの好きなようにしてください。
このフィールドは何らかの深い意味で使われることはありません。</para>
</listitem>
<listitem>
<para><emphasis>Synopsis (概要):</emphasis>
<para><emphasis>Summary (概要):</emphasis>
問題についての簡にして要を得た説明を書き込んでください。
概要は障害報告メールのサブジェクトとして利用されており、
一覧や要旨にも使われています。
@ -693,38 +633,22 @@
と書いて下さい。
Ports に関する障害報告で、あなたがメンテナなら、
<literal>[maintainer update]</literal> (角括弧を含みます)
を追加して、
障害報告の <quote>Class</quote> を
<literal>maintainer-update</literal>
にするようにしてください。</para>
を追加してください。</para>
</listitem>
<listitem>
<para><emphasis>Severity (重要度):</emphasis>
<literal>non-critical (重要ではない)</literal>、
<literal>serious (重要)</literal>、
<literal>critical (致命的) </literal> のどれかです。
<literal>Affects only me</literal>,
<literal>Affects some people</literal> および
<literal>Affects many people</literal>
のどれかを選択してください。
重要度を過大に評価しないでください。
あなたの問題が本当に致命的 (たとえば、
データが壊れたり、-CURRENT
で以前に比べて機能が大きく退化したなど) でない場合は、
<literal>critical</literal>
に分類するのを、また多くの人に影響する
(カーネルがパニックしたりフリーズする、
または特定のデバイスドライバやシステムユーティリティに問題がある)
のでなければ、<literal>serious</literal>
あなたの問題が本当に致命的でない場合は、
<literal>Affects many people</literal>
に分類するのを控えてください。
まったく同じことをやった人があまりに多いため、
まったく同じことをやる人があまりに多いため、
問題の重要性を水増ししても、必ずしも
&os; 開発者がその問題に早くとりかかるわけではありません。
&mdash; 実際、
それが理由でこのフィールドにほとんど注意を払わない開発者もいます。</para>
</listitem>
<listitem>
<para><emphasis>Priority (優先順位):</emphasis>
このフィールドには、
このバグがどの範囲に影響をおよぼしうるかを示します。</para>
&os; 開発者がその問題に早くとりかかるわけではありません。</para>
</listitem>
<listitem>
@ -778,10 +702,7 @@
<filename class="directory">/sbin</filename>, もしくは
<filename class="directory">/usr/sbin</filename> であれば、
それはベースシステムの一部ですので、
<literal>bin</literal> カテゴリを使ってください
(&man.gcc.1; のようないくつかのプログラムでは、
<literal>gnu</literal> カテゴリを使うことになりますが、
今の時点では気にしないでください)。
<literal>bin</literal> カテゴリを使ってください。
このカテゴリには、マニュアルページのセクション 1 または 8
に記述されているすべてが分類されます。</para>
</listitem>
@ -798,16 +719,8 @@
<listitem>
<para>問題がドキュメント (article, book もしくはマニュアルページ)
に関連したものであれば、<literal>docs</literal>
が適切なカテゴリです。</para>
</listitem>
<listitem>
<para>問題が <link
xlink:href="http://www.FreeBSD.org">FreeBSD
ウェブページ</link>
に関連したものであれば、<literal>www</literal>
を選択してください。</para>
またはウェブサイトに関連したものであれば、
<literal>docs</literal> が適切なカテゴリです。</para>
<note>
<para>もし、問題が
@ -852,9 +765,8 @@
<literal>amd64</literal> (この分類には、EMT64 モードで動作する
Intel 互換のコンピュータも含まれます) を選択してください。
通常はあまりよく使われないアーキテクチャには、
<literal>arm</literal>, <literal>ia64</literal>,
<literal>powerpc</literal> および <literal>sparc64</literal>
があります。</para>
<literal>arm</literal>, <literal>ia64</literal> および
<literal>powerpc</literal> があります。</para>
<note>
<para>これらのカテゴリは、<quote>よくわからない</quote>
@ -892,159 +804,8 @@
存在するカテゴリの中から本当に選択すべきものをアドバイスされるかもしれません。</para>
</listitem>
</itemizedlist>
<para>以下に現在の分類一覧を示します (<uri
xlink:href="https://svnweb.freebsd.org/base/head/gnu/usr.bin/send-pr/categories">https://svnweb.freebsd.org/base/head/gnu/usr.bin/send-pr/categories</uri>)
からもってきています)。</para>
<itemizedlist>
<listitem>
<para><literal>advocacy:</literal>
&os; の世間的なイメージに関する問題。
今は用いられません。</para>
</listitem>
<listitem>
<para><literal>amd64:</literal>
AMD64 プラットフォーム固有の問題。</para>
</listitem>
<listitem>
<para><literal>arm:</literal>
ARM プラットフォーム固有の問題。</para>
</listitem>
<listitem>
<para><literal>bin:</literal>
基本システムに含まれるユーザランドプログラムに関する問題。</para>
</listitem>
<listitem>
<para><literal>conf:</literal>
設定ファイルや、既定値などに関する問題。</para>
</listitem>
<listitem>
<para><literal>docs:</literal>
マニュアルページ、オンライン文書に関する問題。</para>
</listitem>
<listitem>
<para><literal>gnu:</literal>
&man.gcc.1; や &man.grep.1; などの、取り込まれた
GNU ソフトウェアに関する問題。</para>
</listitem>
<listitem>
<para><literal>i386:</literal>
&i386; プラットフォーム固有の問題。</para>
</listitem>
<listitem>
<para><literal>ia64:</literal>
ia64 プラットフォーム固有の問題。</para>
</listitem>
<listitem>
<para><literal>java:</literal>
&java; 仮想マシンに関する問題。</para>
</listitem>
<listitem>
<para><literal>kern:</literal>
カーネル、(特定のプラットフォーム用ではない)
デバイスドライバや、
ベースシステムのライブラリにに関する問題。</para>
</listitem>
<listitem>
<para><literal>misc:</literal>
これらの分類に適合しないその他の分類 (なお、
本当にここに分類されるべきものは、
リリースおよびビルドのための基盤をのぞけば、
ほとんどありません。<literal>HEAD</literal>
における一時的なビルドの失敗はここに分類すべきではありません。
また、ここに分類すると見失われやすいです)。</para>
</listitem>
<listitem>
<para><literal>ports:</literal>
Ports Collection に関する問題。</para>
</listitem>
<listitem>
<para><literal>powerpc:</literal>
&powerpc; プラットフォーム固有の問題。</para>
</listitem>
<listitem>
<para><literal>sparc64:</literal>
&sparc64; プラットフォーム固有の問題。</para>
</listitem>
<listitem>
<para><literal>standards:</literal>
標準規格への適合問題。</para>
</listitem>
<listitem>
<para><literal>threads:</literal>
&os; のスレッド実装 (特に &os.current; 上のもの)
に関する問題。</para>
</listitem>
<listitem>
<para><literal>usb:</literal>
&os; の USB 実装に関する問題。</para>
</listitem>
<listitem>
<para><literal>www:</literal>
&os; ウェブサイトへの変更と改善。</para>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<para><emphasis>Class:</emphasis> 以下から一つを選んでください。</para>
<itemizedlist>
<listitem>
<para><literal>sw-bug:</literal>
ソフトウェアのバグ。</para>
</listitem>
<listitem>
<para><literal>doc-bug:</literal>
文書中の間違い。</para>
</listitem>
<listitem>
<para><literal>change-request:</literal>
機能の追加や、既存の機能の変更についての要望。</para>
</listitem>
<listitem>
<para><literal>update:</literal>
ports やその他の寄贈ソフトウェアに対する更新。</para>
</listitem>
<listitem>
<para><literal>maintainer-update:</literal>
あなたが保守している ports の更新。</para>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<para><emphasis>Release:</emphasis>
あなたが動作させている &os; のバージョン。
この項目は入力する必要があります。</para>
</listitem>
</itemizedlist>
<para>最後に、一連の複数行フィールドがあります。</para>
<itemizedlist>
<listitem>
<para><emphasis>Environment (環境):</emphasis>
問題が発生した環境を可能な限り正確に記述すべきです。
@ -1061,54 +822,14 @@
あなたが経験した問題の完全で正確な説明。
開発者が誤解してしまうかもしれないので、
問題の原因について正しく追跡ができたと確信していない限り、
推測は避けるようにしてください。</para>
</listitem>
<listitem>
<para><emphasis>How-To-Repeat:</emphasis>
問題を再現させるために取る必要のある行動の概要。</para>
</listitem>
<listitem>
<para><emphasis>Fix:</emphasis>
できればパッチか、少なくとも回避方法を記述する
(同じ問題を回避する方法として他の人達の助けになるだけではなく、
開発者が問題の原因を理解する役に立つかもしれません) べきですが、
はっきりとしたアイデアがなければ開発者が思索をめぐらすために、
このフィールドは空にしておけば良いでしょう。</para>
推測は避けるようにしてください。
ここには、問題を再現する方法を記述してください。
回避方法をご存知でしたら、それについても記述してください。
この情報は、同じ問題を回避する方法として他の人達の助けになるだけではなく、
開発者が問題の原因を理解する役に立つかもしれません。</para>
</listitem>
</itemizedlist>
</section>
<section xml:id="pr-writing-sending">
<title>障害報告を送信する</title>
<para><link
xlink:href="https://bugs.freebsd.org/bugzilla/enter_bug.cgi">web フォーム</link>
を使っている場合</para>
<para><literal>submit</literal> を押す前に、
そのページに画像で表示されているテキストをフィールドに記入しなければなりません。
この不幸な手順は自動化されたシステムや、
誤りを教えられた人たちによる誤用があったために導入されました。
これは、誰もが嫌う必要悪なのです。
お願いですから、これを取り除くように要望しないでください。</para>
<para>なお、<literal>submit</literal> を押す前に、
どこかにあなたが書いた内容を保存しておくことを
<literal>強く奨めます</literal>。
ユーザがよく出くわす問題に、web ブラウザが、
キャッシュから無効になった画像を表示してしまうというものがあります。
あなたがそういう目に遭ってしまったら、
あなたの報告は拒否されてしまい、
書いたものを失ってしまうでしょう。</para>
<para>何らかの理由で画像が見えない場合は、
ご迷惑をおかけして大変申し訳ありませんが、
障害報告を bugbuster チームに
<email>freebsd-bugbusters@FreeBSD.org</email>
宛で送ってください。</para>
</section>
</section>
<section xml:id="pr-followup">