fix #6 by documenting the GLSL synthesiser