summaryrefslogtreecommitdiffstats
path: root/Help/command/configure_file.rst
diff options
context:
space:
mode:
Diffstat (limited to 'Help/command/configure_file.rst')
-rw-r--r--Help/command/configure_file.rst28
1 files changed, 17 insertions, 11 deletions
diff --git a/Help/command/configure_file.rst b/Help/command/configure_file.rst
index 8d66a9b..63ea84d 100644
--- a/Help/command/configure_file.rst
+++ b/Help/command/configure_file.rst
@@ -38,22 +38,24 @@ a false constant by the :command:`if` command. The "..." content on the
line after the variable name, if any, is processed as above.
Input file lines of the form ``#cmakedefine01 VAR`` will be replaced with
either ``#define VAR 1`` or ``#define VAR 0`` similarly.
-The result lines (with the exception of the ``#undef`` comments) can be
-indented using spaces and/or tabs between the ``#`` character
-and the ``cmakedefine`` or ``cmakedefine01`` words. This whitespace
-indentation will be preserved in the output lines:
-.. code-block:: c
+.. versionadded:: 3.10
+ The result lines (with the exception of the ``#undef`` comments) can be
+ indented using spaces and/or tabs between the ``#`` character
+ and the ``cmakedefine`` or ``cmakedefine01`` words. This whitespace
+ indentation will be preserved in the output lines:
- # cmakedefine VAR
- # cmakedefine01 VAR
+ .. code-block:: c
-will be replaced, if ``VAR`` is defined, with
+ # cmakedefine VAR
+ # cmakedefine01 VAR
-.. code-block:: c
+ will be replaced, if ``VAR`` is defined, with
+
+ .. code-block:: c
- # define VAR
- # define VAR 1
+ # define VAR
+ # define VAR 1
If the input file is modified the build system will re-run CMake to
re-configure the file and generate the build system again.
@@ -88,11 +90,15 @@ The arguments are:
This is useful for configuring scripts that use ``${VAR}`` syntax.
``NO_SOURCE_PERMISSIONS``
+ .. versionadded:: 3.19
+
Does not transfer the file permissions of the original file to the copy.
The copied file permissions default to the standard 644 value
(-rw-r--r--).
``USE_SOURCE_PERMISSIONS``
+ .. versionadded:: 3.20
+
Transfer the file permissions of the original file to the output file.
``NEWLINE_STYLE <style>``