summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2020-07-01 11:02:14 (GMT)
committerKitware Robot <kwrobot@kitware.com>2020-07-01 11:03:03 (GMT)
commitb7af2811aecf9aedf31e3ed98209b6a92c227116 (patch)
tree8c0c17a848dd71c925422a909165ec53dcd5f9f4 /Help
parent57ea0012477828d0f2d34dde994ec6fa18cdd7a1 (diff)
parent27b03281e2028d8239c3f7e43ea67f30a70dc42b (diff)
downloadCMake-b7af2811aecf9aedf31e3ed98209b6a92c227116.zip
CMake-b7af2811aecf9aedf31e3ed98209b6a92c227116.tar.gz
CMake-b7af2811aecf9aedf31e3ed98209b6a92c227116.tar.bz2
Merge topic 'configure_file-permission-control'
27b03281e2 configure_file: Add option to control file permissions transfer to copy Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !4941
Diffstat (limited to 'Help')
-rw-r--r--Help/command/configure_file.rst6
-rw-r--r--Help/release/dev/configure_file-permission-control.rst5
2 files changed, 11 insertions, 0 deletions
diff --git a/Help/command/configure_file.rst b/Help/command/configure_file.rst
index 29e85bd..46d1a05 100644
--- a/Help/command/configure_file.rst
+++ b/Help/command/configure_file.rst
@@ -7,6 +7,7 @@ Copy a file to another location and modify its contents.
configure_file(<input> <output>
[COPYONLY] [ESCAPE_QUOTES] [@ONLY]
+ [NO_SOURCE_PERMISSIONS]
[NEWLINE_STYLE [UNIX|DOS|WIN32|LF|CRLF] ])
Copies an ``<input>`` file to an ``<output>`` file and substitutes
@@ -82,6 +83,11 @@ The arguments are:
Restrict variable replacement to references of the form ``@VAR@``.
This is useful for configuring scripts that use ``${VAR}`` syntax.
+ ``NO_SOURCE_PERMISSIONS``
+ 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--).
+
``NEWLINE_STYLE <style>``
Specify the newline style for the output file. Specify
``UNIX`` or ``LF`` for ``\n`` newlines, or specify
diff --git a/Help/release/dev/configure_file-permission-control.rst b/Help/release/dev/configure_file-permission-control.rst
new file mode 100644
index 0000000..54b52b7
--- /dev/null
+++ b/Help/release/dev/configure_file-permission-control.rst
@@ -0,0 +1,5 @@
+configure_file-permission-control
+---------------------------------
+
+* The :command:`configure_file` command gained a ``NO_SOURCE_PERMISSIONS``
+ option to suppress copying the input file's permissions to the output file.