| 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. |
