Mesa (main): r300: Document the RADEON_DEBUG options

[GitLab Mirror]

Module: Mesa
Branch: main
Commit: 44f134bc2199aa15403692a7cc56286952eac644
URL:    http://cgit.freedesktop.org/mesa/mesa/commit/?id=44f134bc2199aa15403692a7cc56286952eac644

Author: Pavel Ondračka <pavel.ondracka at gmail.com>
Date:   Wed Dec 29 11:04:51 2021 +0100

r300: Document the RADEON_DEBUG options

Reviewed-by: Marek Olšák <marek.olsak at amd.com>
Signed-off-by: Pavel Ondračka <pavel.ondracka at gmail.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/14333>

---

 docs/envvars.rst | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)

diff --git a/docs/envvars.rst b/docs/envvars.rst
index 5ce15ecf398..060119cdd41 100644
--- a/docs/envvars.rst
+++ b/docs/envvars.rst
@@ -972,5 +972,60 @@ r600 driver environment variables
    ``trans``
       Log generic translation messages
 
+r300 driver environment variables
+---------------------------------
+
+:envvar:`RADEON_DEBUG`
+   a comma-separated list of named flags, which do various things:
+
+   ``info``
+      Print hardware info (printed by default on debug builds
+   ``fp``
+      Log fragment program compilation
+   ``vp``
+      Log vertex program compilation
+   ``draw``
+      Log draw calls
+   ``swtcl``
+      Log SWTCL-specific info
+   ``rsblock``
+      Log rasterizer registers
+   ``psc``
+      Log vertex stream registers
+   ``tex``
+      Log basic info about textures
+   ``texalloc``
+      Log texture mipmap tree info
+   ``rs``
+      Log rasterizer
+   ``fb``
+      Log framebuffer
+   ``cbzb``
+      Log fast color clear info
+   ``hyperz``
+      Log HyperZ info
+   ``scissor``
+      Log scissor info
+   ``msaa``
+      Log MSAA resources
+   ``anisohq``
+      Use high quality anisotropic filtering
+   ``notiling``
+      Disable tiling
+   ``noimmd``
+      Disable immediate mode
+   ``noopt``
+      Disable shader optimizations
+   ``nocbzb``
+      Disable fast color clear
+   ``nozmask``
+      Disable zbuffer compression
+   ``nohiz``
+      Disable hierarchical zbuffer
+   ``nocmask``
+      Disable AA compression and fast AA clear
+   ``use_tgsi``
+      Request TGSI shaders from the state tracker
+
 Other Gallium drivers have their own environment variables. These may
 change frequently so the source code should be consulted for details.