ad3c2c0b03
Every policy's documentation has a paragraph on what version of CMake introduced it, how to set the policy, and whether CMake warns if the policy is not set. The wording of this paragraph has diverged across policies over time. Factor the paragraph out into a standard advice document included by every policy.
28 lines
1.1 KiB
ReStructuredText
28 lines
1.1 KiB
ReStructuredText
CMP0072
|
|
-------
|
|
|
|
.. versionadded:: 3.11
|
|
|
|
:module:`FindOpenGL` prefers GLVND by default when available.
|
|
|
|
The :module:`FindOpenGL` module provides an ``OpenGL::GL`` target and an
|
|
``OPENGL_LIBRARIES`` variable for projects to use for legacy GL interfaces.
|
|
When both a legacy GL library (e.g. ``libGL.so``) and GLVND libraries
|
|
for OpenGL and GLX (e.g. ``libOpenGL.so`` and ``libGLX.so``) are available,
|
|
the module must choose between them. It documents an ``OpenGL_GL_PREFERENCE``
|
|
variable that can be used to specify an explicit preference. When no such
|
|
preference is set, the module must choose a default preference.
|
|
|
|
CMake 3.11 and above prefer to choose GLVND libraries. This policy provides
|
|
compatibility with projects that expect the legacy GL library to be used.
|
|
|
|
The ``OLD`` behavior for this policy is to set ``OpenGL_GL_PREFERENCE`` to
|
|
``LEGACY``. The ``NEW`` behavior for this policy is to set
|
|
``OpenGL_GL_PREFERENCE`` to ``GLVND``.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.11
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: warns
|
|
.. include:: STANDARD_ADVICE.txt
|
|
|
|
.. include:: DEPRECATED.txt
|