[Mesa-dev] [PATCH] docs/envvars: order INTEL_DEBUG envvars by name

[Samuel Iglesias Gonsálvez]

On Thu, 2017-04-20 at 16:11 +0200, Iago Toral wrote:
> s/order/sort :)
> 

Right! I unconsciously got it wrong with the similar word in Spanish
('ordenar'), which also has the meaning of 'to sort'.

> Reviewed-by: Iago Toral Quiroga <itoral at igalia.com>
> 

Thanks!

Sam

> 
> On Thu, 2017-04-20 at 14:02 +0200, Samuel Iglesias Gonsálvez wrote:
> > It helps to find the envvar you are looking for.
> > 
> > Signed-off-by: Samuel Iglesias Gonsálvez <siglesias at igalia.com>
> > ---
> >  docs/envvars.html | 58 +++++++++++++++++++++++++++----------------
> > ------------
> >  1 file changed, 29 insertions(+), 29 deletions(-)
> > 
> > diff --git a/docs/envvars.html b/docs/envvars.html
> > index a064f569c8b..05afd2d5529 100644
> > --- a/docs/envvars.html
> > +++ b/docs/envvars.html
> > @@ -163,47 +163,47 @@ See the <a href="xlibdriver.html">Xlib
> > software
> > driver page</a> for details.
> >     This is useful for debugging hangs, etc.</li>
> >  <li>INTEL_DEBUG - a comma-separated list of named flags, which do
> > various things:
> >  <ul>
> > -   <li>color - use color in output</li>
> > -   <li>tex - emit messages about textures.</li>
> > -   <li>state - emit messages about state flag tracking</li>
> > -   <li>blit - emit messages about blit operations</li>
> > -   <li>miptree - emit messages about miptrees</li>
> > -   <li>perf - emit messages about performance issues</li>
> > -   <li>perfmon - emit messages about AMD_performance_monitor</li>
> > +   <li>ann - annotate IR in assembly dumps</li>
> > +   <li>aub - dump batches into an AUB trace for use with
> > simulation
> > tools</li>
> >     <li>bat - emit batch information</li>
> > -   <li>pix - emit messages about pixel operations</li>
> > +   <li>blit - emit messages about blit operations</li>
> > +   <li>blorp - emit messages about the blorp operations (blits
> > &
> > clears)</li>
> >     <li>buf - emit messages about buffer objects</li>
> > +   <li>clip - emit messages about the clip unit (for old gens,
> > includes the CLIP program)</li>
> > +   <li>color - use color in output</li>
> > +   <li>cs - dump shader assembly for compute shaders</li>
> > +   <li>do32 - generate compute shader SIMD32 programs even if
> > workgroup size doesn't exceed the SIMD16 limit</li>
> > +   <li>dri - emit messages about the DRI interface</li>
> >     <li>fbo - emit messages about framebuffers</li>
> >     <li>fs - dump shader assembly for fragment shaders</li>
> >     <li>gs - dump shader assembly for geometry shaders</li>
> > -   <li>sync - after sending each batch, emit a message and wait
> > for
> > that batch to finish rendering</li>
> > -   <li>prim - emit messages about drawing primitives</li>
> > -   <li>vert - emit messages about vertex assembly</li>
> > -   <li>dri - emit messages about the DRI interface</li>
> > -   <li>sf - emit messages about the strips & fans unit (for
> > old
> > gens, includes the SF program)</li>
> > -   <li>stats - enable statistics counters. you probably actually
> > want perfmon or intel_gpu_top instead.</li>
> > -   <li>urb - emit messages about URB setup</li>
> > -   <li>vs - dump shader assembly for vertex shaders</li>
> > -   <li>clip - emit messages about the clip unit (for old gens,
> > includes the CLIP program)</li>
> > -   <li>aub - dump batches into an AUB trace for use with
> > simulation
> > tools</li>
> > -   <li>shader_time - record how much GPU time is spent in each
> > shader</li>
> > +   <li>hex - print instruction hex dump with the disassembly</li>
> > +   <li>l3 - emit messages about the new L3 state during
> > transitions</li>
> > +   <li>miptree - emit messages about miptrees</li>
> > +   <li>no8 - don't generate SIMD8 fragment shader</li>
> >     <li>no16 - suppress generation of 16-wide fragment shaders.
> > useful for debugging broken shaders</li>
> > -   <li>blorp - emit messages about the blorp operations (blits
> > &
> > clears)</li>
> > +   <li>nocompact - disable instruction compaction</li>
> >     <li>nodualobj - suppress generation of dual-object geometry
> > shader code</li>
> > +   <li>norbc - disable single sampled render buffer
> > compression</li>
> >     <li>optimizer - dump shader assembly to files at each
> > optimization pass and iteration that make progress</li>
> > -   <li>ann - annotate IR in assembly dumps</li>
> > -   <li>no8 - don't generate SIMD8 fragment shader</li>
> > -   <li>vec4 - force vec4 mode in vertex shader</li>
> > +   <li>perf - emit messages about performance issues</li>
> > +   <li>perfmon - emit messages about AMD_performance_monitor</li>
> > +   <li>pix - emit messages about pixel operations</li>
> > +   <li>prim - emit messages about drawing primitives</li>
> > +   <li>sf - emit messages about the strips & fans unit (for
> > old
> > gens, includes the SF program)</li>
> > +   <li>shader_time - record how much GPU time is spent in each
> > shader</li>
> >     <li>spill_fs - force spilling of all registers in the scalar
> > backend (useful to debug spilling code)</li>
> >     <li>spill_vec4 - force spilling of all registers in the vec4
> > backend (useful to debug spilling code)</li>
> > -   <li>cs - dump shader assembly for compute shaders</li>
> > -   <li>hex - print instruction hex dump with the disassembly</li>
> > -   <li>nocompact - disable instruction compaction</li>
> > +   <li>state - emit messages about state flag tracking</li>
> > +   <li>stats - enable statistics counters. you probably actually
> > want perfmon or intel_gpu_top instead.</li>
> > +   <li>sync - after sending each batch, emit a message and wait
> > for
> > that batch to finish rendering</li>
> >     <li>tcs - dump shader assembly for tessellation control
> > shaders</li>
> >     <li>tes - dump shader assembly for tessellation evaluation
> > shaders</li>
> > -   <li>l3 - emit messages about the new L3 state during
> > transitions</li>
> > -   <li>do32 - generate compute shader SIMD32 programs even if
> > workgroup size doesn't exceed the SIMD16 limit</li>
> > -   <li>norbc - disable single sampled render buffer
> > compression</li>
> > +   <li>tex - emit messages about textures.</li>
> > +   <li>urb - emit messages about URB setup</li>
> > +   <li>vec4 - force vec4 mode in vertex shader</li>
> > +   <li>vert - emit messages about vertex assembly</li>
> > +   <li>vs - dump shader assembly for vertex shaders</li>
> >  </ul>
> >  <li>INTEL_PRECISE_TRIG - if set to 1, true or yes, then the driver
> > prefers
> >     accuracy over performance in trig functions.</li>
> 
>