[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/submit.xml: 1.10 -> 1.11
以下のページの更新をしました。ツッコミをお願いします。
pkgsrc/doc/guide/files/submit.xml: 1.10 -> 1.11
> revision 1.11
> date: 2006/05/19 21:08:42; author: rillig; state: Exp; lines: +42 -53
> The difference between submission of binary and source packages is
> emphasized by using two distict sections for them.
字下げと改行位置が変わったために差分が大きくなっていますが、
冒頭の一文が削除され、
バイナリーパッケージとソースパッケージの節見出しが追加されただけで、
内容は変わっていません。
水曜日までに異議がなければ、 commit します。
以下、訳と原文それぞれの新旧の差分です。
--- submit.xml.orig 2006-11-14 00:37:28.000000000 +0900
+++ submit.xml 2006-11-14 00:37:28.000000000 +0900
@@ -1,70 +1,55 @@
-<!-- $NetBSD: submit.xml,v 1.10 2006/03/02 23:08:40 rillig Exp $ -->
+<!-- $NetBSD: submit.xml,v 1.11 2006/05/19 21:08:42 rillig Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: submit.xml,v 1.10 2006/03/02 23:08:40 rillig Exp -->
+<!-- NetBSD: submit.xml,v 1.11 2006/05/19 21:08:42 rillig Exp -->
<chapter id="submit"> <?dbhtml filename="submit.html"?>
<title>提出およびコミット</title>
-<sect1 id="submitting-your-package">
-<title>あなたが作ったパッケージの提出</title>
-<para>
-ここでは、バイナリーパッケージと<quote>通常の</quote>(ソース)パッケージとを区別する必要
-があります:
-</para>
+<sect1 id="submitting-binary-packages">
+<title>バイナリーパッケージの提出</title>
-<itemizedlist>
-<listitem>
-<para>コンパイル済みのバイナリーパッケージ</para>
-<para>
- 我々は、トロイの木馬等を含まないことを保証するために、pkgsrc 開発者からし
- かバイナリーを受け取りません。これは、誰かを排斥するものではなく、
- むしろユーザーを保護するための方針です。しかしながら、あなたの作ったバイ
- ナリーパッケージをどこかに置き、配布することは自由に行なってもかまいま
- せん。NetBSD 開発者がバルクビルドを実行してパッケージをアップロードしたい場合は、
- <xref linkend="bulk-upload"/>を参照してください。
-</para>
-</listitem>
-
-<listitem>
-<para>パッケージ</para>
-<para>
- 最初にパッケージが完全かどうか、コンパイル、実行できるかどうかを確認して
- ください。
- このドキュメントの<xref linkend="debug"/>、その他が参考になるでしょう。次に、
- すべてのファイルをなるべくひとつのディレクトリーに置いて、その &man.tar.1;
- アーカイブを作り、gzip して uuencode してください。
- 最後に、パッケージの名前とバージョンを
- 含む概要、簡単な説明(COMMENT 変数または DESCR ファイルの内容でもOKです)を書き、
- さきほど作ったアーカイブをつけて、
- <quote>pkg</quote>カテゴリーで<command>send-pr</command> (問題報告)をおこなってください。
-</para>
+ <para> 我々は、トロイの木馬等を含まないことを保証するために、pkgsrc 開発者からし
+ かバイナリーを受け取りません。これは、誰かを排斥するものではなく、
+ むしろユーザーを保護するための方針です。しかしながら、あなたの作ったバイ
+ ナリーパッケージをどこかに置き、配布することは自由に行なってもかまいま
+ せん。NetBSD 開発者がバルクビルドを実行してパッケージをアップロードしたい場合は、
+ <xref linkend="bulk-upload"/>を参照してください。</para>
-<para>
- 複数のパッケージを提出したい場合は、一つのパッケージにつき一つのPRにわけ
- て送ってください。そうすることで、私たちが追跡しやすくなります。
-</para>
+</sect1>
+<sect1 id="submitting-your-package">
+<title>ソースパッケージの提出 (NetBSD 開発者以外の方向け)</title>
-<para>
- 以上のようにするほか、新しいパッケージは pkgsrc-wip
- (<quote>pkgsrc work-in-progress</quote>) に入れることもできます。詳細は、ホームページ <ulink
- url="http://pkgsrc-wip.sourceforge.net/"/> をご覧ください。
-</para>
-</listitem>
-</itemizedlist>
+ <para>最初にパッケージが完全かどうか、コンパイル、実行できるかどうかを確認して
+ ください。
+ このドキュメントの<xref linkend="debug"/>、その他が参考になるでしょう。次に、
+ すべてのファイルをなるべくひとつのディレクトリーに置いて、その &man.tar.1;
+ アーカイブを作り、gzip して uuencode してください。
+ 最後に、パッケージの名前とバージョンを
+ 含む概要、簡単な説明(COMMENT 変数または DESCR ファイルの内容でもOKです)を書き、
+ さきほど作ったアーカイブをつけて、
+ <quote>pkg</quote>カテゴリーで<command>send-pr</command> (問題報告)をおこなってください。</para>
+
+ <para>複数のパッケージを提出したい場合は、一つのパッケージにつき一つのPRにわけ
+ て送ってください。そうすることで、私たちが追跡しやすくなります。</para>
+
+ <para>以上のようにするほか、新しいパッケージは pkgsrc-wip
+ (<quote>pkgsrc work-in-progress</quote>) に入れることもできます。
+ 詳細は、ホームページ <ulink url="http://pkgsrc-wip.sourceforge.net/"/>
+ をご覧ください。</para>
</sect1>
-
<sect1 id="general-notes-for-changes">
<title>パッケージを追加・更新・削除する際の一般的な覚書</title>
-<para>パッケージの追加、更新、移動、および削除は、すべて
- <filename>pkgsrc/doc/CHANGES</filename> に書いてください。
- このファイルを、これまでと同じ形式のまま最新の状態に保つことは非常に重要なことです。
- なぜなら、このファイルはスクリプトにより
- <ulink url="http://www.NetBSD.org/">www.NetBSD.org</ulink>
- や他のサイトのページを自動的に更新するために使用されているからです。
- また、<filename>pkgsrc/doc/TODO</filename> ファイルを確認し、
- 今回更新あるいは削除したパッケージのことが書かれている場合は、
- その部分を削除してください。</para>
+
+ <para>パッケージの追加、更新、移動、および削除は、すべて
+ <filename>pkgsrc/doc/CHANGES</filename> に書いてください。
+ このファイルを、これまでと同じ形式のまま最新の状態に保つことは非常に重要なことです。
+ なぜなら、このファイルはスクリプトにより <ulink
+ url="http://www.NetBSD.org/">www.NetBSD.org</ulink>
+ や他のサイトのページを自動的に更新するために使用されているからです。
+ また、<filename>pkgsrc/doc/TODO</filename> ファイルを確認し、
+ 今回更新あるいは削除したパッケージのことが書かれている場合は、
+ その部分を削除してください。</para>
<para>パッケージの <varname>PKGREVISION</varname> を引き上げた時に、
その変更がセキュリティーに関するものやその他関連のあるものである場合は、
Index: submit.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/submit.xml,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- submit.xml 2 Mar 2006 23:08:40 -0000 1.10
+++ submit.xml 19 May 2006 21:08:42 -0000 1.11
@@ -1,67 +1,56 @@
-<!-- $NetBSD: submit.xml,v 1.10 2006/03/02 23:08:40 rillig Exp $ -->
+<!-- $NetBSD: submit.xml,v 1.11 2006/05/19 21:08:42 rillig Exp $ -->
<chapter id="submit"> <?dbhtml filename="submit.html"?>
<title>Submitting and Committing</title>
-<sect1 id="submitting-your-package">
-<title>Submitting your packages</title>
-<para>
-You have to separate between binary and <quote>normal</quote> (source)
-packages here:
-</para>
+<sect1 id="submitting-binary-packages">
+<title>Submitting binary packages</title>
-<itemizedlist>
-<listitem>
-<para>precompiled binary packages</para>
-<para>
- Our policy is that we accept binaries only from pkgsrc developers to
- guarantee that the packages don't contain any trojan horses etc.
- This is not to annoy anyone but rather to protect our users!
- You're still free to put up your home-made binary packages and tell
- the world where to get them. NetBSD developers doing bulk builds and
- wanting to upload them please see <xref linkend="bulk-upload"/>.
-</para>
-</listitem>
-
-<listitem>
-<para>packages</para>
-<para>
- First, check that your package is complete, compiles and runs well;
- see <xref linkend="debug"/> and the rest of this document. Next,
- generate an uuencoded gzipped &man.tar.1; archive, preferably with all files
- in a single directory.
- Finally, <command>send-pr</command> with category <quote>pkg</quote>, a
- synopsis which includes the package name and version number, a short
- description of your package (contents of the COMMENT variable or DESCR
- file are OK) and attach the archive to your PR.
-</para>
+ <para>Our policy is that we accept binaries only from pkgsrc
+ developers to guarantee that the packages don't contain any
+ trojan horses etc. This is not to annoy anyone but rather to
+ protect our users! You're still free to put up your home-made
+ binary packages and tell the world where to get them. NetBSD
+ developers doing bulk builds and wanting to upload them please
+ see <xref linkend="bulk-upload"/>.</para>
-<para>
- If you want to submit several packages, please send a separate PR for
- each one, it's easier for us to track things that way.
-</para>
+</sect1>
+<sect1 id="submitting-your-package">
+<title>Submitting source packages (for non-NetBSD-developers)</title>
-<para>
- Alternatively, you can also import new packages into pkgsrc-wip
- (<quote>pkgsrc work-in-progress</quote>); see the homepage at <ulink
- url="http://pkgsrc-wip.sourceforge.net/"/> for details.
-</para>
-</listitem>
-</itemizedlist>
+ <para>First, check that your package is complete, compiles and
+ runs well; see <xref linkend="debug"/> and the rest of this
+ document. Next, generate an uuencoded gzipped &man.tar.1;
+ archive, preferably with all files in a single directory.
+ Finally, <command>send-pr</command> with category
+ <quote>pkg</quote>, a synopsis which includes the package name
+ and version number, a short description of your package
+ (contents of the COMMENT variable or DESCR file are OK) and
+ attach the archive to your PR.</para>
+
+ <para>If you want to submit several packages, please send a
+ separate PR for each one, it's easier for us to track things
+ that way.</para>
+
+ <para>Alternatively, you can also import new packages into
+ pkgsrc-wip (<quote>pkgsrc work-in-progress</quote>); see the
+ homepage at <ulink url="http://pkgsrc-wip.sourceforge.net/"/>
+ for details.</para>
</sect1>
-
<sect1 id="general-notes-for-changes">
<title>General notes when adding, updating, or removing packages</title>
-<para>Please note all package additions, updates, moves, and removals
- in <filename>pkgsrc/doc/CHANGES</filename>. It's very important
- to keep this file up to date and conforming to the existing
- format, because it will be used by scripts to automatically update
- pages on <ulink url="http://www.NetBSD.org/">www.NetBSD.org</ulink>
- and other sites. Additionally, check the
- <filename>pkgsrc/doc/TODO</filename> file and remove the entry
- for the package you updated or removed, in case it was mentioned
- there.</para>
+
+ <para>Please note all package additions, updates, moves, and
+ removals in <filename>pkgsrc/doc/CHANGES</filename>. It's very
+ important to keep this file up to date and conforming to the
+ existing format, because it will be used by scripts to
+ automatically update pages on <ulink
+ url="http://www.NetBSD.org/">www.NetBSD.org</ulink> and other
+ sites. Additionally, check the
+ <filename>pkgsrc/doc/TODO</filename> file and remove the entry
+ for the package you updated or removed, in case it was mentioned
+ there.</para>
<para>When the <varname>PKGREVISION</varname> of a package is
bumped, the change should appear in