File: CMAKE_INTERMEDIATE_DIR_STRATEGY.rst

package info (click to toggle)
cmake 4.2.1-1
  • links: PTS, VCS
  • area: main
  • in suites: experimental
  • size: 152,348 kB
  • sloc: ansic: 403,894; cpp: 303,807; sh: 4,097; python: 3,582; yacc: 3,106; lex: 1,279; f90: 538; asm: 471; lisp: 375; cs: 270; java: 266; fortran: 239; objc: 215; perl: 213; xml: 198; makefile: 108; javascript: 83; pascal: 63; tcl: 55; php: 25; ruby: 22
file content (35 lines) | stat: -rw-r--r-- 1,318 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
CMAKE_INTERMEDIATE_DIR_STRATEGY
-------------------------------

.. versionadded:: 4.2

``CMAKE_INTERMEDIATE_DIR_STRATEGY`` is a string cache variable specifying the
strategy to use for target intermediate directories and their contents. The
supported values are:

- ``FULL``: Intermediate directories are named based on a
  ``<TARGET_NAME>.dir`` pattern (with some slight deviations and sanitizations
  applied in various places). Object file names are based on the filename of
  the source file being compiled or, if set, its :prop_sf:`OBJECT_NAME`
  property.
- ``SHORT``: Intermediate directories are named from the hash of the target
  name and the build directory location. Object file names are based on hashes
  of the source file name to reduce path lengths. This may help with projects
  that generate long paths in the build directory to support building in
  directories other than those near a root path.

When unset or the named strategy is not supported, the ``FULL`` strategy is
used.

.. note::
  This only works as a cache variable, not a locally-scoped variable.

This is supported by the following generators:

- :ref:`Ninja Generators`
- :ref:`Makefile Generators`
- :ref:`Visual Studio Generators`

.. note::
  Not all generators support all strategies and paths may differ between
  generators.