third_party/mesa/README.txt

   1 Compilation has a few phases:
   2
   3 1. Generate the header and dispatch source files that have to match the GL api.
   4    These read in a description of the GL api in the form of XML files. In
   5    addition, generate the GLSL parser and lexer using flex and bison. These
   6    sources are needed for step 2
   7 2. Compile everything in src/glsl into a library. This step uses the parser and
   8    lexer output.
   9 3. Compile the compiler (executable) that can create the builtin functions'
  10    source file.  Note that this step uses builtin_stubs.cpp because we haven't
  11    generated the actual builtin functions' source file yet.
  12 4. Invoke the compiler that we just built to create
  13    gen/mesa/builtin_function.cpp
  14 5. Compile the rest of mesa, using the builtins that we created in step 4. In
  15    addition, link in all the files that we've previously compiled in step 2.