Cogl deprecated API

About the deprecated API

Cogl has evolved from once being a thin abstraction over OpenGL and GLES where a lot of OpenGL's state machine style APIs were simply rebranded as Cogl API into the more distinguished API style we have today. The result of this evolution though is that some of the APIs are considered deprecated and because we plan to remove them at the next opportunity we have to break the API developers should aim to avoid these functions to keep their code working with future major versions of Cogl.