From e2aeffb46ee16fc993b1dd956c505f7f62e3e52a Mon Sep 17 00:00:00 2001 From: Hideyuki KURASHINA Date: Fri, 24 Sep 2004 17:37:44 +0000 Subject: [PATCH] Merge the following from the English version: 1.1483 -> 1.484 articles/contributing/article.sgml Submitted by: Hiroo Ono References: [doc-jp-work 784, 903] --- .../articles/contributing/article.sgml | 380 ++++++------------ 1 file changed, 132 insertions(+), 248 deletions(-) diff --git a/ja_JP.eucJP/articles/contributing/article.sgml b/ja_JP.eucJP/articles/contributing/article.sgml index c00e8f59ba..3cae761bb9 100644 --- a/ja_JP.eucJP/articles/contributing/article.sgml +++ b/ja_JP.eucJP/articles/contributing/article.sgml @@ -2,7 +2,7 @@ The FreeBSD Documentation Project The FreeBSD Japanese Documentation Project - Original revision: 1.483 + Original revision: 1.484 $FreeBSD$ --> この文書は、個人や団体が FreeBSD - プロジェクトに貢献するためのいくつかの方法について説明しています。 + プロジェクトに貢献するためのいくつかの方法について説明しています。 @@ -73,169 +73,23 @@ 何が必要? - 次のタスクとサブプロジェクトのリストは、コアチームの色々な + 次の課題とサブプロジェクトの一覧は、色々な TODO - リストと最近 2 ヶ月で集めたユーザリクエストを合わせたものです。 - 可能なところでは、緊急度によってタスクがランクづけされています。 - もしここにあるタスクの実行に興味があるのでしたら、 - コーディネータの名前をクリックしてメールを送ってください。 - もしコーディネータが決まっていなければ、 - あなたがボランティアしてみませんか? + リストとユーザからの要求を合わせたものです。 - - 進行中のタスク + + 進行中の非プログラマ向けの課題 - 次のタスクはやっておくべきではありますが、 - 特にさし迫っているわけではありません: + FreeBSD に関わっている中には、プログラマではない人が + たくさんいます。プロジェクトには、文書を書く人、Web デザイナ、 + サポートを行う人がいます。貢献するのに必要なのは、時間の投資と学ぶ + 意欲です。 - - 完全な KLD ベースのドライバのサポート / - コンフィグレーションマネージャ。 - - - - 穏やかな方法でハードウェアを検知するコンフィグレーションマネージャの作成 - (第 3 ステージ・ブートの中に?)。ハードウェアが必要とする - KLD だけを残す等 - - - - - - PCMCIA/PCCARD。コーディネータ: &a.msmith; と &a.imp; - - - - ドキュメンテーション! - - - - pcic ドライバの信頼性のある操作 (テスト要) - - - - sio.c - のリコグナイザとハンドラ (ほぼ完了) - - - - ed.c のリコグナイザとハンドラ - (ほぼ完了) - - - - ep.c のリコグナイザとハンドラ - (ほぼ完了) - - - - User-mode のリコグナイザとハンドラ - (部分的に完了) - - - - - - 先進的なパワーマネージメント。コーディネータ: &a.nate; - と &a.phk; - - - - APM サブドライバ (ほぼ完了) - - - - IDE/ATA ディスクサブドライバ (部分的に完了) - - - - syscons/pcvt サブドライバ - - - - PCMCIA/PCCARD ドライバ群との統合 (サスペンド / - レジューム) - - - - - - - - 優先度の低いタスク - - 次のタスクは全くのあら隠し、 - または誰もすぐにおこないそうもない投資のような仕事を表します: - - 最初の N 項目は Terry Lambert - terry@lambert.org からのものです。 - - - - ネットワークカードと一緒に提供される ODI - カードドライバを使用できるようにする、NetWare サーバ - (プロテクトモードの ODI ドライバ) ローダとサブサービス。 - NDIS ドライバと NetWare の SCSI ドライバについても同様。 - - - - 前のリビジョンの FreeBSD マシンではなく、Linux - マシンで動作する 「アップグレードシステム」オプション。 - - - - カーネルのマルチスレッド化 - (カーネルのプリエンプションが必要)。 - - - - カーネルのプリエンプション付き対称マルチプロセッシング - (カーネルのプリエンプションが必要)。 - - - - ポータブルコンピュータのサポートにおける協調の試み。 - これは PCMCIA - ブリッジング規則と電源管理イベント処理の変更により、 - いくらかは処理できます。しかし、 - 内蔵ディスプレイと外部ディスプレイの検出、この 2 - 種類のディスプレイがあるという事実に基づく異なる解像度の選択、 - マシンがドックにある場合にはディスクのモータ停止を防止すること、 - マシンのブート能力に影響を与えずにドックベースのカードの消滅を可能にすること - (PCMCIA と同じ問題) などの問題があります。 - - - - - - もっと簡単なタスク - - 上のセクションで挙げたタスクは膨大な時間の投資または - FreeBSD のカーネルに関する深い知識を必要とします - (もしくはそのどちらも)。しかしながら、週末ハッカー - やプログラミングのスキルを持たない人々に適した立派なタスクも数多くあります。 - - - - FreeBSD-current を運用しており、 - 状態の良いインターネット接続があるならば、current.FreeBSD.org - という一日に一回フルリリースを行っているマシンがあります - — 時おり最新のリリースをそこからインストールし、 - その過程で何か問題があるなら報告して下さい。 - - - - freebsd-bugs - メーリングリストを読んでください。 - そこではあなたが建設的なコメントを付けたりテストできるパッチが提供されているような問題があるかもしれません。 - もしくはそれらの問題の一つをあなた自身で修正することさえできるかもしれません。 - - 定期的に FAQ とハンドブックを通して読んでみてください。 - もしまずい説明や古い事柄や完全に間違っていることなどがあれば我々に知らせて下さい。 + もしまずい説明や古い事柄や完全に間違っていることなどがあれば + 私達に教えてください。 さらに良いのは我々に修正案を送ることです (SGML は学ぶのにそれほど難しくありませんが、 プレインテキストでも問題はありません)。 @@ -253,7 +107,7 @@ そうすることによってあなたがすべての FreeBSD 文書の翻訳に携わるようになるわけではないですからね。 — ボランティアとして、 - 自分がやろうと思うだけ少しでもたくさんでも :) 活動してください。 + 多少に関わらず、自分がやろうと思うだけやってください。 いったん誰かが翻訳を始めたら、 たくさんの人達がいつだって協力してくれますから。 もし翻訳に費す時間やエネルギーが限られているなら、 @@ -269,6 +123,35 @@ 時にはあなた自身で新しいことを学ぶことさえできるかもしれません。 これらのフォーラムはやるべきことのアイディアの源にもなり得るのです。 + + + + + 進行中のプログラマ向けの課題 + + このセクションで挙げる課題は膨大な時間の投資または + FreeBSD のカーネルに関する深い知識、もしくは両方を必要とします。 + しかしながら、週末ハッカー に適した立派な課題も + 数多くあります。 + + + + FreeBSD-current を運用しており、 + 状態の良いインターネット接続があるならば、 + current.FreeBSD.org + という一日に一回フルリリースを行っているマシンがあります + — 時おり最新のリリースをそこからインストールし、 + その過程で何か問題があるなら報告してください。 + + + + freebsd-bugs + メーリングリストを読んでください。 + そこではあなたが建設的なコメントを付けたりテストできるパッチが + 提供されているような問題があるかもしれません。 + もしくはそれらの問題の一つをあなた自身で + 修正することさえできるかもしれません。 + -current に正しく当てられるがしばらく経っても (通常は @@ -295,7 +178,7 @@ ports で、gets() を使っているとか - malloc.h + malloc.h をインクルードしているなどといった警告が出ないようにしてください。 @@ -306,7 +189,7 @@ - このリストに追加するタスクを提案して下さい! + この一覧に追加する課題を提案してください! @@ -317,43 +200,42 @@ 障害報告 (PR) データベース - FreeBSD 障害報告リストでは、現在問題となっている報告と、 - FreeBSD の利用者によって提出された改良の要望に関するすべてのリストを公開しています。 - open 状態の障害情報を見て、興味を引く内容かどうか確かめて下さい。 - 本当に複雑なものも含まれているでしょうし、 - たとえば、障害報告に対する修正がちゃんとしたものであるかどうか単にチェックするだけのとても簡単な作業もあるでしょう。 + FreeBSD 障害報告一覧では、現在問題となっている障害報告と、 + FreeBSD の利用者によって提出された改良の要望すべての一覧を公開しています。 + 障害報告データベースには、プログラマ向けと非プログラマ向けの + 課題が共に含まれています。 + open 状態の障害報告を見て、興味を引くものがあるか確かめてください。 + なかには、障害報告に対する修正が適切なものであるかどうか単に + チェックするだけのとても簡単な作業もあるでしょうし、ずっと + 複雑なものや、修正が含まれてすらいないものもあるでしょう。 - まず、まだ誰にも割り当てられていない障害報告から作業を始めて下さい。 - もし、誰か他の人に割り当てが決まっているけれども自分が作業可能だ、 - というものがあれば、作業ができるかどうか — - 既にテスト用パッチが用意されているのかどうか、あるいは - その問題についてあなたが考えている、 - より進んだ考えに関して議論ができるかどうか、 - 割り当てられている人に電子メールで問い合わせて下さい。 + まず、まだ誰にも割り当てられていない障害報告から作業を始めてください。 + もし、誰か他の人に割り当てが決まっているけれども自分が作業可能だ、 + という障害報告があれば、作業ができるかどうか — + 既にテスト用パッチが用意されているのかどうか、あるいは + その問題についてあなたが考えている、 + より進んだ考えに関して議論ができるかどうか、 + 割り当てられている人に電子メールで問い合わせてください。 - 貢献の仕方 - 一般的に、システムへの貢献は次の 6 + 一般的に、システムへの貢献は次の 5 つのカテゴリの 1 つ以上に分類されます: バグ報告と一般的な論評 - 報告するべきバグがあったり、提案したいことがあれば: - 一般的な技術的関心事に関するアイデアや提案は - &a.hackers; へメールしてください。同様に、このような事柄に興味のある + &a.hackers; へメールしてください。同様に、このような事柄に興味のある (そして膨大なメール! に耐えられる) 人は、 &a.majordomo; へメールを送って hackers - メーリングリストに参加すると良いでしょう。情報については - - メーリングリスト - を参照してください。 + メーリングリストに参加すると良いでしょう。詳しい情報については + FreeBSD + ハンドブックを参照してください。 バグを発見したり変更を送付しようとしている場合は &man.send-pr.1; プログラムか [PATCH] と書いておいてください。 - その場合、カット＆ペーストはしないでください。 - カット＆ペーストではタブがスペースに展開されてパッチが使い物にならなくなってしまいます。 + パッチを入れる場合、カット&ペーストはしないで + ください。カット&ペーストではタブがスペースに展開されて + パッチが使い物にならなくなってしまいます。 20KB を超える場合は、 それらを compress して &man.uuencode.1; することも検討してください。とても大きくなる場合は ftp://ftp.FreeBSD.org/pub/FreeBSD/incoming/ + url="ftp://ftp.FreeBSD.org/pub/FreeBSD/incoming/">ftp://ftp.FreeBSD.org/pub/FreeBSD/incoming/ を利用してください。 @@ -390,8 +273,8 @@ 誰か代りにバグ報告を送付してもらうようたずねてください。 良い障害報告を書く方法についてはこの文書をご覧ください。 + URL="../problem-reports/article.html">この文書をご覧ください。 @@ -399,8 +282,11 @@ 文書に関する提案 - 文書の変更は &a.doc; が監督しています。バグ報告と一般的な論評 + 文書の変更は &a.doc; が監督しています。 + 完全な説明は、FreeBSD + ドキュメンテーションプロジェクト入門をご覧ください。 + バグ報告と一般的な論評 に記述されているように send-pr コマンドを使用して、提案や変更 (どんな些細なものでも歓迎します!) を送ってください。 @@ -412,14 +298,14 @@ FreeBSD-current 現存のソースコードへの追加または変更は、 - いくらかトリッキーな仕事であり、core の FreeBSD + いくらかトリッキーな仕事であり、FreeBSD 開発の現状にあなたがどれだけ通じているかに大きく依存します。 FreeBSD-current として知られる FreeBSD の特別な継続的リリースがあります。FreeBSD-current は開発者の積極的な活動の便宜のために、 色々な方法で利用可能になっています。FreeBSD-current の入手と使用方法についての詳しい情報についてはFreeBSD ハンドブック + url="../../books/handbook/current-stable.html">FreeBSD ハンドブック を参照してください。 不幸にして古いソースをもとに仕事をすることは、 @@ -429,14 +315,14 @@ &a.current; へ参加することで、 この可能性を最小限にすることができます。 - 完全な最新のソースを変更のベースにできることが確実になったと仮定して、 - 次のステップは FreeBSD + 十分新しいソースを変更のベースにできることが確実になったと仮定して、 + 次のステップは FreeBSD の保守担当者へ送る差分ファイルの生成です。これは &man.diff.1; コマンドを使用しておこないますが、context diff 形式が好まれるようです。たとえば: - diff + diff &prompt.user; diff -c oldfile newfile @@ -445,7 +331,7 @@ &prompt.user; diff -c -r olddir newdir これで指定されたソースファイルまたはディレクトリ階層に対するコンテキスト形式の差分が生成されます。 - 詳しい説明は + 詳しい説明は &man.diff.1; のマニュアルページを参照してください。 差分ファイル (&man.patch.1; コマンドでテストできます) @@ -454,16 +340,15 @@ linkend="contrib-general">バグ報告と一般的な論評 に記述されているように &man.send-pr.1; コマンドを使用してください。差分ファイルだけを &a.hackers; - へ送ってはいけません。途方にくれてしまいます! - 私たちは多忙なので、あなたの提案に大変感謝します - (これはボランティアのプロジェクトです!)。 - すぐに取りかかることはできませんが、処理されるまではちゃんと - PR データベースに残っています。 + へ送ってはいけません。見過ごされてしまうでしょう。 + あなたの提案は大歓迎です (これはボランティアのプロジェクトです!)。 + 私たちは多忙なのですぐに取りかかれないかもしれませんが、 + それまで PR データベースに残っているでしょう。 報告の概要に [PATCH] と書いてあなたの提案を表明してください。 - uuencode + uuencode あなたがそうした方がいいと思う場合 (たとえば、 ファイルの追加、削除または名称変更など)、変更を @@ -471,36 +356,36 @@ プログラムにかけてください。shar アーカイブも歓迎します。 - たとえばあなたがそれ自身のさらなる配布を管理する著作権の問題を良く分かっていないとか、 - 単に厳しいレビューをおこなっておらずリリースする準備ができていないなど、 - あなたの変更が潜在的に不安定な性質を持つものである場合、 - &man.send-pr.1; で送付するよりむしろ &a.core; - へ直接送ってください。コアチームメーリングリスト宛のメールは、 - 日々の仕事のほとんどを FreeBSD でおこなっている人たちの、 + たとえば、再配布に適用される著作権の問題に自信がないとか、 + より厳しいレビューを行わなければどうしてもリリースできない場合など、 + あなたの変更が微妙な性質のものである可能性があれば、 + &man.send-pr.1; で提出するよりむしろ直接 &a.core; + へ送ってください。コアチームメーリングリスト宛のメールは、 + 日々の仕事のかなりの割合を FreeBSD に割いている人たちの、 より小さなグループに届きます。 このグループもまたとても忙しいことに注意して、 - 本当に必要な場合にコアチームの彼らにメールを送るだけにしてください。 + 本当に必要な場合だけコアチームにメールを送るようにしてください。 - コーディングスタイルに関する情報は - &man.intro.9; および &man.style.9; + コーディングスタイルに関して + &man.intro.9; および &man.style.9; を参照してください。コードを提出する前には、 少なくともこの情報を意識しておいてくださるようお願いします。 - 新たなコードやメジャーな付加価値の高いパッケージ + 新たなコードやきわめて付加価値の高いパッケージ - 重要な大きい仕事の寄贈や、重要な新しい機能を - FreeBSD に追加する場合には通常、変更点を tar/uuencode - したファイルにして送るか、それらをウェブサイトや FTP - サイトへアップロードしてアクセスできるようにすることのどちらかが必要になります。 - web や FTP サイトへのアクセスができないときは適切な FreeBSD - のメーリングリストで誰かに変更を受け取って貰ってください。 + 大きな分量の作業成果の貢献や、重要な新しい機能を + FreeBSD に追加する場合には、大抵、変更点を tar ファイルにまとめて + uuencode して送るか、ウェブサイトや FTP サイトへアップロードして + アクセスできるようにしなければなりません。 + web や FTP サイトへが利用できなければ、適切な FreeBSD の + メーリングリストで誰かその変更をおくサイトを提供してくれるよう + 頼んでください。 - 大量のコードをともなった仕事の場合は、 - 常に著作権に関する微妙な問題が出てきます。FreeBSD - に含めるコードのコピーライトとして受け入れることができるのは、 - 以下の二つです。 + 大量のコードを扱っている時は、常に著作権に関する微妙な問題が + 出てきます。FreeBSD に含めるコードの著作権として受け入れることが + できるのは、以下の二つです。 BSD copyright @@ -532,13 +417,13 @@ - これ以外のタイプのコピーライトによる寄贈は、FreeBSD + これ以外のタイプの著作権による寄贈は、FreeBSD へ含めることを考慮する前に注意深いレビューを受けなければなりません。 - 作者が独自のチャネルを通して配布しており、 - そのような変更をおこなうことを常に奨励している場合でも、 - 特に限定的な商用のコピーライトが適用される寄贈は一般に拒否されます。 + 特に限定的な商用の著作権が適用される寄贈は一般に拒否されます。 + しかし、作者が独自の経路でそのような変更を配布することは常に + 奨励されています。 - あなたの作品に BSD スタイル のコピーライトを付けるには、 + あなたの作品に BSD スタイル の著作権を付けるには、 保護したいソースコードファイルすべての一番最初に以下のテキストを入れて、 %% の間を適切な情報に置き換えください。 @@ -575,13 +460,13 @@ THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. /usr/share/examples/etc/bsd-style-copyright - 訳注 + 訳注 - 以下は神田敏広氏より寄贈された bsd-style-copyright - の日本語訳です。 - ソースファイルに含めるものは原文の方であることに注意してご利用ください。 - また、原文との間に趣旨の差異が生じた場合、 - 原文の内容が FreeBSD プロジェクトの意思であるものとします。 + 以下は神田敏広氏より寄贈された bsd-style-copyright + の日本語訳です。 + ソースファイルに含めるものは原文の方であることに注意してご利用ください。 + また、原文との間に趣旨の差異が生じた場合、 + 原文の内容が FreeBSD プロジェクトの意思であるものとします。 @@ -621,23 +506,22 @@ Copyright (C) [年] 金銭、ハードウェアまたはインターネットアクセス - FreeBSD プロジェクトの目的を進めるための寄付や、 - 私たちと同じようなボランティアの細く長い!努力を、 - 私たちは常に喜んで受け入れています。 - また一般的に私たちは自分達で周辺機器を買う資金が不足しているため、 + 私たちは FreeBSD プロジェクトの目的を進めるための寄付を + 常に喜んで受け入れています。私たちのようなボランティア活動では、 + ちょっとしたことが大いに役立つのです! + また一般的に、私たちは自前で周辺機器を買う資金が不足しているため、 周辺機器のサポートを充実させるのにハードウェアの寄付はとても重要です。 資金の寄付 - FreeBSD 財団は、FreeBSD - プロジェクトの目標を推進するために確立された非営利的で税金を免除された財団です。 - 501(c)3 の実体として、財団はコロラド州所得税ならびに、 - アメリカ連邦主義者所得税を一般に免除されています。 - 免税実体への寄付は、 - しばしば有税の連邦政府の所得から差し引くことができます。 + FreeBSD 財団は、FreeBSD プロジェクトの目標を推進するために + 設立された、非営利の、税金を免除された財団です。501(c)3 に + 適合する団体として、財団はアメリカ合衆国連邦所得税ならびに + コロラド州所得税を一般に免除されています。免税団体への寄付は、 + 多くの場合連邦政府の課税対象所得から控除できます。 - 寄付は以下に送ってください。 + 寄付は小切手で以下に送ってください。
The FreeBSD Foundation 7321 Brockway Dr. @@ -646,7 +530,7 @@ Copyright (C) [年]
- 現在、PayPal による寄付の受け付けを + また、寄付の受け付けを PayPal を通じて web 経由でできるようになりました。 寄付をするには、FreeBSD 財団の web サイトを @@ -679,7 +563,7 @@ Copyright (C) [年] - 進行中の受け入れテストのためのハードウェアが必要とされています。 + 進行中の適合性テストのためのハードウェアを必要としています。 新たなリリース毎に適切な逆行テストができるように、 私たちは現在、FreeBSD がサポートするすべてのコンポーネントのテストラボを設置しようとしています。 @@ -693,9 +577,9 @@ Copyright (C) [年] 現在 FreeBSD にサポートされていないハードウェアで、 サポートに追加して欲しいもの。 - 私たちが新しいハードウェアを受けとる前にそのタスクを引き受けてくれる開発者を探す必要があるため、 - その部品を送る前に &a.core; - にコンタクトを取ってください。 + 私たちが新しいハードウェアを受けとる前にその課題を + 引き受けてくれる開発者を探す必要があるため、 + その部品を送る前に &a.core; に連絡してください。