[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Documentation/pkgsrc/build.xml: 1.3 -> 1.4
以下のページの更新をしました。ツッコミをお願いします。
Documentation/pkgsrc/build.xml: 1.3 -> 1.4
> revision 1.4
> date: 2004/09/29 23:04:30; author: hubertf; state: Exp; lines: +64 -26
> Moving stuff around a lot, FAQ is down from 50 to 15 items.
改行位置の調整と、若干の加筆がおこなわれています。
項目の移動などはありません。
火曜日までに異議がなければ、 commit します。
以下、訳と原文それぞれの新旧の差分です。
--- Documentation/pkgsrc/build.xml.orig 2006-08-07 22:22:19.000000000 +0900
+++ Documentation/pkgsrc/build.xml 2006-08-07 22:22:19.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: build.xml,v 1.3 2004/09/29 13:08:36 hubertf Exp $ -->
+<!-- $NetBSD: build.xml,v 1.4 2004/09/29 23:04:30 hubertf Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: build.xml,v 1.3 2004/09/29 13:08:36 hubertf Exp -->
+<!-- NetBSD: build.xml,v 1.4 2004/09/29 23:04:30 hubertf Exp -->
<chapter id="build">
<title>構築の手順</title>
@@ -165,13 +165,41 @@
<term>extract</term>
<listitem>
- <para>distfileがローカルシステム上に存在している場合、通常、それらは圧縮アーカ
- イブフォーマットで保存されているので、展開する必要があります。もっとも一
- 般なフォーマットは<filename>.tar.gz</filename>です。もし、すべてのdistfileを伸張する必要がな
- いのであれば、伸張するファイルを<varname>EXTRACT_ONLY</varname>に設定してください。もし
- distfileが<filename>.tar.gz</filename>フォーマットでなければ、<varname>EXTRACT_CMD</varname>、
- <varname>EXTRACT_BEFORE_ARGS</varname>、そして<varname>EXTRACT_AFTER_ARGS</varname>を設定することにより、それ
- らを展開することができます。</para>
+ <para>distfileがローカルシステム上に存在している場合、
+ 通常、それらは圧縮アーカイブフォーマットで保存されているので、
+ 展開する必要があります。もっとも一般なフォーマットは
+ <filename>.tar.gz</filename> です。
+
+ <para> もし、すべてのdistfileを伸張する必要がないのであれば、
+ 伸張するファイルを
+ <varname>EXTRACT_ONLY</varname> に設定してください。
+
+ <para> もし distfile が
+ <filename>.tar.gz</filename> フォーマットでなければ、
+ <varname>EXTRACT_SUFX</varname> を設定するか、
+ <varname>EXTRACT_CMD</varname>,
+ <varname>EXTRACT_BEFORE_ARGS</varname>,
+ <varname>EXTRACT_AFTER_ARGS</varname> を設定するかのいずれかにより、
+ それらを展開することができます。
+ 最初の変数に関して、pkgsrc は多くのサフィックスの展開方法を知っています
+ (<filename>.tar.gz</filename>, <filename>.tgz</filename>,
+ <filename>.tar.gz2</filename>, <filename>.tbz</filename>,
+ <filename>.tar.Z</filename>, <filename>.tar</filename>,
+ <filename>.shar.gz</filename>,
+ <filename>.shar.bz2</filename>,
+ <filename>.shar.Z</filename>, <filename>.shar</filename>,
+ <filename>.Z</filename>, <filename>.bz2</filename> and
+ <filename>.gz</filename>; 完全な一覧は、
+ <filename>bsd.pkg.mk</filename> で定義されている
+ 各種 <varname>DECOMPRESS_CMD</varname> 変数を参照)。
+ プログラムが圧縮されたシェルアーカイブの形で配布され、
+ そのファイル名の末尾が <filename>.msg.gz</filename> である場合、
+ 残りの変数の使い方は以下のようになります。</para>
+
+ <programlisting> EXTRACT_SUFX= .msg.gz
+ EXTRACT_CMD= zcat
+ EXTRACT_BEFORE_ARGS=
+ EXTRACT_AFTER_ARGS= |sh</programlisting>
</listitem>
</varlistentry>
@@ -209,7 +237,12 @@
クリプトがGNUのautoconfスクリプトである場合は、かわりに、<varname>GNU_CONFIGURE</varname>を
指定してください。どちらの場合も、configureスクリプトの引数は、変数
<varname>CONFIGURE_ARGS</varname>で指定されます。もし設定スクリプトの名前がデフォルトの
- <quote>configure</quote>でない場合は、その名前を<varname>CONFIGURE_SCRIPT</varname>に設定してください。</para>
+ <quote>configure</quote>でない場合は、その名前を<varname>CONFIGURE_SCRIPT</varname>に設定してください。
+ <pkg>sysutils/top</pkg> パッケージから抜粋した例を以下に掲げます。</para>
+
+ <programlisting>HAS_CONFIGURE= yes
+CONFIGURE_SCRIPT= Configure
+CONFIGURE_ARGS+= netbsd13</programlisting>
<para>もし、プログラムがコンフィギュレーションのためにImakefileを使用するので
あれば、<varname>USE_IMAKE</varname>を<quote>YES</quote>に設定することにより、適切な手順が実行されます。
@@ -559,7 +592,8 @@
<listitem>
<para>パッケージを新規に、または更新のために<quote>make install</quote>した後、
- <command>find -newer work/.extract_done</command>をもとに新しい<filename>PLIST</filename>を生成して表示します。PLIST生成は、
+ <command>find -newer
+ work/.extract_done</command>をもとに新しい<filename>PLIST</filename>を生成して表示します。PLIST生成は、
共有ライブラリーなどに配慮して行われますが、生成した結果を<filename>PLIST</filename>に置く前
に再確認するよう<emphasis>強く</emphasis>おすすめします。パッケージ更新時には、このコマンド
の出力と、更新前の<filename>PLIST</filename>ファイルとを比較すると便利でしょう。</para>
@@ -568,6 +602,9 @@
てファイルをインストールする場合は、それらのファイルはこのターゲットで使われる <quote>find
-newer</quote> コマンドで検
出されないので、手で<filename>PLIST</filename>に書き足すよう注意してください!</para>
+
+ <para> このターゲットに関するさらなる情報は、
+ <xref linkend="print-PLIST"/>を参照してください。
</listitem>
</varlistentry>
Index: Documentation/pkgsrc/build.xml
===================================================================
RCS file: /cvsroot/htdocs/Documentation/pkgsrc/Attic/build.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- Documentation/pkgsrc/build.xml 29 Sep 2004 13:08:36 -0000 1.3
+++ Documentation/pkgsrc/build.xml 29 Sep 2004 23:04:30 -0000 1.4
@@ -1,4 +1,4 @@
-<!-- $NetBSD: build.xml,v 1.3 2004/09/29 13:08:36 hubertf Exp $ -->
+<!-- $NetBSD: build.xml,v 1.4 2004/09/29 23:04:30 hubertf Exp $ -->
<chapter id="build">
<title>The build process</title>
@@ -176,15 +176,41 @@
<term>extract</term>
<listitem>
- <para>When the distfiles are present on the local system, they need to be
- extracted, as they are usually in the form of some compressed archive
- format, most commonly <filename>.tar.gz</filename>. If only some of
- the distfiles need to be uncompressed, the files to be uncompressed
- should be put into <varname>EXTRACT_ONLY</varname>. If the distfiles
- are not in <filename>.tar.gz</filename> format, they can be
- extracted by setting <varname>EXTRACT_CMD</varname>,
- <varname>EXTRACT_BEFORE_ARGS</varname> and/or
- <varname>EXTRACT_AFTER_ARGS</varname>.</para>
+ <para>When the distfiles are present on the local system,
+ they need to be extracted, as they are usually in the form
+ of some compressed archive format, most commonly
+ <filename>.tar.gz</filename>.
+
+ <para> If only some of the
+ distfiles need to be uncompressed, the files to be
+ uncompressed should be put into
+ <varname>EXTRACT_ONLY</varname>.
+
+ <para> If the distfiles are not in
+ <filename>.tar.gz</filename> format, they can be extracted
+ by setting either <varname>EXTRACT_SUFX</varname>, or
+ <varname>EXTRACT_CMD</varname>,
+ <varname>EXTRACT_BEFORE_ARGS</varname> and
+ <varname>EXTRACT_AFTER_ARGS</varname>. In the former case,
+ pkgsrc knows how to extract a number of suffixes
+ (<filename>.tar.gz</filename>, <filename>.tgz</filename>,
+ <filename>.tar.gz2</filename>, <filename>.tbz</filename>,
+ <filename>.tar.Z</filename>, <filename>.tar</filename>,
+ <filename>.shar.gz</filename>,
+ <filename>.shar.bz2</filename>,
+ <filename>.shar.Z</filename>, <filename>.shar</filename>,
+ <filename>.Z</filename>, <filename>.bz2</filename> and
+ <filename>.gz</filename>; see the definition of the
+ various <varname>DECOMPRESS_CMD</varname> variables
+ <filename>bsd.pkg.mk</filename> for a complete
+ list). Here's an example on how to use the other variables
+ for a program that comes with a compressed shell archive
+ whose name ends in <filename>.msg.gz</filename>:</para>
+
+ <programlisting> EXTRACT_SUFX= .msg.gz
+ EXTRACT_CMD= zcat
+ EXTRACT_BEFORE_ARGS=
+ EXTRACT_AFTER_ARGS= |sh</programlisting>
</listitem>
</varlistentry>
@@ -222,14 +248,21 @@
and its invocation results in generation of header files,
Makefiles, etc.</para>
- <para>If the program's distfile contains its own configure script, this can
- be invoked by setting <varname>HAS_CONFIGURE</varname>. If the
- configure script is a GNU autoconf script,
- <varname>GNU_CONFIGURE</varname> should be specified instead. In either
- case, any arguments to the configure script can be specified in the
- <varname>CONFIGURE_ARGS</varname> variable, and the configure script's
- name can be set in <varname>CONFIGURE_SCRIPT</varname> if it differs
- from the default <quote>configure</quote>.</para>
+ <para>If the program's distfile contains its own configure
+ script, this can be invoked by setting
+ <varname>HAS_CONFIGURE</varname>. If the configure script
+ is a GNU autoconf script, <varname>GNU_CONFIGURE</varname>
+ should be specified instead. In either case, any arguments
+ to the configure script can be specified in the
+ <varname>CONFIGURE_ARGS</varname> variable, and the
+ configure script's name can be set in
+ <varname>CONFIGURE_SCRIPT</varname> if it differs from the
+ default <quote>configure</quote>. Here's an example from
+ the <pkg>sysutils/top</pkg> package:</para>
+
+ <programlisting>HAS_CONFIGURE= yes
+CONFIGURE_SCRIPT= Configure
+CONFIGURE_ARGS+= netbsd13</programlisting>
<para>If the program uses an Imakefile for configuration, the appropriate
steps can be invoked by setting <varname>USE_IMAKE</varname> to
@@ -604,14 +637,16 @@
<term>print-PLIST</term>
<listitem>
- <para>After a <quote>make install</quote> from a new or upgraded pkg, this
- prints out an attempt to generate a new <filename>PLIST</filename> from
- a <command>find -newer work/.extract_done</command>.
- An attempt is made to care for shared libs etc., but it is
- <emphasis>strongly</emphasis> recommended to review the result before
- putting it into <filename>PLIST</filename>. On upgrades, it's useful to
- diff the output of this command against an already existing
- <filename>PLIST</filename> file.</para>
+ <para>After a <quote>make install</quote> from a new or
+ upgraded pkg, this prints out an attempt to generate a new
+ <filename>PLIST</filename> from a <command>find -newer
+ work/.extract_done</command>. An attempt is made to care
+ for shared libs etc., but it is
+ <emphasis>strongly</emphasis> recommended to review the
+ result before putting it into
+ <filename>PLIST</filename>. On upgrades, it's useful to
+ diff the output of this command against an already
+ existing <filename>PLIST</filename> file.</para>
<para>If the package installs files via tar(1) or other
methods that don't update file access times, be sure to
@@ -619,6 +654,9 @@
<filename>PLIST</filename>, as the <quote>find
-newer</quote> command used by this target won't catch
them!</para>
+
+ <para> See <xref linkend="print-PLIST"/> for more
+ information on this target.
</listitem>
</varlistentry>