First draft.

1 files changed, 194 insertions, 0 deletions

diff --git a/docs/MESA_shader_debug.spec b/docs/MESA_shader_debug.spec
new file mode 100644
index 00000000000..0aef8f7df84
--- /dev/null
+++ b/docs/MESA_shader_debug.spec
@@ -0,0 +1,194 @@
+Name
+
+    MESA_shader_debug
+
+Name Strings
+
+    GL_MESA_shader_debug
+
+Contact
+
+    Brian Paul (brian.paul 'at' tungstengraphics.com)
+    Michal Krol (mjkrol 'at' gmail.com)
+
+Status
+
+    XXX - Not complete yet!!!
+
+Version
+
+    Last Modified Date: May 29, 2006
+    Author Revision: 0.1
+    $Date: 2006/05/30 09:35:36 $ $Revision: 1.1 $
+
+Number
+
+    TBD
+
+Dependencies
+
+    OpenGL 1.5 is required.
+    The extension is written against the OpenGL 1.5 specification.
+    ARB_shading_language_100 is required.
+    ARB_shader_objects is required.
+    The extension is written against the OpenGL Shading Language
+    1.10 Specification.
+
+Overview
+
+    TBD
+
+IP Status
+
+    None
+
+Issues
+
+    None
+
+New Procedures and Functions
+
+    TBD
+
+New Types
+
+    None
+
+New Tokens
+
+    TBD
+
+Additions to Chapter 2 of the OpenGL 1.5 Specification
+(OpenGL Operation)
+
+    None
+
+Additions to Chapter 3 of the OpenGL 1.5 Specification (Rasterization)
+
+    None
+
+Additions to Chapter 4 of the OpenGL 1.5 Specification (Per-Fragment
+Operations and the Frame Buffer)
+
+    None
+
+Additions to Chapter 5 of the OpenGL 1.5 Specification
+(Special Functions)
+
+    None
+
+Additions to Chapter 6 of the OpenGL 1.5 Specification (State and State
+Requests)
+
+    None
+
+Additions to Appendix A of the OpenGL 1.5 Specification (Invariance)
+
+    None
+
+Additions to Chapter 1 of the OpenGL Shading Language 1.10 Specification
+(Introduction)
+
+    None
+
+Additions to Chapter 2 of the OpenGL Shading Language 1.10 Specification
+(Overview of OpenGL Shading)
+
+    None
+
+Additions to Chapter 3 of the OpenGL Shading Language 1.10 Specification
+(Basics)
+
+    None
+
+Additions to Chapter 4 of the OpenGL Shading Language 1.10 Specification
+(Variables and Types)
+
+    None
+
+Additions to Chapter 5 of the OpenGL Shading Language 1.10 Specification
+(Operators and Expressions)
+
+    None
+
+Additions to Chapter 6 of the OpenGL Shading Language 1.10 Specification
+(Statements and Structure)
+
+    None
+
+Additions to Chapter 7 of the OpenGL Shading Language 1.10 Specification
+(Built-in Variables)
+
+    None
+
+Additions to Chapter 8 of the OpenGL Shading Language 1.10 Specification
+(Built-in Functions)
+
+    Add a new section 8.10 "Debug Functions":
+
+    Debug functions are available to both fragment and vertex shaders.
+    They are used to track the execution of a shader by logging
+    passed-in arguments to the shader's info log. That values can be
+    retrieved and validated by the application after shader execution
+    is complete.
+
+    void printMESA(const float value);
+    void printMESA(const int value);
+    void printMESA(const bool value);
+    void printMESA(const vec2 value);
+    void printMESA(const vec3 value);
+    void printMESA(const vec4 value);
+    void printMESA(const ivec2 value);
+    void printMESA(const ivec3 value);
+    void printMESA(const ivec4 value);
+    void printMESA(const bvec2 value);
+    void printMESA(const bvec3 value);
+    void printMESA(const bvec4 value);
+    void printMESA(const mat2 value);
+    void printMESA(const mat3 value);
+    void printMESA(const mat4 value);
+    void printMESA(const sampler1D value);
+    void printMESA(const sampler2D value);
+    void printMESA(const sampler3D value);
+    void printMESA(const samplerCube value);
+    void printMESA(const sampler1DShadow value);
+    void printMESA(const sampler2DShadow value);
+
+Additions to Chapter 9 of the OpenGL Shading Language 1.10 Specification
+(Shading Language Grammar)
+
+    None
+
+Additions to Chapter 10 of the OpenGL Shading Language 1.10
+Specification (Issues)
+
+    None
+
+Additions to the AGL/EGL/GLX/WGL Specifications
+
+    None
+
+GLX Protocol
+
+    None
+
+Errors
+
+    TBD
+
+New State
+
+    TBD
+
+New Implementation Dependent State
+
+    TBD
+
+Sample Code
+
+    TBD
+
+Revision History
+
+    29 May 2006
+        Initial draft. (Michal Krol)