[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Documentation/pkgsrc/plist.xml: 1.1 -> 1.2
以下のページの更新をしました。ツッコミをお願いします。
Documentation/pkgsrc/plist.xml: 1.1 -> 1.2
火曜日までに異議がなければ、 commit します。
以下、訳と原文の差分です。
--- Documentation/pkgsrc/plist.xml.orig 2006-05-29 23:13:38.000000000 +0900
+++ Documentation/pkgsrc/plist.xml 2006-05-29 23:13:38.000000000 +0900
@@ -1,12 +1,13 @@
-<!-- $NetBSD: plist.xml,v 1.1 2004/06/06 13:31:54 grant Exp $ -->
+<!-- $NetBSD: plist.xml,v 1.2 2004/09/29 13:08:36 hubertf Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: plist.xml,v 1.1 2004/06/06 13:31:54 grant Exp -->
+<!-- NetBSD: plist.xml,v 1.2 2004/09/29 13:08:36 hubertf Exp -->
<chapter id="plist">
<title>PLIST*問題</title>
- <para>このセクションでは、<filename>PLIST</filename>ファイル(複数の場合もあります、以下を参照してくだ
- さい)を扱う場合に注意が必要な、いくつかの特別な問題について述べます。</para>
+ <para>このセクションでは、<filename>PLIST</filename>ファイル
+ (複数の場合もあります、以下を参照してください)を扱う場合に注意が必要な、
+ いくつかの特別な問題について述べます。</para>
<sect1 id="plist.misc">
<title>その他色々</title>
@@ -42,7 +43,7 @@
<note>
<title>昔の話</title>
- <para>「<$ARCH>」シンボルは<command>uname -m</command>の出力によって置きかえられていま
+ <para><quote>$ARCH</quote>シンボルは<command>uname -m</command>の出力によって置きかえられていま
した。しかし、もはやサポートされていませんし、削除されています。</para>
</note>
</listitem>
@@ -58,15 +59,15 @@
<itemizedlist>
<listitem>
- <para>${OPSYS} - "uname -s"の出力</para>
+ <para><varname>${OPSYS}</varname> - <quote><command>uname -s</command></quote>の出力</para>
</listitem>
<listitem>
- <para>${LOWER_OPSYS} - 共通名の小文字表記(例: "solaris")</para>
+ <para><varname>${LOWER_OPSYS}</varname> - 共通名の小文字表記(例: <quote>solaris</quote>)</para>
</listitem>
<listitem>
- <para>${OS_VERSION} - "uname -r"</para>
+ <para><varname>${OS_VERSION}</varname> - <quote><command>uname -r</command></quote></para>
</listitem>
</itemizedlist>
</listitem>
@@ -132,7 +133,8 @@
<listitem>
<para><command>make print-PLIST</command>コマンドを使って、パッケージの展開後に新しくできた全ファ
イルにマッチするPLISTを出力することができます。このターゲットに関するさ
- らなる情報は、下の説明をご覧ください。</para>
+ らなる情報は、
+ <xref linkend="build.helpful-targets"/>をご覧ください。</para>
</listitem>
</varlistentry>
</variablelist>
@@ -149,7 +151,8 @@
<sect1>
<title>PLIST_SUBST</title>
- <para><varname>MESSAGE_SUBST</varname>(前述)に似ており、以下のようにして、変数とその展開結果を追
+ <para><varname>MESSAGE_SUBST</varname>(<xref
+ linkend="components.optional"/>参照)に似ており、以下のようにして、変数とその展開結果を追
加することができます:</para>
<programlisting>PLIST_SUBST+= SOMEVAR="somevalue"</programlisting>
@@ -162,18 +165,18 @@
<sect1>
<title>Perl5 モジュール</title>
- <para>perl5モジュールを提供するパッケージでは、Makefileにmakefileの断片
- <filename>lang/perl5/module.mk</filename>をインクルードしてください。このファイルには、perl5モ
- ジュール用の標準的なperlの構成をするdo-configureターゲットのほか、その構成
+ <para>perl5モジュールを提供するパッケージでは、MakefileにMakefileの断片
+ <filename>../../lang/perl5/module.mk</filename>をインクルードしてください。このファイルには、perl5モ
+ ジュール用の標準的なperlの構成をする<command>do-configure</command>ターゲットのほか、その構成
を調整するためのさまざまなフックが含まれています。詳細は、このファイル中の
コメントをご覧ください。</para>
<para>perl5 のモジュールがインストールされる場所は、構築プロセスで使われるperl の
- バージョンに応じて変わります。これを扱うために、&os; パッケージシステムは、
- インストールされた.packlistファイル(ほとんどの perl5 モジュールが生成します)
+ バージョンに応じて変わります。これを扱うために、pkgsrc は、
+ インストールされた<filename>.packlist</filename>ファイル(ほとんどの perl5 モジュールが生成します)
に列挙された各ファイルに対応する行を、<filename>PLIST</filename> に追加します。これは、packlist
ファイルへのパスをスペースで区切ったリストを<varname>PERL5_PACKLIST</varname>として定義するこ
- とで行なわれるようになります:</para>
+ とで行なわれるようになります。たとえば以下のように定義します。</para>
<programlisting>PERL5_PACKLIST= ${PERL5_SITEARCH}/auto/Pg/.packlist</programlisting>
@@ -183,38 +186,4 @@
で使うことができます。この3変数の置換は、<filename>PLIST</filename>でもおこなわれます。</para>
</sect1>
- <sect1>
- <title>ユーザーとの対話</title>
-
- <para>時々、パッケージがユーザーとの対話を必要とする場合がありますが、そのような
- 状況は何通りもありえます:</para>
-
- <itemizedlist>
- <listitem>
- <para>distfileの取得に関する補助</para>
- </listitem>
-
- <listitem>
- <para>パッケージの構築前の設定の補助</para>
- </listitem>
-
- <listitem>
- <para>構築過程の最中の補助</para>
- </listitem>
-
- <listitem>
- <para>パッケージのインストール中の補助</para>
- </listitem>
- </itemizedlist>
-
- <para>どの段階で対話が必要になるかをpkgsrcの機構に知らせるため、<varname>INTERACTIVE_STAGE</varname>
- 定義が用意されており、パッケージの<filename>Makefile</filename>で定義します。たとえば以下のよう
- にします。</para>
-
- <programlisting>INTERACTIVE_STAGE= build</programlisting>
-
- <para>複数の段階を指定することもできます:</para>
-
- <programlisting>INTERACTIVE_STAGE= configure install</programlisting>
- </sect1>
</chapter>
Index: Documentation/pkgsrc/plist.xml
===================================================================
RCS file: /cvsroot/htdocs/Documentation/pkgsrc/Attic/plist.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- Documentation/pkgsrc/plist.xml 6 Jun 2004 13:31:54 -0000 1.1
+++ Documentation/pkgsrc/plist.xml 29 Sep 2004 13:08:36 -0000 1.2
@@ -1,10 +1,11 @@
-<!-- $NetBSD: plist.xml,v 1.1 2004/06/06 13:31:54 grant Exp $ -->
+<!-- $NetBSD: plist.xml,v 1.2 2004/09/29 13:08:36 hubertf Exp $ -->
<chapter id="plist">
<title>PLIST issues</title>
- <para>This section addresses some special issues that one needs to pay attention
- to when dealing with the <filename>PLIST</filename> file (or files, see below!).</para>
+ <para>This section addresses some special issues that one needs to
+ pay attention to when dealing with the <filename>PLIST</filename>
+ file (or files, see below!).</para>
<sect1 id="plist.misc">
<title>Miscellaneous</title>
@@ -40,7 +41,7 @@
<note>
<title>Legacy note</title>
- <para>There used to be a symbol "<$ARCH>" that was replaced by
+ <para>There used to be a symbol <quote>$ARCH</quote> that was replaced by
the output of <command>uname -m</command>, but that's no longer supported
and has been removed.</para>
</note>
@@ -57,15 +58,15 @@
<itemizedlist>
<listitem>
- <para>${OPSYS} - output of "uname -s"</para>
+ <para><varname>${OPSYS}</varname> - output of <quote><command>uname -s</command></quote></para>
</listitem>
<listitem>
- <para>${LOWER_OPSYS} - lowercase common name (eg. "solaris")</para>
+ <para><varname>${LOWER_OPSYS}</varname> - lowercase common name (eg. <quote>solaris</quote>)</para>
</listitem>
<listitem>
- <para>${OS_VERSION} - "uname -r"</para>
+ <para><varname>${OS_VERSION}</varname> - <quote><command>uname -r</command></quote></para>
</listitem>
</itemizedlist>
</listitem>
@@ -135,7 +136,8 @@
<listitem>
<para>You can use the <command>make print-PLIST</command> command to output
a PLIST that matches any new files since the package was extracted.
- See below for more information on this target.</para>
+ See <xref linkend="build.helpful-targets"/> for more
+ information on this target.</para>
</listitem>
</varlistentry>
</variablelist>
@@ -154,7 +156,8 @@
<sect1>
<title>PLIST_SUBST</title>
- <para>Similar to <varname>MESSAGE_SUBST</varname> (see above), you can add
+ <para>Similar to <varname>MESSAGE_SUBST</varname> (see <xref
+ linkend="components.optional"/>), you can add
variables and their expansions to this variable in the following way:</para>
<programlisting>PLIST_SUBST+= SOMEVAR="somevalue"</programlisting>
@@ -169,20 +172,20 @@
<sect1>
<title>Perl5 modules</title>
- <para>Makefile of packages providing perl5 modules should include the
- makefile fragment <filename>lang/perl5/module.mk</filename>. It provides
- a do-configure
+ <para>Makefiles of packages providing perl5 modules should include the
+ Makefile fragment <filename>../../lang/perl5/module.mk</filename>. It provides
+ a <command>do-configure</command>
target for the standard perl configuration for such modules as well
as various hooks to tune this configuration. See comments in this
file for details.</para>
<para>Perl5 modules will install into different places depending on the version
- of perl used during the build process. To address this, the &os;
- packages system will append lines to the <filename>PLIST</filename>
+ of perl used during the build process. To address this, pkgsrc
+ will append lines to the <filename>PLIST</filename>
corresponding to the files
- listed in the installed .packlist file generated by most perl5 modules.
+ listed in the installed <filename>.packlist</filename> file generated by most perl5 modules.
This is invoked by defining <varname>PERL5_PACKLIST</varname> to a
- space-separated list of paths to packlist files:</para>
+ space-separated list of paths to packlist files, e.g.:</para>
<programlisting>PERL5_PACKLIST= ${PERL5_SITEARCH}/auto/Pg/.packlist</programlisting>
@@ -193,38 +196,4 @@
variables are also substituted for in the <filename>PLIST</filename>.</para>
</sect1>
- <sect1>
- <title>User Interaction</title>
-
- <para>Occasionally, packages require interaction from the user, and this can be
- in a number of ways:</para>
-
- <itemizedlist>
- <listitem>
- <para>help in fetching the distfiles</para>
- </listitem>
-
- <listitem>
- <para>help to configure the package before it is built</para>
- </listitem>
-
- <listitem>
- <para>help during the build process</para>
- </listitem>
-
- <listitem>
- <para>help during the installation of a package</para>
- </listitem>
- </itemizedlist>
-
- <para>The <varname>INTERACTIVE_STAGE</varname> definition is provided to notify
- the pkgsrc mechanism of an interactive stage which will be needed, and
- this should be set in the package's <filename>Makefile</filename>. e.g.</para>
-
- <programlisting>INTERACTIVE_STAGE= build</programlisting>
-
- <para>Multiple interactive stages can be specified:</para>
-
- <programlisting>INTERACTIVE_STAGE= configure install</programlisting>
- </sect1>
</chapter>