docs: use external link-references

The rST code here is much more to the point and easy to read if we
define the links as external link-references instead of inlining them.

This will make the next few patches much easier to grok.

Reviewed-by: Eric Anholt <eric@anholt.net>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/7709>
This commit is contained in:
Erik Faye-Lund 2020-11-20 13:58:40 +01:00 committed by Marge Bot
parent 2f9e27cc1a
commit 7b54772d53

View file

@ -4,23 +4,27 @@ Introduction
============
The Mesa project began as an open-source implementation of the
`OpenGL <https://www.opengl.org/>`__ specification - a system for
rendering interactive 3D graphics.
`OpenGL`_ specification - a system for rendering interactive 3D graphics.
Over the years the project has grown to implement more graphics APIs,
including `OpenGL ES <https://www.khronos.org/opengles/>`__ (versions 1,
2, 3), `OpenCL <https://www.khronos.org/opencl/>`__,
`OpenMAX <https://www.khronos.org/openmax/>`__,
`VDPAU <https://en.wikipedia.org/wiki/VDPAU>`__, `VA
API <https://en.wikipedia.org/wiki/Video_Acceleration_API>`__,
`XvMC <https://en.wikipedia.org/wiki/X-Video_Motion_Compensation>`__ and
`Vulkan <https://www.khronos.org/vulkan/>`__.
including `OpenGL ES`_ (versions 1, 2, 3), `OpenCL`_, `OpenMAX`_,
`VDPAU`_, `VA API`_, `XvMC`_ and `Vulkan`_.
A variety of device drivers allows the Mesa libraries to be used in many
different environments ranging from software emulation to complete
hardware acceleration for modern GPUs.
Mesa ties into several other open-source projects: the `Direct Rendering
Infrastructure <https://dri.freedesktop.org/>`__ and
`X.org <https://x.org>`__ to provide OpenGL support on Linux, FreeBSD
Infrastructure`_ and `X.org`_ to provide OpenGL support on Linux, FreeBSD
and other operating systems.
.. _OpenGL: https://www.opengl.org/
.. _OpenGL ES: https://www.khronos.org/opengles/
.. _OpenCL: https://www.khronos.org/opencl/
.. _OpenMAX: https://www.khronos.org/openmax/
.. _VDPAU: https://en.wikipedia.org/wiki/VDPAU
.. _VA API: https://en.wikipedia.org/wiki/Video_Acceleration_API
.. _XvMC: https://en.wikipedia.org/wiki/X-Video_Motion_Compensation
.. _Vulkan: https://www.khronos.org/vulkan/
.. _Direct Rendering Infrastructure: https://dri.freedesktop.org/
.. _X.org: https://x.org