pkgsrc/doc/guide/files/options.xml: 1.24 -> 1.25

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

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

pkgsrc/doc/guide/files/options.xml: 1.24 -> 1.25
> revision 1.25
> date: 2007/10/01 22:38:42;  author: rillig;  state: Exp;  lines: +28 -1
> Documented how to query for the options with which a dependent package
> has been built.

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

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

--- options.xml.orig	2007-10-02 23:29:23.000000000 +0900
+++ options.xml	2007-10-02 23:29:23.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: options.xml,v 1.24 2007/09/22 02:52:48 kano Exp $ -->
+<!-- $NetBSD: options.xml,v 1.25 2007/10/01 22:38:42 rillig Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: options.xml,v 1.24 2007/09/22 02:52:48 kano Exp   -->
+<!-- NetBSD: options.xml,v 1.25 2007/10/01 22:38:42 rillig Exp   -->
 
 <!-- based on: pkgsrc/mk/bsd.options.mk 1.56 -->
 
@@ -253,4 +253,34 @@
 
 </sect1>
 
+<sect1 id="option-build">
+<title>依存パッケージのオプションを判別する</title>
+
+<para>&buildlink3.mk; ファイルを書くときには、
+依存パッケージがどのようなオプションで構築されたかによって場合分けして、
+異なる依存性を列挙する必要がある場合がよくあります。
+このようなオプションの問い合わせには、
+<filename>pkgsrc/mk/pkg-build-options.mk</filename> ファイルを使うようにします。
+通常は、以下のように使います。</para>
+
+<programlisting>
+pkgbase := libpurple
+.include "../../mk/pkg-build-options.mk"
+
+.if !empty(PKG_BUILD_OPTIONS.libpurple:Mdbus)
+...
+.endif
+</programlisting>
+
+<para><filename>pkg-build-options.mk</filename> をインクルードしたところで、
+<varname>PKG_BUILD_OPTIONS.libpurple</varname> 変数に、
+libpurple パッケージの構築オプションが設定されます。これにより、
+<filename>options.mk</filename> における <varname>PKG_OPTIONS</varname>
+と同様に、オプションを問い合わせることができます。
+詳細は、<filename>pkg-build-options.mk</filename>
+ファイルをご覧ください。
+</para>
+
+</sect1>
+
 </chapter>
Index: options.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/options.xml,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- options.xml	22 Sep 2007 02:52:48 -0000	1.24
+++ options.xml	1 Oct 2007 22:38:42 -0000	1.25
@@ -1,4 +1,4 @@
-<!-- $NetBSD: options.xml,v 1.24 2007/09/22 02:52:48 kano Exp $ -->
+<!-- $NetBSD: options.xml,v 1.25 2007/10/01 22:38:42 rillig Exp $ -->
 
 <!-- based on: pkgsrc/mk/bsd.options.mk 1.56 -->
 
@@ -243,4 +243,31 @@
 
 </sect1>
 
+<sect1 id="option-build">
+<title>Determining the options of dependencies</title>
+
+<para>When writing &buildlink3.mk; files, it is often necessary to list
+different dependencies based on the options with which the package was
+built. For querying these options, the file
+<filename>pkgsrc/mk/pkg-build-options.mk</filename> should be used. A
+typical example looks like this:</para>
+
+<programlisting>
+pkgbase := libpurple
+.include "../../mk/pkg-build-options.mk"
+
+.if !empty(PKG_BUILD_OPTIONS.libpurple:Mdbus)
+...
+.endif
+</programlisting>
+
+<para>Including <filename>pkg-build-options.mk</filename> here will set
+the variable <varname>PKG_BUILD_OPTIONS.libpurple</varname> to the build
+options of the libpurple package, which can then be queried like
+<varname>PKG_OPTIONS</varname> in the <filename>options.mk</filename>
+file. See the file <filename>pkg-build-options.mk</filename> for more
+details.</para>
+
+</sect1>
+
 </chapter>