1load_cache
2----------
3
4Load in the values from another project's CMake cache.
5
6.. code-block:: cmake
7
8  load_cache(pathToBuildDirectory READ_WITH_PREFIX prefix entry1...)
9
10Reads the cache and store the requested entries in variables with their
11name prefixed with the given prefix.  This only reads the values, and
12does not create entries in the local project's cache.
13
14.. code-block:: cmake
15
16  load_cache(pathToBuildDirectory [EXCLUDE entry1...]
17             [INCLUDE_INTERNALS entry1...])
18
19Loads in the values from another cache and store them in the local
20project's cache as internal entries.  This is useful for a project
21that depends on another project built in a different tree.  ``EXCLUDE``
22option can be used to provide a list of entries to be excluded.
23``INCLUDE_INTERNALS`` can be used to provide a list of internal entries to
24be included.  Normally, no internal entries are brought in.  Use of
25this form of the command is strongly discouraged, but it is provided
26for backward compatibility.
27