os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Add the chapter repo-copied from books/handbook/contrib/chapter.sgml

Browse source 
as a doc in articles/ and activate it:

	(new) -> 1.1  	Makefile
	1.469 -> 1.473	contributing/article.sgml
This commit is contained in:
Hiroki Sato 2001-11-24 21:11:17 +00:00
parent 7d8fc7d0ac
commit c264f50ea4
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=11291
2 changed files with 85 additions and 44 deletions
ja_JP.eucJP/articles/contributing
Makefilearticle.sgml

19
ja_JP.eucJP/articles/contributing/Makefile Normal file
View file

@ -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"

110
ja_JP.eucJP/articles/contributing/article.sgml
View file

@ -2,26 +2,46 @@
The FreeBSD Documentation Project
The FreeBSD Japanese Documentation Project
Original revision: 1.469
Original revision: 1.473
$FreeBSD$
-->
<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN">
%man;
<!ENTITY % freebsd PUBLIC "-//FreeBSD//ENTITIES DocBook Miscellaneous
FreeBSD Entities//EN"> %freebsd;
<!ENTITY % newsgroups PUBLIC "-//FreeBSD//ENTITIES DocBook Newsgroup Entities//EN"> %newsgroups;
<!ENTITY % ja-authors PUBLIC "-//FreeBSD//ENTITIES DocBook Author Entities//JA">
%ja-authors;
<!ENTITY % authors PUBLIC "-//FreeBSD//ENTITIES DocBook Author Entities//EN">
%authors;
<!ENTITY % mailing-lists PUBLIC "-//FreeBSD//ENTITIES DocBook Mailing List Entities//JA"> %mailing-lists;
<!ENTITY % not.published "IGNORE">
]>
<article>
<articleinfo>
<title>FreeBSD への貢献</title>
<pubdate>$FreeBSD$</pubdate>
<abstract>
<para>この文書は, 個人や団体が FreeBSD
プロジェクトに貢献するためのいくつかの方法について説明しています.</para>
</abstract>
<chapter id="contrib">
<chapterinfo>
<authorgroup>
<author>
<firstname>Jordan</firstname>
<surname>Hubbard</surname>
<contrib>寄稿: </contrib>
<firstname>Jordan</firstname>
<surname>Hubbard</surname>
<contrib>寄稿: </contrib>
</author>
</authorgroup>
</chapterinfo>
<title>FreeBSD への貢献</title>
</articleinfo>
<!-- <para><emphasis>訳: &a.jp.iwasaki;,
1997 年 4 月 27 日.</emphasis></para> -->
<indexterm><primary>貢献</primary></indexterm>
<para>あなたも何か FreeBSD のために貢献したくなりましたか?
素晴らしい! 私たちは常に支援を受ける用意がありますし, FreeBSD
@ -204,7 +224,7 @@
<para>上のセクションで挙げたタスクは膨大な時間の投資または
FreeBSD のカーネルに関する深い知識を必要とします
(もしくはそのどちらも). しかしながら,
&quot;週末ハッカー&quot;やプログラミングのスキルを持たない人々に適した立派なタスクも数多くあります.</para>
<quote>週末ハッカー</quote>やプログラミングのスキルを持たない人々に適した立派なタスクも数多くあります.</para>
<orderedlist>
<listitem>
@ -276,7 +296,8 @@
</listitem>
<listitem>
<para>ports で, gets() を使っているとか malloc.h
<para>ports で, <function>gets()</function> を使っているとか
<filename>malloc.h</filename>
をインクルードしているなどといった警告が出ないようにしてください.</para>
</listitem>
@ -333,7 +354,8 @@
(そして<emphasis>膨大な</emphasis>メール! に耐えられる) 人は,
&a.majordomo; へメールを送って hackers
メーリングリストに参加すると良いでしょう. 情報については
<link linkend="eresources-mail">メーリングリスト</link>
<ulink url="../../books/handbook/eresources.html#ERESOURCES-MAIL">
メーリングリスト</ulink>
を参照してください.</para>
<para>バグを発見したり変更を送付しようとしている場合は
@ -358,7 +380,7 @@
バグ報告の確認とトラッキング番号をメールで受け取るはずです.
このトラッキング番号を覚えておき, 問題に関する詳細情報を
<email>bug-followup@FreeBSD.org</email> に
メールで送って更新できるようにしてください. 例えば
メールで送って更新できるようにしてください. たとえば
<literal>"Re: kern/3377"</literal> のように,
この番号をサブジェクト行に使用してください.
すべてのバグレポートの追加情報は,
@ -369,6 +391,10 @@
&man.send-pr.1; コマンドが使用できない場合には, &a.bugs;
へメールを送り,
誰か代りにバグ報告を送付してもらうようたずねてください.</para>
<para>良い障害報告を書く方法については<ulink
URL="../../../en_US.ISO8859-1/articles/problem-reports/article.html">この文書</ulink
>をご覧ください.</para>
</sect2>
<sect2>
@ -395,8 +421,8 @@
の特別な継続的リリースがあります. FreeBSD-current
は開発者の積極的な活動の便宜のために,
色々な方法で利用可能になっています. FreeBSD-current
の入手と使用方法についての詳しい情報については<link
linkend="current">最新の FreeBSD を追いかける</link>
の入手と使用方法についての詳しい情報については<ulink
url="../../books/handbook/current-stable.html">FreeBSD ハンドブック</ulink>
を参照してください.</para>
<para>不幸にして古いソースをもとに仕事をすることは,
@ -437,8 +463,7 @@
すぐに取りかかることはできませんが, 処理されるまではちゃんと
PR データベースに残っています.
報告の概要に <literal>[PATCH]</literal>
と書いてあなたの提案を表明してください.
</para>
と書いてあなたの提案を表明してください.</para>
<indexterm>
<primary><command>uuencode</command></primary>
@ -449,10 +474,9 @@
プログラムにかけてください. shar
アーカイブも歓迎します.</para>
<para>例えばあなたがそれ自身のさらなる配布を管理するコピーライト問題を良く分かっていないとか,
単に厳しいレビューをおこなっておらず,
リリースする準備ができていないなど,
あなたの変更が潜在的に不安定な性質をも つものである場合,
<para>例えばあなたがそれ自身のさらなる配布を管理する著作権の問題を良く分かっていないとか,
単に厳しいレビューをおこなっておらずリリースする準備ができていないなど,
あなたの変更が潜在的に不安定な性質を持つものである場合,
&man.send-pr.1; で送付するよりむしろ &a.core;
へ直接送ってください. コアチームメーリングリスト宛のメールは,
日々の仕事のほとんどを FreeBSD でおこなっている人たちの,
@ -463,24 +487,23 @@
<para>コーディングスタイルに関する情報は
&man.intro.9; および &man.style.9;
を参照してください. コードを提出する前には,
少なくともこの情報を意識しておいてくださるようお願いします.
</para>
少なくともこの情報を意識しておいてくださるようお願いします.</para>
</sect2>
<sect2>
<title>新たなコードやメジャーな付加価値の高いパッケージ</title>
<para>重要な大きい仕事の寄贈や, 重要な新しい機能を
FreeBSD に追加する場合には, 変更点を tar/uuencode
したファイルにして送るか, それらを web や FTP
サイトへアップロードしてアクセスできるようにすることのどちらかが通常必要になります.
FreeBSD に追加する場合には通常, 変更点を tar/uuencode
したファイルにして送るか, それらをウェブサイトや FTP
サイトへアップロードしてアクセスできるようにすることのどちらかが必要になります.
web や FTP サイトへのアクセスができないときは適切な FreeBSD
のメーリングリストで誰かに変更を受け取って貰ってください.</para>
<para>大量のコードを伴った仕事の場合,
コピーライトの神経過敏な問題が常に出てきます. FreeBSD
<para>大量のコードをともなった仕事の場合は,
常に著作権に関する微妙な問題が出てきます. FreeBSD
に含めるコードのコピーライトとして受け入れることができるのは,
以下の二つです:</para>
以下の二つです.</para>
<orderedlist>
<indexterm><primary>BSD copyright</primary></indexterm>
@ -511,14 +534,12 @@
</orderedlist>
<para>これ以外のタイプのコピーライトによる寄贈は, FreeBSD
へ含めることを考慮する前に,
注意深いレビューを受けなければなりません.
へ含めることを考慮する前に注意深いレビューを受けなければなりません.
作者が独自のチャネルを通して配布しており,
そのような変更をおこなうことを常に奨励している場合でも,
特に限定的な商用のコピーライトが適用される寄贈は一般に拒否されます.</para>
<para>あなたの作品に <quote>BSD-
スタイル</quote>のコピーライトを付けるには,
<para>あなたの作品に <quote>BSD スタイル</quote>のコピーライトを付けるには,
保護したいソースコードファイルすべての一番最初に以下のテキストを入れて,
<literal>%%</literal>
の間を適切な情報に置き換えください.</para>
@ -552,14 +573,17 @@ THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
<para>便宜をはかるため,
このテキストのコピーは次の場所に置いてあります.
<filename>/usr/share/examples/etc/bsd-style-copyright</filename>.
</para>
<filename>/usr/share/examples/etc/bsd-style-copyright</filename>.</para>
<para>(訳注: 以下は神田敏広氏より寄贈された bsd-style-copyright
の日本語訳です.
ソースファイルに含めるものは原文の方であることに注意してご利用ください.
また, 原文との間に趣旨の差異が生じた場合,
原文の内容が FreeBSD プロジェクトの意思であるものとします.)</para>
<note>
<title>訳注</title>
<para>以下は神田敏広氏より寄贈された bsd-style-copyright
の日本語訳です.
ソースファイルに含めるものは原文の方であることに注意してご利用ください.
また, 原文との間に趣旨の差異が生じた場合,
原文の内容が FreeBSD プロジェクトの意思であるものとします.</para>
</note>
<programlisting>
Copyright (C) [年]
@ -684,15 +708,13 @@ Copyright (C) [ǯ]
</sect2>
</sect1>
</chapter>
</article>
<!--
Local Variables:
mode: sgml
sgml-declaration: "../chapter.decl"
sgml-indent-data: t
sgml-omittag: nil
sgml-always-quote-attributes: t
sgml-parent-document: ("../book.sgml" "part" "chapter")
End:
-->