[glitz] Add doc skeleton.

Add gtk-doc skeleton, documentation is really a missing piece of glitz.

29 files changed, 3241 insertions, 4 deletions

diff --git a/Makefile.am b/Makefile.am
index 9a7a255..a27bf61 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -1,3 +1,3 @@
-SUBDIRS = . src examples
+SUBDIRS = . src doc examples
 
-EXTRA_DIST = COPYING
+EXTRA_DIST = COPYING gtk-doc.make
diff --git a/configure.in b/configure.in
index 7e8461f..e2394cc 100644
--- a/configure.in
+++ b/configure.in
@@ -2,9 +2,11 @@
 
 # Package version number, (as distinct from shared library version)
 # This must be manually synchronized with the version in src/glitz.h
-m4_define([GLITZ_VERSION], 0.5.7)
+m4_define(glitz_version_major, 0)
+m4_define(glitz_version_minor, 5)
+m4_define(glitz_version_micro, 7)
 
-AC_INIT(glitz, [GLITZ_VERSION])
+AC_INIT(glitz, [glitz_version_major.glitz_version_minor.glitz_version_micro])
 
 AC_CONFIG_AUX_DIR(config)
 
@@ -13,6 +15,9 @@ AM_CONFIG_HEADER(config.h)
 
 AM_MAINTAINER_MODE
 
+GLITZ_VERSION=glitz_version_major().glitz_version_minor().glitz_version_micro()
+AC_SUBST(GLITZ_VERSION)
+
 dnl ===========================================================================
 
 # libtool shared library version
@@ -101,6 +106,11 @@ AC_SUBST(GLITZ_LIB)
 AC_SUBST(GLITZ_INC)
 
 dnl ===========================================================================
+dnl Check for gtk-doc and docbook
+
+GTK_DOC_CHECK([1.6])
+
+dnl ===========================================================================
 
 PKG_PROG_PKG_CONFIG
 PKG_CHECK_EXISTS([libpng12], [enable_png=yes], [enable_png=no])
@@ -333,6 +343,9 @@ src/glx/glitz-glx.pc
 src/agl/glitz-agl.pc
 src/egl/glitz-egl.pc
 src/wgl/glitz-wgl.pc
+doc/Makefile
+doc/reference/Makefile
+doc/reference/version.xml
 examples/Makefile
 examples/cairogears/Makefile
 examples/glitzinfo/Makefile
diff --git a/doc/Makefile.am b/doc/Makefile.am
new file mode 100644
index 0000000..b4e27b3
--- /dev/null
+++ b/doc/Makefile.am
@@ -0,0 +1,4 @@
+SUBDIRS=reference
+.PHONY: doc
+doc:
+	cd reference && $(MAKE) $(AM_MAKEFLAGS) doc
diff --git a/doc/reference/Makefile.am b/doc/reference/Makefile.am
new file mode 100644
index 0000000..1158612
--- /dev/null
+++ b/doc/reference/Makefile.am
@@ -0,0 +1,67 @@
+## Process this file with automake to create Makefile.in.
+
+# The name of the module.
+DOC_MODULE=glitz
+
+# The top-level SGML file.
+DOC_MAIN_SGML_FILE=glitz-docs.xml
+
+# Extra options to supply to gtkdoc-scan
+SCAN_OPTIONS=
+
+# The directory containing the source code. Relative to $(srcdir)
+DOC_SOURCE_DIR=../../src
+
+# Used for dependencies
+HFILE_GLOB=$(top_srcdir)/src/*.h $(top_srcdir)/src/glx/*.h
+CFILE_GLOB=$(top_srcdir)/src/*.c $(top_srcdir)/src/*.h $(top_srcdir)/src/glx/*.c $(top_srcdir)/src/glx/*.h
+
+UNSUPPORTED_HFILES=	glitzint.h \
+                    glitz_gl.h \
+                    glitz_trapimp.h \
+                    glitz_glxext.h \
+                    glitz_glxint.h \
+                    glitz_aglext.h \
+                    glitz_aglint.h \
+                    glitz_eglext.h \
+                    glitz_eglint.h \
+                    glitz_wglext.h \
+                    glitz_wglint.h 
+
+# Headers to ignore
+IGNORE_HFILES=					\
+	$(UNSUPPORTED_HFILES)
+
+# CFLAGS and LDFLAGS for compiling scan program. Only needed
+# if $(DOC_MODULE).types is non-empty.
+INCLUDES =
+GTKDOC_LIBS =
+
+# Extra options to supply to gtkdoc-mkdb
+MKDB_OPTIONS=--sgml-mode --output-format=xml
+
+# Extra options to supply to gtkdoc-mktmpl
+MKTMPL_OPTIONS=
+
+# Non-autogenerated SGML files to be included in $(DOC_MAIN_SGML_FILE)
+content_files =					\
+	version.xml
+
+# Images to copy into HTML directory
+HTML_IMAGES =
+
+# Extra options to supply to gtkdoc-fixref
+FIXXREF_OPTIONS=
+
+include $(top_srcdir)/gtk-doc.make
+
+# Version information for marking the documentation
+EXTRA_DIST += version.xml.in
+
+if ENABLE_GTK_DOC
+check: doc
+endif
+
+TESTS_ENVIRONMENT = srcdir="$(srcdir)" top_srcdir="$(top_srcdir)" MAKE="$(MAKE)"
+TESTS = check-doc-coverage.sh check-doc-syntax.sh
+EXTRA_DIST += $(TESTS)
diff --git a/doc/reference/check-doc-coverage.sh b/doc/reference/check-doc-coverage.sh
new file mode 100755
index 0000000..aa1ee52
--- /dev/null
+++ b/doc/reference/check-doc-coverage.sh
@@ -0,0 +1,45 @@
+#!/bin/sh
+
+LANG=C
+if test -z "$DOC_MODULE"; then
+	# extract from Makefile
+	eval `grep '^DOC_MODULE' Makefile | sed 's/ //g'`
+	if test -z "$DOC_MODULE"; then
+		echo Failed extracting DOC_MODULE from Makefile 1>&2
+		echo Try setting DOC_MODULE env var manually 1>&2
+		exit 1
+	fi
+fi
+
+
+test -z "$srcdir" && srcdir=.
+stat=0
+
+if test -f "$DOC_MODULE-undocumented.txt" -a -f "$DOC_MODULE-unused.txt"; then
+	:
+else
+	echo At least one of "$DOC_MODULE-undocumented.txt" and "$DOC_MODULE-unused.txt" not found.
+	echo Skipping test.
+	exit 0
+fi
+
+if test -f "$DOC_MODULE-unused.txt"; then
+	unused=`cat "$DOC_MODULE-unused.txt"`
+	if test -n "$unused"; then
+		echo Unused documentated symbols: 1>&2
+		cat "$DOC_MODULE-unused.txt" 1>&2
+		stat=1
+	fi
+fi
+if test -f "$DOC_MODULE-undocumented.txt"; then
+	if grep '^0 symbols incomplete' "$DOC_MODULE-undocumented.txt" >/dev/null &&
+	   grep '^0 not documented'     "$DOC_MODULE-undocumented.txt" >/dev/null; then
+		:
+	else
+		echo Incomplete or undocumented symbols: 1>&2
+		cat "$DOC_MODULE-undocumented.txt" 1>&2
+		stat=1
+	fi
+fi
+
+exit $stat
diff --git a/doc/reference/check-doc-syntax.sh b/doc/reference/check-doc-syntax.sh
new file mode 100755
index 0000000..c446d26
--- /dev/null
+++ b/doc/reference/check-doc-syntax.sh
@@ -0,0 +1,11 @@
+#!/bin/sh
+
+LANG=C
+
+test -z "$srcdir" && srcdir=.
+test -z "$top_srcdir" && top_srcdir=$srcdir/../..
+
+SGML_DOCS=true
+FILES=`echo $srcdir/tmpl/*.sgml`
+
+. "$top_srcdir/src/check-doc-syntax.sh"
diff --git a/doc/reference/glitz-docs.xml b/doc/reference/glitz-docs.xml
new file mode 100644
index 0000000..e8fff21
--- /dev/null
+++ b/doc/reference/glitz-docs.xml
@@ -0,0 +1,32 @@
+<?xml version="1.0"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+                "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+<!ENTITY version SYSTEM "version.xml">
+]>
+<book lang="en" id="glitz" xmlns:xi="http://www.w3.org/2003/XInclude"> 
+<title>Glitz: An OpenGL image compositing Library</title>
+  <bookinfo>
+    <title>Glitz: An OpenGL image compositing Library</title>
+    <releaseinfo>for Glitz &version;</releaseinfo>
+  </bookinfo>
+
+  <chapter>
+    <title>Glitz core</title>
+    <xi:include href="xml/glitz-types.xml"/>
+    <xi:include href="xml/glitz-formats.xml"/>
+    <xi:include href="xml/glitz-drawable.xml"/>
+    <xi:include href="xml/glitz-surface.xml"/>
+    <xi:include href="xml/glitz-texture.xml"/>
+    <xi:include href="xml/glitz-context.xml"/>
+    <xi:include href="xml/glitz-buffer.xml"/>
+    <xi:include href="xml/glitz-pixels.xml"/>
+    <xi:include href="xml/glitz-drawing.xml"/>
+  </chapter>
+  <chapter>
+    <title>Glitz backends</title>
+    <xi:include href="xml/glitz-agl.xml"/>
+    <xi:include href="xml/glitz-egl.xml"/>
+    <xi:include href="xml/glitz-glx.xml"/>
+    <xi:include href="xml/glitz-wgl.xml"/>
+  </chapter>
+</book>
diff --git a/doc/reference/glitz-overrides.txt b/doc/reference/glitz-overrides.txt
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/doc/reference/glitz-overrides.txt
diff --git a/doc/reference/glitz-sections.txt b/doc/reference/glitz-sections.txt
new file mode 100644
index 0000000..5f4bdd5
--- /dev/null
+++ b/doc/reference/glitz-sections.txt
@@ -0,0 +1,272 @@
+<SECTION>
+<FILE>glitz-types</FILE>
+<TITLE>Types</TITLE>
+glitz_bool_t
+glitz_short_t
+glitz_int_t
+glitz_float_t
+glitz_double_t
+glitz_fixed16_16_t
+glitz_drawable_t
+glitz_surface_t
+glitz_rectangle_t
+glitz_box_t
+glitz_point_fixed_t
+glitz_line_fixed_t
+glitz_trapezoid_t
+glitz_span_fixed_t
+glitz_trap_t
+glitz_transform_t
+glitz_color_t
+glitz_filter_t
+glitz_operator_t
+glitz_status_t
+glitz_status_string
+glitz_gl_string_t
+glitz_fill_t
+GLITZ_FEATURE_TEXTURE_RECTANGLE_MASK
+GLITZ_FEATURE_TEXTURE_NON_POWER_OF_TWO_MASK
+GLITZ_FEATURE_TEXTURE_MIRRORED_REPEAT_MASK
+GLITZ_FEATURE_TEXTURE_BORDER_CLAMP_MASK
+GLITZ_FEATURE_MULTISAMPLE_MASK
+GLITZ_FEATURE_MULTISAMPLE_FILTER_HINT_MASK
+GLITZ_FEATURE_MULTITEXTURE_MASK
+GLITZ_FEATURE_TEXTURE_ENV_COMBINE_MASK
+GLITZ_FEATURE_TEXTURE_ENV_DOT3_MASK
+GLITZ_FEATURE_FRAGMENT_PROGRAM_MASK
+GLITZ_FEATURE_VERTEX_BUFFER_OBJECT_MASK
+GLITZ_FEATURE_PIXEL_BUFFER_OBJECT_MASK
+GLITZ_FEATURE_PER_COMPONENT_RENDERING_MASK
+GLITZ_FEATURE_BLEND_COLOR_MASK
+GLITZ_FEATURE_PACKED_PIXELS_MASK
+GLITZ_FEATURE_MULTI_DRAW_ARRAYS_MASK
+GLITZ_FEATURE_FRAMEBUFFER_OBJECT_MASK
+GLITZ_FEATURE_COPY_SUB_BUFFER_MASK
+GLITZ_FEATURE_DIRECT_RENDERING_MASK
+GLITZ_FEATURE_TEXTURE_FROM_PIXMAP_MASK
+</SECTION>
+
+<SECTION>
+<FILE>glitz-formats</FILE>
+<TITLE>Formats</TITLE>
+glitz_format_name_t
+GLITZ_FORMAT_ID_MASK
+GLITZ_FORMAT_RED_SIZE_MASK
+GLITZ_FORMAT_GREEN_SIZE_MASK
+GLITZ_FORMAT_BLUE_SIZE_MASK
+GLITZ_FORMAT_ALPHA_SIZE_MASK
+glitz_format_id_t
+glitz_fourcc_t
+GLITZ_FORMAT_FOURCC_MASK
+GLITZ_FOURCC
+GLITZ_FOURCC_RGB
+GLITZ_FOURCC_YV12
+GLITZ_FOURCC_YUY2
+glitz_color_format_t
+GLITZ_FORMAT_DEPTH_SIZE_MASK
+GLITZ_FORMAT_STENCIL_SIZE_MASK
+GLITZ_FORMAT_DOUBLEBUFFER_MASK
+GLITZ_FORMAT_SAMPLES_MASK
+GLITZ_FORMAT_Y_INVERTED_MASK
+glitz_drawable_format_t
+glitz_format_t
+glitz_find_standard_format
+glitz_find_format
+glitz_find_drawable_format
+glitz_find_pbuffer_format
+</SECTION>
+</SECTION>
+
+<SECTION>
+<FILE>glitz-drawable</FILE>
+<TITLE>Drawable</TITLE>
+glitz_drawable_buffer_t
+glitz_create_drawable
+glitz_create_pbuffer_drawable
+glitz_drawable_destroy
+glitz_drawable_reference
+glitz_drawable_update_size
+glitz_drawable_get_width
+glitz_drawable_get_height
+glitz_drawable_swap_buffer_region
+glitz_drawable_swap_buffers
+glitz_drawable_flush
+glitz_drawable_finish
+glitz_drawable_get_features
+glitz_drawable_get_format
+glitz_drawable_get_gl_string
+</SECTION>
+
+<SECTION>
+<FILE>glitz-surface</FILE>
+<TITLE>Surface</TITLE>
+GLITZ_SURFACE_UNNORMALIZED_MASK
+glitz_surface_attributes_t
+glitz_surface_create
+glitz_surface_destroy
+glitz_surface_reference
+glitz_surface_attach
+glitz_surface_detach
+glitz_surface_flush
+glitz_surface_get_drawable
+glitz_surface_get_attached_drawable
+glitz_surface_set_transform
+glitz_surface_set_fill
+glitz_surface_set_component_alpha
+glitz_surface_set_filter
+glitz_surface_set_dither
+glitz_surface_get_width
+glitz_surface_get_height
+glitz_surface_get_status
+glitz_surface_get_format
+glitz_surface_translate_point
+glitz_surface_set_clip_region
+glitz_surface_valid_target
+glitz_surface_bind_tex_image
+glitz_surface_release_tex_image
+</SECTION>
+
+<SECTION>
+<FILE>glitz-texture</FILE>
+<TITLE>Texture</TITLE>
+glitz_texture_object_t
+glitz_texture_object_create
+glitz_texture_object_destroy
+glitz_texture_object_reference
+glitz_texture_filter_type_t
+glitz_texture_filter_t
+glitz_texture_object_set_filter
+glitz_texture_wrap_type_t
+glitz_texture_wrap_t
+glitz_texture_object_set_wrap
+glitz_texture_object_set_border_color
+glitz_texture_target_t
+glitz_texture_object_get_target
+</SECTION>
+
+<SECTION>
+<FILE>glitz-context</FILE>
+<TITLE>Context</TITLE>
+glitz_context_t
+glitz_context_create
+glitz_context_destroy
+glitz_context_reference
+glitz_context_copy
+glitz_lose_current_function_t
+glitz_context_set_user_data
+glitz_function_pointer_t
+glitz_context_get_proc_address
+glitz_context_make_current
+glitz_context_bind_texture
+glitz_context_draw_buffers
+glitz_context_read_buffer
+glitz_set_rectangle
+glitz_set_rectangles
+</SECTION>
+
+<SECTION>
+<FILE>glitz-buffer</FILE>
+<TITLE>Buffer</TITLE>
+glitz_buffer_t
+glitz_buffer_hint_t
+glitz_buffer_access_t
+glitz_vertex_buffer_create
+glitz_pixel_buffer_create
+glitz_buffer_create_for_data
+glitz_buffer_destroy
+glitz_buffer_reference
+glitz_buffer_set_data
+glitz_buffer_get_data
+glitz_buffer_map
+glitz_buffer_unmap
+</SECTION>
+
+<SECTION>
+<FILE>glitz-pixels</FILE>
+<TITLE>Pixel operations</TITLE>
+glitz_pixel_scanline_order_t
+glitz_pixel_masks_t
+glitz_pixel_format_t
+glitz_set_pixels
+glitz_get_pixels
+</SECTION>
+
+<SECTION>
+<FILE>glitz-drawing</FILE>
+<TITLE>Drawing</TITLE>
+glitz_primitive_t
+glitz_data_type_t
+glitz_coordinate_size_t
+glitz_coordinate_attribute_t
+GLITZ_VERTEX_ATTRIBUTE_SRC_COORD_MASK
+GLITZ_VERTEX_ATTRIBUTE_MASK_COORD_MASK
+glitz_vertex_format_t
+glitz_bitmap_format_t
+glitz_geometry_type_t
+glitz_set_geometry
+glitz_set_array
+glitz_multi_array_t
+glitz_multi_array_create
+glitz_multi_array_destroy
+glitz_multi_array_reference
+glitz_multi_array_add
+glitz_multi_array_reset
+glitz_set_multi_array
+glitz_add_trapezoids
+glitz_add_traps
+glitz_composite
+glitz_copy_area
+</SECTION>
+
+<SECTION>
+<FILE>glitz-agl</FILE>
+<TITLE>AGL Backend</TITLE>
+glitz_agl_init
+glitz_agl_fini
+glitz_agl_find_window_format
+glitz_agl_find_pbuffer_format
+glitz_agl_create_drawable_for_window
+glitz_agl_create_pbuffer_drawable
+</SECTION>
+
+<SECTION>
+<FILE>glitz-egl</FILE>
+<TITLE>EGL Backend</TITLE>
+glitz_egl_init
+glitz_egl_fini
+glitz_egl_find_window_config
+glitz_egl_find_pbuffer_config
+glitz_egl_create_surface
+glitz_egl_create_pbuffer_surface
+</SECTION>
+
+<SECTION>
+<FILE>glitz-glx</FILE>
+<TITLE>GLX Backend</TITLE>
+glitz_glx_init
+glitz_glx_fini
+glitz_glx_set_render_type
+glitz_glx_find_window_format
+glitz_glx_find_pbuffer_format
+glitz_glx_find_drawable_format_for_visual
+glitz_glx_get_visual_info_from_format
+glitz_glx_get_xdrawable
+glitz_glx_create_drawable_for_window
+glitz_glx_create_drawable_for_pixmap
+glitz_glx_create_pixmap_drawable
+glitz_glx_create_pbuffer_drawable
+</SECTION>
+
+<SECTION>
+<FILE>glitz-wgl</FILE>
+<TITLE>WGL Backend</TITLE>
+glitz_wgl_thread_starter_arg_t
+glitz_wgl_thread_starter
+glitz_wgl_init
+glitz_wgl_fini
+glitz_wgl_find_window_format
+glitz_wgl_find_pbuffer_format
+glitz_wgl_create_drawable_for_window
+glitz_wgl_create_pbuffer_drawable
+</SECTION>
+
diff --git a/doc/reference/glitz-undeclared.txt b/doc/reference/glitz-undeclared.txt
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/doc/reference/glitz-undeclared.txt
diff --git a/doc/reference/glitz-undocumented.txt b/doc/reference/glitz-undocumented.txt
new file mode 100644
index 0000000..7ef258c
--- /dev/null
+++ b/doc/reference/glitz-undocumented.txt
@@ -0,0 +1,239 @@
+0% symbol docs coverage.
+1 symbols documented.
+0 symbols incomplete.
+231 not documented.
+
+
+GLITZ_FEATURE_BLEND_COLOR_MASK
+GLITZ_FEATURE_COPY_SUB_BUFFER_MASK
+GLITZ_FEATURE_DIRECT_RENDERING_MASK
+GLITZ_FEATURE_FRAGMENT_PROGRAM_MASK
+GLITZ_FEATURE_FRAMEBUFFER_OBJECT_MASK
+GLITZ_FEATURE_MULTISAMPLE_FILTER_HINT_MASK
+GLITZ_FEATURE_MULTISAMPLE_MASK
+GLITZ_FEATURE_MULTITEXTURE_MASK
+GLITZ_FEATURE_MULTI_DRAW_ARRAYS_MASK
+GLITZ_FEATURE_PACKED_PIXELS_MASK
+GLITZ_FEATURE_PER_COMPONENT_RENDERING_MASK
+GLITZ_FEATURE_PIXEL_BUFFER_OBJECT_MASK
+GLITZ_FEATURE_TEXTURE_BORDER_CLAMP_MASK
+GLITZ_FEATURE_TEXTURE_ENV_COMBINE_MASK
+GLITZ_FEATURE_TEXTURE_ENV_DOT3_MASK
+GLITZ_FEATURE_TEXTURE_FROM_PIXMAP_MASK
+GLITZ_FEATURE_TEXTURE_MIRRORED_REPEAT_MASK
+GLITZ_FEATURE_TEXTURE_NON_POWER_OF_TWO_MASK
+GLITZ_FEATURE_TEXTURE_RECTANGLE_MASK
+GLITZ_FEATURE_VERTEX_BUFFER_OBJECT_MASK
+GLITZ_FORMAT_ALPHA_SIZE_MASK
+GLITZ_FORMAT_BLUE_SIZE_MASK
+GLITZ_FORMAT_DEPTH_SIZE_MASK
+GLITZ_FORMAT_DOUBLEBUFFER_MASK
+GLITZ_FORMAT_FOURCC_MASK
+GLITZ_FORMAT_GREEN_SIZE_MASK
+GLITZ_FORMAT_ID_MASK
+GLITZ_FORMAT_RED_SIZE_MASK
+GLITZ_FORMAT_SAMPLES_MASK
+GLITZ_FORMAT_STENCIL_SIZE_MASK
+GLITZ_FORMAT_Y_INVERTED_MASK
+GLITZ_FOURCC
+GLITZ_FOURCC_RGB
+GLITZ_FOURCC_YUY2
+GLITZ_FOURCC_YV12
+GLITZ_SURFACE_UNNORMALIZED_MASK
+GLITZ_VERTEX_ATTRIBUTE_MASK_COORD_MASK
+GLITZ_VERTEX_ATTRIBUTE_SRC_COORD_MASK
+glitz_add_trapezoids
+glitz_add_traps
+glitz_agl_create_drawable_for_window
+glitz_agl_create_pbuffer_drawable
+glitz_agl_find_pbuffer_format
+glitz_agl_find_window_format
+glitz_agl_fini
+glitz_agl_init
+glitz_bitmap_format_t
+glitz_bool_t
+glitz_box_t
+glitz_buffer_access_t
+glitz_buffer_create_for_data
+glitz_buffer_destroy
+glitz_buffer_get_data
+glitz_buffer_hint_t
+glitz_buffer_map
+glitz_buffer_reference
+glitz_buffer_set_data
+glitz_buffer_t
+glitz_buffer_unmap
+glitz_color_format_t
+glitz_color_t
+glitz_composite
+glitz_context_bind_texture
+glitz_context_copy
+glitz_context_create
+glitz_context_destroy
+glitz_context_draw_buffers
+glitz_context_get_proc_address
+glitz_context_make_current
+glitz_context_read_buffer
+glitz_context_reference
+glitz_context_set_user_data
+glitz_context_t
+glitz_coordinate_attribute_t
+glitz_coordinate_size_t
+glitz_copy_area
+glitz_create_drawable
+glitz_create_pbuffer_drawable
+glitz_data_type_t
+glitz_double_t
+glitz_drawable_buffer_t
+glitz_drawable_destroy
+glitz_drawable_finish
+glitz_drawable_flush
+glitz_drawable_format_t
+glitz_drawable_get_features
+glitz_drawable_get_format
+glitz_drawable_get_gl_string
+glitz_drawable_get_height
+glitz_drawable_get_width
+glitz_drawable_reference
+glitz_drawable_swap_buffer_region
+glitz_drawable_swap_buffers
+glitz_drawable_t
+glitz_drawable_update_size
+glitz_egl_create_pbuffer_surface
+glitz_egl_create_surface
+glitz_egl_find_pbuffer_config
+glitz_egl_find_window_config
+glitz_egl_fini
+glitz_egl_init
+glitz_fill_t
+glitz_filter_t
+glitz_find_drawable_format
+glitz_find_format
+glitz_find_pbuffer_format
+glitz_find_standard_format
+glitz_fixed16_16_t
+glitz_float_t
+glitz_format_id_t
+glitz_format_name_t
+glitz_format_t
+glitz_fourcc_t
+glitz_function_pointer_t
+glitz_geometry_type_t
+glitz_get_pixels
+glitz_gl_string_t
+glitz_glx_create_drawable_for_pixmap
+glitz_glx_create_drawable_for_window
+glitz_glx_create_pbuffer_drawable
+glitz_glx_create_pixmap_drawable
+glitz_glx_find_drawable_format_for_visual
+glitz_glx_find_pbuffer_format
+glitz_glx_find_window_format
+glitz_glx_fini
+glitz_glx_get_visual_info_from_format
+glitz_glx_get_xdrawable
+glitz_glx_init
+glitz_glx_set_render_type
+glitz_int_t
+glitz_line_fixed_t
+glitz_lose_current_function_t
+glitz_multi_array_add
+glitz_multi_array_create
+glitz_multi_array_destroy
+glitz_multi_array_reference
+glitz_multi_array_reset
+glitz_multi_array_t
+glitz_operator_t
+glitz_pixel_buffer_create
+glitz_pixel_format_t
+glitz_pixel_masks_t
+glitz_pixel_scanline_order_t
+glitz_point_fixed_t
+glitz_primitive_t
+glitz_rectangle_t
+glitz_set_array
+glitz_set_geometry
+glitz_set_multi_array
+glitz_set_pixels
+glitz_set_rectangle
+glitz_set_rectangles
+glitz_short_t
+glitz_span_fixed_t
+glitz_status_string
+glitz_status_t
+glitz_surface_attach
+glitz_surface_attributes_t
+glitz_surface_bind_tex_image
+glitz_surface_create
+glitz_surface_destroy
+glitz_surface_detach
+glitz_surface_flush
+glitz_surface_get_attached_drawable
+glitz_surface_get_drawable
+glitz_surface_get_format
+glitz_surface_get_height
+glitz_surface_get_status
+glitz_surface_get_width
+glitz_surface_reference
+glitz_surface_release_tex_image
+glitz_surface_set_clip_region
+glitz_surface_set_component_alpha
+glitz_surface_set_dither
+glitz_surface_set_fill
+glitz_surface_set_filter
+glitz_surface_set_transform
+glitz_surface_t
+glitz_surface_translate_point
+glitz_surface_valid_target
+glitz_texture_filter_t
+glitz_texture_filter_type_t
+glitz_texture_object_create
+glitz_texture_object_destroy
+glitz_texture_object_get_target
+glitz_texture_object_reference
+glitz_texture_object_set_border_color
+glitz_texture_object_set_filter
+glitz_texture_object_set_wrap
+glitz_texture_object_t
+glitz_texture_target_t
+glitz_texture_wrap_t
+glitz_texture_wrap_type_t
+glitz_transform_t
+glitz_trap_t
+glitz_trapezoid_t
+glitz_vertex_buffer_create
+glitz_vertex_format_t
+glitz_wgl_create_drawable_for_window
+glitz_wgl_create_pbuffer_drawable
+glitz_wgl_find_pbuffer_format
+glitz_wgl_find_window_format
+glitz_wgl_fini
+glitz_wgl_init
+glitz_wgl_thread_starter
+glitz_wgl_thread_starter_arg_t
+
+
+glitz-agl:Long_Description
+glitz-agl:Short_Description
+glitz-buffer:Long_Description
+glitz-buffer:Short_Description
+glitz-context:Long_Description
+glitz-context:Short_Description
+glitz-drawable:Long_Description
+glitz-drawable:Short_Description
+glitz-drawing:Long_Description
+glitz-drawing:Short_Description
+glitz-egl:Long_Description
+glitz-egl:Short_Description
+glitz-formats:Long_Description
+glitz-formats:Short_Description
+glitz-glx:Long_Description
+glitz-glx:Short_Description
+glitz-pixels:Long_Description
+glitz-pixels:Short_Description
+glitz-surface:Long_Description
+glitz-surface:Short_Description
+glitz-texture:Long_Description
+glitz-texture:Short_Description
+glitz-types:Long_Description
+glitz-types:Short_Description
+glitz-wgl:Short_Description
diff --git a/doc/reference/glitz.types b/doc/reference/glitz.types
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/doc/reference/glitz.types
diff --git a/doc/reference/tmpl/glitz-agl.sgml b/doc/reference/tmpl/glitz-agl.sgml
new file mode 100644
index 0000000..9addef7
--- /dev/null
+++ b/doc/reference/tmpl/glitz-agl.sgml
@@ -0,0 +1,78 @@
+<!-- ##### SECTION Title ##### -->
+AGL Backend
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### FUNCTION glitz_agl_init ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### FUNCTION glitz_agl_fini ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### FUNCTION glitz_agl_find_window_format ##### -->
+<para>
+
+</para>
+
+@mask: 
+@templ: 
+@count: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_agl_find_pbuffer_format ##### -->
+<para>
+
+</para>
+
+@mask: 
+@templ: 
+@count: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_agl_create_drawable_for_window ##### -->
+<para>
+
+</para>
+
+@format: 
+@window: 
+@width: 
+@height: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_agl_create_pbuffer_drawable ##### -->
+<para>
+
+</para>
+
+@format: 
+@width: 
+@height: 
+@Returns: 
+
+
diff --git a/doc/reference/tmpl/glitz-buffer.sgml b/doc/reference/tmpl/glitz-buffer.sgml
new file mode 100644
index 0000000..373be3a
--- /dev/null
+++ b/doc/reference/tmpl/glitz-buffer.sgml
@@ -0,0 +1,139 @@
+<!-- ##### SECTION Title ##### -->
+Buffer
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### TYPEDEF glitz_buffer_t ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ENUM glitz_buffer_hint_t ##### -->
+<para>
+
+</para>
+
+@GLITZ_BUFFER_HINT_STREAM_DRAW: 
+@GLITZ_BUFFER_HINT_STREAM_READ: 
+@GLITZ_BUFFER_HINT_STREAM_COPY: 
+@GLITZ_BUFFER_HINT_STATIC_DRAW: 
+@GLITZ_BUFFER_HINT_STATIC_READ: 
+@GLITZ_BUFFER_HINT_STATIC_COPY: 
+@GLITZ_BUFFER_HINT_DYNAMIC_DRAW: 
+@GLITZ_BUFFER_HINT_DYNAMIC_READ: 
+@GLITZ_BUFFER_HINT_DYNAMIC_COPY: 
+
+<!-- ##### ENUM glitz_buffer_access_t ##### -->
+<para>
+
+</para>
+
+@GLITZ_BUFFER_ACCESS_READ_ONLY: 
+@GLITZ_BUFFER_ACCESS_WRITE_ONLY: 
+@GLITZ_BUFFER_ACCESS_READ_WRITE: 
+
+<!-- ##### FUNCTION glitz_vertex_buffer_create ##### -->
+<para>
+
+</para>
+
+@drawable: 
+@data: 
+@size: 
+@hint: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_pixel_buffer_create ##### -->
+<para>
+
+</para>
+
+@drawable: 
+@data: 
+@size: 
+@hint: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_buffer_create_for_data ##### -->
+<para>
+
+</para>
+
+@data: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_buffer_destroy ##### -->
+<para>
+
+</para>
+
+@buffer: 
+
+
+<!-- ##### FUNCTION glitz_buffer_reference ##### -->
+<para>
+
+</para>
+
+@buffer: 
+
+
+<!-- ##### FUNCTION glitz_buffer_set_data ##### -->
+<para>
+
+</para>
+
+@buffer: 
+@offset: 
+@size: 
+@data: 
+
+
+<!-- ##### FUNCTION glitz_buffer_get_data ##### -->
+<para>
+
+</para>
+
+@buffer: 
+@offset: 
+@size: 
+@data: 
+
+
+<!-- ##### FUNCTION glitz_buffer_map ##### -->
+<para>
+
+</para>
+
+@buffer: 
+@access: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_buffer_unmap ##### -->
+<para>
+
+</para>
+
+@buffer: 
+@Returns: 
+
+
diff --git a/doc/reference/tmpl/glitz-context.sgml b/doc/reference/tmpl/glitz-context.sgml
new file mode 100644
index 0000000..26a45c4
--- /dev/null
+++ b/doc/reference/tmpl/glitz-context.sgml
@@ -0,0 +1,157 @@
+<!-- ##### SECTION Title ##### -->
+Context
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### TYPEDEF glitz_context_t ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION glitz_context_create ##### -->
+<para>
+
+</para>
+
+@drawable: 
+@format: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_context_destroy ##### -->
+<para>
+
+</para>
+
+@context: 
+
+
+<!-- ##### FUNCTION glitz_context_reference ##### -->
+<para>
+
+</para>
+
+@context: 
+
+
+<!-- ##### FUNCTION glitz_context_copy ##### -->
+<para>
+
+</para>
+
+@src: 
+@dst: 
+@mask: 
+
+
+<!-- ##### USER_FUNCTION glitz_lose_current_function_t ##### -->
+<para>
+
+</para>
+
+@closure: 
+
+
+<!-- ##### FUNCTION glitz_context_set_user_data ##### -->
+<para>
+
+</para>
+
+@context: 
+@closure: 
+@lose_current: 
+
+
+<!-- ##### USER_FUNCTION glitz_function_pointer_t ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### FUNCTION glitz_context_get_proc_address ##### -->
+<para>
+
+</para>
+
+@context: 
+@name: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_context_make_current ##### -->
+<para>
+
+</para>
+
+@context: 
+@drawable: 
+
+
+<!-- ##### FUNCTION glitz_context_bind_texture ##### -->
+<para>
+
+</para>
+
+@context: 
+@texture: 
+
+
+<!-- ##### FUNCTION glitz_context_draw_buffers ##### -->
+<para>
+
+</para>
+
+@context: 
+@buffers: 
+@n: 
+
+
+<!-- ##### FUNCTION glitz_context_read_buffer ##### -->
+<para>
+
+</para>
+
+@context: 
+@buffer: 
+
+
+<!-- ##### FUNCTION glitz_set_rectangle ##### -->
+<para>
+
+</para>
+
+@dst: 
+@color: 
+@x: 
+@y: 
+@width: 
+@height: 
+
+
+<!-- ##### FUNCTION glitz_set_rectangles ##### -->
+<para>
+
+</para>
+
+@dst: 
+@color: 
+@rects: 
+@n_rects: 
+
+
diff --git a/doc/reference/tmpl/glitz-drawable.sgml b/doc/reference/tmpl/glitz-drawable.sgml
new file mode 100644
index 0000000..59640bc
--- /dev/null
+++ b/doc/reference/tmpl/glitz-drawable.sgml
@@ -0,0 +1,159 @@
+<!-- ##### SECTION Title ##### -->
+Drawable
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### ENUM glitz_drawable_buffer_t ##### -->
+<para>
+
+</para>
+
+@GLITZ_DRAWABLE_BUFFER_FRONT_COLOR: 
+@GLITZ_DRAWABLE_BUFFER_BACK_COLOR: 
+
+<!-- ##### FUNCTION glitz_create_drawable ##### -->
+<para>
+
+</para>
+
+@other: 
+@format: 
+@width: 
+@height: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_create_pbuffer_drawable ##### -->
+<para>
+
+</para>
+
+@other: 
+@format: 
+@width: 
+@height: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_drawable_destroy ##### -->
+<para>
+
+</para>
+
+@drawable: 
+
+
+<!-- ##### FUNCTION glitz_drawable_reference ##### -->
+<para>
+
+</para>
+
+@drawable: 
+
+
+<!-- ##### FUNCTION glitz_drawable_update_size ##### -->
+<para>
+
+</para>
+
+@drawable: 
+@width: 
+@height: 
+
+
+<!-- ##### FUNCTION glitz_drawable_get_width ##### -->
+<para>
+
+</para>
+
+@drawable: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_drawable_get_height ##### -->
+<para>
+
+</para>
+
+@drawable: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_drawable_swap_buffer_region ##### -->
+<para>
+
+</para>
+
+@drawable: 
+@x_origin: 
+@y_origin: 
+@box: 
+@n_box: 
+
+
+<!-- ##### FUNCTION glitz_drawable_swap_buffers ##### -->
+<para>
+
+</para>
+
+@drawable: 
+
+
+<!-- ##### FUNCTION glitz_drawable_flush ##### -->
+<para>
+
+</para>
+
+@drawable: 
+
+
+<!-- ##### FUNCTION glitz_drawable_finish ##### -->
+<para>
+
+</para>
+
+@drawable: 
+
+
+<!-- ##### FUNCTION glitz_drawable_get_features ##### -->
+<para>
+
+</para>
+
+@drawable: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_drawable_get_format ##### -->
+<para>
+
+</para>
+
+@drawable: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_drawable_get_gl_string ##### -->
+<para>
+
+</para>
+
+@drawable: 
+@name: 
+@Returns: 
+
+
diff --git a/doc/reference/tmpl/glitz-drawing.sgml b/doc/reference/tmpl/glitz-drawing.sgml
new file mode 100644
index 0000000..3c6252a
--- /dev/null
+++ b/doc/reference/tmpl/glitz-drawing.sgml
@@ -0,0 +1,259 @@
+<!-- ##### SECTION Title ##### -->
+Drawing
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### ENUM glitz_primitive_t ##### -->
+<para>
+
+</para>
+
+@GLITZ_PRIMITIVE_POINTS: 
+@GLITZ_PRIMITIVE_LINES: 
+@GLITZ_PRIMITIVE_LINE_STRIP: 
+@GLITZ_PRIMITIVE_LINE_LOOP: 
+@GLITZ_PRIMITIVE_TRIANGLES: 
+@GLITZ_PRIMITIVE_TRIANGLE_STRIP: 
+@GLITZ_PRIMITIVE_TRIANGLE_FAN: 
+@GLITZ_PRIMITIVE_QUADS: 
+@GLITZ_PRIMITIVE_QUAD_STRIP: 
+@GLITZ_PRIMITIVE_POLYGON: 
+
+<!-- ##### ENUM glitz_data_type_t ##### -->
+<para>
+
+</para>
+
+@GLITZ_DATA_TYPE_SHORT: 
+@GLITZ_DATA_TYPE_INT: 
+@GLITZ_DATA_TYPE_FLOAT: 
+@GLITZ_DATA_TYPE_DOUBLE: 
+
+<!-- ##### ENUM glitz_coordinate_size_t ##### -->
+<para>
+
+</para>
+
+@GLITZ_COORDINATE_SIZE_X: 
+@GLITZ_COORDINATE_SIZE_XY: 
+
+<!-- ##### STRUCT glitz_coordinate_attribute_t ##### -->
+<para>
+
+</para>
+
+@type: 
+@size: 
+@offset: 
+
+<!-- ##### MACRO GLITZ_VERTEX_ATTRIBUTE_SRC_COORD_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_VERTEX_ATTRIBUTE_MASK_COORD_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### STRUCT glitz_vertex_format_t ##### -->
+<para>
+
+</para>
+
+@primitive: 
+@type: 
+@bytes_per_vertex: 
+@attributes: 
+@src: 
+@mask: 
+
+<!-- ##### STRUCT glitz_bitmap_format_t ##### -->
+<para>
+
+</para>
+
+@scanline_order: 
+@bytes_per_line: 
+@pad: 
+
+<!-- ##### ENUM glitz_geometry_type_t ##### -->
+<para>
+
+</para>
+
+@GLITZ_GEOMETRY_TYPE_NONE: 
+@GLITZ_GEOMETRY_TYPE_VERTEX: 
+@GLITZ_GEOMETRY_TYPE_BITMAP: 
+
+<!-- ##### FUNCTION glitz_set_geometry ##### -->
+<para>
+
+</para>
+
+@dst: 
+@type: 
+@format: 
+@buffer: 
+
+
+<!-- ##### FUNCTION glitz_set_array ##### -->
+<para>
+
+</para>
+
+@dst: 
+@first: 
+@size: 
+@count: 
+@x_off: 
+@y_off: 
+
+
+<!-- ##### TYPEDEF glitz_multi_array_t ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION glitz_multi_array_create ##### -->
+<para>
+
+</para>
+
+@size: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_multi_array_destroy ##### -->
+<para>
+
+</para>
+
+@array: 
+
+
+<!-- ##### FUNCTION glitz_multi_array_reference ##### -->
+<para>
+
+</para>
+
+@array: 
+
+
+<!-- ##### FUNCTION glitz_multi_array_add ##### -->
+<para>
+
+</para>
+
+@array: 
+@first: 
+@size: 
+@count: 
+@x_off: 
+@y_off: 
+
+
+<!-- ##### FUNCTION glitz_multi_array_reset ##### -->
+<para>
+
+</para>
+
+@array: 
+
+
+<!-- ##### FUNCTION glitz_set_multi_array ##### -->
+<para>
+
+</para>
+
+@dst: 
+@array: 
+@x_off: 
+@y_off: 
+
+
+<!-- ##### FUNCTION glitz_add_trapezoids ##### -->
+<para>
+
+</para>
+
+@buffer: 
+@offset: 
+@size: 
+@type: 
+@mask: 
+@traps: 
+@n_traps: 
+@n_added: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_add_traps ##### -->
+<para>
+
+</para>
+
+@buffer: 
+@offset: 
+@size: 
+@type: 
+@mask: 
+@traps: 
+@n_traps: 
+@n_added: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_composite ##### -->
+<para>
+
+</para>
+
+@op: 
+@src: 
+@mask: 
+@dst: 
+@x_src: 
+@y_src: 
+@x_mask: 
+@y_mask: 
+@x_dst: 
+@y_dst: 
+@width: 
+@height: 
+
+
+<!-- ##### FUNCTION glitz_copy_area ##### -->
+<para>
+
+</para>
+
+@src: 
+@dst: 
+@x_src: 
+@y_src: 
+@width: 
+@height: 
+@x_dst: 
+@y_dst: 
+
+
diff --git a/doc/reference/tmpl/glitz-egl.sgml b/doc/reference/tmpl/glitz-egl.sgml
new file mode 100644
index 0000000..973443e
--- /dev/null
+++ b/doc/reference/tmpl/glitz-egl.sgml
@@ -0,0 +1,87 @@
+<!-- ##### SECTION Title ##### -->
+EGL Backend
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### FUNCTION glitz_egl_init ##### -->
+<para>
+
+</para>
+
+@gl_library: 
+
+
+<!-- ##### FUNCTION glitz_egl_fini ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### FUNCTION glitz_egl_find_window_config ##### -->
+<para>
+
+</para>
+
+@egl_display: 
+@egl_screen: 
+@mask: 
+@templ: 
+@count: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_egl_find_pbuffer_config ##### -->
+<para>
+
+</para>
+
+@egl_display: 
+@egl_screen: 
+@mask: 
+@templ: 
+@count: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_egl_create_surface ##### -->
+<para>
+
+</para>
+
+@egl_display: 
+@egl_screen: 
+@format: 
+@egl_surface: 
+@width: 
+@height: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_egl_create_pbuffer_surface ##### -->
+<para>
+
+</para>
+
+@egl_display: 
+@egl_screen: 
+@format: 
+@width: 
+@height: 
+@Returns: 
+
+
diff --git a/doc/reference/tmpl/glitz-formats.sgml b/doc/reference/tmpl/glitz-formats.sgml
new file mode 100644
index 0000000..937c253
--- /dev/null
+++ b/doc/reference/tmpl/glitz-formats.sgml
@@ -0,0 +1,228 @@
+<!-- ##### SECTION Title ##### -->
+Formats
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### ENUM glitz_format_name_t ##### -->
+<para>
+
+</para>
+
+@GLITZ_STANDARD_ARGB32: 
+@GLITZ_STANDARD_RGB24: 
+@GLITZ_STANDARD_A8: 
+@GLITZ_STANDARD_A1: 
+
+<!-- ##### MACRO GLITZ_FORMAT_ID_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FORMAT_RED_SIZE_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FORMAT_GREEN_SIZE_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FORMAT_BLUE_SIZE_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FORMAT_ALPHA_SIZE_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### TYPEDEF glitz_format_id_t ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### TYPEDEF glitz_fourcc_t ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO GLITZ_FORMAT_FOURCC_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FOURCC ##### -->
+<para>
+
+</para>
+
+@a: 
+@b: 
+@c: 
+@d: 
+
+
+<!-- ##### MACRO GLITZ_FOURCC_RGB ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FOURCC_YV12 ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FOURCC_YUY2 ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### STRUCT glitz_color_format_t ##### -->
+<para>
+
+</para>
+
+@fourcc: 
+@red_size: 
+@green_size: 
+@blue_size: 
+@alpha_size: 
+
+<!-- ##### MACRO GLITZ_FORMAT_DEPTH_SIZE_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FORMAT_STENCIL_SIZE_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FORMAT_DOUBLEBUFFER_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FORMAT_SAMPLES_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FORMAT_Y_INVERTED_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### STRUCT glitz_drawable_format_t ##### -->
+<para>
+
+</para>
+
+@id: 
+@color: 
+@depth_size: 
+@stencil_size: 
+@samples: 
+@doublebuffer: 
+@y_inverted: 
+
+<!-- ##### STRUCT glitz_format_t ##### -->
+<para>
+
+</para>
+
+@id: 
+@color: 
+
+<!-- ##### FUNCTION glitz_find_standard_format ##### -->
+<para>
+
+</para>
+
+@drawable: 
+@format_name: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_find_format ##### -->
+<para>
+
+</para>
+
+@drawable: 
+@mask: 
+@templ: 
+@count: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_find_drawable_format ##### -->
+<para>
+
+</para>
+
+@other: 
+@mask: 
+@templ: 
+@count: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_find_pbuffer_format ##### -->
+<para>
+
+</para>
+
+@other: 
+@mask: 
+@templ: 
+@count: 
+@Returns: 
+
+
diff --git a/doc/reference/tmpl/glitz-formats.sgml.sgml b/doc/reference/tmpl/glitz-formats.sgml.sgml
new file mode 100644
index 0000000..dc5b2cb
--- /dev/null
+++ b/doc/reference/tmpl/glitz-formats.sgml.sgml
@@ -0,0 +1,228 @@
+<!-- ##### SECTION Title ##### -->
+glitz-formats.sgml
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### ENUM glitz_format_name_t ##### -->
+<para>
+
+</para>
+
+@GLITZ_STANDARD_ARGB32: 
+@GLITZ_STANDARD_RGB24: 
+@GLITZ_STANDARD_A8: 
+@GLITZ_STANDARD_A1: 
+
+<!-- ##### MACRO GLITZ_FORMAT_ID_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FORMAT_RED_SIZE_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FORMAT_GREEN_SIZE_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FORMAT_BLUE_SIZE_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FORMAT_ALPHA_SIZE_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### TYPEDEF glitz_format_id_t ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### TYPEDEF glitz_fourcc_t ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO GLITZ_FORMAT_FOURCC_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FOURCC ##### -->
+<para>
+
+</para>
+
+@a: 
+@b: 
+@c: 
+@d: 
+
+
+<!-- ##### MACRO GLITZ_FOURCC_RGB ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FOURCC_YV12 ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FOURCC_YUY2 ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### STRUCT glitz_color_format_t ##### -->
+<para>
+
+</para>
+
+@fourcc: 
+@red_size: 
+@green_size: 
+@blue_size: 
+@alpha_size: 
+
+<!-- ##### MACRO GLITZ_FORMAT_DEPTH_SIZE_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FORMAT_STENCIL_SIZE_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FORMAT_DOUBLEBUFFER_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FORMAT_SAMPLES_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FORMAT_Y_INVERTED_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### STRUCT glitz_drawable_format_t ##### -->
+<para>
+
+</para>
+
+@id: 
+@color: 
+@depth_size: 
+@stencil_size: 
+@samples: 
+@doublebuffer: 
+@y_inverted: 
+
+<!-- ##### STRUCT glitz_format_t ##### -->
+<para>
+
+</para>
+
+@id: 
+@color: 
+
+<!-- ##### FUNCTION glitz_find_standard_format ##### -->
+<para>
+
+</para>
+
+@drawable: 
+@format_name: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_find_format ##### -->
+<para>
+
+</para>
+
+@drawable: 
+@mask: 
+@templ: 
+@count: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_find_drawable_format ##### -->
+<para>
+
+</para>
+
+@other: 
+@mask: 
+@templ: 
+@count: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_find_pbuffer_format ##### -->
+<para>
+
+</para>
+
+@other: 
+@mask: 
+@templ: 
+@count: 
+@Returns: 
+
+
diff --git a/doc/reference/tmpl/glitz-glx.sgml b/doc/reference/tmpl/glitz-glx.sgml
new file mode 100644
index 0000000..2bd9294
--- /dev/null
+++ b/doc/reference/tmpl/glitz-glx.sgml
@@ -0,0 +1,155 @@
+<!-- ##### SECTION Title ##### -->
+GLX Backend
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### FUNCTION glitz_glx_init ##### -->
+<para>
+
+</para>
+
+@gl_library: 
+
+
+<!-- ##### FUNCTION glitz_glx_fini ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### FUNCTION glitz_glx_set_render_type ##### -->
+<para>
+
+</para>
+
+@display: 
+@screen: 
+@direct: 
+
+
+<!-- ##### FUNCTION glitz_glx_find_window_format ##### -->
+<para>
+
+</para>
+
+@display: 
+@screen: 
+@mask: 
+@templ: 
+@count: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_glx_find_pbuffer_format ##### -->
+<para>
+
+</para>
+
+@display: 
+@screen: 
+@mask: 
+@templ: 
+@count: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_glx_find_drawable_format_for_visual ##### -->
+<para>
+
+</para>
+
+@display: 
+@screen: 
+@visual_id: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_glx_get_visual_info_from_format ##### -->
+<para>
+
+</para>
+
+@display: 
+@screen: 
+@format: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_glx_get_xdrawable ##### -->
+<para>
+
+</para>
+
+@drawable: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_glx_create_drawable_for_window ##### -->
+<para>
+
+</para>
+
+@display: 
+@screen: 
+@format: 
+@window: 
+@width: 
+@height: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_glx_create_drawable_for_pixmap ##### -->
+<para>
+
+</para>
+
+@display: 
+@screen: 
+@format: 
+@pixmap: 
+@width: 
+@height: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_glx_create_pixmap_drawable ##### -->
+<para>
+
+</para>
+
+@display: 
+@screen: 
+@format: 
+@width: 
+@height: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_glx_create_pbuffer_drawable ##### -->
+<para>
+
+</para>
+
+@display: 
+@screen: 
+@format: 
+@width: 
+@height: 
+@Returns: 
+
+
diff --git a/doc/reference/tmpl/glitz-pixels.sgml b/doc/reference/tmpl/glitz-pixels.sgml
new file mode 100644
index 0000000..9f4b7d3
--- /dev/null
+++ b/doc/reference/tmpl/glitz-pixels.sgml
@@ -0,0 +1,78 @@
+<!-- ##### SECTION Title ##### -->
+Pixel operations
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### ENUM glitz_pixel_scanline_order_t ##### -->
+<para>
+
+</para>
+
+@GLITZ_PIXEL_SCANLINE_ORDER_TOP_DOWN: 
+@GLITZ_PIXEL_SCANLINE_ORDER_BOTTOM_UP: 
+
+<!-- ##### STRUCT glitz_pixel_masks_t ##### -->
+<para>
+
+</para>
+
+@bpp: 
+@alpha_mask: 
+@red_mask: 
+@green_mask: 
+@blue_mask: 
+
+<!-- ##### STRUCT glitz_pixel_format_t ##### -->
+<para>
+
+</para>
+
+@fourcc: 
+@masks: 
+@xoffset: 
+@skip_lines: 
+@bytes_per_line: 
+@scanline_order: 
+
+<!-- ##### FUNCTION glitz_set_pixels ##### -->
+<para>
+
+</para>
+
+@dst: 
+@x_dst: 
+@y_dst: 
+@width: 
+@height: 
+@format: 
+@buffer: 
+
+
+<!-- ##### FUNCTION glitz_get_pixels ##### -->
+<para>
+
+</para>
+
+@src: 
+@x_src: 
+@y_src: 
+@width: 
+@height: 
+@format: 
+@buffer: 
+
+
diff --git a/doc/reference/tmpl/glitz-surface.sgml b/doc/reference/tmpl/glitz-surface.sgml
new file mode 100644
index 0000000..9604c03
--- /dev/null
+++ b/doc/reference/tmpl/glitz-surface.sgml
@@ -0,0 +1,241 @@
+<!-- ##### SECTION Title ##### -->
+Surface
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### MACRO GLITZ_SURFACE_UNNORMALIZED_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### STRUCT glitz_surface_attributes_t ##### -->
+<para>
+
+</para>
+
+@unnormalized: 
+
+<!-- ##### FUNCTION glitz_surface_create ##### -->
+<para>
+
+</para>
+
+@drawable: 
+@format: 
+@width: 
+@height: 
+@mask: 
+@attributes: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_surface_destroy ##### -->
+<para>
+
+</para>
+
+@surface: 
+
+
+<!-- ##### FUNCTION glitz_surface_reference ##### -->
+<para>
+
+</para>
+
+@surface: 
+
+
+<!-- ##### FUNCTION glitz_surface_attach ##### -->
+<para>
+
+</para>
+
+@surface: 
+@drawable: 
+@buffer: 
+
+
+<!-- ##### FUNCTION glitz_surface_detach ##### -->
+<para>
+
+</para>
+
+@surface: 
+
+
+<!-- ##### FUNCTION glitz_surface_flush ##### -->
+<para>
+
+</para>
+
+@surface: 
+
+
+<!-- ##### FUNCTION glitz_surface_get_drawable ##### -->
+<para>
+
+</para>
+
+@surface: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_surface_get_attached_drawable ##### -->
+<para>
+
+</para>
+
+@surface: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_surface_set_transform ##### -->
+<para>
+
+</para>
+
+@surface: 
+@transform: 
+
+
+<!-- ##### FUNCTION glitz_surface_set_fill ##### -->
+<para>
+
+</para>
+
+@surface: 
+@fill: 
+
+
+<!-- ##### FUNCTION glitz_surface_set_component_alpha ##### -->
+<para>
+
+</para>
+
+@surface: 
+@component_alpha: 
+
+
+<!-- ##### FUNCTION glitz_surface_set_filter ##### -->
+<para>
+
+</para>
+
+@surface: 
+@filter: 
+@params: 
+@n_params: 
+
+
+<!-- ##### FUNCTION glitz_surface_set_dither ##### -->
+<para>
+
+</para>
+
+@surface: 
+@dither: 
+
+
+<!-- ##### FUNCTION glitz_surface_get_width ##### -->
+<para>
+
+</para>
+
+@surface: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_surface_get_height ##### -->
+<para>
+
+</para>
+
+@surface: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_surface_get_status ##### -->
+<para>
+
+</para>
+
+@surface: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_surface_get_format ##### -->
+<para>
+
+</para>
+
+@surface: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_surface_translate_point ##### -->
+<para>
+
+</para>
+
+@surface: 
+@src: 
+@dst: 
+
+
+<!-- ##### FUNCTION glitz_surface_set_clip_region ##### -->
+<para>
+
+</para>
+
+@surface: 
+@x_origin: 
+@y_origin: 
+@box: 
+@n_box: 
+
+
+<!-- ##### FUNCTION glitz_surface_valid_target ##### -->
+<para>
+
+</para>
+
+@surface: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_surface_bind_tex_image ##### -->
+<para>
+
+</para>
+
+@surface: 
+@drawable: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_surface_release_tex_image ##### -->
+<para>
+
+</para>
+
+@surface: 
+@drawable: 
+@Returns: 
+
+
diff --git a/doc/reference/tmpl/glitz-texture.sgml b/doc/reference/tmpl/glitz-texture.sgml
new file mode 100644
index 0000000..a8b844e
--- /dev/null
+++ b/doc/reference/tmpl/glitz-texture.sgml
@@ -0,0 +1,135 @@
+<!-- ##### SECTION Title ##### -->
+Texture
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### TYPEDEF glitz_texture_object_t ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION glitz_texture_object_create ##### -->
+<para>
+
+</para>
+
+@surface: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_texture_object_destroy ##### -->
+<para>
+
+</para>
+
+@texture: 
+
+
+<!-- ##### FUNCTION glitz_texture_object_reference ##### -->
+<para>
+
+</para>
+
+@texture: 
+
+
+<!-- ##### ENUM glitz_texture_filter_type_t ##### -->
+<para>
+
+</para>
+
+@GLITZ_TEXTURE_FILTER_TYPE_MAG: 
+@GLITZ_TEXTURE_FILTER_TYPE_MIN: 
+
+<!-- ##### ENUM glitz_texture_filter_t ##### -->
+<para>
+
+</para>
+
+@GLITZ_TEXTURE_FILTER_NEAREST: 
+@GLITZ_TEXTURE_FILTER_LINEAR: 
+@GLITZ_TEXTURE_FILTER_NEAREST_MIPMAP_NEAREST: 
+@GLITZ_TEXTURE_FILTER_LINEAR_MIPMAP_NEAREST: 
+@GLITZ_TEXTURE_FILTER_NEAREST_MIPMAP_LINEAR: 
+@GLITZ_TEXTURE_FILTER_LINEAR_MIPMAP_LINEAR: 
+
+<!-- ##### FUNCTION glitz_texture_object_set_filter ##### -->
+<para>
+
+</para>
+
+@texture: 
+@type: 
+@filter: 
+
+
+<!-- ##### ENUM glitz_texture_wrap_type_t ##### -->
+<para>
+
+</para>
+
+@GLITZ_TEXTURE_WRAP_TYPE_S: 
+@GLITZ_TEXTURE_WRAP_TYPE_T: 
+
+<!-- ##### ENUM glitz_texture_wrap_t ##### -->
+<para>
+
+</para>
+
+@GLITZ_TEXTURE_WRAP_CLAMP: 
+@GLITZ_TEXTURE_WRAP_CLAMP_TO_EDGE: 
+@GLITZ_TEXTURE_WRAP_CLAMP_TO_BORDER: 
+@GLITZ_TEXTURE_WRAP_REPEAT: 
+@GLITZ_TEXTURE_WRAP_MIRRORED_REPEAT: 
+
+<!-- ##### FUNCTION glitz_texture_object_set_wrap ##### -->
+<para>
+
+</para>
+
+@texture: 
+@type: 
+@wrap: 
+
+
+<!-- ##### FUNCTION glitz_texture_object_set_border_color ##### -->
+<para>
+
+</para>
+
+@texture: 
+@color: 
+
+
+<!-- ##### ENUM glitz_texture_target_t ##### -->
+<para>
+
+</para>
+
+@GLITZ_TEXTURE_TARGET_2D: 
+@GLITZ_TEXTURE_TARGET_RECT: 
+
+<!-- ##### FUNCTION glitz_texture_object_get_target ##### -->
+<para>
+
+</para>
+
+@texture: 
+@Returns: 
+
+
diff --git a/doc/reference/tmpl/glitz-types.sgml b/doc/reference/tmpl/glitz-types.sgml
new file mode 100644
index 0000000..e3e64ed
--- /dev/null
+++ b/doc/reference/tmpl/glitz-types.sgml
@@ -0,0 +1,356 @@
+<!-- ##### SECTION Title ##### -->
+Types
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### TYPEDEF glitz_bool_t ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### TYPEDEF glitz_short_t ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### TYPEDEF glitz_int_t ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### TYPEDEF glitz_float_t ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### TYPEDEF glitz_double_t ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### TYPEDEF glitz_fixed16_16_t ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### TYPEDEF glitz_drawable_t ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### TYPEDEF glitz_surface_t ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### STRUCT glitz_rectangle_t ##### -->
+<para>
+
+</para>
+
+@y: 
+@width: 
+@height: 
+
+<!-- ##### STRUCT glitz_box_t ##### -->
+<para>
+
+</para>
+
+@y1: 
+@x2: 
+@y2: 
+
+<!-- ##### STRUCT glitz_point_fixed_t ##### -->
+<para>
+
+</para>
+
+@x: 
+@y: 
+
+<!-- ##### STRUCT glitz_line_fixed_t ##### -->
+<para>
+
+</para>
+
+@p1: 
+@p2: 
+
+<!-- ##### STRUCT glitz_trapezoid_t ##### -->
+<para>
+
+</para>
+
+@top: 
+@bottom: 
+@left: 
+@right: 
+
+<!-- ##### STRUCT glitz_span_fixed_t ##### -->
+<para>
+
+</para>
+
+@left: 
+@right: 
+@y: 
+
+<!-- ##### STRUCT glitz_trap_t ##### -->
+<para>
+
+</para>
+
+@top: 
+@bottom: 
+
+<!-- ##### STRUCT glitz_transform_t ##### -->
+<para>
+
+</para>
+
+@matrix: 
+
+<!-- ##### STRUCT glitz_color_t ##### -->
+<para>
+
+</para>
+
+@red: 
+@green: 
+@blue: 
+@alpha: 
+
+<!-- ##### ENUM glitz_filter_t ##### -->
+<para>
+
+</para>
+
+@GLITZ_FILTER_NEAREST: 
+@GLITZ_FILTER_BILINEAR: 
+@GLITZ_FILTER_CONVOLUTION: 
+@GLITZ_FILTER_GAUSSIAN: 
+@GLITZ_FILTER_LINEAR_GRADIENT: 
+@GLITZ_FILTER_RADIAL_GRADIENT: 
+
+<!-- ##### ENUM glitz_operator_t ##### -->
+<para>
+
+</para>
+
+@GLITZ_OPERATOR_CLEAR: 
+@GLITZ_OPERATOR_SRC: 
+@GLITZ_OPERATOR_DST: 
+@GLITZ_OPERATOR_OVER: 
+@GLITZ_OPERATOR_OVER_REVERSE: 
+@GLITZ_OPERATOR_IN: 
+@GLITZ_OPERATOR_IN_REVERSE: 
+@GLITZ_OPERATOR_OUT: 
+@GLITZ_OPERATOR_OUT_REVERSE: 
+@GLITZ_OPERATOR_ATOP: 
+@GLITZ_OPERATOR_ATOP_REVERSE: 
+@GLITZ_OPERATOR_XOR: 
+@GLITZ_OPERATOR_ADD: 
+
+<!-- ##### ENUM glitz_status_t ##### -->
+<para>
+
+</para>
+
+@GLITZ_STATUS_SUCCESS: 
+@GLITZ_STATUS_NO_MEMORY: 
+@GLITZ_STATUS_BAD_COORDINATE: 
+@GLITZ_STATUS_NOT_SUPPORTED: 
+@GLITZ_STATUS_CONTENT_DESTROYED: 
+
+<!-- ##### FUNCTION glitz_status_string ##### -->
+<para>
+
+</para>
+
+@status: 
+@Returns: 
+
+
+<!-- ##### ENUM glitz_gl_string_t ##### -->
+<para>
+
+</para>
+
+@GLITZ_GL_STRING_VENDOR: 
+@GLITZ_GL_STRING_RENDERER: 
+@GLITZ_GL_STRING_VERSION: 
+@GLITZ_GL_STRING_EXTENSIONS: 
+
+<!-- ##### ENUM glitz_fill_t ##### -->
+<para>
+
+</para>
+
+@GLITZ_FILL_TRANSPARENT: 
+@GLITZ_FILL_NEAREST: 
+@GLITZ_FILL_REPEAT: 
+@GLITZ_FILL_REFLECT: 
+
+<!-- ##### MACRO GLITZ_FEATURE_TEXTURE_RECTANGLE_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FEATURE_TEXTURE_NON_POWER_OF_TWO_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FEATURE_TEXTURE_MIRRORED_REPEAT_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FEATURE_TEXTURE_BORDER_CLAMP_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FEATURE_MULTISAMPLE_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FEATURE_MULTISAMPLE_FILTER_HINT_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FEATURE_MULTITEXTURE_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FEATURE_TEXTURE_ENV_COMBINE_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FEATURE_TEXTURE_ENV_DOT3_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FEATURE_FRAGMENT_PROGRAM_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FEATURE_VERTEX_BUFFER_OBJECT_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FEATURE_PIXEL_BUFFER_OBJECT_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FEATURE_PER_COMPONENT_RENDERING_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FEATURE_BLEND_COLOR_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FEATURE_PACKED_PIXELS_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FEATURE_MULTI_DRAW_ARRAYS_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FEATURE_FRAMEBUFFER_OBJECT_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FEATURE_COPY_SUB_BUFFER_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FEATURE_DIRECT_RENDERING_MASK ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GLITZ_FEATURE_TEXTURE_FROM_PIXMAP_MASK ##### -->
+<para>
+
+</para>
+
+
+
diff --git a/doc/reference/tmpl/glitz-unused.sgml b/doc/reference/tmpl/glitz-unused.sgml
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/doc/reference/tmpl/glitz-unused.sgml
diff --git a/doc/reference/tmpl/glitz-wgl.sgml b/doc/reference/tmpl/glitz-wgl.sgml
new file mode 100644
index 0000000..de235a5
--- /dev/null
+++ b/doc/reference/tmpl/glitz-wgl.sgml
@@ -0,0 +1,96 @@
+<!-- ##### SECTION Title ##### -->
+WGL Backend
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### STRUCT glitz_wgl_thread_starter_arg_t ##### -->
+<para>
+
+</para>
+
+@user_thread_function: 
+@user_thread_function_arg: 
+
+<!-- ##### FUNCTION glitz_wgl_thread_starter ##### -->
+<para>
+
+</para>
+
+@arg: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_wgl_init ##### -->
+<para>
+
+</para>
+
+@gl_library: 
+
+
+<!-- ##### FUNCTION glitz_wgl_fini ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### FUNCTION glitz_wgl_find_window_format ##### -->
+<para>
+
+</para>
+
+@mask: 
+@templ: 
+@count: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_wgl_find_pbuffer_format ##### -->
+<para>
+
+</para>
+
+@mask: 
+@templ: 
+@count: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_wgl_create_drawable_for_window ##### -->
+<para>
+
+</para>
+
+@format: 
+@window: 
+@width: 
+@height: 
+@Returns: 
+
+
+<!-- ##### FUNCTION glitz_wgl_create_pbuffer_drawable ##### -->
+<para>
+
+</para>
+
+@format: 
+@width: 
+@height: 
+@Returns: 
+
+
diff --git a/doc/reference/version.xml.in b/doc/reference/version.xml.in
new file mode 100644
index 0000000..e23a16d
--- /dev/null
+++ b/doc/reference/version.xml.in
@@ -0,0 +1 @@
+@GLITZ_VERSION@
diff --git a/gtk-doc.make b/gtk-doc.make
new file mode 100644
index 0000000..02fc218
--- /dev/null
+++ b/gtk-doc.make
@@ -0,0 +1,157 @@
+# -*- mode: makefile -*-
+
+####################################
+# Everything below here is generic #
+####################################
+
+if GTK_DOC_USE_LIBTOOL
+GTKDOC_CC = $(LIBTOOL) --mode=compile $(CC) $(INCLUDES) $(AM_CFLAGS) $(CFLAGS)
+GTKDOC_LD = $(LIBTOOL) --mode=link $(CC) $(AM_CFLAGS) $(CFLAGS) $(LDFLAGS)
+else
+GTKDOC_CC = $(CC) $(INCLUDES) $(AM_CFLAGS) $(CFLAGS)
+GTKDOC_LD = $(CC) $(AM_CFLAGS) $(CFLAGS) $(LDFLAGS)
+endif
+
+# We set GPATH here; this gives us semantics for GNU make
+# which are more like other make's VPATH, when it comes to
+# whether a source that is a target of one rule is then
+# searched for in VPATH/GPATH.
+#
+GPATH = $(srcdir)
+
+TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE)
+
+EXTRA_DIST = 				\
+	$(content_files)		\
+	$(HTML_IMAGES)			\
+	$(DOC_MAIN_SGML_FILE)		\
+	$(DOC_MODULE)-sections.txt	\
+	$(DOC_MODULE)-overrides.txt
+
+DOC_STAMPS=scan-build.stamp tmpl-build.stamp sgml-build.stamp html-build.stamp \
+	   $(srcdir)/tmpl.stamp $(srcdir)/sgml.stamp $(srcdir)/html.stamp
+
+SCANOBJ_FILES = 		 \
+	$(DOC_MODULE).args 	 \
+	$(DOC_MODULE).hierarchy  \
+	$(DOC_MODULE).interfaces \
+	$(DOC_MODULE).prerequisites \
+	$(DOC_MODULE).signals
+
+CLEANFILES = $(SCANOBJ_FILES) $(DOC_MODULE)-unused.txt $(DOC_STAMPS)
+
+if ENABLE_GTK_DOC
+doc: html-build.stamp
+
+#### scan ####
+
+scan-build.stamp: $(HFILE_GLOB) $(CFILE_GLOB)
+	@echo 'gtk-doc: Scanning header files'
+	@-chmod -R u+w $(srcdir)
+	if grep -l '^..*$$' $(srcdir)/$(DOC_MODULE).types > /dev/null 2>&1 ; then \
+	    CC="$(GTKDOC_CC)" LD="$(GTKDOC_LD)" CFLAGS="$(GTKDOC_CFLAGS)" LDFLAGS="$(GTKDOC_LIBS)" gtkdoc-scangobj $(SCANGOBJ_OPTIONS) --module=$(DOC_MODULE) --output-dir=$(srcdir) ; \
+	else \
+	    cd $(srcdir) ; \
+	    for i in $(SCANOBJ_FILES) ; do \
+               test -f $$i || touch $$i ; \
+	    done \
+	fi
+	cd $(srcdir) && \
+	  gtkdoc-scan --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) --ignore-headers="$(IGNORE_HFILES)" $(SCAN_OPTIONS) $(EXTRA_HFILES)
+	touch scan-build.stamp
+
+$(DOC_MODULE)-decl.txt $(SCANOBJ_FILES): scan-build.stamp
+	@true
+
+#### templates ####
+
+tmpl-build.stamp: $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(DOC_MODULE)-sections.txt $(DOC_MODULE)-overrides.txt
+	@echo 'gtk-doc: Rebuilding template files'
+	@-chmod -R u+w $(srcdir)
+	cd $(srcdir) && gtkdoc-mktmpl --module=$(DOC_MODULE) $(MKTMPL_OPTIONS)
+	touch tmpl-build.stamp
+
+tmpl.stamp: tmpl-build.stamp
+	@true
+
+#### xml ####
+
+sgml-build.stamp: tmpl.stamp $(CFILE_GLOB) $(srcdir)/tmpl/*.sgml $(expand_content_files)
+	@echo 'gtk-doc: Building XML'
+	@-chmod -R u+w $(srcdir)
+	cd $(srcdir) && \
+	gtkdoc-mkdb --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) --output-format=xml --expand-content-files="$(expand_content_files)" --main-sgml-file=$(DOC_MAIN_SGML_FILE) $(MKDB_OPTIONS)
+	touch sgml-build.stamp
+
+sgml.stamp: sgml-build.stamp
+	@true
+
+#### html ####
+
+dist-hook-local: html-build.stamp
+
+html-build.stamp: sgml.stamp $(DOC_MAIN_SGML_FILE) $(content_files)
+	@echo 'gtk-doc: Building HTML'
+	@-chmod -R u+w $(srcdir)
+	rm -rf $(srcdir)/html 
+	mkdir $(srcdir)/html
+	cd $(srcdir)/html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE)
+	test "x$(HTML_IMAGES)" = "x" || ( cd $(srcdir) && cp $(HTML_IMAGES) html )
+	@echo 'gtk-doc: Fixing cross-references' 
+	cd $(srcdir) && gtkdoc-fixxref --module-dir=html --html-dir=$(HTML_DIR) $(FIXXREF_OPTIONS)
+	touch html-build.stamp
+else
+doc:
+	@echo "*** gtk-doc must be installed and enabled in order to make doc"
+	@false
+endif
+
+##############
+
+clean-local:
+	rm -f *~ *.bak
+	rm -rf .libs
+
+maintainer-clean-local: clean
+	cd $(srcdir) && rm -rf xml html $(DOC_MODULE)-decl-list.txt $(DOC_MODULE)-decl.txt
+
+install-data-local:
+	installfiles=`echo $(srcdir)/html/*`; \
+	if test "$$installfiles" = '$(srcdir)/html/*'; \
+	then echo '-- Nothing to install' ; \
+	else \
+	  $(mkinstalldirs) $(DESTDIR)$(TARGET_DIR); \
+	  for i in $$installfiles; do \
+	    echo '-- Installing '$$i ; \
+	    $(INSTALL_DATA) $$i $(DESTDIR)$(TARGET_DIR); \
+	  done; \
+	  echo '-- Installing $(srcdir)/html/index.sgml' ; \
+	  $(INSTALL_DATA) $(srcdir)/html/index.sgml $(DESTDIR)$(TARGET_DIR) || :; \
+	fi
+
+uninstall-local:
+	rm -f $(DESTDIR)$(TARGET_DIR)/*
+
+#
+# Require gtk-doc when making dist
+#
+if ENABLE_GTK_DOC
+dist-check-gtkdoc:
+else
+dist-check-gtkdoc:
+	@echo "*** gtk-doc must be installed and enabled in order to make dist"
+	@false
+endif
+
+dist-hook: dist-check-gtkdoc dist-hook-local
+	mkdir $(distdir)/tmpl
+	mkdir $(distdir)/xml
+	mkdir $(distdir)/html
+	-cp $(srcdir)/tmpl/*.sgml $(distdir)/tmpl
+	-cp $(srcdir)/xml/*.xml $(distdir)/xml
+	-cp $(srcdir)/html/* $(distdir)/html
+	if test -f $(srcdir)/$(DOC_MODULE).types; then \
+	  cp $(srcdir)/$(DOC_MODULE).types $(distdir)/$(DOC_MODULE).types; \
+	fi
+
+.PHONY : dist-hook-local