CVS commit: pkgsrc/doc/guide/files

["Thomas Klausner" <wiz%netbsd.org@localhost>]

Module Name:    pkgsrc
Committed By:   wiz
Date:           Fri Jan 20 12:21:56 UTC 2023

Modified Files:
        pkgsrc/doc/guide/files: build.xml

Log Message:
guide: update documentation for cmake/build.mk


To generate a diff of this commit:
cvs rdiff -u -r1.88 -r1.89 pkgsrc/doc/guide/files/build.xml

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: pkgsrc/doc/guide/files/build.xml
diff -u pkgsrc/doc/guide/files/build.xml:1.88 pkgsrc/doc/guide/files/build.xml:1.89
--- pkgsrc/doc/guide/files/build.xml:1.88       Mon Jul 25 05:42:22 2022
+++ pkgsrc/doc/guide/files/build.xml    Fri Jan 20 12:21:56 2023
@@ -1,4 +1,4 @@
-<!-- $NetBSD: build.xml,v 1.88 2022/07/25 05:42:22 rillig Exp $ -->
+<!-- $NetBSD: build.xml,v 1.89 2023/01/20 12:21:56 wiz Exp $ -->
 
 <chapter id="build">
   <title>The build process</title>
@@ -523,13 +523,18 @@ ${FETCH_CMD} ${FETCH_BEFORE_ARGS} ${site
 
     <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>.
+    including <filename>../../devel/cmake/build.mk</filename>.
     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>
+    If you want to add arguments only for particular stages, you can use the
+    <varname>CMAKE_CONFIGURE_ARGS</varname>,
+    <varname>CMAKE_BUILD_ARGS</varname>, and
+    <varname>CMAKE_INSTALL_ARGS</varname> variables.
+    You can set the <varname>CONFIGURE_DIRS</varname> variable to the
+    directories in which CMake should be run, relative to
+    <varname>WRKSRC</varname>. This defaults to to <quote>.</quote>.
+    </para>
 
     <para>If there is no configure step at all, set
     <varname>NO_CONFIGURE</varname> to <quote>yes</quote>.</para>