28 lines
970 B
ReStructuredText
28 lines
970 B
ReStructuredText
|
CMAKE_NINJA_OUTPUT_PATH_PREFIX
|
||
|
|
------------------------------
|
||
|
|
|
||
|
|
Set output files path prefix for the :generator:`Ninja` generator.
|
||
|
|
|
||
|
|
Every output files listed in the generated ``build.ninja`` will be
|
||
|
|
prefixed by the contents of this variable (a trailing slash is
|
||
|
|
appended if missing). This is useful when the generated ninja file is
|
||
|
|
meant to be embedded as a ``subninja`` file into a *super* ninja
|
||
|
|
project. For example, a ninja build file generated with a command
|
||
|
|
like::
|
||
|
|
|
||
|
|
cd top-build-dir/sub &&
|
||
|
|
cmake -G Ninja -DCMAKE_NINJA_OUTPUT_PATH_PREFIX=sub/ path/to/source
|
||
|
|
|
||
|
|
can be embedded in ``top-build-dir/build.ninja`` with a directive like
|
||
|
|
this::
|
||
|
|
|
||
|
|
subninja sub/build.ninja
|
||
|
|
|
||
|
|
The ``auto-regeneration`` rule in ``top-build-dir/build.ninja`` must have an
|
||
|
|
order-only dependency on ``sub/build.ninja``.
|
||
|
|
|
||
|
|
.. note::
|
||
|
|
When ``CMAKE_NINJA_OUTPUT_PATH_PREFIX`` is set, the project generated
|
||
|
|
by CMake cannot be used as a standalone project. No default targets
|
||
|
|
are specified.
|