pkgsrc/doc/guide/files/build.xml: 1.51 -> 1.54

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

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

pkgsrc/doc/guide/files/build.xml: 1.51 -> 1.54
> revision 1.54
> date: 2008/07/23 15:33:44;  author: kano;  state: Exp;  lines: +2 -2
> fix typo
> ----------------------------
> revision 1.53
> date: 2008/07/22 13:14:21;  author: wiz;  state: Exp;  lines: +5 -5
> Fix a typo, and remove information that will get outdated soon.
> ----------------------------
> revision 1.52
> date: 2008/07/22 10:39:36;  author: agc;  state: Exp;  lines: +11 -2
> Document CREATE_WRKDIR_SYMLINK, prompted by Tobias Nygren.

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

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

--- build.xml.orig	2008-07-24 00:40:39.000000000 +0900
+++ build.xml	2008-07-24 00:40:39.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: build.xml,v 1.51 2008/05/27 15:06:25 kano Exp $ -->
+<!-- $NetBSD: build.xml,v 1.54 2008/07/23 15:33:44 kano Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: build.xml,v 1.51 2008/05/27 15:06:25 kano Exp   -->
+<!-- NetBSD: build.xml,v 1.54 2008/07/23 15:33:44 kano Exp   -->
 
 <chapter id="build">
   <title>構築の手順</title>
@@ -156,7 +156,7 @@
     <title>構築の過程で使われるディレクトリー</title>
 
     <para>パッケージの構築時には、ソースファイル、一時ファイル、
-    pkgsrc 内部ファイルなどを置いておくために、多数のディレクトリーが使われます。
+    pkgsrc 内部ファイルなどを置いておくために、さまざまなディレクトリーが使われます。
     そのようなディレクトリーについて説明します。</para>
 
     <para>ディレクトリーを指す変数のなかには、相対パス名を値に持つものがあります。
@@ -196,6 +196,15 @@
       <filename>Makefile</filename> で変更することができます。</para></listitem></varlistentry>
 
     </variablelist>
+
+    <para><varname>CREATE_WRKDIR_SYMLINK</varname> 定義は、
+    <emphasis>yes</emphasis> または <emphasis>no</emphasis> のいずれかの値をとり、
+    標準状態では <emphasis>yes</emphasis> になります。これは、
+    pkgsrc の個々のパッケージのディレクトリー内に、
+    <varname>WRKDIR</varname> へのシンボリックリンクを作成するか否かを示します。
+    pkgsrc ツリーを読み取り専用として使いたい場合は、
+    <varname>CREATE_WRKDIR_SYMLINK</varname> の値を
+    <emphasis>no</emphasis> にしてください。
   </sect1>
 
   <sect1 id="build.running">
Index: build.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/build.xml,v
retrieving revision 1.51
retrieving revision 1.54
diff -u -r1.51 -r1.54
--- build.xml	27 May 2008 15:06:25 -0000	1.51
+++ build.xml	23 Jul 2008 15:33:44 -0000	1.54
@@ -1,4 +1,4 @@
-<!-- $NetBSD: build.xml,v 1.51 2008/05/27 15:06:25 kano Exp $ -->
+<!-- $NetBSD: build.xml,v 1.54 2008/07/23 15:33:44 kano Exp $ -->
 
 <chapter id="build">
   <title>The build process</title>
@@ -169,7 +169,7 @@
   <sect1 id="build.builddirs">
     <title>Directories used during the build process</title>
 
-    <para>When building a package, a number of directories is used to store
+    <para>When building a package, various directories are used to store
     source files, temporary files, pkgsrc-internal files, and so on. These
     directories are explained here.</para>
 
@@ -210,6 +210,15 @@
       <filename>Makefile</filename>.</para></listitem></varlistentry>
 
     </variablelist>
+
+    <para>The <varname>CREATE_WRKDIR_SYMLINK</varname> definition takes either
+    the value <emphasis>yes</emphasis> or <emphasis>no</emphasis> and defaults
+    to <emphasis>yes</emphasis>. It indicates whether a symbolic link to the
+    <varname>WRKDIR</varname> is to be created in the pkgsrc entry's directory.
+    If users would like to have their pkgsrc trees behave in a
+    read-only manner, then the value of
+    <varname>CREATE_WRKDIR_SYMLINK</varname> should be set to
+    <emphasis>no</emphasis>.
   </sect1>
 
   <sect1 id="build.running">