CVS commit: pkgsrc/doc/guide/files

["Greg Troxel" <gdt%netbsd.org@localhost>]

Module Name:    pkgsrc
Committed By:   gdt
Date:           Tue Aug 20 18:02:04 UTC 2024

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

Log Message:
doc/guide: Add migration advice for USE_CMAKE


To generate a diff of this commit:
cvs rdiff -u -r1.90 -r1.91 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.90 pkgsrc/doc/guide/files/build.xml:1.91
--- pkgsrc/doc/guide/files/build.xml:1.90       Wed May  8 10:34:12 2024
+++ pkgsrc/doc/guide/files/build.xml    Tue Aug 20 18:02:04 2024
@@ -1,4 +1,4 @@
-<!-- $NetBSD: build.xml,v 1.90 2024/05/08 10:34:12 cheusov Exp $ -->
+<!-- $NetBSD: build.xml,v 1.91 2024/08/20 18:02:04 gdt Exp $ -->
 
 <chapter id="build">
   <title>The build process</title>
@@ -536,6 +536,16 @@ ${FETCH_CMD} ${FETCH_BEFORE_ARGS} ${site
     <varname>WRKSRC</varname>. This defaults to to <quote>.</quote>.
     </para>
 
+    <para>Any package using the now-deprecated
+    <varname>USE_CMAKE=yes</varname> should be converted.
+    Essentially, replace with an include of
+    <filename>../../devel/cmake/build.mk</filename>, change
+    <varname>CMAKE_ARGS</varname> to
+    <varname>CMAKE_CONFIGURE_ARGS</varname>, prune creation of a build
+    directory and settings to use it, and check/fix settings that
+    intend to perform the build in a subdirectory.
+    </para>
+
     <para>If there is no configure step at all, set
     <varname>NO_CONFIGURE</varname> to <quote>yes</quote>.</para>
   </sect1>