Merge the following from the English version:

1.484 -> 1.503 articles/contributing/article.sgml Submitted by: Hiroo Ono <hiroo at oikumene dot gcd dot org> Reference: [doc-jp-work 971]
svn path=/head/; revision=22827
2004-11-07 07:08:39 +00:00 · 2004-11-07 07:08:39 +00:00 · 17790d9cd7 · 2020-12-08 03:00:23 +00:00
commit 17790d9cd7
parent 25700709b7
1 changed files with 72 additions and 79 deletions
--- 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.484
+     Original revision: 1.503
     $FreeBSD$
 -->
 <!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
@ -29,6 +29,13 @@
 	<contrib>寄稿: </contrib>
      </author>
    </authorgroup>
+
+    <legalnotice id="trademarks" role="trademarks">
+      &tm-attrib.freebsd;
+      &tm-attrib.ieee;
+      &tm-attrib.general;
+    </legalnotice>
+
  </articleinfo>

  <!-- <para><emphasis>訳: &a.jp.iwasaki;,
@ -101,7 +108,7 @@
 	    文書がすでに存在すれば、もっと文書を翻訳したり、
 	    その翻訳が最新の状態かどうか確認するのを手伝うことができます。
 	    まず FreeBSD ドキュメンテーションプロジェクト入門の <ulink
-	      url="../../books/fdp-primer/translations.html">翻訳に関する
+	      url="&url.books.fdp-primer;/translations.html">翻訳に関する
 	    FAQ (よくある質問とその答え)</ulink> を一読してください。
 	    とはいっても、
 	    そうすることによってあなたがすべての FreeBSD
@ -116,8 +123,8 @@
 	</listitem>

 	<listitem>
-	  <para>たまに (もしくは定期的に) freebsd-questions
-	    メーリングリストや &ng.misc; を読んでください。
+	  <para>たまに (もしくは定期的に)
+	    &a.questions; や &ng.misc; を読んでください。
 	    これは、あなたの持っている専門知識を共有したり、
 	    誰かが抱えている問題を解決するのに非常に有効なものになり得ることです。
 	    時にはあなた自身で新しいことを学ぶことさえできるかもしれません。
@ -136,7 +143,7 @@

      <orderedlist>
 	<listitem>
-	  <para>FreeBSD-current を運用しており、
+	  <para>FreeBSD-CURRENT を運用しており、
 	    状態の良いインターネット接続があるならば、
 	    <hostid role="fqdn">current.FreeBSD.org</hostid>
 	    という一日に一回フルリリースを行っているマシンがあります
@ -145,8 +152,7 @@
 	</listitem>

 	<listitem>
-	  <para>freebsd-bugs
-	    メーリングリストを読んでください。
+	  <para>&a.bugs; を読んでください。
 	    そこではあなたが建設的なコメントを付けたりテストできるパッチが
 	    提供されているような問題があるかもしれません。
 	    もしくはそれらの問題の一つをあなた自身で
@ -154,8 +160,8 @@
 	</listitem>

 	<listitem>
-	  <para>-current に正しく当てられるがしばらく経っても (通常は
-	    2、3 週間) -stable
+	  <para>-CURRENT に正しく当てられるがしばらく経っても (通常は
+	    2, 3 週間) -STABLE
 	    に取り込まれてないようなバグフィックスがあるならばコミッターに丁寧に思い出させてください。</para>
 	</listitem>

@ -188,6 +194,20 @@
 	    (次のバージョンが出た時にあなたが楽になります)。</para>
 	</listitem>

+	<listitem>
+	  <para>&posix; のような公式標準の写しを入手してください。
+	    <ulink
+	      url="&url.base;/projects/c99/index.html">FreeBSD
+	      C99 & POSIX 標準適合プロジェクト</ulink>のウェブサイトに、
+	    そういった標準へのリンクがいくつかあります。FreeBSD の挙動を
+	    標準が要求するものと比較してください。挙動が異なる場合、
+	    特にそれが仕様の取るに足らなかったり分かりにくい細かい部分なら、
+	    障害報告を提出してください。できればどう修正すべきか明らかにして、
+	    障害報告にパッチをつけてください。標準が間違っていると感じたら、
+	    標準化団体にその疑問を糺してください。
+	  </para>
+	</listitem>
+
 	<listitem>
 	  <para>この一覧に追加する課題を提案してください!</para>
 	</listitem>
@ -199,8 +219,8 @@

      <indexterm><primary>障害報告 (PR) データベース</primary></indexterm>

-      <para><ulink url="http://www.FreeBSD.org/cgi/query-pr-summary.cgi">
-	FreeBSD 障害報告一覧</ulink>では、現在問題となっている障害報告と、
+      <para><ulink url="&url.base;/cgi/query-pr-summary.cgi">FreeBSD
+	  障害報告一覧</ulink>では、現在問題となっている障害報告と、
 	FreeBSD の利用者によって提出された改良の要望すべての一覧を公開しています。
 	障害報告データベースには、プログラマ向けと非プログラマ向けの
 	課題が共に含まれています。
@ -232,14 +252,14 @@
      <para><emphasis>一般的な</emphasis>技術的関心事に関するアイデアや提案は
 	&a.hackers; へメールしてください。同様に、このような事柄に興味のある
 	(そして<emphasis>膨大な</emphasis>メール!  に耐えられる) 人は、
-	  &a.majordomo; へメールを送って hackers
-	メーリングリストに参加すると良いでしょう。詳しい情報については
-	<ulink url="../../books/handbook/eresources.html#ERESOURCES-MAIL">FreeBSD
-	ハンドブック</ulink>を参照してください。</para>
+	&a.hackers; に参加すると良いでしょう。
+	このメーリングリストや他のメーリングリストに関する詳しい情報については
+	<ulink url="&url.books.handbook;/eresources.html#ERESOURCES-MAIL">FreeBSD
+	  ハンドブック</ulink>を参照してください。</para>

      <para>バグを発見したり変更を送付しようとしている場合は
 	&man.send-pr.1; プログラムか <ulink
-	  url="../../../../ja/send-pr.html">ウェブベースの
+	  url="&url.base;/ja/send-pr.html">ウェブベースの
 	  send-pr</ulink> を使用して報告してください。
 	バグレポートの各項目を埋めるようにしてください。65KB
 	を超えるのでなければ、
@ -251,15 +271,12 @@
 	パッチが使い物にならなくなってしまいます。
 	20KB を超える場合は、
 	それらを compress して &man.uuencode.1;
-	することも検討してください。とても大きくなる場合は <ulink
-	url="ftp://ftp.FreeBSD.org/pub/FreeBSD/incoming/">ftp://ftp.FreeBSD.org/pub/FreeBSD/incoming/</ulink>
-	を利用してください。
-      </para>
+	することも検討してください。</para>

      <para>レポートがファイリングされれば、
 	バグ報告の確認とトラッキング番号をメールで受け取るはずです。
 	このトラッキング番号を覚えておき、問題に関する詳細情報を
-	<email>bug-followup@FreeBSD.org</email> に
+	<email>FreeBSD-gnats-submit@FreeBSD.org</email> に
 	メールで送って更新できるようにしてください。たとえば
 	<literal>"Re: kern/3377"</literal> のように、
 	この番号をサブジェクト行に使用してください。
@ -273,7 +290,7 @@
 	誰か代りにバグ報告を送付してもらうようたずねてください。</para>

      <para>良い障害報告を書く方法については<ulink
-	URL="../problem-reports/article.html">この文書</ulink
+	URL="&url.articles.problem-reports;/article.html">この文書</ulink
 	>をご覧ください。</para>
    </sect2>

@ -284,10 +301,10 @@

      <para>文書の変更は &a.doc; が監督しています。
 	完全な説明は、<ulink
-	url="../../books/fdp-primer/index.html">FreeBSD
+	url="&url.books.fdp-primer;/index.html">FreeBSD
 	ドキュメンテーションプロジェクト入門</ulink>をご覧ください。
 	<link linkend="contrib-general">バグ報告と一般的な論評</link>
-	に記述されているように <command>send-pr</command>
+	に記述されているように &man.send-pr.1;
 	コマンドを使用して、提案や変更
 	(どんな些細なものでも歓迎します!) を送ってください。</para>
    </sect2>
@ -295,44 +312,48 @@
    <sect2>
      <title>現存のソースコードの変更</title>

-      <indexterm><primary>FreeBSD-current</primary></indexterm>
+      <indexterm><primary>FreeBSD-CURRENT</primary></indexterm>

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

-      <para>不幸にして古いソースをもとに仕事をすることは、
-	時々あなたの変更が時代遅れ、または FreeBSD
-	への簡単な再統合に合わなくなっていることを意味します。
+      <para>古いソースをもとに作業すると、残念ながらあなたの変更が
+	時として時代遅れもしくは大きく異なるものになってしまって、
+	FreeBSD に再統合するのは困難になる恐れがあります。
 	システムの現状に関する議論がおこなわれている &a.announce; と
-	&a.current; へ参加することで、
-	この可能性を最小限にすることができます。</para>
+	&a.current; へ参加すれば、この可能性を最小限にできます。</para>

      <para>十分新しいソースを変更のベースにできることが確実になったと仮定して、
 	次のステップは FreeBSD
 	の保守担当者へ送る差分ファイルの生成です。これは &man.diff.1;
-	コマンドを使用しておこないますが、<quote>context
-	diff</quote> 形式が好まれるようです。たとえば:</para>
+	コマンドを使用しておこないます。</para>

      <indexterm>
 	<primary><command>diff</command></primary>
      </indexterm>
-      <screen>&prompt.user; <userinput>diff -c oldfile newfile</userinput></screen>

-      <para>または</para>
+      <para>たとえば、
+	<screen>&prompt.user; <userinput>diff -c oldfile newfile</userinput></screen>
+	または
+	<screen>&prompt.user; <userinput>diff -c -r olddir newdir</userinput></screen>
+	で、指定されたソースファイルまたはディレクトリ階層に対する
+	コンテキスト形式の差分が生成されます。</para>

-      <screen>&prompt.user; <userinput>diff -c -r olddir newdir</userinput></screen>
+      <para>同様に、
+	<screen>&prompt.user; <userinput>diff -u oldfile newfile</userinput></screen>
+	または、
+	<screen>&prompt.user; <userinput>diff -u -r olddir newdir</userinput></screen>
+	で、unified diff 形式である以外は同じ結果が得られます。</para>

-      <para>これで指定されたソースファイルまたはディレクトリ階層に対するコンテキスト形式の差分が生成されます。
-	詳しい説明は
-	&man.diff.1; のマニュアルページを参照してください。</para>
+      <para>詳しい説明は &man.diff.1; のマニュアルページを参照してください。</para>

      <para>差分ファイル (&man.patch.1; コマンドでテストできます)
 	を作ったら、それらを FreeBSD
@ -353,14 +374,14 @@
      <para>あなたがそうした方がいいと思う場合 (たとえば、
 	ファイルの追加、削除または名称変更など)、変更を
 	<command>tar</command> ファイルにまとめ、&man.uuencode.1;
-	プログラムにかけてください。shar
+	プログラムにかけてください。&man.shar.1;
 	アーカイブも歓迎します。</para>

      <para>たとえば、再配布に適用される著作権の問題に自信がないとか、
 	より厳しいレビューを行わなければどうしてもリリースできない場合など、
 	あなたの変更が微妙な性質のものである可能性があれば、
 	&man.send-pr.1; で提出するよりむしろ直接 &a.core;
-	へ送ってください。コアチームメーリングリスト宛のメールは、
+	へ送ってください。&a.core; 宛のメールは、
 	日々の仕事のかなりの割合を FreeBSD に割いている人たちの、
 	より小さなグループに届きます。
 	このグループもまた<emphasis>とても忙しい</emphasis>ことに注意して、
@ -426,7 +447,7 @@
      <para>あなたの作品に <quote>BSD スタイル</quote> の著作権を付けるには、
 	保護したいソースコードファイルすべての一番最初に以下のテキストを入れて、
 	<literal>%%</literal>
-	の間を適切な情報に置き換えください。</para>
+	の間を適切な情報に置き換えてください。</para>

      <programlisting>Copyright (c) %%適切な年%%
 	%%あなたの名前%%, %%あなたの州%%  %%郵便番号%%.
@ -550,38 +571,9 @@ Copyright (C) [ǯ]

  <indexterm><primary>寄贈</primary></indexterm>

-	<para>FreeBSD プロジェクトは、
-	  次の 3 つのカテゴリのどんなハードウェアの寄贈も、
-	  喜んで受け付けます:</para>
-
-	<itemizedlist>
-	  <listitem>
-	    <para>ディスクドライブ、
-	      メモリまたは完全なシステムといった一般用途のハードウェアは、
-	      <emphasis>資金の寄付</emphasis>の節にある
-	      FreeBSD, Inc. の住所まで送ってください。</para>
-	  </listitem>
-
-	  <listitem>
-	    <para>進行中の適合性テストのためのハードウェアを必要としています。
-	      新たなリリース毎に適切な逆行テストができるように、
-	      私たちは現在、FreeBSD
-	      がサポートするすべてのコンポーネントのテストラボを設置しようとしています。
-	      私たちにはまだ、
-	      たくさんの重要な部品 (ネットワークカード、
-	      マザーボードなど) が不足していますので、
-	      このような寄贈をしたいと思っているならば、&a.dg;
-	      へコンタクトしてどの部品がまだ必要とされているかの情報を得てください。</para>
-	  </listitem>
-
-	  <listitem>
-	    <para>現在 FreeBSD にサポートされていないハードウェアで、
-	      サポートに追加して欲しいもの。
-	      私たちが新しいハードウェアを受けとる前にその課題を
-	      引き受けてくれる開発者を探す必要があるため、
-	      その部品を送る前に &a.core; に連絡してください。</para>
-	  </listitem>
-	</itemizedlist>
+	<para>FreeBSD プロジェクトは適切な使い道のあるハードウェアの
+	  寄付を喜んで受け入れています。ハードウェアを寄贈しようとしているなら、
+	  <ulink url="&url.base;/donations/">寄贈品受付事務局</ulink>に連絡してください。</para>
      </sect3>

      <sect3>
@ -589,8 +581,9 @@ Copyright (C) [ǯ]

 	<para>私たちは常に FTP、WWW や <command>cvsup</command>
 	  の新しいミラーサイトを募集しています。
-	  ミラーサイトになりたい場合には &a.hubs;
-	  にコンタクトを取って、詳しい情報を手に入れてください。</para>
+	  ミラーサイトになりたい場合には <ulink
+	    url="&url.articles.hubs;/index.html">Mirroring FreeBSD</ulink>
+	  を見て、詳しい情報を手に入れてください。</para>
      </sect3>
    </sect2>
  </sect1>