mesa/src/compiler/glsl/glcpp at a8e2d79e0228106d11b6ceeb38f4ffb587f0a819 - fdo-mirrors/mesa

mirror of https://gitlab.freedesktop.org/mesa/mesa.git synced 2026-01-14 14:00:17 +01:00

History

Dylan Baker a8e2d79e02 meson: use gnu_symbol_visibility argument This uses a meson builtin to handle -fvisibility=hidden. This is nice because we don't need to track which languages are used, if C++ is suddenly added meson just does the right thing. Acked-by: Matt Turner <mattst88@gmail.com> Reviewed-by: Eric Engestrom <eric@engestrom.ch> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4740>		2020-06-01 18:59:18 +00:00
..
tests	tests: Make tests aware of meson test wrapper	2020-05-20 17:57:15 +00:00
glcpp-lex.l	glsl: add preprocessor #include support	2019-11-20 05:05:55 +00:00
glcpp-parse.y	glsl: do not crash if string literal is used outside of #include/#line	2020-03-13 11:49:06 +02:00
glcpp.c	Fix scons build	2018-04-12 19:55:01 -04:00
glcpp.h	glsl: add preprocessor #include support	2019-11-20 05:05:55 +00:00
meson.build	meson: use gnu_symbol_visibility argument	2020-06-01 18:59:18 +00:00
pp.c	glsl: pass gl_context to glcpp_parser_create()	2019-11-20 05:05:55 +00:00
pp_standalone_scaffolding.c	mesa: add support cursor support for relative path shader includes	2019-11-20 05:05:56 +00:00
pp_standalone_scaffolding.h	mesa: add support cursor support for relative path shader includes	2019-11-20 05:05:56 +00:00
README	glsl: move to compiler/	2016-01-26 16:08:33 +00:00

README

glcpp -- GLSL "C" preprocessor

This is a simple preprocessor designed to provide the preprocessing
needs of the GLSL language. The requirements for this preprocessor are
specified in the GLSL 1.30 specification availble from:

http://www.opengl.org/registry/doc/GLSLangSpec.Full.1.30.10.pdf

This specification is not precise on some semantics, (for example,
#define and #if), defining these merely "as is standard for C++
preprocessors". To fill in these details, I've been using a draft of
the C99 standard as available from:

http://www.open-std.org/jtc1/sc22/wg14/www/docs/n1256.pdf

Any downstream compiler accepting output from glcpp should be prepared
to encounter and deal with the following preprocessor macros:

	#line
	#pragma
	#extension

All other macros will be handled according to the GLSL specification
and will not appear in the output.

Known limitations
-----------------
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).