- Merge the following from the English version:

r31426 -> r31428	head/ja_JP.eucJP/articles/problem-reports/article.xml
This commit is contained in:
Ryusuke SUZUKI 2013-01-06 01:03:36 +00:00
parent c26bf48f27
commit 03050dbbfe
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=40545

View file

@ -7,7 +7,7 @@
<!--
The FreeBSD Japanese Documentation Project
Original revision: r31426
Original revision: r31428
$FreeBSD$
-->
@ -775,13 +775,132 @@
<para><emphasis>Category (分類):</emphasis>
適切な分類を選んでください。</para>
<note>
<para>ある特定のハードウェアアーキテクチャに特有のバグをいれるための、
"platform" (プラットホーム) 分類がたくさんあります。
&os; の複数のバージョンにまたがる一般的な問題は、
<literal>kern</literal><literal>bin</literal>
に入れるべきでしょう。これらのカテゴリについては、
下記の議論をご覧ください。</para>
<para>まず最初に行わなければならないのは、
あなたの問題がシステムのどの部分に関連しているかを決めることです。
&os; は完全なオペレーティングシステムなので、
カーネル、標準ライブラリの両方、および、
周辺ドライバ、多くのユーティリティ (<quote>ベースシステム</quote>)
をインストールします。
さらに、Ports Collection
には数多くの追加のアプリケーションが用意されています。
そのため、最初に判断しなくてならないのは、
問題がベースシステムに関連しているのか、
それとも Ports Collection からインストールされた何かに関係しているのか、
ということになります。</para>
<para>以下はメジャーなカテゴリについての説明です。</para>
<itemizedlist>
<listitem>
<para>もし、問題がカーネル、(標準 C ライブラリ <literal>libc</literal>)
ライブラリ、またはベースシステムの周辺ドライバで起こるのであれば、
通常は <literal>kern</literal> カテゴリを使うとよいでしょう
(下記に説明するようにいくつかの例外があります)。
一般的に、マニュアルページのセクション 2, 3 もしくは 4
に書かれているようなものがここに分類されます。</para>
</listitem>
<listitem>
<para>問題が &man.sh.1;&man.mount.8;
のようなバイナリプログラムで起きるのであれば、
まず最初に、それらのプログラムがベースシステムのものか、
もしくは Ports Collection から追加されたものなのかを判断してください。
よくわかならければ、
<command>whereis <replaceable>programname</replaceable></command>
と実行してください。
&os; の Ports Collection の慣例では、
(システム管理者は、この設定を変更することができますが) すべてのものは
<filename class="directory">/usr/local</filename>
以下にインストールされます。
このような場合は、<literal>ports</literal> カテゴリを使うことになります
(もし、その port のカテゴリが <literal>www</literal>
であっても当てはまります。説明が下にあります)。
もし、コマンドの場所が
<filename class="directory">/bin</filename>,
<filename class="directory">/usr/bin</filename>,
<filename class="directory">/sbin</filename> もしくは
<filename class="directory">/usr/sbin</filename> であれば、
それはベースシステムの一部ですので、
<literal>bin</literal> カテゴリを使ってください
(&man.gcc.1; のようないくつかのプログラムでは、<literal>gnu</literal>
カテゴリを使うことになりますが、今の時点では気にしないでください)。
このカテゴリには、マニュアルページのセクション 1 または 8
に記述されているすべてが分類されます。</para>
</listitem>
<listitem>
<para>もし、エラーがスタートアップ <literal>(rc)</literal>
スクリプトで起きている、または他の非実行形式の設定ファイルに関連したようなものあれば、
<literal>conf</literal> (configuration) が適切なカテゴリでしょう。
マニュアルページのセクション 5
に書かれている内容がここに分類されます。</para>
</listitem>
<listitem>
<para>問題がドキュメント (article, book もしくはマニュアルページ)
に関連したものであれば、<literal>docs</literal>
が適切なカテゴリです。</para>
</listitem>
<listitem>
<para>問題が
<ulink url="http://www.FreeBSD.org">FreeBSD ウェブページ</ulink>
に関連したものであれば、<literal>www</literal>
を選択してください。</para>
<note>
<para>もし、問題が
<literal>www/<replaceable>someportname</replaceable></literal>
という名前の port に関連したものであっても、
<literal>ports</literal> カテゴリを選択してください。</para>
</note>
</listitem>
</itemizedlist>
<para>さらにいくつかの特別なカテゴリがあります。</para>
<itemizedlist>
<listitem>
<para>問題が <literal>kern</literal> に分類されるようなものでも、
USB サブシステムに関連したものであれば、<literal>usb</literal>
が適切なカテゴリです。</para>
</listitem>
<listitem>
<para>問題が <literal>kern</literal> に分類されるようなものでも、
スレッドのライブラリに関連したものであれば、<literal>threads</literal>
が適切なカテゴリです。</para>
</listitem>
<listitem>
<para>問題がベースシステムに分類されるようなものでも、
&posix; のような標準への準拠に関連したものであれば、
<literal>standards</literal> が適切なカテゴリです。</para>
</listitem>
</itemizedlist>
<para>その他の問題については、以下のカテゴリを使用してください。</para>
<itemizedlist>
<listitem>
<para>問題が、あなたの使っているプロセッサアーキテクチャでのみ起こると確信できるのであれば、
アーキテクチャ固有のカテゴリから選んでください。
良く使われている 32-bit モードの Intel 互換コンピュータは
<literal>i386</literal>, 64-bit モードで動作する AMD マシンの場合は
<literal>amd64</literal> (この分類には、EMT64 モードで動作する
Intel 互換のコンピュータも含まれます) を選択してください。
通常はあまりよく使われないアーキテクチャには、
<literal>arm</literal>, <literal>ia64</literal>,
<literal>powerpc</literal> および <literal>sparc64</literal>
があります。</para>
<note>
<para>これらのカテゴリは、<quote>よくわからない</quote>
問題に対して間違ってよく使われます。
とりあえず推測で選んでしまうのではなく、そのような場合には
<literal>misc</literal> を選んでください。</para>
</note>
<example>
<title>アーキテクチャカテゴリの正しい使い方</title>
@ -801,7 +920,17 @@
この場合は、複数のアーキテクチャに影響する可能性があり、
<literal>kern</literal> がふさわしい分類になります。</para>
</example>
</note>
</listitem>
<listitem>
<para>もし、問題をどの分類に分ければよいのかわからなければ
(上で説明したものに当てはまらなければ)、
<literal>misc</literal> カテゴリを選んでください。
このカテゴリを選択する前に、まず最初に &a.questions; で、
助けを求めてみてください。
存在するカテゴリの中から本当に選択すべきものをアドバイスされるかもしれません。</para>
</listitem>
</itemizedlist>
<para>以下に現在の分類一覧を示します (
<ulink url="http://www.FreeBSD.org/cgi/cvsweb.cgi/src/gnu/usr.bin/send-pr/categories"></ulink>