File: CMAKE_AUTOGEN_INTERMEDIATE_DIR_STRATEGY.rst

package info (click to toggle)
cmake 4.2.3-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 152,336 kB
  • sloc: ansic: 403,896; cpp: 303,920; sh: 4,105; python: 3,583; 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: 111; javascript: 83; pascal: 63; tcl: 55; php: 25; ruby: 22
file content (33 lines) | stat: -rw-r--r-- 1,283 bytes parent folder | download | duplicates (2)
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
CMAKE_AUTOGEN_INTERMEDIATE_DIR_STRATEGY
---------------------------------------

.. versionadded:: 4.2

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

- ``FULL``: Intermediate directories are named based on a
  ``<TARGET_NAME>_autogen.dir`` and ``<TARGET_NAME>_autogen`` 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.
- ``SHORT``: Intermediate directories are named from the hash of the target
  name and the build directory location and an ``/autogen`` subdirectory.
  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.