aboutsummaryrefslogtreecommitdiff
path: root/mesalib/src/glsl/glcpp/README
diff options
context:
space:
mode:
authormarha <marha@users.sourceforge.net>2011-01-28 08:34:35 +0000
committermarha <marha@users.sourceforge.net>2011-01-28 08:34:35 +0000
commit39339fcb860cb48b4f988f5eed31f8d7d2fc1464 (patch)
tree84ecdb55b6759e58969e7e8e3e36a6d361e1c90a /mesalib/src/glsl/glcpp/README
parent613fdaf384eb16a4d7058dcbfbca9f43e44e063d (diff)
parentdc0f390b45a3037c85163b8a9e945a31f5756690 (diff)
downloadvcxsrv-39339fcb860cb48b4f988f5eed31f8d7d2fc1464.tar.gz
vcxsrv-39339fcb860cb48b4f988f5eed31f8d7d2fc1464.tar.bz2
vcxsrv-39339fcb860cb48b4f988f5eed31f8d7d2fc1464.zip
svn merge ^/branches/released .
Diffstat (limited to 'mesalib/src/glsl/glcpp/README')
-rw-r--r--mesalib/src/glsl/glcpp/README25
1 files changed, 24 insertions, 1 deletions
diff --git a/mesalib/src/glsl/glcpp/README b/mesalib/src/glsl/glcpp/README
index 0b5ef508c..9cc00e927 100644
--- a/mesalib/src/glsl/glcpp/README
+++ b/mesalib/src/glsl/glcpp/README
@@ -29,4 +29,27 @@ The __LINE__ and __FILE__ macros are not yet supported.
A file that ends with a function-like macro name as the last
non-whitespace token will result in a parse error, (where it should be
-passed through as is). \ No newline at end of file
+passed through as is).
+
+Known deviations from the specification
+---------------------------------------
+As mentoned above, the GLSL specification (as of 1.30.10) is fairly
+vague on some aspects of the preprocessor, and we've been using C99 to
+fill in details. Here is a list of cases where we have deviated from
+the behavior specified in C99 to obtain better compatibility with
+other GLSL implementations:
+
+ * Redefining a macro with a different value
+
+ C89 says that a macro "may be redefined ... provided that the
+ second definition [is equivalent]" (Section 3.8.3 Macro
+ Replacement/constraints)
+
+ C99 is even more explicit, saying tthat a macro "shall not be
+ redefined by another #define preprocessing directive unless the
+ second definition [is equivalent]" (Section 6.10.3 Macro
+ Replacement/Constraints)
+
+ In spite of this, glcpp emits a warning rather than an error for
+ non-equivalent redefinition of macros since this matches the
+ behavior of other, widely-used implementations.