pkgsrc/doc/guide/files/fixes.xml: 1.93 -> 1.94

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

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

pkgsrc/doc/guide/files/fixes.xml: 1.93 -> 1.94
> revision 1.94
> date: 2008/06/22 15:22:44;  author: wiz;  state: Exp;  lines: +15 -2
> Describe what DESTDIR means and improve description what to do for packages.
> Fix a typo while here.

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

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

--- fixes.xml.orig	2008-07-26 00:24:56.000000000 +0900
+++ fixes.xml	2008-07-26 00:24:56.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: fixes.xml,v 1.93 2008/05/29 08:34:26 abs Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.94 2008/06/22 15:22:44 wiz Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: fixes.xml,v 1.93 2008/05/29 08:34:26 abs Exp   -->
+<!-- NetBSD: fixes.xml,v 1.94 2008/06/22 15:22:44 wiz Exp   -->
 
 <chapter id="fixes"> <?dbhtml filename="fixes.html"?>
 <title>パッケージを動くようにする</title>
@@ -1316,7 +1316,22 @@
   <sect2 id="destdir-support">
     <title>パッケージを DESTDIR に対応させる</title>
 
+    <para>パッケージが <varname>DESTDIR</varname> に対応しているというのは、
+    ファイルを最終的な置き場所にインストールせずに、
+    足場となるディレクトリーにインストールするということです。
+    その後、通常の方法でインストール可能なバイナリーパッケージが作成されます。
+    この対応には、二つの方法があります。
+    パッケージを root としてインストールする必要がある場合
+    (<quote>destdir</quote>)と、root 以外のユーザーでインストール可能な場合
+    (<quote>user-destdir</quote>) です。</para>
+
     <itemizedlist>
+      <listitem><para><varname>PKG_DESTDIR_SUPPORT</varname> を、
+      <quote>destdir</quote> または <quote>user-destdir</quote> のいずれかに設定する必要があります。
+      Makefile で bsd.prefs.mk をインクルードする場合、
+      <varname>PKG_DESTDIR_SUPPORT</varname> は、
+      インクルードの前に設定する必要があります。</para></listitem>
+
       <listitem><para>すべてのインストール操作では、インストール先を
       <filename>${DESTDIR}</filename> から始まる場所にする必要があります。</para></listitem>
 
Index: fixes.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/fixes.xml,v
retrieving revision 1.93
retrieving revision 1.94
diff -u -r1.93 -r1.94
--- fixes.xml	29 May 2008 08:34:26 -0000	1.93
+++ fixes.xml	22 Jun 2008 15:22:44 -0000	1.94
@@ -1,4 +1,4 @@
-<!-- $NetBSD: fixes.xml,v 1.93 2008/05/29 08:34:26 abs Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.94 2008/06/22 15:22:44 wiz Exp $ -->
 
 <chapter id="fixes"> <?dbhtml filename="fixes.html"?>
 <title>Making your package work</title>
@@ -1332,7 +1332,7 @@
     disabled;  setting <varname>SETGIDGAME=YES</varname> will set all
     the other variables accordingly.</para>
 
-    <para>A package should therefor never hard code file ownership or
+    <para>A package should therefore never hard code file ownership or
     access permissions but rely on <varname>INSTALL_GAME</varname> and
     <varname>INSTALL_GAME_DATA</varname> to set these
     correctly.</para>
@@ -1341,7 +1341,20 @@
   <sect2 id="destdir-support">
     <title>Adding DESTDIR support to packages</title>
 
+    <para><varname>DESTDIR</varname> support means that a package
+    installs into a staging directory, not the final location of the
+    files. Then a binary package is created which can be used for
+    installation as usual. There are two ways: Either the package must
+    install as root (<quote>destdir</quote>) or the package can
+    install as non-root user (<quote>user-destdir</quote>).</para>
+
     <itemizedlist>
+      <listitem><para><varname>PKG_DESTDIR_SUPPORT</varname> has to be
+      set to <quote>destdir</quote> or <quote>user-destdir</quote>. If
+      bsd.prefs.mk is included in the Makefile,
+      <varname>PKG_DESTDIR_SUPPORT</varname> needs to be set before
+      the inclusion.</para></listitem>
+
       <listitem><para>All installation operations have to be prefixed with
       <filename>${DESTDIR}</filename>.</para></listitem>