[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Documentation/pkgsrc/binary/chapter.xml: 1.7 -> 1.8



以下のページの更新をしました。ツッコミをお願いします。

Documentation/pkgsrc/binary/chapter.xml: 1.7 -> 1.8

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

以下、訳と原文の差分です。

--- Documentation/pkgsrc/binary/chapter.xml.orig	Wed Feb 15 00:18:35 2006
+++ Documentation/pkgsrc/binary/chapter.xml	Wed Feb 15 00:18:35 2006
@@ -1,6 +1,6 @@
-<!-- $NetBSD: chapter.xml,v 1.7 2003/06/20 04:13:59 grant Exp $ -->
+<!-- $NetBSD: chapter.xml,v 1.8 2003/06/20 04:44:42 grant Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: chapter.xml,v 1.7 2003/06/20 04:13:59 grant Exp   -->
+<!-- NetBSD: chapter.xml,v 1.8 2003/06/20 04:44:42 grant Exp   -->
 
 <chapter id="binary"> <?dbhtml filename="binary.html"?>
 <title>コンパイル済みのパッケージを作る</title>
@@ -8,22 +8,29 @@
 <sect1>
 <title>単数のパッケージを作成する</title>
 <para> 
-上に述べた手順でパッケージを構築しインストールしたら、これを<emphasis>バイナリー・パッ
-ケージ</emphasis>にすることができます。- 他のNetBSDマシン上で作成したバイナリーを使い
-たいと思うかもしれませんし、単にCPU時間を無駄に使わずにすむようにあなたのバ
-イナリー・パッケージを他の人のために使わせてあげたいと思うかもしれません。- 
-これは、pkgsrcツリー内の適切なディレクトリーに移動し、シェル・プロンプト上
-で以下のコマンドをタイプすることにより可能です。
-</para>
-
-<screen><prompt>#</prompt> make package</screen>
-
-<para>
-これにより、パッケージが構築、インストールされます(もし、まだ済んでいなけれ
-ば)。そして、<command>pkg_*</command>ツールを使い操作できるようにバイナリー・パッケージが構築
-されます。現状ではバイナリー・パッケージは<filename>/usr/pkgsrc/packages</filename>
-以下にgzipされたファイルとして作成されます。
-上記のtopの例の続きは、<xref linkend="logs.package"/>を参照して下さい。
+パッケージを構築しインストールしたら、
+pkg_add(1) を使って別のシステムにインストールすることができる<emphasis>バイナリー・パッ
+ケージ</emphasis>を作ることができます。
+こうすると、複数のホストで同じパッケージを構築するような、
+CPU時間の無駄をなくすことができます。
+また、あなたのバイナリー・パッケージを配布して、
+他の人が簡単にインストールできるようにすることもできます。
+</para>
+
+<para>
+バイナリーパッケージを作るには、以下のようにします。
+</para>
+
+<screen><prompt>#</prompt> <userinput>cd sysutils/top</userinput>
+<prompt>#</prompt> <userinput>make package</userinput></screen>
+
+<para>
+これにより、パッケージが構築、インストール(もし、まだ済んでいなけれ
+ば)され、インストールされたパッケージからバイナリー・パッケージが構築
+されます。これは<command>pkg_*</command>ツールを使い操作できます。
+バイナリー・パッケージは<filename>/usr/pkgsrc/packages</filename>
+以下に、gzipまたはbzip2されたtarファイルとして作成されます。
+上記の<pkg>sysutils/top</pkg>の例の続きは、<xref linkend="logs.package"/>を参照して下さい。
 </para>
 
 <para>
@@ -109,8 +116,8 @@
 pre-build.localの使い方の例としては、このファイルに
 </para>
 
-<screen><prompt>#</prompt> echo "I do not have enough disk space to build this pig." \
-    &gt; pkgsrc/games/crafty-book-enormous/$BROKENF</screen>
+<screen><prompt>#</prompt> <userinput>echo "I do not have enough disk space to build this pig." \
+    &gt; pkgsrc/games/crafty-book-enormous/$BROKENF</userinput></screen>
 
 <para>
 のような内容を書いておいて、3 Gb近くのディスク容量が必要な個々のパッケージ
@@ -152,15 +159,15 @@
 もすべて削除しておいてください。root になって、以下のようにタイプします:
 </para>
 
-<screen><prompt>#</prompt> cd /usr/pkgsrc
-<prompt>#</prompt> sh mk/bulk/build</screen>
+<screen><prompt>#</prompt> <userinput>cd /usr/pkgsrc</userinput>
+<prompt>#</prompt> <userinput>sh mk/bulk/build</userinput></screen>
 
 <para>
 何らかの理由で前回の構築が完了していない場合(電源断、システムパニックなど)
 は、以下を実行すると、その続きをすることができます:
 </para>
 
-<screen><prompt>#</prompt> sh mk/bulk/build restart</screen>
+<screen><prompt>#</prompt> <userinput>sh mk/bulk/build restart</userinput></screen>
 
 <para>
 バルクビルド実行が終わると、その要約がメールで届きます。また、<quote>build.conf</quote>
@@ -261,36 +268,35 @@
 <listitem>
 カーネル
 <para>
-<screen><prompt>#</prompt> cp /netbsd /usr/sandbox</screen>
+<screen><prompt>#</prompt> <userinput>cp /netbsd /usr/sandbox</userinput></screen>
 </para>
 </listitem>
 
 <listitem>
 <filename>/dev/*</filename>
 <para>
-<screen><prompt>#</prompt> cd /usr/sandbox/dev ; sh MAKEDEV all</screen>
+<screen><prompt>#</prompt> <userinput>cd /usr/sandbox/dev ; sh MAKEDEV all</userinput></screen>
 </para>
 </listitem>
 
 <listitem>
 <filename>/etc/resolv.conf</filename> (<pkg>security/smtpd</pkg>およびメール用):
 <para>
-<screen><prompt>#</prompt> cp /etc/resolv.conf /usr/sandbox/etc</screen>
+<screen><prompt>#</prompt> <userinput>cp /etc/resolv.conf /usr/sandbox/etc</userinput></screen>
 </para>
 </listitem>
 
 <listitem>
 動作する(!)ようなメールの設定 (hostname, sendmail.cf):
 <para>
-<screen><prompt>#</prompt> cp /etc/mail/sendmail.cf /usr/sandbox/etc/mail</screen>
+<screen><prompt>#</prompt> <userinput>cp /etc/mail/sendmail.cf /usr/sandbox/etc/mail</userinput></screen>
 </para>
 </listitem>
 
 <listitem>
 <filename>/etc/localtime</filename> (<pkg>security/smtpd</pkg>用):
 <para>
-<screen><prompt>#</prompt> ln -sf /usr/share/zoneinfo/GMT
-/usr/sandbox/etc/localtime</screen>
+<screen><prompt>#</prompt> <userinput>ln -sf /usr/share/zoneinfo/GMT /usr/sandbox/etc/localtime</userinput></screen>
 </para>
 </listitem>
 
@@ -298,73 +304,74 @@
 <filename>/usr/src</filename> (<pkg>sysutils/aperture</pkg>,
 <pkg>net/ppp-mppe</pkg>用のシステムソース):
 <para>
-<screen><prompt>#</prompt> ln -s ../disk1/cvs .
-<prompt>#</prompt> ln -s cvs/src-1.6 src
-<prompt>#</prompt> ln -s cvs/pkgsrc .</screen>
+<screen><prompt>#</prompt> <userinput>ln -s ../disk1/cvs .</userinput>
+<prompt>#</prompt> <userinput>ln -s cvs/src-1.6 src</userinput>
+<prompt>#</prompt> <userinput>ln -s cvs/pkgsrc .</userinput></screen>
 </para>
 </listitem>
 
 <listitem>
 <filename>/var/db/pkg</filename>を作成する(デフォルトのインストールには含まれません):
 <para>
-<screen><prompt>#</prompt> mkdir /usr/sandbox/var/db/pkg</screen>
+<screen><prompt>#</prompt> <userinput>mkdir /usr/sandbox/var/db/pkg</userinput></screen>
 </para>
 </listitem>
 
 <listitem>
 <filename>/usr/pkg</filename>を作成する(デフォルトのインストールには含まれません):
 <para>
-<screen><prompt>#</prompt> mkdir /usr/sandbox/usr/pkg</screen>
+<screen><prompt>#</prompt> <userinput>mkdir /usr/sandbox/usr/pkg</userinput></screen>
 </para>
 </listitem>
 
 <listitem>
 <filename>/usr/sandbox/usr/pkgsrc</filename>
-内にpkgsrcをcvsからチェックアウトする:
+内にpkgsrcをチェックアウトする:
 <para>
-<screen><prompt>#</prompt> cvs -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -d -P pkgsrc</screen>
+<screen><prompt>#</prompt> <userinput>cd /usr/sandbox/usr</userinput>
+<prompt>#</prompt> <userinput>cvs -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -d -P pkgsrc</userinput></screen>
 </para>
-/usr/pkgsrc/packages &amp; .../distfiles (砂場の外を指します)
 </listitem>
 
 <listitem>
-<filename>/etc/mk.conf</filename>, <xref linkend="binary.mk.conf"/>参照
+<filename>/etc/mk.conf</filename> を編集する。<xref linkend="binary.mk.conf"/>参照。
 </listitem>
 
 <listitem>
-<filename>mk/bulk/build.conf</filename>を調整する
+<filename>mk/bulk/build.conf</filename>を必要に合わせて調整する
 </listitem>
 
 </itemizedlist>
 
+<note>
+Xをインストールするのを忘れないでください。
+</note>
+
 <para>
-!!! Xをインストールするのを忘れないでください !!!
 あなたが開発者で、構築したバイナリーパッケージをftp.NetBSD.orgへアップロー
 ドする場合は、当該アーキテクチャーおよびリリースでのデフォルトのXバージョン
-(1.6以降は、全アーキテクチャーが3.3.6)を使うようにしてください。
+(NetBSD 1.5.x では XFree86 3.3.6です。 NetBSD 1.6.1 では、 <ulink url="../../Ports/cats/">cats</ulink>,
+<ulink url="../../Ports/i386/">i386</ulink> は XFree86
+4.2.1 、これ以外の各ポートは XFree86 3.3.6 です)を使うようにしてください。
 </para>
 
 <para>
-次に、<filename>/usr/sandbox/usr/pkgsrc</filename>以下に、(たとえばanoncvsで)チェックアウトした
-ままのpkgsrcを置きます。開発用のpkgsrcツリーをここにマウントしたり、リンク
+次に必要なものは、(たとえばanoncvsで)<emphasis>チェックアウトした
+ままのpkgsrc</emphasis>です。開発用のpkgsrcツリーをここにマウントしたり、リンク
 したりすると問題が起こりがちなので、そういうことはしてはいけません!
 <filename>.../pkgsrc/packages</filename>および<filename>.../pkgsrc/distfiles</filename>のファイルを公開したい場合は、
 これらのディレクトリーが砂場の外のどこかを指すように調節します。
 </para>
 
 <para>
-その後、必要に合わせて<filename>.../pkgsrc/mk/bulk/build.conf</filename>を設定してください!
-</para>
-
-<para>
 chroot砂場の用意ができれば、以下の手順で構築を開始できます:
 </para>
 
-<screen><prompt>#</prompt> cd /usr/sandbox/usr/pkgsrc
-<prompt>#</prompt> sh mk/bulk/do-sandbox-build</screen>
+<screen><prompt>#</prompt> <userinput>cd /usr/sandbox/usr/pkgsrc</userinput>
+<prompt>#</prompt> <userinput>sh mk/bulk/do-sandbox-build</userinput></screen>
 
 <para>
-このコマンドは、砂場内に移動して、激しい構築を開始するものです。構築が終わ
+このコマンドは、砂場内に移動して、構築を開始するものです。構築が終わ
 ると、構築の結果がメールで送信されます。できあがったバイナリーパッケージは、
 <filename>/usr/sandbox/usr/pkgsrc/packages</filename> (の指す/マウントされた先/元)に置かれます。
 </para>
@@ -389,28 +396,28 @@
 ジ用の十分なディスク容量が<filename>/u2</filename>にあるものとします。
 </para>
 
-<screen><prompt>#</prompt> mkdir /u2/images
-<prompt>#</prompt> pkg_add /usr/pkgsrc/packages/All/cdpack
-<prompt>#</prompt> cdpack /usr/pkgsrc/packages/All /u2/images</screen>
+<screen><prompt>#</prompt> <userinput>mkdir /u2/images</userinput>
+<prompt>#</prompt> <userinput>pkg_add /usr/pkgsrc/packages/All/cdpack</userinput>
+<prompt>#</prompt> <userinput>cdpack /usr/pkgsrc/packages/All /u2/images</userinput></screen>
 
 <para>
 各CDに共通ファイル(<filename>COPYRIGHT</filename>, <filename>README</filename>, など)を含めたい場合は、そのファイルを
 含むディレクトリーを作る必要があります。たとえば以下のようにします。
 </para>
 
-<screen><prompt>#</prompt> mkdir /tmp/common
-<prompt>#</prompt> echo "This is a README" &gt; /tmp/common/README
-<prompt>#</prompt> echo "Another file" &gt; /tmp/common/COPYING
-<prompt>#</prompt> mkdir /tmp/common/bin
-<prompt>#</prompt> echo "#!/bin/sh" &gt; /tmp/common/bin/myscript
-<prompt>#</prompt> echo "echo Hello world" &gt;&gt; /tmp/common/bin/myscript
-<prompt>#</prompt> chmod 755 /tmp/common/bin/myscript</screen>
+<screen><prompt>#</prompt> <userinput>mkdir /tmp/common</userinput>
+<prompt>#</prompt> <userinput>echo "This is a README" &gt; /tmp/common/README</userinput>
+<prompt>#</prompt> <userinput>echo "Another file" &gt; /tmp/common/COPYING</userinput>
+<prompt>#</prompt> <userinput>mkdir /tmp/common/bin</userinput>
+<prompt>#</prompt> <userinput>echo "#!/bin/sh" &gt; /tmp/common/bin/myscript</userinput>
+<prompt>#</prompt> <userinput>echo "echo Hello world" &gt;&gt; /tmp/common/bin/myscript</userinput>
+<prompt>#</prompt> <userinput>chmod 755 /tmp/common/bin/myscript</userinput></screen>
 
 <para>
 ここで、以下のようにしてイメージを作成します。
 </para>
 
-<screen><prompt>#</prompt> cdpack -x /tmp/common /usr/pkgsrc/packages/All /u2/images</screen>
+<screen><prompt>#</prompt> <userinput>cdpack -x /tmp/common /usr/pkgsrc/packages/All /u2/images</userinput></screen>
 
 <para>
 こうすると、各イメージのルートディレクトリーに<filename>README</filename>, <filename>COPYING</filename>および
Index: Documentation/pkgsrc/binary/chapter.xml
===================================================================
RCS file: /cvsroot/htdocs/Documentation/pkgsrc/binary/Attic/chapter.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- Documentation/pkgsrc/binary/chapter.xml	20 Jun 2003 04:13:59 -0000	1.7
+++ Documentation/pkgsrc/binary/chapter.xml	20 Jun 2003 04:44:42 -0000	1.8
@@ -1,4 +1,4 @@
-<!-- $NetBSD: chapter.xml,v 1.7 2003/06/20 04:13:59 grant Exp $ -->
+<!-- $NetBSD: chapter.xml,v 1.8 2003/06/20 04:44:42 grant Exp $ -->
 
 <chapter id="binary"> <?dbhtml filename="binary.html"?>
 <title>Making precompiled packages</title>
@@ -6,24 +6,27 @@
 <sect1>
 <title>Packaging a single package</title>
 <para> 
-Once you have built and installed the package as mentioned above, you can
-build it into a <emphasis>binary package</emphasis> - you might want to do
-this so that you can use the binaries you have just built on another system,
-or to provide a simple means for others to use your binary package instead
-of wasting CPU time - this is done by changing to the appropriate directory
-in the pkgsrc tree, and typing the command
-</para>
-
-<screen><prompt>#</prompt> make package</screen>
-
-<para>
-at the shell prompt. This will build and install your package (if not
-already done), and then construct a binary package out of the results so
-that you can use the <command>pkg_*</command> tools to manipulate this.
-The binary package is
-stored under <filename>/usr/pkgsrc/packages</filename>, it's in the form
-of a gzipped file at the present time. See <xref linkend="logs.package"/>
-for a continuation of the above top example.
+Once you have built and installed a package, you can create a
+<emphasis>binary package</emphasis> which can be installed on another
+system with pkg_add(1). This saves having to build the same package on
+a group of hosts and wasting CPU time. It also provides a simple means
+for others to install your package, should you distribute it.
+</para>
+
+<para>
+Creating a binary package:
+</para>
+
+<screen><prompt>#</prompt> <userinput>cd sysutils/top</userinput>
+<prompt>#</prompt> <userinput>make package</userinput></screen>
+
+<para>
+This will build and install your package (if not already done), and then
+build a binary package from what was installed. You can then use the
+<command>pkg_*</command> tools to manipulate it. Binary packages are
+created by default in <filename>/usr/pkgsrc/packages</filename>, in the
+form of a gzip or bzip2 tar file. See <xref linkend="logs.package"/> for
+a continuation of the above <pkg>sysutils/top</pkg> example.
 </para>
 
 <para>
@@ -59,7 +62,7 @@
 <para>
 You may want to set things in <filename>/etc/mk.conf</filename>.  Look at
 <filename>pkgsrc/mk/bsd.pkg.defaults.mk</filename> for details of the default settings. 
-You will want to make sure that <varname>ACCEPTABLE_LICENSES</varname>
+You will want to ensure that <varname>ACCEPTABLE_LICENSES</varname>
 meet your local policy. As used in this example,
 <varname>_ACCEPTABLE=yes</varname> accepts <emphasis>all</emphasis> licenses.
 </para>
@@ -109,8 +112,8 @@
 example use of pre-build.local is to have the line:
 </para>
 
-<screen><prompt>#</prompt> echo "I do not have enough disk space to build this pig." \
-    &gt; pkgsrc/games/crafty-book-enormous/$BROKENF</screen>
+<screen><prompt>#</prompt> <userinput>echo "I do not have enough disk space to build this pig." \
+    &gt; pkgsrc/games/crafty-book-enormous/$BROKENF</userinput></screen>
 
 <para>
 to prevent the system from trying to build a particular package
@@ -154,15 +157,15 @@
 some libs installed in <filename>/usr/local</filename>, etc. then become root and type:
 </para>
 
-<screen><prompt>#</prompt> cd /usr/pkgsrc
-<prompt>#</prompt> sh mk/bulk/build</screen>
+<screen><prompt>#</prompt> <userinput>cd /usr/pkgsrc</userinput>
+<prompt>#</prompt> <userinput>sh mk/bulk/build</userinput></screen>
 
 <para>
 If for some reason your last build didn't complete (power failure,
 system panic, ...), you can continue it by running:
 </para>
 
-<screen><prompt>#</prompt> sh mk/bulk/build restart</screen>
+<screen><prompt>#</prompt> <userinput>sh mk/bulk/build restart</userinput></screen>
 
 <para>
 At the end of the bulk run, you will get a summary via mail, and find
@@ -256,7 +259,8 @@
 <para>
 The first step to do so is setting up a chroot sandbox, e.g. <filename>/usr/sandbox</filename>.
 After extracting all the sets from a NetBSD installation or doing a
-<command>make distribution DESTDIR=/usr/sandbox</command> in <filename>/usr/src/etc</filename>, make sure the following
+<command>make distribution DESTDIR=/usr/sandbox</command> in
+<filename>/usr/src/etc</filename>, be sure the following
 items are present and properly configured:
 </para>
 
@@ -264,36 +268,35 @@
 <listitem>
 kernel
 <para>
-<screen><prompt>#</prompt> cp /netbsd /usr/sandbox</screen>
+<screen><prompt>#</prompt> <userinput>cp /netbsd /usr/sandbox</userinput></screen>
 </para>
 </listitem>
 
 <listitem>
 <filename>/dev/*</filename>
 <para>
-<screen><prompt>#</prompt> cd /usr/sandbox/dev ; sh MAKEDEV all</screen>
+<screen><prompt>#</prompt> <userinput>cd /usr/sandbox/dev ; sh MAKEDEV all</userinput></screen>
 </para>
 </listitem>
 
 <listitem>
 <filename>/etc/resolv.conf</filename> (for <pkg>security/smtpd</pkg> and mail):
 <para>
-<screen><prompt>#</prompt> cp /etc/resolv.conf /usr/sandbox/etc</screen>
+<screen><prompt>#</prompt> <userinput>cp /etc/resolv.conf /usr/sandbox/etc</userinput></screen>
 </para>
 </listitem>
 
 <listitem>
 working(!) mail config (hostname, sendmail.cf):
 <para>
-<screen><prompt>#</prompt> cp /etc/mail/sendmail.cf /usr/sandbox/etc/mail</screen>
+<screen><prompt>#</prompt> <userinput>cp /etc/mail/sendmail.cf /usr/sandbox/etc/mail</userinput></screen>
 </para>
 </listitem>
 
 <listitem>
 <filename>/etc/localtime</filename> (for <pkg>security/smtpd</pkg>):
 <para>
-<screen><prompt>#</prompt> ln -sf /usr/share/zoneinfo/GMT
-/usr/sandbox/etc/localtime</screen>
+<screen><prompt>#</prompt> <userinput>ln -sf /usr/share/zoneinfo/GMT /usr/sandbox/etc/localtime</userinput></screen>
 </para>
 </listitem>
 
@@ -301,62 +304,66 @@
 <filename>/usr/src</filename> (system sources, for <pkg>sysutils/aperture</pkg>,
 <pkg>net/ppp-mppe</pkg>):
 <para>
-<screen><prompt>#</prompt> ln -s ../disk1/cvs .
-<prompt>#</prompt> ln -s cvs/src-1.6 src
-<prompt>#</prompt> ln -s cvs/pkgsrc .</screen>
+<screen><prompt>#</prompt> <userinput>ln -s ../disk1/cvs .</userinput>
+<prompt>#</prompt> <userinput>ln -s cvs/src-1.6 src</userinput>
+<prompt>#</prompt> <userinput>ln -s cvs/pkgsrc .</userinput></screen>
 </para>
 </listitem>
 
 <listitem>
 create <filename>/var/db/pkg</filename> (not part of default install):
 <para>
-<screen><prompt>#</prompt> mkdir /usr/sandbox/var/db/pkg</screen>
+<screen><prompt>#</prompt> <userinput>mkdir /usr/sandbox/var/db/pkg</userinput></screen>
 </para>
 </listitem>
 
 <listitem>
 create <filename>/usr/pkg</filename> (not part of default install):
 <para>
-<screen><prompt>#</prompt> mkdir /usr/sandbox/usr/pkg</screen>
+<screen><prompt>#</prompt> <userinput>mkdir /usr/sandbox/usr/pkg</userinput></screen>
 </para>
 </listitem>
 
 <listitem>
-checkout pkgsrc from cvs into
+checkout pkgsrc into
 <filename>/usr/sandbox/usr/pkgsrc</filename>:
 <para>
-<screen><prompt>#</prompt> cvs -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -d -P pkgsrc</screen>
+<screen><prompt>#</prompt> <userinput>cd /usr/sandbox/usr</userinput>
+<prompt>#</prompt> <userinput>cvs -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -d -P pkgsrc</userinput></screen>
 </para>
-/usr/pkgsrc/packages &amp; .../distfiles (point outside of sandbox)
 </listitem>
 
 <listitem>
-<filename>/etc/mk.conf</filename>, see <xref linkend="binary.mk.conf"/>.
+edit <filename>/etc/mk.conf</filename>, see <xref linkend="binary.mk.conf"/>.
 </listitem>
 
 <listitem>
-adjust <filename>mk/bulk/build.conf</filename>
+adjust <filename>mk/bulk/build.conf</filename> to suit your needs.
 </listitem>
 
 </itemizedlist>
 
-<para>
-!!! Don't forget to install X !!!
-If you are a developer and want to upload the resulting binary packages 
-to ftp.NetBSD.org, make sure you are using the default X version for your
-architecture and release (up to 1.6, that is 3.3.6 for all architectures).
-</para>
+<note>
+Don't forget to install X.
+</note>
 
 <para>
-Next thing you will want to is make sure <filename>/usr/sandbox/usr/pkgsrc</filename> contains a
-fresh checkout of pkgsrc (e.g. from anoncvs). Do not mount/link this to the
-copy of your pkgsrc tree you do development in, as this will likely cause
-problems! Adjust <filename>.../pkgsrc/packages</filename> and <filename>.../pkgsrc/distfiles</filename> to point to
-some places outside the sandbox if you want to make the files public. 
+If you are a developer and want to upload the resulting binary packages 
+to ftp.NetBSD.org, be sure you are using the default X version for your
+architecture and release (that is XFree86 3.3.6 for 1.5.x, and XFree86
+4.2.1 for NetBSD 1.6.1 on <ulink url="../../Ports/cats/">cats</ulink>,
+<ulink url="../../Ports/i386/">i386</ulink> and <ulink
+url="../../Ports/macppc/">macppc</ulink> ports, 3.3.6 on all other
+ports).
 </para>
 
 <para>
-Then, configure <filename>.../pkgsrc/mk/bulk/build.conf</filename> to fit your needs!
+The next thing you need is a <emphasis>fresh checkout of pkgsrc</emphasis>
+(e.g. from anoncvs). Do not mount/link this to the copy of your pkgsrc tree
+you do development in, as this will likely cause problems! Adjust
+<filename>.../pkgsrc/packages</filename> and
+<filename>.../pkgsrc/distfiles</filename> to point to some places
+outside the sandbox if you want to make the files public. 
 </para>
 
 <para>
@@ -364,13 +371,14 @@
 steps:
 </para>
 
-<screen><prompt>#</prompt> cd /usr/sandbox/usr/pkgsrc
-<prompt>#</prompt> sh mk/bulk/do-sandbox-build</screen>
+<screen><prompt>#</prompt> <userinput>cd /usr/sandbox/usr/pkgsrc</userinput>
+<prompt>#</prompt> <userinput>sh mk/bulk/do-sandbox-build</userinput></screen>
 
 <para>
-This will just jump inside the sandbox and start thrash^Wbuilding.
+This will just jump inside the sandbox and start building.
 At the end of the build, mail will be sent with the results of the build.
-Created binary pkgs will be in <filename>/usr/sandbox/usr/pkgsrc/packages</filename> (wherever
+Created binary pkgs will be in
+<filename>/usr/sandbox/usr/pkgsrc/packages</filename> (wherever
 that points/mounts to/from).
 </para>
 </sect2>
@@ -382,9 +390,9 @@
 After your bulk pkgsrc build has completed, you may wish to create a CD-ROM
 set of the resulting binary packages to assist in installing packages on
 other machines.  The package pkgsrc/pkgtools/cdpack provides a simple tool for 
-creating the ISO 9660 images. <command>cdpack</command> arranges the packages on the CD-ROMs
-in a way that keeps all the dependencies for given package on the same
-CD as that package.
+creating the ISO 9660 images. <command>cdpack</command> arranges the
+packages on the CD-ROMs in a way that keeps all the dependencies for
+given package on the same CD as that package.
 </para>
 
 <sect2>
@@ -392,36 +400,38 @@
 <para>
 Complete documentation for cdpack is found in cdpack(1).  The following
 short example assumes that the binary packages are left in
-<filename>/usr/pkgsrc/packages/All</filename> and that sufficient disk space exists in <filename>/u2</filename>
-to hold the ISO 9660 images.
+<filename>/usr/pkgsrc/packages/All</filename> and that sufficient disk
+space exists in <filename>/u2</filename> to hold the ISO 9660 images.
 </para>
 
-<screen><prompt>#</prompt> mkdir /u2/images
-<prompt>#</prompt> pkg_add /usr/pkgsrc/packages/All/cdpack
-<prompt>#</prompt> cdpack /usr/pkgsrc/packages/All /u2/images</screen>
+<screen><prompt>#</prompt> <userinput>mkdir /u2/images</userinput>
+<prompt>#</prompt> <userinput>pkg_add /usr/pkgsrc/packages/All/cdpack</userinput>
+<prompt>#</prompt> <userinput>cdpack /usr/pkgsrc/packages/All /u2/images</userinput></screen>
 
 <para>
-If you wish to include a common set of files (<filename>COPYRIGHT</filename>, <filename>README</filename>, etc.)
+If you wish to include a common set of files
+(<filename>COPYRIGHT</filename>, <filename>README</filename>, etc.)
 on each CD in the collection, then you need to create a directory which
-contains these files.  For example
+contains these files. e.g.
 </para>
 
-<screen><prompt>#</prompt> mkdir /tmp/common
-<prompt>#</prompt> echo "This is a README" &gt; /tmp/common/README
-<prompt>#</prompt> echo "Another file" &gt; /tmp/common/COPYING
-<prompt>#</prompt> mkdir /tmp/common/bin
-<prompt>#</prompt> echo "#!/bin/sh" &gt; /tmp/common/bin/myscript
-<prompt>#</prompt> echo "echo Hello world" &gt;&gt; /tmp/common/bin/myscript
-<prompt>#</prompt> chmod 755 /tmp/common/bin/myscript</screen>
+<screen><prompt>#</prompt> <userinput>mkdir /tmp/common</userinput>
+<prompt>#</prompt> <userinput>echo "This is a README" &gt; /tmp/common/README</userinput>
+<prompt>#</prompt> <userinput>echo "Another file" &gt; /tmp/common/COPYING</userinput>
+<prompt>#</prompt> <userinput>mkdir /tmp/common/bin</userinput>
+<prompt>#</prompt> <userinput>echo "#!/bin/sh" &gt; /tmp/common/bin/myscript</userinput>
+<prompt>#</prompt> <userinput>echo "echo Hello world" &gt;&gt; /tmp/common/bin/myscript</userinput>
+<prompt>#</prompt> <userinput>chmod 755 /tmp/common/bin/myscript</userinput></screen>
 
 <para>
-Now create the images with
+Now create the images:
 </para>
 
-<screen><prompt>#</prompt> cdpack -x /tmp/common /usr/pkgsrc/packages/All /u2/images</screen>
+<screen><prompt>#</prompt> <userinput>cdpack -x /tmp/common /usr/pkgsrc/packages/All /u2/images</userinput></screen>
 
 <para>
-and each image will contain <filename>README</filename>, <filename>COPYING</filename>, and <filename>bin/myscript</filename>
+Each image will contain <filename>README</filename>,
+<filename>COPYING</filename>, and <filename>bin/myscript</filename>
 in their root directories.
 </para>
 </sect2>