From 7b54772d53abfdb619343035815526ff13061e33 Mon Sep 17 00:00:00 2001 From: Erik Faye-Lund Date: Fri, 20 Nov 2020 13:58:40 +0100 Subject: [PATCH] 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 Part-of: --- docs/index.rst | 26 +++++++++++++++----------- 1 file changed, 15 insertions(+), 11 deletions(-) diff --git a/docs/index.rst b/docs/index.rst index c25bd348a5e..65d186864d3 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -4,23 +4,27 @@ Introduction ============ The Mesa project began as an open-source implementation of the -`OpenGL `__ 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 `__ (versions 1, -2, 3), `OpenCL `__, -`OpenMAX `__, -`VDPAU `__, `VA -API `__, -`XvMC `__ and -`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 `__ and -`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