[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/build.xml: 1.38 -> 1.39 ほか
以下のページの更新をしました。ツッコミをお願いします。
pkgsrc/doc/guide/files/build.xml: 1.38 -> 1.39
> revision 1.39
> date: 2006/12/02 06:03:31; author: kano; state: Exp; lines: +4 -4
> - fix URL syntax: colon must be used with port number
> - fix path to pkgtools/pkg_tarup package
>
> approved by yyamano@
pkgsrc/doc/guide/files/configuring.xml: 1.22 -> 1.23
> revision 1.23
> date: 2006/12/02 06:12:40; author: kano; state: Exp; lines: +6 -6
> move sentence describing BINPKG_SITES to the proper location.
>
> approved by yyamano@
pkgsrc/doc/guide/files/submit.xml: 1.15 -> 1.16
> revision 1.16
> date: 2006/12/02 06:05:27; author: kano; state: Exp; lines: +6 -6
> doc/CHANGES -> doc/CHANGES-YYYY
>
> approved by yyamano@
configuring.xml 以外は、原文の変更をそのまま訳に反映しています。
水曜日までに異議がなければ、 commit します。
以下、訳と原文それぞれの新旧の差分です。
--- build.xml.orig 2007-01-16 21:28:18.000000000 +0900
+++ build.xml 2007-01-16 21:28:18.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: build.xml,v 1.38 2006/11/23 11:47:54 yyamano Exp $ -->
+<!-- $NetBSD: build.xml,v 1.39 2006/12/02 06:03:31 kano Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: build.xml,v 1.38 2006/11/23 11:47:54 yyamano Exp -->
+<!-- NetBSD: build.xml,v 1.39 2006/12/02 06:03:31 kano Exp -->
<chapter id="build">
<title>構築の手順</title>
@@ -293,10 +293,10 @@
<para>名前から意味がわかりにくいものについて、説明しておきます。
<varname>MASTER_SITE_BACKUP</varname> には、<ulink
- url="ftp://ftp.NetBSD.org:/pub/NetBSD/packages/distfiles/${DIST_SUBDIR}"
+ url="ftp://ftp.NetBSD.org/pub/NetBSD/packages/distfiles/${DIST_SUBDIR}"
/> で保守されている、パッケージのバックアップサイトが含まれます。
<varname>MASTER_SITE_LOCAL</varname> には、<ulink
- url="ftp://ftp.NetBSD.org:/pub/NetBSD/packages/distfiles/LOCAL_PORTS/"
+ url="ftp://ftp.NetBSD.org/pub/NetBSD/packages/distfiles/LOCAL_PORTS/"
/> で保守されている、パッケージのローカルなソース配布物が含まれます。</para>
<para>もしこれらの予め定義されたサイトの1つを選んだ場合、そのサイトのサブディレク
@@ -914,7 +914,7 @@
依存するパッケージの置き換えをおこなわないという点で
update と異なります。
このターゲットを動作させるためには、<filename
- role="pkg">pkgsrc/pkgtools/pkg_tarup</filename>
+ role="pkg">pkgtools/pkg_tarup</filename>
をインストールする必要があります。</para>
<para><emphasis>このターゲットは注意して使ってください。
--- configuring.xml.orig 2007-01-16 21:28:19.000000000 +0900
+++ configuring.xml 2007-01-16 21:28:19.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: configuring.xml,v 1.22 2006/09/18 13:25:37 rillig Exp $ -->
+<!-- $NetBSD: configuring.xml,v 1.23 2006/12/02 06:12:40 kano Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: configuring.xml,v 1.22 2006/09/18 13:25:37 rillig Exp -->
+<!-- NetBSD: configuring.xml,v 1.23 2006/12/02 06:12:40 kano Exp -->
<chapter id="configuring">
<title>pkgsrc を設定する</title>
@@ -68,7 +68,10 @@
<filename>ftp://ftp.freebsd.org/pub/FreeBSD/distfiles/${DIST_SUBDIR}/</filename> になります。</para>
</listitem>
<listitem><para><varname>BINPKG_SITES</varname>:
- バイナリーパッケージの配布サイトのリストです。</para>
+ バイナリーパッケージの配布サイトのリストです。<replaceable>rel</replaceable> および
+ <replaceable>arch</replaceable> は、ぞれぞれ OS
+ リリース (<quote>2.0</quote> など) およびアーキテクチャー
+ (<quote>mipsel</quote> など) で置き換えられます。</para>
</listitem>
<listitem><para><varname>ACCEPTABLE_LICENSES</varname>:
受け入れ可能なライセンスのリストです。
@@ -102,10 +105,7 @@
<listitem><para><varname>LOCALPATCHES</varname>:
pkgsrc に含まれていないローカルなパッチ用のディレクトリーです。
さらなる情報は、<xref linkend="components.patches" />
- をご覧ください。<replaceable>rel</replaceable> および
- <replaceable>arch</replaceable> は、ぞれぞれ OS
- リリース (<quote>2.0</quote> など) およびアーキテクチャー
- (<quote>mipsel</quote> など) で置き換えられます。</para>
+ をご覧ください。</para>
</listitem>
<listitem><para><varname>PKGMAKECONF</varname>: パッケージの
BSD 形式の Makefile が使用する <filename>mk.conf</filename>
--- submit.xml.orig 2007-01-16 21:28:20.000000000 +0900
+++ submit.xml 2007-01-16 21:28:20.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: submit.xml,v 1.15 2006/09/13 23:34:05 wiz Exp $ -->
+<!-- $NetBSD: submit.xml,v 1.16 2006/12/02 06:05:27 kano Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: submit.xml,v 1.15 2006/09/13 23:34:05 wiz Exp -->
+<!-- NetBSD: submit.xml,v 1.16 2006/12/02 06:05:27 kano Exp -->
<chapter id="submit"> <?dbhtml filename="submit.html"?>
<title>提出およびコミット</title>
@@ -52,7 +52,7 @@
<title>パッケージを追加・更新・削除する際の一般的な覚書</title>
<para>パッケージの追加、更新、移動、および削除は、すべて
- <filename>pkgsrc/doc/CHANGES</filename> に書いてください。
+ <filename>pkgsrc/doc/CHANGES-<replaceable>YYYY</replaceable></filename> に書いてください。
このファイルを、これまでと同じ形式のまま最新の状態に保つことは非常に重要なことです。
なぜなら、このファイルはスクリプトにより <ulink
url="http://www.NetBSD.org/">www.NetBSD.org</ulink>
@@ -63,15 +63,15 @@
<para>パッケージの <varname>PKGREVISION</varname> を引き上げた時に、
その変更がセキュリティーに関するものやその他関連のあるものである場合は、
- <filename>pkgsrc/doc/CHANGES</filename> に載せるようにします。
+ <filename>pkgsrc/doc/CHANGES-<replaceable>YYYY</replaceable></filename> に載せるようにします。
依存性の更新にともなう大量の引き上げについては、ここには書かないでください。
これら以外の場合は、書くべきかどうかは開発者が自分で決めることです。</para>
-<para>正しい <filename>CHANGES</filename>
+<para>正しい <filename>CHANGES-<replaceable>YYYY</replaceable></filename>
の項目を作るのを手伝ってくれる make ターゲット、 <command>make
changes-entry</command> があります。このターゲットは <varname>CTYPE</varname>
および <varname>NETBSD_LOGIN_NAME</varname> というオプションの変数を使います。
- 一般的な使い方は、まず <filename>CHANGES</filename>
+ 一般的な使い方は、まず <filename>CHANGES-<replaceable>YYYY</replaceable></filename>
ファイルを (あとで衝突して修正する必要が起こらないように)
最新の状態にした上で、パッケージのディレクトリーに <command>cd</command>
します。パッケージを更新した場合は <command>make changes-entry</command>
@@ -80,7 +80,7 @@
"Moved" または "Removed" に設定します。ローカルのログイン名が
NetBSD のログイン名と異なる場合は、<filename>/etc/mk.conf</filename> で
<varname>NETBSD_LOGIN_NAME</varname> を設定することができます。最後に
- <filename>pkgsrc/doc/CHANGES</filename> の変更を
+ <filename>pkgsrc/doc/CHANGES-<replaceable>YYYY</replaceable></filename> の変更を
commit するのを忘れないでください。</para>
</sect1>
Index: build.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/build.xml,v
retrieving revision 1.38
retrieving revision 1.39
diff -u -r1.38 -r1.39
--- build.xml 23 Nov 2006 11:47:54 -0000 1.38
+++ build.xml 2 Dec 2006 06:03:31 -0000 1.39
@@ -1,4 +1,4 @@
-<!-- $NetBSD: build.xml,v 1.38 2006/11/23 11:47:54 yyamano Exp $ -->
+<!-- $NetBSD: build.xml,v 1.39 2006/12/02 06:03:31 kano Exp $ -->
<chapter id="build">
<title>The build process</title>
@@ -313,10 +313,10 @@
<para>Some explanations for the less self-explaining ones:
<varname>MASTER_SITE_BACKUP</varname> contains backup sites
for packages that are maintained in <ulink
- url="ftp://ftp.NetBSD.org:/pub/NetBSD/packages/distfiles/${DIST_SUBDIR}"
+ url="ftp://ftp.NetBSD.org/pub/NetBSD/packages/distfiles/${DIST_SUBDIR}"
/>. <varname>MASTER_SITE_LOCAL</varname> contains local
package source distributions that are maintained in <ulink
- url="ftp://ftp.NetBSD.org:/pub/NetBSD/packages/distfiles/LOCAL_PORTS/"
+ url="ftp://ftp.NetBSD.org/pub/NetBSD/packages/distfiles/LOCAL_PORTS/"
/>.</para>
<para>If you choose one of these predefined sites, you may
@@ -1005,7 +1005,7 @@
<para>Update the installation of the current package. This
differs from update in that it does not replace dependent
packages. You will need to install <filename
- role="pkg">pkgsrc/pkgtools/pkg_tarup</filename> for this
+ role="pkg">pkgtools/pkg_tarup</filename> for this
target to work.</para>
<para><emphasis>Be careful when using this
Index: configuring.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/configuring.xml,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- configuring.xml 18 Sep 2006 13:25:37 -0000 1.22
+++ configuring.xml 2 Dec 2006 06:12:40 -0000 1.23
@@ -1,4 +1,4 @@
-<!-- $NetBSD: configuring.xml,v 1.22 2006/09/18 13:25:37 rillig Exp $ -->
+<!-- $NetBSD: configuring.xml,v 1.23 2006/12/02 06:12:40 kano Exp $ -->
<chapter id="configuring">
<title>Configuring pkgsrc</title>
@@ -67,7 +67,10 @@
<filename>ftp://ftp.freebsd.org/pub/FreeBSD/distfiles/${DIST_SUBDIR}/</filename>.</para>
</listitem>
<listitem><para><varname>BINPKG_SITES</varname>:
- List of sites carrying binary pkgs.</para>
+ List of sites carrying binary pkgs. <replaceable>rel</replaceable> and
+ <replaceable>arch</replaceable> are replaced with OS
+ release (<quote>2.0</quote>, etc.) and architecture
+ (<quote>mipsel</quote>, etc.).</para>
</listitem>
<listitem><para><varname>ACCEPTABLE_LICENSES</varname>:
List of acceptable licenses. Whenever you try to build a package
@@ -101,10 +104,7 @@
<listitem><para><varname>LOCALPATCHES</varname>:
Directory for local patches that aren't part of pkgsrc.
See <xref linkend="components.patches" /> for more
- information. <replaceable>rel</replaceable> and
- <replaceable>arch</replaceable> are replaced with OS
- release (<quote>2.0</quote>, etc.) and architecture
- (<quote>mipsel</quote>, etc.).</para>
+ information.</para>
</listitem>
<listitem><para><varname>PKGMAKECONF</varname>: Location of
the <filename>mk.conf</filename> file used by a package's
Index: submit.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/submit.xml,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- submit.xml 13 Sep 2006 23:34:05 -0000 1.15
+++ submit.xml 2 Dec 2006 06:05:27 -0000 1.16
@@ -1,4 +1,4 @@
-<!-- $NetBSD: submit.xml,v 1.15 2006/09/13 23:34:05 wiz Exp $ -->
+<!-- $NetBSD: submit.xml,v 1.16 2006/12/02 06:05:27 kano Exp $ -->
<chapter id="submit"> <?dbhtml filename="submit.html"?>
<title>Submitting and Committing</title>
@@ -52,7 +52,7 @@
<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
+ removals in <filename>pkgsrc/doc/CHANGES-<replaceable>YYYY</replaceable></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
@@ -64,16 +64,16 @@
<para>When the <varname>PKGREVISION</varname> of a package is
bumped, the change should appear in
- <filename>pkgsrc/doc/CHANGES</filename> if it is security
+ <filename>pkgsrc/doc/CHANGES-<replaceable>YYYY</replaceable></filename> if it is security
related or otherwise relevant. Mass bumps that result from a
dependency being updated should not be mentioned. In all other
cases it's the developer's decision.</para>
<para>There is a make target that helps in creating proper
- <filename>CHANGES</filename> entries: <command>make
+ <filename>CHANGES-<replaceable>YYYY</replaceable></filename> entries: <command>make
changes-entry</command>. It uses the optional <varname>CTYPE</varname>
and <varname>NETBSD_LOGIN_NAME</varname> variables. The general
- usage is to first make sure that your <filename>CHANGES</filename>
+ usage is to first make sure that your <filename>CHANGES-<replaceable>YYYY</replaceable></filename>
file is up-to-date (to avoid having to resolve conflicts later-on)
and then to <command>cd</command> to the package directory. For
package updates, <command>make changes-entry</command> is enough.
@@ -82,7 +82,7 @@
"Moved", or "Removed". You can set <varname>NETBSD_LOGIN_NAME</varname>
in <filename>/etc/mk.conf</filename> if your local login name is
not the same as your NetBSD login name. Don't forget to commit
- the changes to <filename>pkgsrc/doc/CHANGES</filename>!</para>
+ the changes to <filename>pkgsrc/doc/CHANGES-<replaceable>YYYY</replaceable></filename>!</para>
</sect1>
<sect1 id="committing-importing">