cmake-policies.7.rst 1.7 KB

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