[pkgsrc/trunk]: pkgsrc/doc/guide/files Document USE_CMAKE.

[markd <markd%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/a8b600532605
branches:  trunk
changeset: 536374:a8b600532605
user:      markd <markd%pkgsrc.org@localhost>
date:      Wed Dec 12 01:03:33 2007 +0000

description:
Document USE_CMAKE.

diffstat:

 doc/guide/files/build.xml |  12 +++++++++++-
 1 files changed, 11 insertions(+), 1 deletions(-)

diffs (26 lines):

diff -r fd1d7ce808d0 -r a8b600532605 doc/guide/files/build.xml
--- a/doc/guide/files/build.xml Wed Dec 12 01:00:38 2007 +0000
+++ b/doc/guide/files/build.xml Wed Dec 12 01:03:33 2007 +0000
@@ -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>