diff options
| -rw-r--r-- | Help/command/cmake_language.rst | 9 |
1 files changed, 7 insertions, 2 deletions
diff --git a/Help/command/cmake_language.rst b/Help/command/cmake_language.rst index 4944f5c..38d06bb 100644 --- a/Help/command/cmake_language.rst +++ b/Help/command/cmake_language.rst @@ -519,8 +519,13 @@ Terminating Scripts Terminate the current :option:`cmake -P` script and exit with ``<exit-code>``. This command works only in :ref:`script mode <Script Processing Mode>`. + If used outside of that context, it will cause a fatal error. The ``<exit-code>`` should be non-negative. - If ``<exit-code>`` is negative then the behavior + If ``<exit-code>`` is negative, then the behavior is unspecified (e.g., on Windows the error code -1 - becomes ``0xffffffff``, and on Linux it becomes ``255``). + becomes ``0xffffffff``, and on Linux it becomes 255). + Exit codes above 255 may not be supported by the underlying + shell or platform, and some shells may interpret values + above 125 specially. Therefore, it is advisable to only + specify an ``<exit-code>`` in the range 0 to 125. |