kolan
/
CMake
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
CMake/Help/manual/cmake-policies.7.rst

76 lines
1.8 KiB
ReStructuredText
Raw Normal View History

Help: Glob manual/*.rst in Sphinx configuration Add the man page description line as explicit markup at the top of each Help/manual/*.rst file and scan it from conf.py to automatically generate the man_pages Sphinx configuration value. This reduces the number of places that need to be changed when a new manual is added.
2013-10-30 17:58:25 +04:00
.. cmake-manual-description: CMake Policies Reference
Convert builtin help to reStructuredText source files Run the convert-help.bash script to convert documentation: ./convert-help.bash "/path/to/CMake-build/bin" Then remove it.
2013-10-15 19:17:36 +04:00
cmake-policies(7)
*****************
.. only:: html or latex
.. contents::
Help: Add introduction section to cmake-policies manual Explain the concept behind policies.
2013-10-18 21:22:09 +04:00
Introduction
============
Policies in CMake are used to preserve backward compatible behavior
across multiple releases. When a new policy is introduced, newer CMake
versions will begin to warn about the backward compatible behavior. It
is possible to disable the warning by explicitly requesting the OLD, or
backward compatible behavior using the :command:`cmake_policy` command.
It is also possible to request NEW, or non-backward compatible behavior
for a policy, also avoiding the warning.
The :command:`cmake_minimum_required` command does more than report an
error if a too-old version of CMake is used to build a project. It
also sets all policies introduced in that CMake version or earlier to
NEW behavior.
The :variable:`CMAKE_MINIMUM_REQUIRED_VERSION` variable may also be used
to determine whether to report an error on use of deprecated macros or
functions.
Convert builtin help to reStructuredText source files Run the convert-help.bash script to convert documentation: ./convert-help.bash "/path/to/CMake-build/bin" Then remove it.
2013-10-15 19:17:36 +04:00
All Policies
============
.. toctree::
Help: Limit reference manual toctree depth to 1 Add a :maxdepth: option to all toctree directives to limit their depth to 1. We do not want subheadings from individual documents to pollute the already large lists of CMake Domain objects.
2013-11-01 19:12:02 +04:00
:maxdepth: 1
Convert builtin help to reStructuredText source files Run the convert-help.bash script to convert documentation: ./convert-help.bash "/path/to/CMake-build/bin" Then remove it.
2013-10-15 19:17:36 +04:00
/policy/CMP0000
/policy/CMP0001
/policy/CMP0002
/policy/CMP0003
/policy/CMP0004
/policy/CMP0005
/policy/CMP0006
/policy/CMP0007
/policy/CMP0008
/policy/CMP0009
/policy/CMP0010
/policy/CMP0011
/policy/CMP0012
/policy/CMP0013
/policy/CMP0014
/policy/CMP0015
/policy/CMP0016
/policy/CMP0017
/policy/CMP0018
/policy/CMP0019
/policy/CMP0020
/policy/CMP0021
/policy/CMP0022
/policy/CMP0023
/policy/CMP0024
/policy/CMP0025
/policy/CMP0026
Handle genexes when evaluating INTERFACE_INCLUDE_DIRECTORIES errors.
2013-06-18 18:33:33 +04:00
/policy/CMP0027
Consider targets with double colons to be IMPORTED or ALIAS targets. Introduce a policy to control the behavior. The AliasTargets unit test already tests that using a double-semicolon in the name is not an error. Change the ExportImport test to use a namespace with a double-semicolon too.
2013-07-30 11:51:56 +04:00
/policy/CMP0028
Add policy CMP0029 to disallow subdir_depends
2013-10-18 19:54:48 +04:00
/policy/CMP0029
Add policy CMP0030 to disallow use_mangled_mesa
2013-10-18 19:55:42 +04:00
/policy/CMP0030
Add policy CMP0031 to disallow load_command
2013-10-18 20:41:54 +04:00
/policy/CMP0031
Add policy CMP0032 to disallow output_required_files
2013-10-18 21:00:17 +04:00
/policy/CMP0032
Add policy CMP0033 to disallow export_library_dependencies
2013-10-18 21:09:32 +04:00
/policy/CMP0033
Add policy CMP0034 to disallow utility_source
2013-10-21 19:50:47 +04:00
/policy/CMP0034
Add policy CMP0035 to disallow variable_requires
2013-10-21 19:58:48 +04:00
/policy/CMP0035
Add policy CMP0036 to disallow build_name
2013-10-21 21:12:18 +04:00
/policy/CMP0036
Disallow invalid target names (#13140) Exclude Borland and NMake from the CMP0037 test. They do not accept the colon in a target name.
2013-11-05 20:32:30 +04:00
/policy/CMP0037
Disallow link-to-self (#13947).
2013-11-05 21:01:09 +04:00
/policy/CMP0038
Disallow linking to utility targets (#13902).
2013-11-05 22:15:53 +04:00
/policy/CMP0039