From 7a88ca2e56276c6d28b8476b1185fdf99189b4c2 Mon Sep 17 00:00:00 2001 From: scivision Date: Wed, 2 Oct 2024 12:23:29 -0400 Subject: Help: Document find_program filename suffix behavior Issue: #16453 --- Help/command/find_program.rst | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/Help/command/find_program.rst b/Help/command/find_program.rst index b6b2508..d20ca93 100644 --- a/Help/command/find_program.rst +++ b/Help/command/find_program.rst @@ -41,3 +41,23 @@ When more than one value is given to the ``NAMES`` option this command by default will consider one name at a time and search every directory for it. The ``NAMES_PER_DIR`` option tells this command to consider one directory at a time and search for all names in it. + +The set of files considered to be programs is platform-specific: + +* On Windows, filename suffixes are considered in order ``.com``, ``.exe``, + and no suffix. + +* On non-Windows systems, no filename suffix is considered, but files + must have execute permission (see policy :policy:`CMP0109`). + +To search for scripts, specify an extension explicitly: + +.. code-block:: cmake + + if(WIN32) + set(_script_suffix .bat) + else() + set(_script_suffix .sh) + endif() + + find_program(MY_SCRIPT NAMES my_script${_script_suffix}) -- cgit v0.12