[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/configuring.xml: 1.27 -> 1.28 ほか

Subject: pkgsrc/doc/guide/files/configuring.xml: 1.27 -> 1.28 ほか
From: kano@na.rim.or.jp (OKANO Takayoshi)
To: www-changes-ja@jp.NetBSD.org
Date: Sat, 11 Aug 2007 20:28:42 +0900 (JST)
Message-Id: <200708111128.UAA14347@shell.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/configuring.xml: 1.27 -> 1.28
pkgsrc/doc/guide/files/fixes.xml: 1.87 -> 1.88

> Move DESTDIR documentation to guide.
(pkgsrc/doc/HOWTO-destdir からのマージ)

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

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

--- configuring.xml.orig	2007-08-11 20:26:43.000000000 +0900
+++ configuring.xml	2007-08-11 20:26:43.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: configuring.xml,v 1.27 2007/06/01 11:07:24 rillig Exp $ -->
+<!-- $NetBSD: configuring.xml,v 1.28 2007/08/10 00:51:51 wiz Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: configuring.xml,v 1.27 2007/06/01 11:07:24 rillig Exp   -->
+<!-- NetBSD: configuring.xml,v 1.28 2007/08/10 00:51:51 wiz Exp   -->
 
 <chapter id="configuring">
   <title>pkgsrc を設定する</title>
@@ -130,6 +130,45 @@
       </itemizedlist></para>
   </sect1>
 
+  <sect1 id="variables-affecting-installation">
+    <title>インストール過程に影響をおよぼす変数</title>
+
+    <para><varname>WRKDIR</varname> のサブディレクトリーへのインストールに
+    対応したパッケージが増えています。そのようにインストールをすれば、
+    本番のファイルシステムに手を加えずにパッケージを構築することができます。
+    DESTDIR への対応には、以下の二通りの形態があります。</para>
+    <itemizedlist>
+      <listitem><para>基本的な (basic) DESTDIR 対応。
+      パッケージのインストールや、バイナリーパッケージ作成は、
+      通常と同じく root で実行します。</para></listitem>
+      <listitem><para>完全な (full) DESTDIR 対応。
+      完全な構築、インストール、バイナリーパッケージ作成を、
+      通常ユーザー権限でおこなうことができます。root 権限が必要なのは、
+      パッケージを追加するときだけです。</para></listitem>
+    </itemizedlist>
+    <para>DESTDIR に対応しているパッケージで、これを利用する方法は、
+    基本的な対応なら <varname>USE_DESTDIR=yes</varname> を、
+    完全な対応なら (失敗した場合は、基本的な対応に切り替わります)
+    <varname>USE_DESTDIR=full</varname>
+    を使います。
+    <varname>USE_DESTDIR=full</varname> を使うには、<filename
+    role="pkg">pkgtools/pkg_install</filename> のバージョン 20070802 (以降)
+    が必要となります。
+    将来は、DESTDIR への対応が標準となるかもしれません。</para>
+    <para>DESTDIR への対応によって、各種ターゲットの挙動が少し変わります。
+    パッケージを構築してからインストールする場合は、
+    <literal>package-install</literal> を使ってください。<literal>package</literal>
+    および <literal>install</literal> の各ターゲットは、何もしてくれません。
+    <literal>package-install</literal> は、
+    <varname>DEPENDS_TARGET</varname> にすることができます。
+    <literal>bin-install</literal>
+    は、インストール用に root のパスワードを尋ねてきますが、
+    その後に失敗し、
+    <literal>package-install</literal> があらためてパスワードを尋ねてきます。</para>
+    <para>基本的な DESTDIR 対応を使う場合、<userinput>make
+    clean</userinput> は root で実行する必要があります。</para>
+  </sect1>
+
 <sect1 id="conf.compiler">
 <title>コンパイラーの選択と設定</title>
 
--- fixes.xml.orig	2007-08-11 20:26:45.000000000 +0900
+++ fixes.xml	2007-08-11 20:26:45.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: fixes.xml,v 1.87 2007/06/01 11:07:25 rillig Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.88 2007/08/10 00:51:51 wiz Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: fixes.xml,v 1.87 2007/06/01 11:07:25 rillig Exp   -->
+<!-- NetBSD: fixes.xml,v 1.88 2007/08/10 00:51:51 wiz Exp   -->
 
 <chapter id="fixes"> <?dbhtml filename="fixes.html"?>
 <title>パッケージを動くようにする</title>
@@ -1311,6 +1311,31 @@
     の設定に応じて適切に設定されるようにします。</para>
   </sect2>
 
+  <sect2 id="destdir-support">
+    <title>パッケージを DESTDIR に対応させる</title>
+
+    <itemizedlist>
+      <listitem><para>すべてのインストール操作では、インストール先を
+      <filename>${DESTDIR}</filename> から始まる場所にする必要があります。</para></listitem>
+
+      <listitem><para>automake は、たいていは、この DESTDIR に対して、
+      自動的に対処します。自動化されていない処理や pre/post-install
+      では、不適切に処理されることが多いので、修正してください。</para></listitem>
+
+      <listitem><para>ファイルが、特別な所有者や所有グループでインストールされる場合は、
+      <filename>PLIST</filename> で @owner/@group を使う (推奨) か、
+      <varname>SPECIAL_PERMS</varname> を使う (非推奨) か、いずれかの方法をとってください。
+      なお、@owner/@group はインストールの間だけ有効となるものですので、
+      注意してください。</para></listitem>
+
+      <listitem><para>一般的に、各パッケージは、
+      DESTDIR を使えるようにするために、
+      <varname>UNPRIVILEGED</varname> に対応させるようにしてください。
+</para></listitem>
+
+    </itemizedlist>
+  </sect2>
+
 
   <sect2 id="hardcoded-paths">
     <title>その他のインタープリターへのパスがハードコードされているパッケージ</title>
Index: configuring.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/configuring.xml,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- configuring.xml	1 Jun 2007 11:07:24 -0000	1.27
+++ configuring.xml	10 Aug 2007 00:51:51 -0000	1.28
@@ -1,4 +1,4 @@
-<!-- $NetBSD: configuring.xml,v 1.27 2007/06/01 11:07:24 rillig Exp $ -->
+<!-- $NetBSD: configuring.xml,v 1.28 2007/08/10 00:51:51 wiz Exp $ -->
 
 <chapter id="configuring">
   <title>Configuring pkgsrc</title>
@@ -129,6 +129,40 @@
       </itemizedlist></para>
   </sect1>
 
+  <sect1 id="variables-affecting-installation">
+    <title>Variables affecting the installion process</title>
+
+    <para>A growing number of packages support installation into a
+    subdirectory of <varname>WRKDIR</varname>. This allows a package
+    to be built, before the actual filesystem is touched. DESTDIR
+    support exists in two variations:</para>
+    <itemizedlist>
+      <listitem><para>Basic DESTDIR support means that the package
+      installation and packaging is still run as
+      root.</para></listitem>
+      <listitem><para>Full DESTDIR support can run the complete build,
+      installation and packaging as normal user. Root privileges are
+      only needed to add packages.</para></listitem>
+    </itemizedlist>
+    <para>To use the DESTDIR support, set either
+    <varname>USE_DESTDIR=yes</varname> to use the basic support for
+    packages that offer it or <varname>USE_DESTDIR=full</varname> to
+    get the full support with fallback to basic
+    support. <varname>USE_DESTDIR=full</varname> needs <filename
+    role="pkg">pkgtools/pkg_install</filename> version 20070802 (or
+    newer). It might become the default DESTDIR support later.</para>
+    <para>DESTDIR support changes the behaviour of various targets
+    slightly. To install a package after building it, use
+    <literal>package-install</literal>. <literal>package</literal> and
+    <literal>install</literal> don't do that any
+    longer. <literal>package-install</literal> can be used as
+    <varname>DEPENDS_TARGET</varname>.  <literal>bin-install</literal>
+    will ask for the root password to install the package and fail,
+    <literal>package-install</literal> will ask again.</para>
+    <para>With basic DESTDIR support, <userinput>make
+    clean</userinput> needs to be run as root.</para>
+  </sect1>
+
 <sect1 id="conf.compiler">
 <title>Selecting and configuring the compiler</title>
 
Index: fixes.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/fixes.xml,v
retrieving revision 1.87
retrieving revision 1.88
diff -u -r1.87 -r1.88
--- fixes.xml	1 Jun 2007 11:07:25 -0000	1.87
+++ fixes.xml	10 Aug 2007 00:51:51 -0000	1.88
@@ -1,4 +1,4 @@
-<!-- $NetBSD: fixes.xml,v 1.87 2007/06/01 11:07:25 rillig Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.88 2007/08/10 00:51:51 wiz Exp $ -->
 
 <chapter id="fixes"> <?dbhtml filename="fixes.html"?>
 <title>Making your package work</title>
@@ -1336,6 +1336,30 @@
     correctly.</para>
   </sect2>
 
+  <sect2 id="destdir-support">
+    <title>Adding DESTDIR support to packages</title>
+
+    <itemizedlist>
+      <listitem><para>All installation operations have to be prefixed with
+      <filename>${DESTDIR}</filename>.</para></listitem>
+
+      <listitem><para>automake gets this DESTDIR mostly right
+      automatically. Many manual rules and pre/post-install often are
+      incorrect; fix them.</para></listitem>
+
+      <listitem><para>If files are installed with special owner/group
+      either use @owner/@group in the <filename>PLIST</filename>
+      (preferred) or use <varname>SPECIAL_PERMS</varname>
+      (discouraged). Note that @owner/@group are sticky during
+      install, keep this in mind.</para></listitem>
+
+      <listitem><para>In general, packages should support
+      <varname>UNPRIVILEGED</varname> to be able to use
+      DESTDIR.</para></listitem>
+
+    </itemizedlist>
+  </sect2>
+
 
   <sect2 id="hardcoded-paths">
     <title>Packages with hardcoded paths to other interpreters</title>
Prev by Date: docs/updating.xml: 1.3 -> 1.5
Next by Date: changes/2001.xml
Prev by thread: docs/updating.xml: 1.3 -> 1.5
Next by thread: changes/2001.xml
Index(es):
- Date
- Thread