https://github.com/Kitware/CMake
Raw File
Tip revision: 8bd6af0d6386d1e0b26ff594b7d42621d67b5985 authored by Brad King on 02 May 2017, 12:40:39 UTC
CMake 3.8.1
Tip revision: 8bd6af0
CMAKE_NINJA_OUTPUT_PATH_PREFIX.rst
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.
back to top