1CMP0072
2-------
3
4.. versionadded:: 3.11
5
6:module:`FindOpenGL` prefers GLVND by default when available.
7
8The :module:`FindOpenGL` module provides an ``OpenGL::GL`` target and an
9``OPENGL_LIBRARIES`` variable for projects to use for legacy GL interfaces.
10When both a legacy GL library (e.g. ``libGL.so``) and GLVND libraries
11for OpenGL and GLX (e.g. ``libOpenGL.so`` and ``libGLX.so``) are available,
12the module must choose between them.  It documents an ``OpenGL_GL_PREFERENCE``
13variable that can be used to specify an explicit preference.  When no such
14preference is set, the module must choose a default preference.
15
16CMake 3.11 and above prefer to choose GLVND libraries.  This policy provides
17compatibility with projects that expect the legacy GL library to be used.
18
19The ``OLD`` behavior for this policy is to set ``OpenGL_GL_PREFERENCE`` to
20``LEGACY``.  The ``NEW`` behavior for this policy is to set
21``OpenGL_GL_PREFERENCE`` to ``GLVND``.
22
23This policy was introduced in CMake version 3.11.  CMake version
24|release| warns when the policy is not set and uses ``OLD`` behavior.
25Use the :command:`cmake_policy` command to set it to ``OLD`` or ``NEW``
26explicitly.
27
28.. include:: DEPRECATED.txt
29