Completely separate backends from platform implementation

This removes PuglContextType and allows the user to pass a backend directly.
Normally this would come from one of the two accessors declared in the headers,
but it would be possible to add backends without changing any of the existing
code at all.

Unfortunately, it is not possible to preserve backwards compatibility and
achieve the ultimate goal of linking only to the required dependencies, so
puglInitContextType() has just been removed.

1 files changed, 10 insertions, 1 deletions

diff --git a/pugl/pugl_gl_backend.h b/pugl/pugl_gl_backend.h
index 11f4e4b..5913b95 100644
--- a/pugl/pugl_gl_backend.h
+++ b/pugl/pugl_gl_backend.h
@@ -14,15 +14,24 @@
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
+/**
+   @file pugl_gl_backend.h Declaration of OpenGL backend accessor.
+*/
+
 #ifndef PUGL_GL_BACKEND_H
 #define PUGL_GL_BACKEND_H
 
-#include "pugl/pugl_internal_types.h"
+#include "pugl/pugl.h"
 
 #ifdef __cplusplus
 extern "C" {
 #endif
 
+/**
+   OpenGL graphics backend.
+
+   Pass the return value to puglInitBackend() to draw to a view with OpenGL.
+*/
 PUGL_API const PuglBackend*
 puglGlBackend(void);