summaryrefslogtreecommitdiffstats
path: root/Help/command/file.rst
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2015-05-08 13:28:44 (GMT)
committerBrad King <brad.king@kitware.com>2015-05-08 13:29:05 (GMT)
commitf39d26caa77525ee12b8f5fcb4932ebb642c970f (patch)
tree0278a4fdf2f1a31d4eeca48a881a116c11172682 /Help/command/file.rst
parent4566850bdd48c53997c5aea4489d5949c7d26b0b (diff)
downloadCMake-f39d26caa77525ee12b8f5fcb4932ebb642c970f.zip
CMake-f39d26caa77525ee12b8f5fcb4932ebb642c970f.tar.gz
CMake-f39d26caa77525ee12b8f5fcb4932ebb642c970f.tar.bz2
Help: Clarify file(COPY) directory semantics (#15561)
State explicitly that directory structure is preserved.
Diffstat (limited to 'Help/command/file.rst')
-rw-r--r--Help/command/file.rst6
1 files changed, 5 insertions, 1 deletions
diff --git a/Help/command/file.rst b/Help/command/file.rst
index 2fe7414..bbddd40 100644
--- a/Help/command/file.rst
+++ b/Help/command/file.rst
@@ -313,8 +313,12 @@ preserves input file timestamps, and optimizes out a file if it exists
at the destination with the same timestamp. Copying preserves input
permissions unless explicit permissions or ``NO_SOURCE_PERMISSIONS``
are given (default is ``USE_SOURCE_PERMISSIONS``).
+
See the :command:`install(DIRECTORY)` command for documentation of
-permissions, ``PATTERN``, ``REGEX``, and ``EXCLUDE`` options.
+permissions, ``FILES_MATCHING``, ``PATTERN``, ``REGEX``, and
+``EXCLUDE`` options. Copying directories preserves the structure
+of their content even if options are used to select a subset of
+files.
The ``INSTALL`` signature differs slightly from ``COPY``: it prints
status messages (subject to the :variable:`CMAKE_INSTALL_MESSAGE` variable),