cmake-policies.7.rst 1.8 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374
  1. .. cmake-manual-description: CMake Policies Reference
  2. cmake-policies(7)
  3. *****************
  4. .. only:: html or latex
  5. .. contents::
  6. Introduction
  7. ============
  8. Policies in CMake are used to preserve backward compatible behavior
  9. across multiple releases. When a new policy is introduced, newer CMake
  10. versions will begin to warn about the backward compatible behavior. It
  11. is possible to disable the warning by explicitly requesting the OLD, or
  12. backward compatible behavior using the :command:`cmake_policy` command.
  13. It is also possible to request NEW, or non-backward compatible behavior
  14. for a policy, also avoiding the warning.
  15. The :command:`cmake_minimum_required` command does more than report an
  16. error if a too-old version of CMake is used to build a project. It
  17. also sets all policies introduced in that CMake version or earlier to
  18. NEW behavior.
  19. The :variable:`CMAKE_MINIMUM_REQUIRED_VERSION` variable may also be used
  20. to determine whether to report an error on use of deprecated macros or
  21. functions.
  22. All Policies
  23. ============
  24. .. toctree::
  25. :maxdepth: 1
  26. /policy/CMP0000
  27. /policy/CMP0001
  28. /policy/CMP0002
  29. /policy/CMP0003
  30. /policy/CMP0004
  31. /policy/CMP0005
  32. /policy/CMP0006
  33. /policy/CMP0007
  34. /policy/CMP0008
  35. /policy/CMP0009
  36. /policy/CMP0010
  37. /policy/CMP0011
  38. /policy/CMP0012
  39. /policy/CMP0013
  40. /policy/CMP0014
  41. /policy/CMP0015
  42. /policy/CMP0016
  43. /policy/CMP0017
  44. /policy/CMP0018
  45. /policy/CMP0019
  46. /policy/CMP0020
  47. /policy/CMP0021
  48. /policy/CMP0022
  49. /policy/CMP0023
  50. /policy/CMP0024
  51. /policy/CMP0025
  52. /policy/CMP0026
  53. /policy/CMP0027
  54. /policy/CMP0028
  55. /policy/CMP0029
  56. /policy/CMP0030
  57. /policy/CMP0031
  58. /policy/CMP0032
  59. /policy/CMP0033
  60. /policy/CMP0034
  61. /policy/CMP0035
  62. /policy/CMP0036
  63. /policy/CMP0037
  64. /policy/CMP0038