pkgsrc/doc/guide/files/build.xml: 1.47 -> 1.48

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

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

pkgsrc/doc/guide/files/build.xml: 1.47 -> 1.48
> revision 1.48
> date: 2007/12/12 01:03:33;  author: markd;  state: Exp;  lines: +11 -1
> Document USE_CMAKE.

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

原文で追加された段落が、前の段落と同じいいまわしなので、
訳も使いまわしですが、
なんか日本語が変っぽいので、あとで修正案を投げるつもりです。

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

--- build.xml.orig	2007-12-14 00:11:36.000000000 +0900
+++ build.xml	2007-12-14 00:11:36.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: build.xml,v 1.47 2007/08/15 06:33:44 rillig Exp $ -->
+<!-- $NetBSD: build.xml,v 1.48 2007/12/12 01:03:33 markd Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: build.xml,v 1.47 2007/08/15 06:33:44 rillig Exp   -->
+<!-- NetBSD: build.xml,v 1.48 2007/12/12 01:03:33 markd Exp   -->
 
 <chapter id="build">
   <title>構築の手順</title>
@@ -539,6 +539,18 @@
     <varname>SCRIPTS_ENV</varname> に変数を設定すると、
     その変数を xmkmf の環境変数に追加することができます。</para>
 
+    <para>プログラムがコンフィギュレーションのために <filename>cmake</filename>
+    を使用するのであれば、
+    <varname>USE_CMAKE</varname> を <quote>yes</quote> に設定することにより、適切な手順が実行されます。
+    <varname>CONFIGURE_ENV</varname> に変数を追加すると、
+    その変数を cmake の環境変数に追加することができます。
+    また、<varname>CMAKE_ARGS</varname> 変数に引数を追加すると、
+    cmake の引数に追加することができます。
+    最上層ディレクトリーを指定する引数は
+    <varname>CMAKE_ARG_PATH</varname> 変数で与えられるようになっており、
+    この変数の標準の値は
+    <quote>.</quote> (<varname>CONFIGURE_DIRS</varname> からの相対位置) です。</para>
+
     <para>configure の段階ですることが何もない場合は、
     <varname>NO_CONFIGURE</varname> を <quote>yes</quote> に設定します。</para>
   </sect1>
Index: build.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/build.xml,v
retrieving revision 1.47
retrieving revision 1.48
diff -u -r1.47 -r1.48
--- build.xml	15 Aug 2007 06:33:44 -0000	1.47
+++ build.xml	12 Dec 2007 01:03:33 -0000	1.48
@@ -1,4 +1,4 @@
-<!-- $NetBSD: build.xml,v 1.47 2007/08/15 06:33:44 rillig Exp $ -->
+<!-- $NetBSD: build.xml,v 1.48 2007/12/12 01:03:33 markd Exp $ -->
 
 <chapter id="build">
   <title>The build process</title>
@@ -582,6 +582,16 @@
     xmkmf's environment by adding them to the
     <varname>SCRIPTS_ENV</varname> variable.</para>
 
+    <para>If the program uses <filename>cmake</filename>
+    for configuration, the appropriate steps can be invoked by
+    setting <varname>USE_CMAKE</varname> to <quote>yes</quote>.
+    You can add variables to cmake's environment by adding them to the
+    <varname>CONFIGURE_ENV</varname> variable and arguments to cmake
+    by adding them to the <varname>CMAKE_ARGS</varname> variable.
+    The top directory argument is given by the
+    <varname>CMAKE_ARG_PATH</varname> variable, that defaults to
+    <quote>.</quote> (relative to <varname>CONFIGURE_DIRS</varname>)</para>
+
     <para>If there is no configure step at all, set
     <varname>NO_CONFIGURE</varname> to <quote>yes</quote>.</para>
   </sect1>