cmake_path: remove new command from 3.19

Defer adding this command until post-3.19 development so that it
has more time to mature before being included in a release.

Issue: #21385

Help/command/file.rst

@@ -3,21 +3,6 @@ file
 
 File manipulation command.
 
-This command is dedicated to file and path manipulation requiring access to the
-filesystem.
-
-For other path manipulation, handling only syntactic aspects, have a look at
-:command:`cmake_path` command.
-
-.. note::
-
-  The sub-commands `RELATIVE_PATH`_, `TO_CMAKE_PATH`_ and `TO_NATIVE_PATH`_ has
-  been superseded, respectively, by sub-commands
-  :ref:`RELATIVE_PATH <cmake_path-RELATIVE_PATH>`,
-  :ref:`CONVERT ... TO_CMAKE_PATH_LIST <cmake_path-TO_CMAKE_PATH_LIST>` and
-  :ref:`CONVERT ... TO_NATIVE_PATH_LIST <cmake_path-TO_NATIVE_PATH_LIST>` of
-  :command:`cmake_path` command.
-
 Synopsis
 ^^^^^^^^
 

Help/command/get_filename_component.rst

@@ -56,6 +56,6 @@ separate a program name from its arguments in a command line string.
 
 .. note::
 
-  This command been superseded by :command:`cmake_path` command, except
-  ``REALPATH`` now offered by :ref:`file(REAL_PATH) <REAL_PATH>` command and
-  ``PROGRAM`` now available in :command:`separate_arguments(PROGRAM)` command.
+  The ``REALPATH`` and ``PROGRAM`` subcommands had been superseded,
+  respectively, by :ref:`file(REAL_PATH) <REAL_PATH>` and
+  :command:`separate_arguments(PROGRAM)` commands.

Help/manual/cmake-commands.7.rst

@@ -20,7 +20,6 @@ These commands are always available.
    /command/cmake_language
    /command/cmake_minimum_required
    /command/cmake_parse_arguments
-   /command/cmake_path
    /command/cmake_policy
    /command/configure_file
    /command/continue

Help/release/3.19.rst

@@ -87,9 +87,6 @@ Commands
 * The :command:`cmake_language` command gained a ``DEFER`` mode to
   schedule command calls to occur at the end of processing a directory.
 
-* The :command:`cmake_path` command was added for operations on
-  filesystem paths.
-
 * The :command:`configure_file` command gained a ``NO_SOURCE_PERMISSIONS``
   option to suppress copying the input file's permissions to the output file.
 

Modules/FindPython/Support.cmake

@@ -2997,9 +2997,8 @@ if (("Development.Module" IN_LIST ${_PYTHON_PREFIX}_FIND_COMPONENTS
     unset(_${_PYTHON_PREFIX}_is_prefix)
     foreach (_${_PYTHON_PREFIX}_implementation IN LISTS _${_PYTHON_PREFIX}_FIND_IMPLEMENTATIONS)
       foreach (_${_PYTHON_PREFIX}_framework IN LISTS _${_PYTHON_PREFIX}_${_${_PYTHON_PREFIX}_implementation}_FRAMEWORKS)
-        cmake_path (IS_PREFIX _${_PYTHON_PREFIX}_framework "${${_PYTHON_PREFIX}_LIBRARY_RELEASE}" _${_PYTHON_PREFIX}_is_prefix)
-        if (_${_PYTHON_PREFIX}_is_prefix)
-          cmake_path (GET _${_PYTHON_PREFIX}_framework PARENT_PATH _${_PYTHON_PREFIX}_framework)
+        if (${_PYTHON_PREFIX}_LIBRARY_RELEASE MATCHES "^${_${_PYTHON_PREFIX}_framework}")
+          get_filename_component (_${_PYTHON_PREFIX}_framework "${_${_PYTHON_PREFIX}_framework}" DIRECTORY)
           set (${_PYTHON_PREFIX}_LINK_OPTIONS "LINKER:-rpath,${_${_PYTHON_PREFIX}_framework}")
           break()
         endif()

Source/CMakeLists.txt

@@ -505,8 +505,6 @@ set(SRCS
   cmCMakeLanguageCommand.h
   cmCMakeMinimumRequired.cxx
   cmCMakeMinimumRequired.h
-  cmCMakePathCommand.h
-  cmCMakePathCommand.cxx
   cmCMakePolicyCommand.cxx
   cmCMakePolicyCommand.h
   cmConditionEvaluator.cxx

Source/cmCommands.cxx

@@ -17,7 +17,6 @@
 #include "cmBreakCommand.h"
 #include "cmBuildCommand.h"
 #include "cmCMakeMinimumRequired.h"
-#include "cmCMakePathCommand.h"
 #include "cmCMakePolicyCommand.h"
 #include "cmCommand.h"
 #include "cmConfigureFileCommand.h"
@@ -121,7 +120,6 @@ void GetScriptingCommands(cmState* state)
 {
   state->AddBuiltinCommand("break", cmBreakCommand);
   state->AddBuiltinCommand("cmake_minimum_required", cmCMakeMinimumRequired);
-  state->AddBuiltinCommand("cmake_path", cmCMakePathCommand);
   state->AddBuiltinCommand("cmake_policy", cmCMakePolicyCommand);
   state->AddBuiltinCommand("configure_file", cmConfigureFileCommand);
   state->AddBuiltinCommand("continue", cmContinueCommand);

Tests/RunCMake/CMakeLists.txt

@@ -308,7 +308,7 @@ add_RunCMake_test(export)
 add_RunCMake_test(cmake_language)
 add_RunCMake_test(cmake_minimum_required)
 add_RunCMake_test(cmake_parse_arguments)
-add_RunCMake_test(cmake_path)
+# add_RunCMake_test(cmake_path)
 add_RunCMake_test(continue)
 add_executable(color_warning color_warning.c)
 add_executable(fake_build_command fake_build_command.c)

Tests/RunCMake/separate_arguments/ProgramCommand.cmake

@@ -7,7 +7,7 @@ endif()
 set (TEST_EXE_DIR "${CMAKE_CURRENT_BINARY_DIR}/TestExe")
 file(MAKE_DIRECTORY "${TEST_EXE_DIR}")
 file(COPY "${CMAKE_COMMAND}" DESTINATION "${TEST_EXE_DIR}")
-cmake_path (GET CMAKE_COMMAND FILENAME cmake_exe)
+get_filename_component (cmake_exe "${CMAKE_COMMAND}" NAME)
 
 set (ENV{PATH} "${TEST_EXE_DIR}")
 

Tests/RunCMake/separate_arguments/ProgramCommandWithSeparateArgs.cmake

@@ -7,7 +7,7 @@ endif()
 set (TEST_EXE_DIR "${CMAKE_CURRENT_BINARY_DIR}/TestExe")
 file(MAKE_DIRECTORY "${TEST_EXE_DIR}")
 file(COPY "${CMAKE_COMMAND}" DESTINATION "${TEST_EXE_DIR}")
-cmake_path (GET CMAKE_COMMAND FILENAME cmake_exe)
+get_filename_component (cmake_exe "${CMAKE_COMMAND}" NAME)
 
 set (ENV{PATH} "${TEST_EXE_DIR}")
 

bootstrap

@@ -289,7 +289,6 @@ CMAKE_CXX_SOURCES="\
   cmBuildCommand \
   cmCMakeMinimumRequired \
   cmCMakePath \
-  cmCMakePathCommand \
   cmCMakePolicyCommand \
   cmCPackPropertiesGenerator \
   cmCacheManager \