[PATCH 02/75] HOWTO: update ja_JP/HOWTO with latest changes

[Greg Kroah-Hartman]

From: Tsugikazu Shibata <[EMAIL PROTECTED]>

Here is another sync patch of Documentation/ja_JP/HOWTO

Japanese developer sent me some cosmetic changes and also follow
changes of HOWTO
    Cross reference URL (sosdg.org/qiyong/lxr)
    known_regression explanations on kernel dev. process

Signed-off-by: Tsugikazu Shibata <[EMAIL PROTECTED]>
Cc: stable <[EMAIL PROTECTED]>
Signed-off-by: Greg Kroah-Hartman <[EMAIL PROTECTED]>
---
 Documentation/ja_JP/HOWTO |   84 ++++++++++++++++++++++++---------------------
 1 files changed, 45 insertions(+), 39 deletions(-)

diff --git a/Documentation/ja_JP/HOWTO b/Documentation/ja_JP/HOWTO
index 9f08dab..d9d832c 100644
--- a/Documentation/ja_JP/HOWTO
+++ b/Documentation/ja_JP/HOWTO
@@ -1,4 +1,4 @@
-NOTE:
+NOTE:
 This is a version of Documentation/HOWTO translated into Japanese.
 This document is maintained by Tsugikazu Shibata <[EMAIL PROTECTED]>
 and the JF Project team <www.linux.or.jp/JF>.
@@ -11,14 +11,14 @@ for non English (read: Japanese) speakers and is not 
intended as a
 fork. So if you have any comments or updates for this file, please try
 to update the original English file first.
 
-Last Updated: 2007/07/18
+Last Updated: 2007/09/23
 ==================================
 これは、
-linux-2.6.22/Documentation/HOWTO
+linux-2.6.23/Documentation/HOWTO
 の和訳です。
 
 翻訳団体： JF プロジェクト < http://www.linux.or.jp/JF/ >
-翻訳日： 2007/07/16
+翻訳日： 2007/09/19
 翻訳者： Tsugikazu Shibata <tshibata at ab dot jp dot nec dot com>
 校正者： 松倉さん <nbh--mats at nifty dot com>
          小林 雅典さん (Masanori Kobayasi) <zap03216 at nifty dot ne dot 
jp>
@@ -27,6 +27,7 @@ linux-2.6.22/Documentation/HOWTO
          野口さん (Kenji Noguchi) <tokyo246 at gmail dot com>
          河内さん (Takayoshi Kochi) <t-kochi at bq dot jp dot nec dot com>
          岩本さん (iwamoto) <iwamoto.kn at ncos dot nec dot co dot jp>
+         内田さん (Satoshi Uchida) <s-uchida at ap dot jp dot nec dot com>
 ==================================
 
 Linux カーネル開発のやり方
@@ -40,7 +41,7 @@ Linux 
カーネル開発コミュニティと共に活動するやり方を学ã
 手助けになります。
 
 
もし、このドキュメントのどこかが古くなっていた場合には、このドキュメン
-トの最後にリストしたメンテナーにパッチを送ってください。
+トの最後にリストしたメンテナにパッチを送ってください。
 
 はじめに
 ---------
@@ -59,7 +60,7 @@ Linux 
カーネル開発コミュニティと共に活動するやり方を学ã
 
ネル開発者には必要です。アーキテクチャ向けの低レベル部分の開発をするの
 
でなければ、(どんなアーキテクチャでも)アセンブリ(訳注: 
言語)は必要あり
 ません。以下の本は、C 
言語の十分な知識や何年もの経験に取って代わるもの
-ではありませんが、少なくともリファレンスとしてはいい本です。
+ではありませんが、少なくともリファレンスとしては良い本です。
  - "The C Programming Language" by Kernighan and Ritchie [Prentice Hall]
  -『プログラミング言語Ｃ第2版』(B.W. カーニハン/D.M. 
リッチー著 石田晴久訳) [共立出版]
  - "Practical C Programming" by Steve Oualline [O'Reilly]
@@ -76,7 +77,7 @@ Linux 
カーネル開発コミュニティと共に活動するやり方を学ã
 ときどき、カーネルがツールチェインや C 
言語拡張に置いている前提がどう
 
なっているのかわかりにくいことがあり、また、残念なことに決定的なリファ
 レンスは存在しません。情報を得るには、gcc の info 
ページ( info gcc )を
-みてください。
+見てください。
 
 
あなたは既存の開発コミュニティと一緒に作業する方法を学ぼうとしているこ
 
とに留意してください。そのコミュニティは、コーディング、スタイル、
@@ -92,7 +93,7 @@ Linux 
カーネル開発コミュニティと共に活動するやり方を学ã
 
 Linux カーネルのソースコードは GPL 
ライセンスの下でリリースされていま
 
す。ライセンスの詳細については、ソースツリーのメインディレクトリに存在
-する、COPYING 
のファイルをみてください。もしライセンスについてさらに質
+する、COPYING 
のファイルを見てください。もしライセンスについてさらに質
 問があれば、Linux Kernel 
メーリングリストに質問するのではなく、どうぞ
 
法律家に相談してください。メーリングリストの人達は法律家ではなく、法的
 
問題については彼らの声明はあてにするべきではありません。
@@ -109,7 +110,8 @@ Linux 
カーネルソースツリーは幅広い範囲のドキュメントをå
 新しいドキュメントファイルも追加することを勧めます。
 
カーネルの変更が、カーネルがユーザ空間に公開しているインターフェイスの
 
変更を引き起こす場合、その変更を説明するマニュアルページのパッチや情報
-をマニュアルページのメンテナ [EMAIL PROTECTED] 
に送ることを勧めます。
+をマニュアルページのメンテナ [EMAIL PROTECTED] 
に送ることを勧めま
+す。
 
 
以下はカーネルソースツリーに含まれている読んでおくべきファイルの一覧で
 す-
@@ -117,7 +119,7 @@ Linux 
カーネルソースツリーは幅広い範囲のドキュメントをå
   README
     このファイルは 
Linuxカーネルの簡単な背景とカーネルを設定(訳注
     configure )し、生成(訳注 build 
)するために必要なことは何かが書かれ
-    
ています。カーネルに関して初めての人はここからスタートするとよいで
+    
ています。カーネルに関して初めての人はここからスタートすると良いで
     しょう。
 
   Documentation/Changes
@@ -128,7 +130,7 @@ Linux 
カーネルソースツリーは幅広い範囲のドキュメントをå
   Documentation/CodingStyle
     これは Linux 
カーネルのコーディングスタイルと背景にある理由を記述
     
しています。全ての新しいコードはこのドキュメントにあるガイドライン
-    
に従っていることを期待されています。大部分のメンテナーはこれらのルー
+    
に従っていることを期待されています。大部分のメンテナはこれらのルー
     
ルに従っているものだけを受け付け、多くの人は正しいスタイルのコード
     だけをレビューします。
 
@@ -168,16 +170,16 @@ Linux 
カーネルソースツリーは幅広い範囲のドキュメントをå
     支援してください。
 
   Documentation/ManagementStyle
-    このドキュメントは Linux 
カーネルのメンテナー達がどう行動するか、
+    このドキュメントは Linux 
カーネルのメンテナ達がどう行動するか、
     
彼らの手法の背景にある共有されている精神について記述しています。こ
     
れはカーネル開発の初心者なら（もしくは、単に興味があるだけの人でも）
-    
重要です。なぜならこのドキュメントは、カーネルメンテナー達の独特な
+    
重要です。なぜならこのドキュメントは、カーネルメンテナ達の独特な
     行動についての多くの誤解や混乱を解消するからです。
 
   Documentation/stable_kernel_rules.txt
     このファイルはどのように stable 
カーネルのリリースが行われるかのルー
     
ルが記述されています。そしてこれらのリリースの中のどこかで変更を取
-    
り入れてもらいたい場合に何をすればいいかが示されています。
+    
り入れてもらいたい場合に何をすれば良いかが示されています。
 
   Documentation/kernel-docs.txt
 
　　カーネル開発に付随する外部ドキュメントのリストです。もしあなたが
@@ -218,9 +220,9 @@ web 
サイトには、コードの構成、サブシステム、現在存在すã
 
ここには、また、カーネルのコンパイルのやり方やパッチの当て方などの間接
 的な基本情報も記述されています。
 
-あなたがどこからスタートしてよいかわからないが、Linux 
カーネル開発コミュ
+あなたがどこからスタートして良いかわからないが、Linux 
カーネル開発コミュ
 
ニティに参加して何かすることをさがしている場合には、Linux
 kernel
-Janitor's プロジェクトにいけばよいでしょう -
+Janitor's プロジェクトにいけば良いでしょう -
        http://janitor.kernelnewbies.org/
 
ここはそのようなスタートをするのにうってつけの場所です。ここには、
 Linux 
カーネルソースツリーの中に含まれる、きれいにし、修正しなければな
@@ -243,7 +245,7 @@ Linux 
カーネルソースツリーの中に含まれる、きれいにし、ä¿
 自己参照方式で、索引がついた web 
形式で、ソースコードを参照することが
 
できます。この最新の素晴しいカーネルコードのリポジトリは以下で見つかり
 ます-
-       http://sosdg.org/~coywolf/lxr/
+       http://sosdg.org/~qiyong/lxr/
 
 開発プロセス
 -----------------------
@@ -265,9 +267,9 @@ Linux 
カーネルの開発プロセスは現在幾つかの異なるメインã‚
 以下のとおり-
 
   - 
新しいカーネルがリリースされた直後に、2週間の特別期間が設けられ、
-    この期間中に、メンテナー達は Linus 
に大きな差分を送ることができま
-    す。このような差分は通常 -mm 
カーネルに数週間含まれてきたパッチで
-    す。 大きな変更は 
git(カーネルのソース管理ツール、詳細は
+    この期間中に、メンテナ達は Linus 
に大きな差分を送ることができます。
+    このような差分は通常 -mm 
カーネルに数週間含まれてきたパッチです。
+    大きな変更は git(カーネルのソース管理ツール、詳細は
     http://git.or.cz/  参照) 
を使って送るのが好ましいやり方ですが、パッ
     チファイルの形式のまま送るのでも十分です。
 
@@ -285,6 +287,10 @@ Linux 
カーネルの開発プロセスは現在幾つかの異なるメインã‚
     
に安定した状態にあると判断したときにリリースされます。目標は毎週新
     しい -rc カーネルをリリースすることです。
 
+   - 以下の URL で各 -rc 
リリースに存在する既知の後戻り問題のリスト
+     が追跡されます-
+     http://kernelnewbies.org/known_regressions
+
   - このプロセスはカーネルが 
「準備ができた」と考えられるまで継続しま
     す。このプロセスはだいたい 6週間継続します。
 
@@ -331,8 +337,8 @@ Andrew 
は個別のサブシステムカーネルツリーとパッチを全てé
 linux-kernel 
メーリングリストで収集された多数のパッチと同時に一つにま
 とめます。
 
このツリーは新機能とパッチが検証される場となります。ある期間の間パッチ
-が -mm に入って価値を証明されたら、Andrew 
やサブシステムメンテナが、メ
-インラインへ入れるように Linus にプッシュします。
+が -mm に入って価値を証明されたら、Andrew 
やサブシステムメンテナが、
+メインラインへ入れるように Linus にプッシュします。
 
 メインカーネルツリーに含めるために Linus 
に送る前に、すべての新しいパッ
 チが -mm ツリーでテストされることが強く推奨されます。
@@ -460,7 +466,7 @@ MAINTAINERS 
ファイルにリストがありますので参照してくださã
 せん-
 
彼らはあなたのパッチの行毎にコメントを入れたいので、そのためにはそうす
 
るしかありません。あなたのメールプログラムが空白やタブを圧縮しないよう
-に確認した方がいいです。最初の良いテストとしては、自分にメールを送って
+に確認した方が良いです。最初の良いテストとしては、自分にメールを送って
 
みて、そのパッチを自分で当ててみることです。もしそれがうまく行かないな
 
ら、あなたのメールプログラムを直してもらうか、正しく動くように変えるべ
 きです。
@@ -507,14 +513,14 @@ MAINTAINERS 
ファイルにリストがありますので参照してくださã
 
とも普通のことです。これはあなたのパッチが受け入れられないということで
 は 
*ありません*、そしてあなた自身に反対することを意味するのでも
 *ありま
 
せん*。単に自分のパッチに対して指摘された問題を全て修正して再送すれば
-いいのです。
+良いのです。
 
 
 カーネルコミュニティと企業組織のちがい
 -----------------------------------------------------------------
 
 
カーネルコミュニティは大部分の伝統的な会社の開発環境とは異ったやり方で
-動いています。以下は問題を避けるためにできるとよいことののリストです-
+動いています。以下は問題を避けるためにできると良いことのリストです-
 
   
あなたの提案する変更について言うときのうまい言い方：
 
@@ -525,7 +531,7 @@ MAINTAINERS 
ファイルにリストがありますので参照してくださã
     - "以下は一連の小さなパッチ群ですが..."
     - "これは典型的なマシンでの性能を向上させます.."
 
-  やめた方がいい悪い言い方：
+  やめた方が良い悪い言い方：
 
     - このやり方で AIX/ptx/Solaris 
ではできたので、できるはずだ
     - 私はこれを20年もの間やってきた、だから
@@ -575,10 +581,10 @@ Linux 
カーネルコミュニティは、一度に大量のコードの塊をå–
 
 1) 
小さいパッチはあなたのパッチが適用される見込みを大きくします、カー
    
ネルの人達はパッチが正しいかどうかを確認する時間や労力をかけないか
-   
らです。5行のパッチはメンテナがたった1秒見るだけで適用できます。し
-   
かし、500行のパッチは、正しいことをレビューするのに数時間かかるかも
-   
しれません(時間はパッチのサイズなどにより指数関数に比例してかかりま
-   す)
+   
らです。5行のパッチはメンテナがたった1秒見るだけで適用できます。
+   
しかし、500行のパッチは、正しいことをレビューするのに数時間かかるか
+   
もしれません(時間はパッチのサイズなどにより指数関数に比例してかかり
+   ます)
 
    
小さいパッチは何かあったときにデバッグもとても簡単になります。パッ
    
チを1個1個取り除くのは、とても大きなパッチを当てた後に(かつ、何かお
@@ -587,23 +593,23 @@ Linux 
カーネルコミュニティは、一度に大量のコードの塊をå–
 2) 
小さいパッチを送るだけでなく、送るまえに、書き直して、シンプルにす
    
る(もしくは、単に順番を変えるだけでも)ことも、とても重要です。
 
-以下はカーネル開発者の Al Viro のたとえ話しです：
+以下はカーネル開発者の Al Viro のたとえ話です：
 
         
"生徒の数学の宿題を採点する先生のことを考えてみてください、先
-        
生は生徒が解に到達するまでの試行錯誤をみたいとは思わないでしょ
-        
う。先生は簡潔な最高の解をみたいのです。良い生徒はこれを知って
+        
生は生徒が解に到達するまでの試行錯誤を見たいとは思わないでしょ
+        
う。先生は簡潔な最高の解を見たいのです。良い生徒はこれを知って
         
おり、そして最終解の前の中間作業を提出することは決してないので
         す"
 
-        
カーネル開発でもこれは同じです。メンテナー達とレビューア達は、
-        
問題を解決する解の背後になる思考プロセスをみたいとは思いません。
-        彼らは単純であざやかな解決方法をみたいのです。
+        
カーネル開発でもこれは同じです。メンテナ達とレビューア達は、
+        
問題を解決する解の背後になる思考プロセスを見たいとは思いません。
+        彼らは単純であざやかな解決方法を見たいのです。
 
 
あざやかな解を説明するのと、コミュニティと共に仕事をし、未解決の仕事を
 
議論することのバランスをキープするのは難しいかもしれません。
 
ですから、開発プロセスの早期段階で改善のためのフィードバックをもらうよ
-うにするのもいいですが、変更点を小さい部分に分割して全体ではまだ完成し
-ていない仕事を(部分的に)取り込んでもらえるようにすることもいいことです。
+うにするのも良いですが、変更点を小さい部分に分割して全体ではまだ完成し
+ていない仕事を(部分的に)取り込んでもらえるようにすることも良いことです。
 
 また、でき上がっていないものや、"将来直す" 
ようなパッチを、本流に含め
 
てもらうように送っても、それは受け付けられないことを理解してください。
@@ -629,7 +635,7 @@ Linux 
カーネルコミュニティは、一度に大量のコードの塊をå–
   - テスト結果
 
 
これについて全てがどのようにあるべきかについての詳細は、以下のドキュメ
-ントの ChangeLog セクションをみてください-
+ントの ChangeLog セクションを見てください-
   "The Perfect Patch"
       http://www.zip.com.au/~akpm/linux/patches/stuff/tpp.txt
 
-- 
1.5.3.4

-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to [EMAIL PROTECTED]
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/