[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/bulk.xml: 1.2 -> 1.4

Subject: pkgsrc/doc/guide/files/bulk.xml: 1.2 -> 1.4
From: kano@na.rim.or.jp (OKANO Takayoshi)
To: www-changes-ja@jp.NetBSD.org
Date: Sun, 25 Jan 2009 01:36:12 +0900 (JST)
Message-Id: <20090125.013612.74743915.kano@na.rim.or.jp>
Delivered-To: mailing list www-changes-ja@jp.netbsd.org
Mailing-List: contact www-changes-ja-help@jp.netbsd.org; run by ezmlm-idx
以下のページの更新をしました。ツッコミをお願いします。

pkgsrc/doc/guide/files/bulk.xml: 1.2 -> 1.4
> revision 1.4
> date: 2009/01/07 19:59:12;  author: joerg;  state: Exp;  lines: +2 -2
> Be consistent between sample path and bootstrap command.
> ----------------------------
> revision 1.3
> date: 2008/12/17 09:50:48;  author: rillig;  state: Exp;  lines: +45 -3
> Started to document pbulk in the pkgsrc guide.

月曜日までに異議がなければ、 commit します。

更新後の訳の全文は
  http://www.na.rim.or.jp/%7Ekano/tmp/docs/pkgsrc/bulk.xml
  http://www.na.rim.or.jp/%7Ekano/tmp/docs/pkgsrc/bulk.html#bulk.pbulk
に置いてあります。

以下、訳と原文それぞれの新旧の差分です。

--- bulk.xml.orig	2009-01-25 01:30:55.000000000 +0900
+++ bulk.xml	2009-01-25 01:30:55.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: bulk.xml,v 1.2 2008/04/04 18:32:37 joerg Exp $ -->
+<!-- $NetBSD: bulk.xml,v 1.4 2009/01/07 19:59:12 joerg Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: bulk.xml,v 1.2 2008/04/04 18:32:37 joerg Exp   -->
+<!-- NetBSD: bulk.xml,v 1.4 2009/01/07 19:59:12 joerg Exp   -->
 
 <chapter id="bulk">
 <title>pkgsrc のバイナリーパッケージを全部作成する
@@ -93,8 +93,9 @@
 <sect1 id="bulk.old">
 <title>旧方式のバルクビルドを実行する</title>
 
-<warning><para>以下、本節は古い内容です。
-あまりあてにしないでください。</para></warning>
+<note><para>バルクビルドには、二つの方式があります。
+旧方式のバルクビルドと、新方式の <quote>pbulk</quote> です。
+後者の方式をおすすめします。</para></note>
 
 <sect2 id="binary.configuration">
 <title>設定</title>
@@ -598,11 +599,52 @@
 <sect1 id="bulk.pbulk">
 <title>pbulk 方式のバルクビルドを実行する</title>
 
+<para>pbulk 方式のバルクビルドの実行の概要は、以下のとおりです。</para>
+
+<itemizedlist>
+<listitem><para>最初に、まっさらな pkgsrc ツリー内で pbulk 基盤を構築する。</para></listitem>
+<listitem><para>次に、この pbulk 基盤を使って、まっさらの pkgsrc ディレクトリーから個々のパッケージを構築する。</para></listitem>
+</itemizedlist>
+
+<sect2 id="bulk.pbulk.prepare">
+<title>事前準備</title>
+
+<para>最初に、pbulk 基盤を作るための pkgsrc 基盤を作る必要があります。プラットフォームが何であっても (NetBSD であっても)、専用のディレクトリーを用意してそこに対して bootstrap をしてください。このディレクトリーは <filename>/usr/pbulk</filename> または <filename>$HOME/pbulk</filename> としましょう。bootstrap すると、バルクビルドに必要なツールがインストールされます。</para>
+
+<screen>
+$ <userinput>cd /usr/pkgsrc</userinput>
+$ <userinput>./bootstrap/bootstrap --prefix=/usr/pbulk --varbase=/usr/pbulk/var --workdir=/tmp/pbulk-bootstrap</userinput>
+$ <userinput>rm -rf /tmp/pbulk-bootstrap</userinput>
+</screen>
+
+<para>これで、pbulk 基盤のための基本的な環境がインストールされましたが、いくつかのツールはまだありません。ここで、pkgsrc の設定ファイル <filename>/usr/pbulk/etc/mk.conf</filename> を pbulk 向けに編集しましょう。ここでの典型的な設定内容は以下のとおりです。</para>
+
+<itemizedlist>
+<listitem><para><literal><varname>PKG_DEVELOPER</varname>=yes</literal>, より多くの整合性確認をするため</para></listitem>
+<listitem><para><literal><varname>WRKOBJDIR</varname>=/tmp/pbulk-outer</literal>, <filename>/usr/pkgsrc</filename> にいかなる変更も加わらないようにするため</para></listitem>
+<listitem><para><literal><varname>DISTDIR</varname>=/distfiles</literal>, ダウンロードされた distfile (pbluk 基盤および構築するパッケージ用) を、すべて、ただひとつのデイレクトリーに置くようにするため</para></listitem>
+<listitem><para><literal><varname>ACCEPTABLE_LICENSES</varname>+=...</literal>, 普及しているフリー/オープンソースライセンスのうち許容できるものを追加するため</para></listitem>
+<listitem><para><literal><varname>_ACCEPTABLE</varname>=yes</literal>, 制限内容にかかわらず、すべてのライセンスを許容するため</para></listitem>
+</itemizedlist>
+
+<para>これで、pbulk 基盤の残りの部分を構築する準備ができました。</para>
+
+<screen>
+$ <userinput>cd pkgtools/pbulk</userinput>
+$ <userinput>/usr/pbulk/bin/bmake install</userinput>
+$ <userinput>rm -rf /tmp/pbulk-outer</userinput>
+</screen>
+
+<para>これで、pbulk 基盤が構築・インストールされました。この基盤を設定したうえで、さらなる準備が必要です。そうした後に、実際のバルクビルドを始めることができるようになります。</para>
+</sect2>
+
 <sect2 id="bulk.pbulk.conf">
 <title>設定</title>
 
 <para>TODO; さらなる情報は pkgsrc/doc/HOWTO-pbulk をご覧ください。</para>
 
+<para>TODO: つづきを書く</para>
+
 </sect2>
 
 </sect1>
Index: bulk.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/bulk.xml,v
retrieving revision 1.2
retrieving revision 1.4
diff -u -r1.2 -r1.4
--- bulk.xml	4 Apr 2008 18:32:37 -0000	1.2
+++ bulk.xml	7 Jan 2009 19:59:12 -0000	1.4
@@ -1,4 +1,4 @@
-<!-- $NetBSD: bulk.xml,v 1.2 2008/04/04 18:32:37 joerg Exp $ -->
+<!-- $NetBSD: bulk.xml,v 1.4 2009/01/07 19:59:12 joerg Exp $ -->
 
 <chapter id="bulk">
 <title>Creating binary packages for everything in pkgsrc (bulk
@@ -85,8 +85,9 @@
 <sect1 id="bulk.old">
 <title>Running an old-style bulk build</title>
 
-<warning><para>The rest of this section is rather old. Don't rely on it
-too much.</para></warning>
+<note><para>There are two ways of doing a bulk build. The old-style
+one and the new-style <quote>pbulk</quote>. The latter is the recommended
+way.</para></note>
 
 <sect2 id="binary.configuration">
 <title>Configuration</title>
@@ -612,11 +613,52 @@
 <sect1 id="bulk.pbulk">
 <title>Running a pbulk-style bulk build</title>
 
+<para>Running a pbulk-style bulk build works roughly as follows:</para>
+
+<itemizedlist>
+<listitem><para>First, build the pbulk infrastructure in a fresh pkgsrc location.</para></listitem>
+<listitem><para>Then, build each of the packages from a clean installation directory using the infrastructure.</para></listitem>
+</itemizedlist>
+
+<sect2 id="bulk.pbulk.prepare">
+<title>Preparation</title>
+
+<para>First, you need to create a pkgsrc installation for the pbulk infrastructure. No matter on which platform you are (even on NetBSD), you should bootstrap into its own directory. Let's take the directory <filename>/usr/pbulk</filename> or <filename>$HOME/pbulk</filename> for it. This installation will be bootstrapped and all the tools that are required for the bulk build will be installed there.</para>
+
+<screen>
+$ <userinput>cd /usr/pkgsrc</userinput>
+$ <userinput>./bootstrap/bootstrap --prefix=/usr/pbulk --varbase=/usr/pbulk/var --workdir=/tmp/pbulk-bootstrap</userinput>
+$ <userinput>rm -rf /tmp/pbulk-bootstrap</userinput>
+</screen>
+
+<para>Now the basic environment for the pbulk infrastructure is installed. The specific tools are still missing. This is a good time to edit the pkgsrc configuration file <filename>/usr/pbulk/etc/mk.conf</filename> to fit your needs. Typical things you might set now are:</para>
+
+<itemizedlist>
+<listitem><para><literal><varname>PKG_DEVELOPER</varname>=yes</literal>, to enable many consistency checks,</para></listitem>
+<listitem><para><literal><varname>WRKOBJDIR</varname>=/tmp/pbulk-outer</literal>, to keep <filename>/usr/pkgsrc</filename> free from any modifications,</para></listitem>
+<listitem><para><literal><varname>DISTDIR</varname>=/distfiles</literal>, to have only one directory in which all distfiles (for the infrastructure and for the actual packages) are downloaded,</para></listitem>
+<listitem><para><literal><varname>ACCEPTABLE_LICENSES</varname>+=...</literal>, to select some licenses additional to the usual Free/Open Source licenses that are acceptable to you,</para></listitem>
+<listitem><para><literal><varname>_ACCEPTABLE</varname>=yes</literal>, to accept all licenses, no matter how restrictive they are.</para></listitem>
+</itemizedlist>
+
+<para>Now you are ready to build the rest of the pbulk infrastructure.</para>
+
+<screen>
+$ <userinput>cd pkgtools/pbulk</userinput>
+$ <userinput>/usr/pbulk/bin/bmake install</userinput>
+$ <userinput>rm -rf /tmp/pbulk-outer</userinput>
+</screen>
+
+<para>Now the pbulk infrastructure is built and installed. It still needs to be configured, and after some more preparation, we will be able to start the real bulk build.</para>
+</sect2>
+
 <sect2 id="bulk.pbulk.conf">
 <title>Configuration</title>
 
 <para>TODO; see pkgsrc/doc/HOWTO-pbulk for more information.</para>
 
+<para>TODO: continue writing</para>
+
 </sect2>
 
 </sect1>
Prev by Date: ports/atari/index.xml: 1.6 -> 1.8
Next by Date: CVS commit: htdocs
Prev by thread: ports/atari/index.xml: 1.6 -> 1.8
Next by thread: pkgsrc/doc/guide/files/configuring.xml: 1.31 -> 1.32ほか
Index(es):
- Date
- Thread