[Mesa-dev] [PATCH] docs: update MESA_DEBUG envvar documentation.

Alejandro PiƱeiro apinheiro at igalia.com
Mon Jun 27 08:10:35 UTC 2016


silent, flush, incomplete_tex and incomplete_fbo flags were not
documented (see src/mesa/main.debug.c for more info).

FP is not checked anymore.
---

Didn't know about the flush option for MESA_DEBUG until Grazvydas Ignotas
mentioned it on a freedesktop bug comment (thanks), so this patch documents
it.

CCing Eric Anholt because MESA_DEBUG=flush and VC4_DEBUG=always_flush seems
to have basically the same purpose, in case one needs to be removed.

CCing Brian because he added the incomplete_tex and incomplete_fbo flags
with commit 93bcf7, and I just added a really basic documentation line for
those options, just in case it is worth more details.

Note that I assume that all the specific flags for MESA_DEBUG are handled
at debuc.c:set_debug_flags. As it is not taking into account FP, Im also
dropping the FP line with this patch.


 docs/envvars.html | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/docs/envvars.html b/docs/envvars.html
index ed957bd..abd8a72 100644
--- a/docs/envvars.html
+++ b/docs/envvars.html
@@ -50,8 +50,13 @@ sometimes be useful for debugging end-user issues.
    if the application generates a GL_INVALID_ENUM error, a corresponding error
    message indicating where the error occurred, and possibly why, will be
    printed to stderr.<br>
-   If the value of MESA_DEBUG is 'FP' floating point arithmetic errors will
-   generate exceptions.
+  In addition to just set it, MESA_DEBUG accepts the following flags:
+  <ul>
+    <li>silent - turn off debug messages</li>
+    <li>flush - flush after each drawing command</li>
+    <li>incomplete_tex - extra debug messages when a texture is incomplete</li>
+    <li>incomplete_fbo - extra debug messages when a fbo is incomplete</li>
+  </ul>
 <li>MESA_LOG_FILE - specifies a file name for logging all errors, warnings,
 etc., rather than stderr
 <li>MESA_TEX_PROG - if set, implement conventional texture env modes with
-- 
2.7.4



More information about the mesa-dev mailing list