Merge commit 'origin/gallium-0.1' into gallium-0.2

diff --cc src/mesa/shader/arbprogparse.c
index d1c3cd721415c4822252dbe72a68bf19d7f4fb4c,466ae48bef35fecae78384c5eb964112e612799f..f499499eb3a3e0c068a82fcd63519a3e9a55dec2
--- 1/src/mesa/shader/arbprogparse.c
--- 2/src/mesa/shader/arbprogparse.c
+++ b/src/mesa/shader/arbprogparse.c
@@@ -30,11 -30,29 +30,32 @@@
   * \author Karl Rasche
   */
  
+ /**
+ Notes on program parameters, etc.
+ 
+ The instructions we emit will use six kinds of source registers:
+ 
+   PROGRAM_INPUT      - input registers
+   PROGRAM_TEMPORARY  - temp registers
+   PROGRAM_ADDRESS    - address/indirect register
+   PROGRAM_SAMPLER    - texture sampler
+   PROGRAM_CONSTANT   - indexes into program->Parameters, a known constant/literal
+   PROGRAM_STATE_VAR  - indexes into program->Parameters, and may actually be:
+                        + a state variable, like "state.fog.color", or
+                        + a pointer to a "program.local[k]" parameter, or
+                        + a pointer to a "program.env[k]" parameter
+ 
+ Basically, all the program.local[] and program.env[] values will get mapped
+ into the unified gl_program->Parameters array.  This solves the problem of
+ having three separate program parameter arrays.
+ */
+ 
+ 
  #include "main/glheader.h"
  #include "main/imports.h"
 +#include "main/context.h"
 +#include "main/macros.h"
 +#include "main/mtypes.h"
  #include "shader/grammar/grammar_mesa.h"
  #include "arbprogparse.h"
  #include "program.h"