summaryrefslogtreecommitdiff
path: root/Help/command
diff options
context:
space:
mode:
authorAsit Dhal <dhal.asitk@gmail.com>2020-10-04 19:44:31 +0200
committerAsit Dhal <dhal.asitk@gmail.com>2020-10-24 12:00:47 +0200
commit03ad0e61c19304ae145cfa0683b43d9756d37ff5 (patch)
tree4b80c6107710ce8e1ccca1de4ec03ac9232ba024 /Help/command
parent5988a4deea67ed122b30c2c0437f70e074273789 (diff)
downloadcmake-03ad0e61c19304ae145cfa0683b43d9756d37ff5.tar.gz
configure_file: Add option for user defined permissions
User defined permissions and options to copy permissions are implemented. Fixes: #20866
Diffstat (limited to 'Help/command')
-rw-r--r--Help/command/configure_file.rst9
1 files changed, 8 insertions, 1 deletions
diff --git a/Help/command/configure_file.rst b/Help/command/configure_file.rst
index 46d1a05954..5d55626764 100644
--- a/Help/command/configure_file.rst
+++ b/Help/command/configure_file.rst
@@ -6,8 +6,9 @@ Copy a file to another location and modify its contents.
.. code-block:: cmake
configure_file(<input> <output>
+ [FILE_PERMISSIONS <permissions>...]
[COPYONLY] [ESCAPE_QUOTES] [@ONLY]
- [NO_SOURCE_PERMISSIONS]
+ [NO_SOURCE_PERMISSIONS] [USE_SOURCE_PERMISSIONS]
[NEWLINE_STYLE [UNIX|DOS|WIN32|LF|CRLF] ])
Copies an ``<input>`` file to an ``<output>`` file and substitutes
@@ -72,6 +73,9 @@ The arguments are:
If the path names an existing directory the output file is placed
in that directory with the same file name as the input file.
+``FILE_PERMISSIONS <permissions>...``
+ Use user provided permissions for the output file.
+
``COPYONLY``
Copy the file without replacing any variable references or other
content. This option may not be used with ``NEWLINE_STYLE``.
@@ -88,6 +92,9 @@ The arguments are:
The copied file permissions default to the standard 644 value
(-rw-r--r--).
+``USE_SOURCE_PERMISSIONS``
+ Transfer the file permissions of the original file to the output file.
+
``NEWLINE_STYLE <style>``
Specify the newline style for the output file. Specify
``UNIX`` or ``LF`` for ``\n`` newlines, or specify