diff --git a/ja_JP.eucJP/articles/contributing/Makefile b/ja_JP.eucJP/articles/contributing/Makefile new file mode 100644 index 0000000000..5d01b02690 --- /dev/null +++ b/ja_JP.eucJP/articles/contributing/Makefile @@ -0,0 +1,19 @@ +# $FreeBSD$ +# Original revision: 1.1 + +DOC?= article + +FORMATS?= html + +INSTALL_COMPRESSED?=gz +INSTALL_ONLY_COMPRESSED?= + +JADEFLAGS+= -V %generate-article-toc% + +SRCS= article.sgml + +NO_TIDY=YES + +DOC_PREFIX?= ${.CURDIR}/../../.. + +.include "${DOC_PREFIX}/share/mk/doc.project.mk" diff --git a/ja_JP.eucJP/articles/contributing/article.sgml b/ja_JP.eucJP/articles/contributing/article.sgml index 44af8a02fe..92a55afcdc 100644 --- a/ja_JP.eucJP/articles/contributing/article.sgml +++ b/ja_JP.eucJP/articles/contributing/article.sgml @@ -1,698 +1,720 @@ + +%man; + %freebsd; + %newsgroups; + +%ja-authors; + +%authors; + %mailing-lists; + +]> + +
+ + FreeBSD への貢献 + + $FreeBSD$ + + + この文書は, 個人や団体が FreeBSD + プロジェクトに貢献するためのいくつかの方法について説明しています. + - - - Jordan - Hubbard - 寄稿: + Jordan + Hubbard + 寄稿: - - - FreeBSD への貢献 + - + 貢献 あなたも何か FreeBSD のために貢献したくなりましたか? 素晴らしい! 私たちは常に支援を受ける用意がありますし, FreeBSD は生き残るためにユーザベースの貢献に頼るようなシステムの一つです. あなたの貢献は感謝されるだけではなく, FreeBSD が成長し続けるために極めて重要なものな のです! 一部の人達が言っているのとは逆に, 貢献を受け付けてもらうために腕利 きのプログラマーになるとか FreeBSD コアチームの人と親友になる必要はありません. FreeBSD プロジェクトの開発は, 多くのそして益々増加する世界中の貢献者達によってなされており, 彼らの年齢, 専門技術分野は多岐に渡ります. そして手の空いている人よりも成されるべき仕事の方が常に多いのです. FreeBSD プロジェクトがカーネルや散在しているユーティリティよりも, オペレーティングシステム環境 (と, そのインストール) に対して責任を持つ ようになったため, 私たちの TODO リストはドキュメンテーション, ベータテスト, 高度に専門化されたタイプのカーネル開発の好例を紹介するなど非常に広い範囲のタスクに渡ります. あなたの技能レベルに関わらず, プロジェクトを支援できることが必ず何かあります! FreeBSD 関連の事業に従事している商業団体が私たちにコンタクトすることも歓迎します. あなたの製品を (FreeBSD 上で) 動作させるには, 特別な拡張が必要ではありませんか? あまりにも風変わりな要求でなければ, それを受け入れる用意が私たちにあるとわかるはずです. 付加価値のある製品ですか? 私たちに知らせてください! 多分私たちは, ある面において共同して作業をすることができるでしょう. フリーソフトウェア界は, ソフトウェアがそのライフサイクルを通してどのように開発され, 売られ, 保守されていくかについて, 既存の仮説に挑戦しています. 少なくとももう一度考慮してみることを私たちは強くお奨めします. 何が必要? 次のタスクとサブプロジェクトのリストは, コアチームの色々な TODO リストと最近2ヶ月で集めたユーザリクエストを合わせたものです. 可能なところでは, 緊急度によってタスクがランクづけされています. もしここにあるタスクの実行に興味があるのでしたら, コーディネータの名前をクリックしてメールを送ってください. もしコーディネータが決まっていなければ, あなたがボランティアしてみませんか? 進行中のタスク 次のタスクはやっておくべきではありますが, 特にさし迫っているわけではありません: 完全な 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 は学ぶのにそれほど難しくありませんが, プレインテキストでも問題はありません). (もしまだないならば) FreeBSD のドキュメントを自分の母国語に翻訳するのを手伝ってください — 作業している人がいるかどうか &a.doc; にメールを送って聞くだけです. とはいっても, そうすることによってあなたが全ての FreeBSD ドキュメントの翻訳に携わるようになるというわけではないですからね — 実際, もっとも翻訳が必要とされているドキュメントはインストール方法です. たまに(もしくは定期的に) freebsd-questions メーリングリストや comp.unix.bsd.freebsd.misc を読んでください. これは, あなたの持っている専門知識を共有したり誰かが抱えている問題を解決するのに非常に有効なものになり得ることです. 時にはあなた自身で新しいことを学ぶことさえできるかもしれません. これらのフォーラムはやるべきことのアイディアの源にもなり得るのです. -current に正しく当てられるがしばらく経っても(通常は 2, 3 週間) -stable に取り込まれてないようなバグフィックスがあるならばコミッターに丁寧に思い出させてください. 寄贈ソフトウェアをソースツリーの src/contrib に移動させてください. src/contrib 以下のコードが最新のものであるか確認してください. 警告を詳細に報告するようにして ソースツリー全体(もしくはその一部)を構築してみてください. そして警告が出ないようにしてください. - ports で, gets() を使っているとか malloc.h + ports で, gets() を使っているとか + malloc.h をインクルードしているなどといった警告が出ないようにしてください. もしなんらかの ports に関わっているなら, あなたのパッチを作者にフィードバックしてください (次のバージョンが出た時にあなたが楽になります). このリストに追加するタスクを提案して下さい! 障害報告 (PR; Problem Report) データベースにおける作業 障害報告 (PR) データベース FreeBSD 障害報告リストでは, 現在問題となっている報告と, FreeBSD の利用者によって提出された改良の要望に関する全てのリストを公開しています. open 状態の障害情報を見て, 興味を引く内容かどうか確かめて下さい. 本当に複雑なものも含まれているでしょうし, 例えば, 障害報告に対する修正がちゃんとしたものであるかどうか単にチェックするだけのとても簡単な作業もあるでしょう. まず, まだ誰にも割り当てられていない障害報告から作業を始めて下さい. もし, 誰か他の人に割り当てが決まっているけれども自分が作業可能だ, というものがあれば, 作業ができるかどうか — 既にテスト用パッチが用意されているのかどうか, あるいは その問題についてあなたが考えている, より進んだ考えに関して議論ができるかどうか, 割り当てられている人に電子メールで問い合わせて下さい. 貢献の仕方 一般的に, システムへの貢献は次の 6 つのカテゴリの1つ以上に分類されます: バグ報告と一般的な論評 報告するべきバグがあったり, 提案したいことがあれば: 一般的な 技術的関心事に関するアイデアや提案は &a.hackers; へメールしてください. 同様に, このような事柄に興味のある (そして膨大なメール! に耐えられる) 人は, &a.majordomo; へメールを送って hackers メーリングリストに参加すると良いでしょう. 情報については - メーリングリスト + + メーリングリスト を参照してください. バグを発見したり変更を送付しようとしている場合は &man.send-pr.1; プログラムか ウェブベースの send-pr を使用して報告してください. バグレポートの各項目を埋めるようにしてください. 65KB を超えるのでなければ, レポート中に直接パッチを入れてくださって結構です. パッチがソースツリーにすぐ適用できるものならば, 報告の概要に [PATCH] と書いておいてください. その場合, カット＆ペーストはしないでください. カット＆ペーストではタブがスペースに展開されてパッチが使い物にならなくなってしまいます. 20KB を超える場合は, それらを compress して &man.uuencode.1; することも検討してください. とても大きくなる場合は ftp://ftp.FreeBSD.org/pub/FreeBSD/incoming/ を利用してください. レポートがファイリングされれば, バグ報告の確認とトラッキング番号をメールで受け取るはずです. このトラッキング番号を覚えておき, 問題に関する詳細情報を bug-followup@FreeBSD.org に - メールで送って更新できるようにしてください. 例えば + メールで送って更新できるようにしてください. たとえば "Re: kern/3377" のように, この番号をサブジェクト行に使用してください. すべてのバグレポートの追加情報は, この方法で送付されなければいけません. もしタイムリに (あなたの電子メール接続形態にもよりますが, 3日から 1週間) 確認を受けとれないとか, 何らかの理由で &man.send-pr.1; コマンドが使用できない場合には, &a.bugs; へメールを送り, 誰か代りにバグ報告を送付してもらうようたずねてください. + + 良い障害報告を書く方法についてはこの文書をご覧ください. 文書の変更 文書に関する提案 文書の変更は &a.doc; が監督しています. バグ報告と一般的な論評 に記述されているように send-pr コマンドを使用して, 提案や変更 (どんな些細なものでも歓迎します!) を送ってください. 現存のソースコードの変更 FreeBSD-current 現存のソースコードへの追加または変更は, いくらかトリッキーな仕事で あり, core の FreeBSD 開発の現状にあなたがどれだけ通じているかに大きく依存します. FreeBSD-currentとして知られる FreeBSD の特別な継続的リリースがあります. FreeBSD-current は開発者の積極的な活動の便宜のために, 色々な方法で利用可能になっています. FreeBSD-current - の入手と使用方法についての詳しい情報については最新の FreeBSD を追いかける + の入手と使用方法についての詳しい情報についてはFreeBSD ハンドブック を参照してください. 不幸にして古いソースをもとに仕事をすることは, 時々あなたの変更が時 代遅れ, または FreeBSD への簡単な再統合に合わなくなっていることを意味します. システムの現状に関する議論がおこなわれている &a.announce; と &a.current; へ参加することで, この可能性を最小限にすることができます. 完全な最新のソースを変更のベースにできることが確実になったと仮定して, 次のステップは FreeBSD の保守担当者へ送る差分ファイルの生成です. これは &man.diff.1; コマンドを使用しておこないますが, context diff形式が好まれるようです. 例えば: diff &prompt.user; diff -c oldfile newfile または &prompt.user; diff -c -r olddir newdir これで指定されたソースファイルまたはディレクトリ階層に対するコンテキスト形式の差分が生成されます. 詳しい説明は &man.diff.1; のマ ニュアルページを参照してください. 差分ファイル (&man.patch.1; コマンドでテストできます) を作ったら, それらを FreeBSD に含めてもらうようメールで送ってください. バグ報告と一般的な論評 に記述されているように &man.send-pr.1; コマンドを使用してください. 差分ファイルだけを &a.hackers; へ送ってはいけません. 途方にくれてしまいます! 私たちは多忙なので, あなたの提案に大変感謝します (これはボランティアのプロジェクトです!). すぐに取りかかることはできませんが, 処理されるまではちゃんと PR データベースに残っています. 報告の概要に [PATCH] - と書いてあなたの提案を表明してください. - + と書いてあなたの提案を表明してください. uuencode あなたがそうした方がいいと思う場合 (例えば, ファイルの追加, 削除または名称変更など), 変更を tar ファイルにまとめ, &man.uuencode.1; プログラムにかけてください. shar アーカイブも歓迎します. - 例えばあなたがそれ自身のさらなる配布を管理するコピーライト問題を良く分かっていないとか, - 単に厳しいレビューをおこなっておらず, - リリースする準備ができていないなど, - あなたの変更が潜在的に不安定な性質をも つものである場合, + 例えばあなたがそれ自身のさらなる配布を管理する著作権の問題を良く分かっていないとか, + 単に厳しいレビューをおこなっておらずリリースする準備ができていないなど, + あなたの変更が潜在的に不安定な性質を持つものである場合, &man.send-pr.1; で送付するよりむしろ &a.core; へ直接送ってください. コアチームメーリングリスト宛のメールは, 日々の仕事のほとんどを FreeBSD でおこなっている人たちの, より小さなグルー プに届きます. このグループもまたとても忙しいことに注意して, 本当に必要な場合にコアチームの彼らにメールを送るだけにしてください. コーディングスタイルに関する情報は &man.intro.9; および &man.style.9; を参照してください. コードを提出する前には, - 少なくともこの情報を意識しておいてくださるようお願いします. - + 少なくともこの情報を意識しておいてくださるようお願いします. 新たなコードやメジャーな付加価値の高いパッケージ 重要な大きい仕事の寄贈や, 重要な新しい機能を - FreeBSD に追加する場合には, 変更点を tar/uuencode - したファイルにして送るか, それらを web や FTP - サイトへアップロードしてアクセスできるようにすることのどちらかが通常必要になります. + FreeBSD に追加する場合には通常, 変更点を tar/uuencode + したファイルにして送るか, それらをウェブサイトや FTP + サイトへアップロードしてアクセスできるようにすることのどちらかが必要になります. web や FTP サイトへのアクセスができないときは適切な FreeBSD のメーリングリストで誰かに変更を受け取って貰ってください. - 大量のコードを伴った仕事の場合, - コピーライトの神経過敏な問題が常に出てきます. FreeBSD + 大量のコードをともなった仕事の場合は, + 常に著作権に関する微妙な問題が出てきます. FreeBSD に含めるコードのコピーライトとして受け入れることができるのは, - 以下の二つです: + 以下の二つです. BSD copyright BSD コピーライト. このコピーライトは権利に縛られない性格と商用企業にとって一般的な魅力をもつために最も好まれます. FreeBSD プロジェクトは商用利用を阻んだりせず, 何かを FreeBSD へ投資する気になった商業関係者による参加を積極的に奨励します. GPLGNU General Public License GNU General Public License GNU一般公有使用許諾, またはGPL. このライセンスはコードを商用目的に使用する場合に余分な努力が求められるため, 私たちにあまり評判が良いというわけではありません. しかし, 私たちは既に GPL 下の高品質なコード (コンパイラ, アセンブラ, テキストフォーマッタ等) の提供を受けており, 私たちは現在それを必要としています. そのため, このライセンスによる新たな貢献を拒絶するというのは愚かなことでしょう. GPL 下のコードはソースツリー の別の部分, 現在のところ /sys/gnu か /usr/src/gnu に入っています. そのため, GPL が問題となるような人は, 誰でも簡単にそれとわかるようになっています. これ以外のタイプのコピーライトによる寄贈は, FreeBSD - へ含めることを考慮する前に, - 注意深いレビューを受けなければなりません. + へ含めることを考慮する前に注意深いレビューを受けなければなりません. 作者が独自のチャネルを通して配布しており, そのような変更をおこなうことを常に奨励している場合でも, 特に限定的な商用のコピーライトが適用される寄贈は一般に拒否されます. - あなたの作品に BSD- - スタイルのコピーライトを付けるには, + あなたの作品に BSD スタイルのコピーライトを付けるには, 保護したいソースコードファイルすべての一番最初に以下のテキストを入れて, %% の間を適切な情報に置き換えください. Copyright (c) %%適切な年%% %%あなたの名前%%, %%あなたの州%% %%郵便番号%%. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer as the first lines of this file unmodified. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. THIS SOFTWARE IS PROVIDED BY %%あなたの名前%% ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL %%あなたの名前%% BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. $Id$ 便宜をはかるため, このテキストのコピーは次の場所に置いてあります. - /usr/share/examples/etc/bsd-style-copyright. - - - (訳注: 以下は神田敏広氏より寄贈された bsd-style-copyright - の日本語訳です. - ソースファイルに含めるものは原文の方であることに注意してご利用ください. - また, 原文との間に趣旨の差異が生じた場合, - 原文の内容が FreeBSD プロジェクトの意思であるものとします.) + /usr/share/examples/etc/bsd-style-copyright. + + + 訳注 + + 以下は神田敏広氏より寄贈された bsd-style-copyright + の日本語訳です. + ソースファイルに含めるものは原文の方であることに注意してご利用ください. + また, 原文との間に趣旨の差異が生じた場合, + 原文の内容が FreeBSD プロジェクトの意思であるものとします. + Copyright (C) [年] [あなたの名前] All rights reserved. ソースとバイナリ形式の再配布および使用は, 変更の有無にかかわらず以下の 条件を満たす場合に限り許可される: 1. ソースコードの再配布は, 上記の著作権表示・この条件のリスト・下記の 否認声明文を保持しなければならない. 2. バイナリ形式の再配布は, 上記の著作権表示・この条件のリスト・下記の 否認声明文を, 配布物と共に提供される文書および/または他の資料の中に 含めなければならない. (訳注:ここから「否認声明文」です) このソフトウェアは[あなたの名前]および貢献者によって ``あるがままの状態'' で提供され, 商品性と特定の目的に対する適合性についての暗黙の保証に留ま らず, いかなる明示および暗黙の保証を認めない. [あなたの名前]および貢献 者は, あらゆる直接的・間接的・偶発的・特殊的・典型的・必然的な損害 (代 替製品または代替サービスの獲得費; 効用・データ・利益の喪失; または業務 中断を含み, またそれだけに留まらない損害) に対して, たとえどのようにし て生じたとしても, そしてこのソフトウェアの使用によってどのようにであれ 生じる, 契約上であろうと, 厳密な責任内であろうと, あるいは不正行為 (過 失やそうでない場合を含む) における場合であろうとも, いかなる責任論上も, たとえそのような損害の可能性が予見されていたとしても, 一切の責任を持た ない. 翻訳: 神田敏広 御協力 (五十音順・敬称略): 池田研二, 内川 喜章, 藤村 英治, むらたしゅういちろう 杢野 雅一, 横田＠宇都宮 金銭, ハードウェアまたはインターネットアクセス FreeBSD プロジェクトの目的を進めるための寄付や, 私たちと同じような ボランティアの細く長い!努力を, 私たちは常に喜んで受け入れています. また一般的に私たちは自分達で周辺機器を買う資金が不足しているため, 周辺機器のサポートを充実させるのにハードウェアの寄付はとても重要です. 資金の寄付 FreeBSD財団は, FreeBSD プロジェクトの目標を推進するために確立された非営利的で税金を免除された財団です. 501(c)3 の実体として, 財団はコロラド州所得税ならびに, アメリカ連邦主義者所得税を一般に免除されています. 免税実体への寄付は, しばしば有税の連邦政府の所得から差し引くことができます. 寄付は以下に送ってください.
The FreeBSD Foundation 7321 Brockway Dr. Boulder, CO 80303 USA
財団はまだクレジットカード, およびPayPalといった他の形式の支払いを受け入れることができません. FreeBSD 財団に関するこれ以上の情報は The FreeBSD Foundation -- an Introduction を見てください. 財団への email での連絡は bod@FreeBSDFoundation.org へどうぞ. ハードウェアの寄贈 寄贈 FreeBSD プロジェクトは, 次の3つのカテゴリのどんなハードウェアの寄贈も, 喜んで受け付けます: ディスクドライブ, メモリまたは完全なシステムといった一般用途のハードウェアは, 資金の寄付の節にある FreeBSD, Inc. の住所まで送っ てください. 進行中の受け入れテストのためのハードウェアが必要とされています. 新たなリリース毎に適切な逆行テストができるように, 私たちは現在, FreeBSD がサポートするすべてのコンポーネントのテストラボを設置しよう としています. 私たちにはまだ, たくさんの重要な部品 (ネットワークカード, マザーボードなど) が不足していますので, このような寄贈をしたいと思っているならば, &a.dg; へコンタクトしてどの部品がまだ必要とされているかの情報を得てください. 現在 FreeBSD にサポートされていないハードウェアで, サポートに追加して欲しいもの. 私たちが新しいハードウェアを受けとる前にそのタスクを引き受けてくれる開発者を探す必要があるため, その部品を送る前に &a.core; にコンタクトを取ってください. インターネットアクセスの寄付 私たちは常に FTP, WWW や cvsup の新しいミラーサイトを募集しています. ミラーサイトになりたい場合には the FreeBSD project administrators hubs@FreeBSD.org にコンタクトを取って, 詳しい情報を手に入れてください. - +