FreeBSD への貢献

FreeBSD に関わっている中には、プログラマではない人がたくさんいます。 プロジェクトには、文書を書く人、Web デザイナ、サポートを行う人がいます。 貢献するのに必要なのは、時間の投資と学ぶ意欲です。

このセクションで挙げる課題は膨大な時間の投資または FreeBSD のカーネルに関する深い知識、もしくは両方を必要とします。 しかしながら、「週末ハッカー」 に適した立派な課題も数多くあります。

FreeBSD 障害報告一覧では、現在問題となっている障害報告と、 FreeBSD の利用者によって提出された改良の要望すべての一覧を公開しています。 障害報告データベースには、 プログラマ向けと非プログラマ向けの課題が共に含まれています。 open 状態の障害報告を見て、興味を引くものがあるか確かめてください。 なかには、障害報告に対する修正が適切なものであるかどうか単にチェックするだけのとても簡単な作業もあるでしょうし、 ずっと複雑なものや、修正が含まれてすらいないものもあるでしょう。

まず、まだ誰にも割り当てられていない障害報告から作業を始めてください。 もし、誰か他の人に割り当てが決まっているけれども自分が作業可能だ、 という障害報告があれば、作業ができるかどうか、 割り当てられている人に電子メールで問い合わせてください。― 既にテスト用パッチが用意されているかもしれませんし、 より進んだ考えに関して議論ができるかもしれません。

FreeBSD プロジェクトに貢献したい人のために ボランティアのための FreeBSD のプロジェクトとアイディア一覧 も用意されています。 この一覧は常に更新され続けており、それぞれのプロジェクトについて、 プログラマと非プログラマ両方に向けた項目があります。

一般的な技術的関心事に関するアイデアや提案は FreeBSD technical discussions メーリングリスト へメールしてください。同様に、このような事柄に興味のある (そして膨大なメール! に耐えられる) 人は、 FreeBSD technical discussions メーリングリスト に参加すると良いでしょう。 このメーリングリストや他のメーリングリストに関する詳しい情報については FreeBSD ハンドブックを参照してください。

バグを発見したり変更を送付しようとしている場合は 障害報告提出フォーム を使用して報告してください。 バグレポートの各項目を埋めるようにしてください。65KB を超えるのでなければ、 レポート中に直接パッチを入れてくださって結構です。 パッチがソースツリーにすぐ適用できるものならば、 報告の概要に [PATCH] と書いておいてください。 パッチを入れる場合、カット&ペーストはしないで ください。 カット&ペーストではタブがスペースに展開されてパッチが使い物にならなくなってしまいます。 パッチが 20KB を超える場合は、アップロードをする前に、 それらを (gzip(1) や bzip2(1) で) 圧縮することを検討してください。

レポートがファイリングされれば、 バグ報告の確認とトラッキング番号をメールで受け取るはずです。 このトラッキング番号を覚えておき、 問題に関する詳細情報を更新できるようにしてください。

良い障害報告を書く方法については この文書 をご覧ください。

文書の変更は FreeBSD documentation project メーリングリスト が監督しています。 完全な説明は、FreeBSD ドキュメンテーションプロジェクト入門をご覧ください。 他の障害報告と同様の方法で、提案や変更 (どんな些細なものでも歓迎します!) を送ってください。

現存のソースコードへの追加または変更は、 いくらかトリッキーな仕事であり、FreeBSD 開発の現状にあなたがどれだけ通じているかに大きく依存します。 「FreeBSD-CURRENT」 として知られる FreeBSD の特別な継続的リリースがあります。FreeBSD-CURRENT は開発者の積極的な活動の便宜のために、 色々な方法で利用可能になっています。FreeBSD-CURRENT の入手と使用方法についての詳しい情報については FreeBSD ハンドブック を参照してください。

古いソースをもとに作業すると、 残念ながらあなたの変更が時として時代遅れもしくは大きく異なるものになってしまって、 FreeBSD に再統合するのは困難になる恐れがあります。 システムの現状に関する議論がおこなわれている FreeBSD announcements メーリングリスト と FreeBSD-CURRENT メーリングリスト へ参加すれば、この可能性を最小限にできます。

十分新しいソースを変更のベースにできることが確実になったと仮定して、 次のステップは FreeBSD の保守担当者へ送る差分ファイルの生成です。これは diff(1) コマンドを使用しておこないます。

差分ファイルの提出において好ましい diff(1) の形式は、 diff -u により生成される unified diff 形式です。

% diff -u oldfile newfile

または、

% diff -u -r -N olddir newdir

で、指定されたソースファイルまたはディレクトリ階層に対する unified diff 形式の差分が生成されます。

詳しい説明は diff(1) を参照してください。

差分ファイル (patch(1) コマンドでテストできます) を作ったら、それらを FreeBSD に含めてもらうよう障害報告として提出してください。 差分ファイルだけを FreeBSD technical discussions メーリングリスト へ 送ってはいけません。 見過ごされてしまうでしょう。 あなたの提案は大歓迎です (これはボランティアのプロジェクトです!)。 私たちは多忙なのですぐに取りかかれないかもしれませんが、 それまで PR データベースに残っているでしょう。 報告の概要に [PATCH] と書いてあなたの提案を表明してください。

あなたがそうした方がいいと思う場合 (たとえば、 ファイルの追加、削除または名称変更など)、変更を tar ファイルにまとめてください。 shar(1) アーカイブも歓迎します。

たとえば、再配布に適用される著作権の問題に自信がないといった、 あなたの変更が微妙な性質のものである可能性があれば、 障害報告で提出するよりむしろ直接 コアチーム <core@FreeBSD.org> へ送ってください。コアチーム <core@FreeBSD.org> 宛のメールは、 日々の仕事のかなりの割合を FreeBSD に割いている人たちの、 より小さなグループに届きます。 このグループもまたとても忙しいことに注意して、 本当に必要な場合だけコアチームにメールを送るようにしてください。

コーディングスタイルに関して intro(9) および style(9) を参照してください。コードを提出する前には、 少なくともこの情報を意識しておいてくださるようお願いします。

大きな分量の作業成果の貢献や、重要な新しい機能を FreeBSD に追加する場合には、大抵、変更点を tar ファイルにまとめて送るか、ウェブサイトや FTP サイトへアップロードしてアクセスできるようにしなければなりません。 web や FTP サイトが利用できなければ、適切な FreeBSD のメーリングリストで誰かその変更をおくサイトを提供してくれるよう頼んでください。

大量のコードを扱っている時は、 常に著作権に関する微妙な問題が出てきます。 FreeBSD では、BSD または ISC といったフリーソフトウェアライセンスが好まれます。 GPLv2 のようなコピーレフトライセンスも、場合によっては許可されます。 完全なリストが、コアチームライセンスポリシ ページにあります。

私たちは FreeBSD プロジェクトの目的を進めるための寄付を常に喜んで受け入れています。 私たちのようなボランティア活動では、 ちょっとしたことが大いに役立つのです! また一般的に、私たちは自前で周辺機器を買う資金が不足しているため、 周辺機器のサポートを充実させるのにハードウェアの寄付はとても重要です。