[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/build.xml: 1.18 -> 1.20
以下のページの更新をしました。ツッコミをお願いします。
pkgsrc/doc/guide/files/build.xml: 1.18 -> 1.20
> revision 1.20
> date: 2006/01/12 21:46:33; author: wiz; state: Exp; lines: +2 -2
> s/unstripped/stripped/
> ----------------------------
> revision 1.19
> date: 2006/01/11 22:35:31; author: rillig; state: Exp; lines: +47 -10
> [The ''install'' phase] Documented the various INSTALL_* variables.
水曜日までに異議がなければ、 commit します。
差分で出てくる最初の段落の変更点は、
varname の内容から $ がなくなっただけです。
以下、訳と原文それぞれの新旧の差分です。
--- build.xml.orig 2006-10-24 23:04:02.000000000 +0900
+++ build.xml 2006-10-24 23:04:02.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: build.xml,v 1.18 2006/01/07 21:42:34 rillig Exp $ -->
+<!-- $NetBSD: build.xml,v 1.20 2006/01/12 21:46:33 wiz Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: build.xml,v 1.18 2006/01/07 21:42:34 rillig Exp -->
+<!-- NetBSD: build.xml,v 1.20 2006/01/12 21:46:33 wiz Exp -->
<chapter id="build">
<title>構築の手順</title>
@@ -382,12 +382,48 @@
<sect1 id="build.install">
<title><emphasis>install</emphasis> 相</title>
- <para>構築の段階が完了すると、ユーザーが構築されたプログラムやファイルを使えるようにするため、ソフトウェアをパブリックなディレ
- クトリーにインストールする必要があります。buildターゲットと同様に、
- <varname>$MAKE_PROGRAM</varname>が<varname>$MAKEFILE</varname>中で起動されます。ただし、<varname>$INSTALL_TARGET</varname>が指定
- されます。この変数のデフォルトは<quote>install</quote>です。(もし<varname>USE_IMAKE</varname>が設定さ
- れていれば、<quote>install.man</quote>も追加されます)。</para>
-
+ <para>構築の段階が完了すると、ユーザーが構築されたプログラムやファイルを使えるようにするため、ソフトウェアをパブリックなディレ
+ クトリーにインストールする必要があります。buildターゲットと同様に、
+ <varname>MAKE_PROGRAM</varname>が<varname>MAKEFILE</varname>中で起動されます。ただし、<varname>INSTALL_TARGET</varname>が指定
+ されます。この変数のデフォルトは<quote>install</quote>です。(もし<varname>USE_IMAKE</varname>が設定さ
+ れていれば、<quote>install.man</quote>も追加されます)。</para>
+
+ <para><emphasis>install</emphasis> 相では、以下の変数が有用です。
+ これらはいずれも &man.install.1; コマンドの変種であり、
+ 所有者、所有グループ、パーミッションをあらかじめ決めてあるものです。
+ <varname>INSTALL</varname> は、オプションを何も指定しない install コマンドです。
+ 用途別に特化した変種には、以下のものがあります。</para>
+
+ <variablelist>
+<!-- template:
+ <varlistentry><term><varname></varname></term>
+ <listitem><para></para></listitem></varlistentry>
+-->
+ <varlistentry><term><varname>INSTALL_PROGRAM_DIR</varname></term>
+ <listitem><para>バイナリーを含むディレクトリー</para></listitem></varlistentry>
+ <varlistentry><term><varname>INSTALL_SCRIPT_DIR</varname></term>
+ <listitem><para>スクリプトを含むディレクトリー</para></listitem></varlistentry>
+ <varlistentry><term><varname>INSTALL_LIB_DIR</varname></term>
+ <listitem><para>共有静的ライブラリーを含むディレクトリー</para></listitem></varlistentry>
+ <varlistentry><term><varname>INSTALL_DATA_DIR</varname></term>
+ <listitem><para>データファイルを含むディレクトリー</para></listitem></varlistentry>
+ <varlistentry><term><varname>INSTALL_MAN_DIR</varname></term>
+ <listitem><para>マニュアルページを含むディレクトリー</para></listitem></varlistentry>
+ <varlistentry><term><varname>INSTALL_PROGRAM</varname></term>
+ <listitem><para>デバッグ用シンボルを取り除くことのできるバイナリー</para></listitem></varlistentry>
+ <varlistentry><term><varname>INSTALL_SCRIPT</varname></term>
+ <listitem><para>シンボルを取り除くことのできないバイナリー</para></listitem></varlistentry>
+ <varlistentry><term><varname>INSTALL_GAME</varname></term>
+ <listitem><para>ゲームのバイナリー</para></listitem></varlistentry>
+ <varlistentry><term><varname>INSTALL_LIB</varname></term>
+ <listitem><para>共有静的ライブラリー</para></listitem></varlistentry>
+ <varlistentry><term><varname>INSTALL_DATA</varname></term>
+ <listitem><para>データファイル</para></listitem></varlistentry>
+ <varlistentry><term><varname>INSTALL_GAME_DATA</varname></term>
+ <listitem><para>ゲーム用のデータファイル</para></listitem></varlistentry>
+ <varlistentry><term><varname>INSTALL_MAN</varname></term>
+ <listitem><para>マニュアルページ</para></listitem></varlistentry>
+ </variablelist>
</sect1>
<sect1 id="build.package">
Index: build.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/build.xml,v
retrieving revision 1.18
retrieving revision 1.20
diff -u -r1.18 -r1.20
--- build.xml 7 Jan 2006 21:42:34 -0000 1.18
+++ build.xml 12 Jan 2006 21:46:33 -0000 1.20
@@ -1,4 +1,4 @@
-<!-- $NetBSD: build.xml,v 1.18 2006/01/07 21:42:34 rillig Exp $ -->
+<!-- $NetBSD: build.xml,v 1.20 2006/01/12 21:46:33 wiz Exp $ -->
<chapter id="build">
<title>The build process</title>
@@ -399,15 +399,52 @@
<sect1 id="build.install">
<title>The <emphasis>install</emphasis> phase</title>
- <para>Once the build stage has completed, the final step is to install
- the software in public directories, so users can access
- the programs and files. As in the
- build-target, <varname>$MAKE_PROGRAM</varname> is invoked on
- <varname>$MAKEFILE</varname> here, but with the
- <varname>$INSTALL_TARGET</varname> instead, the latter defaulting to
- <quote>install</quote> (plus <quote>install.man</quote>, if
- <varname>USE_IMAKE</varname> is set).</para>
-
+ <para>Once the build stage has completed, the final step is to
+ install the software in public directories, so users can access
+ the programs and files. As in the build-target,
+ <varname>MAKE_PROGRAM</varname> is invoked on
+ <varname>MAKEFILE</varname> here, but with the
+ <varname>INSTALL_TARGET</varname> instead, the latter defaulting
+ to <quote>install</quote> (plus <quote>install.man</quote>, if
+ <varname>USE_IMAKE</varname> is set).</para>
+
+ <para>In the <emphasis>install</emphasis> phase, the following
+ variables are useful. They are all variations of the
+ &man.install.1; command that have the owner, group and
+ permissions preset. <varname>INSTALL</varname> is the plain
+ install command. The specialized variants, together with their
+ intended use, are:</para>
+
+ <variablelist>
+<!-- template:
+ <varlistentry><term><varname></varname></term>
+ <listitem><para></para></listitem></varlistentry>
+-->
+ <varlistentry><term><varname>INSTALL_PROGRAM_DIR</varname></term>
+ <listitem><para>directories that contain binaries</para></listitem></varlistentry>
+ <varlistentry><term><varname>INSTALL_SCRIPT_DIR</varname></term>
+ <listitem><para>directories that contain scripts</para></listitem></varlistentry>
+ <varlistentry><term><varname>INSTALL_LIB_DIR</varname></term>
+ <listitem><para>directories that contain shared and static libraries</para></listitem></varlistentry>
+ <varlistentry><term><varname>INSTALL_DATA_DIR</varname></term>
+ <listitem><para>directories that contain data files</para></listitem></varlistentry>
+ <varlistentry><term><varname>INSTALL_MAN_DIR</varname></term>
+ <listitem><para>directories that contain man pages</para></listitem></varlistentry>
+ <varlistentry><term><varname>INSTALL_PROGRAM</varname></term>
+ <listitem><para>binaries that can be stripped from debugging symbols</para></listitem></varlistentry>
+ <varlistentry><term><varname>INSTALL_SCRIPT</varname></term>
+ <listitem><para>binaries that cannot be stripped</para></listitem></varlistentry>
+ <varlistentry><term><varname>INSTALL_GAME</varname></term>
+ <listitem><para>game binaries</para></listitem></varlistentry>
+ <varlistentry><term><varname>INSTALL_LIB</varname></term>
+ <listitem><para>shared and static libraries</para></listitem></varlistentry>
+ <varlistentry><term><varname>INSTALL_DATA</varname></term>
+ <listitem><para>data files</para></listitem></varlistentry>
+ <varlistentry><term><varname>INSTALL_GAME_DATA</varname></term>
+ <listitem><para>data files for games</para></listitem></varlistentry>
+ <varlistentry><term><varname>INSTALL_MAN</varname></term>
+ <listitem><para>man pages</para></listitem></varlistentry>
+ </variablelist>
</sect1>
<sect1 id="build.package">