1CMP0088
2-------
3
4.. versionadded:: 3.14
5
6:module:`FindBISON` runs bison in :variable:`CMAKE_CURRENT_BINARY_DIR`
7when executing.
8
9The module provides a ``BISON_TARGET`` macro which generates BISON output.
10In CMake 3.13 and below the macro would generate a custom command that runs
11``bison`` in the source directory.  CMake 3.14 and later prefer to run it
12in the build directory and use :variable:`CMAKE_CURRENT_BINARY_DIR` as the
13``WORKING_DIRECTORY`` of its :command:`add_custom_command` invocation.
14This ensures that any implicitly generated file is written to the build
15tree rather than the source.
16
17This policy provides compatibility for projects that have not been updated
18to expect the new behavior.
19
20The ``OLD`` behavior for this policy is for ``BISON_TARGET`` to use
21the current source directory for the ``WORKING_DIRECTORY`` and where
22to generate implicit files. The ``NEW`` behavior of this policy is to
23use the current binary directory for the ``WORKING_DIRECTORY`` and where
24to generate implicit files.
25
26This policy was introduced in CMake version 3.14.  Use the
27:command:`cmake_policy` command to set it to ``OLD`` or ``NEW`` explicitly.
28Unlike most policies, CMake version |release| does *not* warn
29when this policy is not set and simply uses ``OLD`` behavior.
30
31.. include:: DEPRECATED.txt
32