Rename NAME to CMAKE_PACKAGE_NAME.

Author: davidlion

exports/taskfiles/utils/cmake.yaml

@@ -86,8 +86,8 @@ tasks:
 
   # Runs the CMake install step for the given build directory. The caller must have previously
   # called `build` on `BUILD_DIR` for this task to succeed. If `CMAKE_SETTINGS_DIR` is set, a
-  # settings file will be created in that directory, containing a `{{.NAME}}_ROOT` CMake variable
-  # that points to `INSTALL_PREFIX`.
+  # settings file will be created in that directory, containing a `{{.CMAKE_PACKAGE_NAME}}_ROOT`
+  # CMake variable that points to `INSTALL_PREFIX`.
   #
   # NOTE: We purposely omit `sources` and `generates` as we defer to `cmake` to decide whether it
   # should perform any actions.
@@ -97,8 +97,8 @@ tasks:
   # @param {string} [CMAKE_SETTINGS_DIR] If set, the directory where the project's CMake settings
   # file should be stored.
   # @param {string[]} [EXTRA_ARGS] Any additional arguments to pass to the install command.
-  # @param {string} [NAME] CMake project name (used in directory names and the CMake settings file).
-  # Required if `CMAKE_SETTINGS_DIR` is set.
+  # @param {string} [CMAKE_PACKAGE_NAME] CMake project name (used in directory names and the CMake
+  # settings file).  Required if `CMAKE_SETTINGS_DIR` is set.
   install:
     internal: true
     label: "{{.TASK}}:{{.BUILD_DIR}}-{{.INSTALL_PREFIX}}-{{.EXTRA_ARGS}}"
@@ -112,10 +112,10 @@ tasks:
     preconditions:
       - sh: >-
           {{if .CMAKE_SETTINGS_DIR}}
-            {{not (empty .NAME)}}
+            {{not (empty .CMAKE_PACKAGE_NAME)}}
           {{end}}
         msg: |-
-          NAME must be set if CMAKE_SETTINGS_DIR is set.
+          CMAKE_PACKAGE_NAME must be set if CMAKE_SETTINGS_DIR is set.
           CMAKE_SETTINGS_DIR: {{.CMAKE_SETTINGS_DIR}}
     cmds:
       - >-
@@ -127,19 +127,19 @@ tasks:
         {{- end}}
       - >-
         {{- if .CMAKE_SETTINGS_DIR}}
-          echo "set({{.NAME}}_ROOT
+          echo "set({{.CMAKE_PACKAGE_NAME}}_ROOT
             \"{{.INSTALL_PREFIX}}\"
             CACHE PATH
-            \"Package root for {{.NAME}}.\"
-          )" >> "{{.CMAKE_SETTINGS_DIR}}/{{.NAME}}.cmake"
+            \"Package root for {{.CMAKE_PACKAGE_NAME}}.\"
+          )" >> "{{.CMAKE_SETTINGS_DIR}}/{{.CMAKE_PACKAGE_NAME}}.cmake"
         {{- end}}
 
   # Downloads a CMake project tar file from `TAR_URL` and then generates, builds, and installs the
   # project. We purposely omit `sources` and `generates` as we defer to `cmake` to decide whether it
   # should perform any actions. However, the download and extraction will be skipped if unnecessary.
   #
   # Required parameters
-  # @param {string} NAME CMake package name.
+  # @param {string} CMAKE_PACKAGE_NAME CMake package name.
   # @param {string} TAR_SHA256 Content hash to verify the downloaded tar file against.
   # @param {string} TAR_URL URL of the tar file to download.
   # @param {string} WORK_DIR Directory in which to store the build, install, and source directories.
@@ -159,7 +159,7 @@ tasks:
   # target.
   install-remote-tar:
     internal: true
-    label: "{{.TASK}}:{{.NAME}}-{{.TAR_URL}}-{{.INSTALL_PREFIX}}"
+    label: "{{.TASK}}:{{.CMAKE_PACKAGE_NAME}}-{{.TAR_URL}}-{{.INSTALL_PREFIX}}"
     vars:
       # CMake parameters
       CMAKE_BUILD_ARGS:
@@ -176,12 +176,12 @@ tasks:
         ref: "default (list) .CMAKE_TARGETS"
 
       # Directory parameters
-      BUILD_DIR: "{{.WORK_DIR}}/{{.NAME}}-build"
-      INSTALL_PREFIX: "{{.WORK_DIR}}/{{.NAME}}-install"
-      SOURCE_DIR: "{{.WORK_DIR}}/{{.NAME}}-src"
+      BUILD_DIR: "{{.WORK_DIR}}/{{.CMAKE_PACKAGE_NAME}}-build"
+      INSTALL_PREFIX: "{{.WORK_DIR}}/{{.CMAKE_PACKAGE_NAME}}-install"
+      SOURCE_DIR: "{{.WORK_DIR}}/{{.CMAKE_PACKAGE_NAME}}-src"
 
     requires:
-      vars: ["NAME", "TAR_SHA256", "TAR_URL", "WORK_DIR"]
+      vars: ["CMAKE_PACKAGE_NAME", "TAR_SHA256", "TAR_URL", "WORK_DIR"]
     deps:
       - task: "remote:download-and-extract-tar"
         vars:
@@ -210,7 +210,7 @@ tasks:
           EXTRA_ARGS:
             ref: ".CMAKE_INSTALL_ARGS"
           INSTALL_PREFIX: "{{.INSTALL_PREFIX}}"
-          NAME: "{{.NAME}}"
+          CMAKE_PACKAGE_NAME: "{{.CMAKE_PACKAGE_NAME}}"
 
   # Sets up all CMake dependencies for a project by:
   #