Documentation/pkgsrc/binary/chapter.xml: 1.10 -> 1.11

[kano@na.rim.or.jp (OKANO Takayoshi)]

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

Documentation/pkgsrc/binary/chapter.xml: 1.10 -> 1.11

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

> revision 1.11
> date: 2003/06/23 07:03:03;  author: grant;  state: Exp;  lines: +153 -141
> markup, style and typo fixes.

以下、訳と原文それぞれの、
1.10 から字下げと改行位置を調整したものと 1.11 との差分です。

--- chapter.xml.orig	2006-03-25 10:29:47.000000000 +0900
+++ chapter.xml	2006-03-25 11:29:29.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: chapter.xml,v 1.10 2003/06/20 04:50:36 grant Exp $ -->
+<!-- $NetBSD: chapter.xml,v 1.11 2003/06/23 07:03:03 grant Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: chapter.xml,v 1.10 2003/06/20 04:50:36 grant Exp   -->
+<!-- NetBSD: chapter.xml,v 1.11 2003/06/23 07:03:03 grant Exp   -->
 
 <chapter id="binary"> <?dbhtml filename="binary.html"?>
 <title>バイナリーパッケージを作る</title>
@@ -112,9 +112,9 @@
 <para>
   バルクビルドでは、ビルド前の段階の最後に、サイト独自の作業を行なうよう設定
   することができます。<filename>/usr/pkgsrc/mk/bulk</filename>に
-  <quote>pre-build.local</quote>ファイルがあると、ビ
+  <filename>pre-build.local</filename>ファイルがあると、ビ
   ルド前の段階の最後に、このファイルが(sh(1)スクリプトとして)実行されます。
-  pre-build.localの使い方の例としては、このファイルに
+  <filename>pre-build.local</filename>の使い方の例としては、このファイルに
 </para>
 
 <screen><prompt>#</prompt> <userinput>echo "I do not have enough disk space to build this pig." \
@@ -135,7 +135,7 @@
   に合わせてパスワードファイルも修正して)おくか、<filename>/etc/rc.local</filename>で<command>pkg_add</command>を使っ
   て(再)インストールするようにしておきます。これでリブート後もログインできま
   す(パッケージが削除されてもシェルのプロセスは死なず、シェルを新たに起動でき
-  なくなるだけです)。また、1.5より前のバージョンのOSを使っていたり、何らかの
+  なくなるだけです)。また、1.5より前のNetBSDを使っていたり、何らかの
   理由でpkgsrc版のsshを使いたい場合は、rc.localでsshdが起動する前にsshをイン
   ストールするようにしておきます:
 </para>
@@ -155,7 +155,11 @@
 <title>操作</title>
 <para>
   すでにインストールされているどのパッケージも必要ない状態にしてください。
-  注意: バルクビルドの過程で、 *すべての* パッケージが削除されます!!! その他、
+  <warning>
+    バルクビルドの過程で、<emphasis>すべてのパッケージが
+    削除されます!</emphasis>
+  </warning>
+  その他、
   構築の妨げになりうるもの(<filename>/usr/local</filename>にインストールされているライブラリーなど) 
   もすべて削除しておいてください。root になって、以下のようにタイプします:
 </para>
@@ -171,8 +175,8 @@
 <screen><prompt>#</prompt> <userinput>sh mk/bulk/build restart</userinput></screen>
 
 <para>
-  バルクビルド実行が終わると、その要約がメールで届きます。また、<quote>build.conf</quote>
-  ファイルの<quote>FTP</quote>で指定したディレクトリーに、構築ログがあります。
+  バルクビルド実行が終わると、その要約がメールで届きます。また、<filename>build.conf</filename>
+  ファイルの<varname>FTP</varname>で指定したディレクトリーに、構築ログがあります。
 </para>
 </sect2>
 
@@ -184,18 +188,16 @@
 
 <orderedlist>
 
-<listitem>
+<listitem>ビルド前
 <para>
-  ビルド前:
   スクリプトがpkgsrcを(anon)cvsで更新します。そして、壊れている
   distfileをすべて一掃し、インストールされているパッケージをすべて削
   除します。
 </para>
 </listitem>
 
-<listitem>
+<listitem>バルクビルド
 <para>
-  バルクビルド:
   これは基本的に、<quote>make bulk-package</quote>を、パッケージの構築順
   序を最適化しておこなうものです。他のパッケージに依存しないパッケー
   ジが最初に構築され、多くの依存関係を持つパッケージは後に構築されま
@@ -203,11 +205,10 @@
 </para>
 </listitem>
 
-<listitem>
+<listitem>ビルド後
 <para>
-  ビルド後:
-  報告を作成し、build.confで指定されたディレクトリーに
-  <quote>broken.html</quote> という名前で置きます。あわせて、この報告の簡略版が
+  報告を作成し、<filename>build.conf</filename>で指定されたディレクトリーに
+  <filename>broken.html</filename> という名前で置きます。あわせて、この報告の簡略版が
   構築管理者にメールで送られます。
 </para>
 </listitem>
@@ -216,7 +217,7 @@
 
 <para>
   構築中、壊れているパッケージの一覧が<filename>/usr/pkgsrc/.broken</filename>
-  (OBJMACHINE
+  (<varname>OBJMACHINE</varname>
   が設定されている場合は
   <filename>.../.broken.${MACHINE}</filename>)
   に作られ、構築が壊れているものの個々の
--- chapter.xml.orig	2006-03-25 10:31:54.000000000 +0900
+++ chapter.xml	2006-03-25 09:51:38.000000000 +0900
@@ -1,4 +1,4 @@
-<!-- $NetBSD: chapter.xml,v 1.10 2003/06/20 04:50:36 grant Exp $ -->
+<!-- $NetBSD: chapter.xml,v 1.11 2003/06/23 07:03:03 grant Exp $ -->
 
 <chapter id="binary"> <?dbhtml filename="binary.html"?>
 <title>Creating binary packages</title>
@@ -108,10 +108,11 @@
 <para>
   It is possible to configure the bulk build to perform certain site 
   specific tasks at the end of the pre-build stage.  If the file
-  <quote>pre-build.local</quote> exists in
+  <filename>pre-build.local</filename> exists in
   <filename>/usr/pkgsrc/mk/bulk</filename> it will be executed
   (as a sh(1) script) at the end of the usual pre-build stage.  An
-  example use of pre-build.local is to have the line:
+  example use of <filename>pre-build.local</filename> is to have the
+  line:
 </para>
 
 <screen><prompt>#</prompt> <userinput>echo "I do not have enough disk space to build this pig." \
@@ -135,8 +136,9 @@
   <filename>/etc/rc.local</filename>, so you can login after a reboot
   (remember that your current process won't die if the package is
   removed, you just can't start any new instances of the shell any more).
-  Also, if you use a OS version below 1.5 or you still want to use the
-  pkgsrc version of ssh for some reason, be sure to
+  Also, if you use NetBSD earlier than 1.5, or you still want to use the
+  pkgsrc version of ssh for some reason, be sure to install ssh before
+  starting it from rc.local:
 </para>
 
 <programlisting>( cd /usr/pkgsrc/security/ssh ; make bulk-install )
@@ -155,7 +157,10 @@
 <title>Operation</title>
 <para>
   Make sure you don't need any of the packages still installed.
-  BEWARE: During the bulk build, ALL packages will be removed!!!
+  <warning>
+    During the bulk build, <emphasis>all packages will be
+    removed!</emphasis>
+  </warning>
   Be sure to remove all other things that might
   interfere with builds, like some libs installed in
   <filename>/usr/local</filename>, etc. then become root and type:
@@ -173,8 +178,8 @@
 
 <para>
   At the end of the bulk run, you will get a summary via mail, and find
-  build logs in the directory specified by <quote>FTP</quote> in the
-  <quote>build.conf</quote> file.
+  build logs in the directory specified by <varname>FTP</varname> in the
+  <filename>build.conf</filename> file.
 </para>
 </sect2>
 
@@ -186,17 +191,15 @@
 
 <orderedlist>
 
-<listitem>
+<listitem>pre-build
 <para>
-  pre-build:
   The script updates your pkgsrc via (anon)cvs, then cleans
   out any broken distfiles, and removes all packages installed.
 </para>
 </listitem>
 
-<listitem>
+<listitem>the bulk build
 <para>
-  the bulk build:
   This is basically <quote>make bulk-package</quote> with an optimised
   order in which packages will be built. Packages that don't require
   other packages will be built first, and packages with many depends
@@ -204,12 +207,11 @@
 </para>
 </listitem>
 
-<listitem>
+<listitem>post-build
 <para>
-  post-build:
   Generates a report that's placed in the directory specified
-  in the build.conf file named
-  <quote>broken.html</quote>, a short version of
+  in the <filename>build.conf</filename> file named
+  <filename>broken.html</filename>, a short version of
   that report will also be mailed to the build's admin.
 </para>
 </listitem>
@@ -220,7 +222,7 @@
   During the build, a list of broken packages will be compiled in
   <filename>/usr/pkgsrc/.broken</filename> (or
   <filename>.../.broken.${MACHINE}</filename> if
-  OBJMACHINE is set),
+  <varname>OBJMACHINE</varname> is set),
   individual build logs of broken builds can be found in the package's
   directory. These files are used by the bulk-targets to mark broken builds
   to not waste time trying to rebuild them, and they can be used to debug