docs: Move the gallium driver documentation to the top level.

I actually had never found these, buried under Developer Topics -> Gallium
-> Drivers.  Given that driver documentation contains not just gallium
driver documentation but also end-user information, bring it to a much
more prominent location between User Topics and Developer Topics at the
top level.

Reviewed-by: Erik Faye-Lund <erik.faye-lund@collabora.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/7174>

docs/conf.py

@@ -136,7 +136,16 @@ html_extra_path = [
 ]
 
 html_redirects = [
-  ('llvmpipe', 'gallium/drivers/llvmpipe.html'),
+  ('gallium/drivers/freedreno', 'drivers/freedreno.html'),
+  ('gallium/drivers/freedreno/ir3-notes', 'drivers/freedreno/ir3-notes.html'),
+  ('gallium/drivers/llvmpipe', 'drivers/llvmpipe.html'),
+  ('gallium/drivers/openswr', 'drivers/openswr.html'),
+  ('gallium/drivers/openswr/faq', 'drivers/openswr/faq.html'),
+  ('gallium/drivers/openswr/knobs', 'drivers/openswr/knobs.html'),
+  ('gallium/drivers/openswr/profiling', 'drivers/openswr/profiling.html'),
+  ('gallium/drivers/openswr/usage', 'drivers/openswr/usage.html'),
+  ('gallium/drivers/zink', 'drivers/zink.html'),
+  ('llvmpipe', 'drivers/llvmpipe.html'),
   ('postprocess', 'gallium/postprocess.html'),
   ('webmaster', 'https://www.mesa3d.org/website/'),
 ]

docs/contents.rst

@@ -47,6 +47,16 @@
    viewperf
    xlibdriver
 
+.. toctree::
+   :maxdepth: 1
+   :caption: Drivers
+   :hidden:
+
+   drivers/freedreno
+   drivers/llvmpipe
+   drivers/openswr
+   drivers/zink
+
 .. toctree::
    :maxdepth: 1
    :caption: Developer Topics

docs/drivers/llvmpipe.rst

@@ -1,5 +1,5 @@
-Gallium LLVMpipe Driver
+LLVMpipe
-=======================
+========
 
 Introduction
 ------------

docs/gallium/drivers.rst

@@ -1,9 +0,0 @@
-Drivers
-=======
-
-Driver specific documentation.
-
-.. toctree::
-   :glob:
-
-   drivers/*

docs/gallium/index.rst

@@ -15,7 +15,6 @@ Contents:
    context
    cso
    distro
-   drivers
    postprocess
    glossary
 

docs/systems.rst

@@ -31,7 +31,7 @@ Hardware drivers include:
 
 Software drivers include:
 
--  :doc:`llvmpipe <gallium/drivers/llvmpipe>` - uses LLVM for x86 JIT code generation
+-  :doc:`llvmpipe <drivers/llvmpipe>` - uses LLVM for x86 JIT code generation
    and is multi-threaded
 -  softpipe - a reference Gallium driver
 -  :doc:`svga <vmware-guest>` - driver for VMWare virtual GPU