[glide] Oh goodness gtkdoc

From: Robert Carr <racarr src gnome org>
To: commits-list gnome org
Cc:
Subject: [glide] Oh goodness gtkdoc
Date: Thu, 6 May 2010 06:20:55 +0000 (UTC)
commit a882d8b1c6e72ac958f6e6f932e3d29e7f65a2e4
Author: Robert Carr <racarr Valentine localdomain>
Date:   Thu May 6 02:11:27 2010 -0400

    Oh goodness gtkdoc

 Makefile.am                       |    4 +-
 autogen.sh                        |    8 +
 configure.ac                      |   25 +--
 docs/Makefile.am                  |    1 +
 docs/reference/Makefile.am        |  109 ++++++
 docs/reference/glide-docs.sgml    |   75 ++++
 docs/reference/glide-sections.txt |  669 +++++++++++++++++++++++++++++++++++++
 docs/reference/glide.types        |   20 ++
 libglide/Makefile.am              |    2 +
 libglide/glide.c                  |  114 +++++++
 libglide/glide.h                  |   28 ++
 src/main.c                        |   99 +------
 12 files changed, 1036 insertions(+), 118 deletions(-)
---
diff --git a/Makefile.am b/Makefile.am
index b86bca7..498a6e8 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -1,7 +1,7 @@
 ## Process this file with automake to produce Makefile.in
 ## Created by Anjuta
 
-SUBDIRS = libglide po data src
+SUBDIRS = libglide po data src docs
 
 glidedocdir = ${prefix}/doc/glide
 glidedoc_DATA = \
@@ -28,6 +28,8 @@ DISTCLEANFILES = intltool-extract \
 	intltool-update \
 	po/.intltool-merge-cache
 
+DISTCHECK_CONFIGURE_FLAGS=--enable-gtk-doc
+
 
 # Remove doc directory on uninstall
 uninstall-local:
diff --git a/autogen.sh b/autogen.sh
index baa64d5..bba3133 100755
--- a/autogen.sh
+++ b/autogen.sh
@@ -6,6 +6,14 @@ test -z "$srcdir" && srcdir=.
 
 DIE=0
 
+GTKDOCIZE=`which gtkdocize`
+if test -z $GTKDOCIZE; then
+        echo "*** No gtk-doc support ***"
+        echo "EXTRA_DIST =" > gtk-doc.make
+else
+        gtkdocize --flavour no-tmpl|| exit $?
+fi
+
 if [ -n "$GNOME2_DIR" ]; then
 	ACLOCAL_FLAGS="-I $GNOME2_DIR/share/aclocal $ACLOCAL_FLAGS"
 	LD_LIBRARY_PATH="$GNOME2_DIR/lib:$LD_LIBRARY_PATH"
diff --git a/configure.ac b/configure.ac
index 2eef806..2d2a2ac 100644
--- a/configure.ac
+++ b/configure.ac
@@ -64,27 +64,8 @@ else
 fi
 AC_SUBST(HTML_DIR)
 
-gtk_doc_min_version=1.0
-AC_MSG_CHECKING([gtk-doc version >= $gtk_doc_min_version])
-if pkg-config --atleast-version=$gtk_doc_min_version gtk-doc; then
-  AC_MSG_RESULT(yes)
-  GTKDOC=true
-else
-  AC_MSG_RESULT(no)
-  GTKDOC=false
-fi
-dnl Let people disable the gtk-doc stuff.
-AC_ARG_ENABLE(gtk-doc,
-              [  --enable-gtk-doc  Use gtk-doc to build documentation [default=auto]],
-	      enable_gtk_doc="$enableval", enable_gtk_doc=auto)
-if test x$enable_gtk_doc = xauto ; then
-  if test x$GTKDOC = xtrue ; then
-    enable_gtk_doc=yes
-  else
-    enable_gtk_doc=no
-  fi
-fi
-AM_CONDITIONAL(ENABLE_GTK_DOC, test x$enable_gtk_doc = xyes)
+GTK_DOC_CHECK([1.13],[--flavour no-tmpl])
+AM_CONDITIONAL([BUILD_GTK_DOC], [test "x$enable_gtk_doc" = "xyes" || test ! -f "autogen.sh"])
 
 AC_ARG_ENABLE(debug,
 	      AC_HELP_STRING([--enable-debug],
@@ -113,6 +94,8 @@ data/ui/Makefile
 libglide/Makefile
 po/Makefile.in
 src/Makefile
+docs/Makefile
+docs/reference/Makefile
 ])
 
 AC_OUTPUT
diff --git a/docs/Makefile.am b/docs/Makefile.am
new file mode 100644
index 0000000..f3ddc22
--- /dev/null
+++ b/docs/Makefile.am
@@ -0,0 +1 @@
+SUBDIRS = reference
diff --git a/docs/reference/Makefile.am b/docs/reference/Makefile.am
new file mode 100644
index 0000000..62fb561
--- /dev/null
+++ b/docs/reference/Makefile.am
@@ -0,0 +1,109 @@
+## Process this file with automake to produce Makefile.in
+
+# We require automake 1.6 at least.
+AUTOMAKE_OPTIONS = 1.6
+
+# This is a blank Makefile.am for using gtk-doc.
+# Copy this to your project's API docs directory and modify the variables to
+# suit your project. See the GTK+ Makefiles in gtk+/docs/reference for examples
+# of using the various options.
+
+# The name of the module, e.g. 'glib'.
+DOC_MODULE=glide
+
+# Uncomment for versioned docs and specify the version of the module, e.g. '2'.
+#DOC_MODULE_VERSION=2
+
+
+# The top-level SGML file. You can change this if you want to.
+DOC_MAIN_SGML_FILE=$(DOC_MODULE)-docs.sgml
+
+# Directories containing the source code, relative to $(srcdir).
+# gtk-doc will search all .c and .h files beneath these paths
+# for inline comments documenting functions and macros.
+# e.g. DOC_SOURCE_DIR=../../../gtk ../../../gdk
+DOC_SOURCE_DIR=../../libglide
+
+# Extra options to pass to gtkdoc-scangobj. Not normally needed.
+SCANGOBJ_OPTIONS=
+
+# Extra options to supply to gtkdoc-scan.
+# e.g. SCAN_OPTIONS=--deprecated-guards="GTK_DISABLE_DEPRECATED"
+SCAN_OPTIONS=
+
+# Extra options to supply to gtkdoc-mkdb.
+# e.g. MKDB_OPTIONS=--sgml-mode --output-format=xml
+MKDB_OPTIONS=--sgml-mode --output-format=xml
+
+# Extra options to supply to gtkdoc-mktmpl
+# e.g. MKTMPL_OPTIONS=--only-section-tmpl
+MKTMPL_OPTIONS=
+
+# Extra options to supply to gtkdoc-mkhtml
+MKHTML_OPTIONS=
+
+# Extra options to supply to gtkdoc-fixref. Not normally needed.
+# e.g. FIXXREF_OPTIONS=--extra-dir=../gdk-pixbuf/html --extra-dir=../gdk/html
+FIXXREF_OPTIONS=
+
+# Used for dependencies. The docs will be rebuilt if any of these change.
+# e.g. HFILE_GLOB=$(top_srcdir)/gtk/*.h
+# e.g. CFILE_GLOB=$(top_srcdir)/gtk/*.c
+HFILE_GLOB=$(top_srcdir)/libglide/*.h
+CFILE_GLOB=$(top_srcdir)/libglide/*.c
+
+# Extra header to include when scanning, which are not under DOC_SOURCE_DIR
+# e.g. EXTRA_HFILES=$(top_srcdir}/contrib/extra.h
+EXTRA_HFILES=
+
+# Header files to ignore when scanning. Use base file name, no paths
+# e.g. IGNORE_HFILES=gtkdebug.h gtkintl.h
+IGNORE_HFILES=
+
+# Images to copy into HTML directory.
+# e.g. HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png
+HTML_IMAGES=
+
+# Extra SGML files that are included by $(DOC_MAIN_SGML_FILE).
+# e.g. content_files=running.sgml building.sgml changes-2.0.sgml
+content_files=
+
+# SGML files where gtk-doc abbrevations (#GtkWidget) are expanded
+# These files must be listed here *and* in content_files
+# e.g. expand_content_files=running.sgml
+expand_content_files=
+
+# CFLAGS and LDFLAGS for compiling gtkdoc-scangobj with your library.
+# Only needed if you are using gtkdoc-scangobj to dynamically query widget
+# signals and properties.
+# e.g. GTKDOC_CFLAGS=-I$(top_srcdir) -I$(top_builddir) $(GTK_DEBUG_FLAGS)
+# e.g. GTKDOC_LIBS=$(top_builddir)/gtk/$(gtktargetlib)
+GTKDOC_CFLAGS=-I$(top_srcdir) -I$(top_srcdir)/libglide \
+	$(GTK_CFLAGS) \
+	$(JSON_GLIB_CFLAGS) \
+	$(CLUTTER_CFLAGS) \
+	$(CLUTTER_GTK_CFLAGS) \
+	$(GLIDE_DEBUG_CFLAGS) \
+	$(GOBJECT_INTROSPECTION_CFLAGS)
+GTKDOC_LIBS=$(top_builddir)/libglide/libglide.la \
+$(GTK_LIBS) $(CLUTTER_LIBS) $(CLUTTER_GTK_LIBS) $(GOBJECT_INTROSPECTION_LIBS) $(JSON_GLIB_LIBS) $(GMODULE_LIBS) -Wl --export-dynamic
+
+# This includes the standard gtk-doc make rules, copied by gtkdocize.
+include $(top_srcdir)/gtk-doc.make
+
+# Other files to distribute
+# e.g. EXTRA_DIST += version.xml.in
+EXTRA_DIST +=
+
+# Files not to distribute
+# for --rebuild-types in $(SCAN_OPTIONS), e.g. $(DOC_MODULE).types
+# for --rebuild-sections in $(SCAN_OPTIONS) e.g. $(DOC_MODULE)-sections.txt
+#DISTCLEANFILES +=
+
+# Comment this out if you want your docs-status tested during 'make check'
+if ENABLE_GTK_DOC
+#TESTS_ENVIRONMENT = cd $(srcsrc) &&
+#TESTS = $(GTKDOC_CHECK)
+endif
+
+-include $(top_srcdir)/git.mk
diff --git a/docs/reference/glide-docs.sgml b/docs/reference/glide-docs.sgml
new file mode 100644
index 0000000..dc8f27c
--- /dev/null
+++ b/docs/reference/glide-docs.sgml
@@ -0,0 +1,75 @@
+<?xml version="1.0"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd";
+[
+  <!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
+]>
+<book id="index">
+  <bookinfo>
+    <title>glide Reference Manual</title>
+    <releaseinfo>
+      for glide [VERSION].
+      The latest version of this documentation can be found on-line at
+      <ulink role="online-location" url="http://[SERVER]/glide/index.html";>http://[SERVER]/glide/</ulink>.
+    </releaseinfo>
+  </bookinfo>
+
+  <chapter>
+    <title>[Insert title here]</title>
+        <xi:include href="xml/glide-slide.xml"/>
+    <xi:include href="xml/glide-document.xml"/>
+    <xi:include href="xml/glide-window.xml"/>
+    <xi:include href="xml/glide-inspector-text.xml"/>
+    <xi:include href="xml/glide-inspector-slide.xml"/>
+    <xi:include href="xml/glide-stage-manager.xml"/>
+    <xi:include href="xml/glide-inspector-notebook.xml"/>
+    <xi:include href="xml/glide-slide-box.xml"/>
+    <xi:include href="xml/glide-animation-manager.xml"/>
+    <xi:include href="xml/glide-actor.xml"/>
+    <xi:include href="xml/glide-inspector-actor.xml"/>
+    <xi:include href="xml/glide-rectangle.xml"/>
+    <xi:include href="xml/glide-inspector-animation.xml"/>
+    <xi:include href="xml/glide-manipulator.xml"/>
+    <xi:include href="xml/glide-slide-button.xml"/>
+    <xi:include href="xml/glide-text.xml"/>
+    <xi:include href="xml/glide-image.xml"/>
+    <xi:include href="xml/glide-inspector-image.xml"/>
+    <xi:include href="xml/glide-undo-manager.xml"/>
+    <xi:include href="xml/glide-slide-priv.xml"/>
+    <xi:include href="xml/glide-slide-box-priv.xml"/>
+    <xi:include href="xml/glide-gtk-util.xml"/>
+    <xi:include href="xml/glide-actor-priv.xml"/>
+    <xi:include href="xml/glide-inspector-animation-priv.xml"/>
+    <xi:include href="xml/glide-inspector-notebook-priv.xml"/>
+    <xi:include href="xml/glide-inspector-actor-priv.xml"/>
+    <xi:include href="xml/glide-types.xml"/>
+    <xi:include href="xml/glide-slide-button-priv.xml"/>
+    <xi:include href="xml/glide-json-util.xml"/>
+    <xi:include href="xml/glide-image-priv.xml"/>
+    <xi:include href="xml/glide-document-priv.xml"/>
+    <xi:include href="xml/glide-window-private.xml"/>
+    <xi:include href="xml/glide-stage-manager-priv.xml"/>
+    <xi:include href="xml/glide-inspector-text-priv.xml"/>
+    <xi:include href="xml/glide-animations.xml"/>
+    <xi:include href="xml/glide-vala-animations.xml"/>
+    <xi:include href="xml/glide-debug.xml"/>
+    <xi:include href="xml/glide-cairo-util.xml"/>
+    <xi:include href="xml/glide-pdf-exporter.xml"/>
+    <xi:include href="xml/glide-dirs.xml"/>
+    <xi:include href="xml/glide-manipulator-priv.xml"/>
+    <xi:include href="xml/glide-undo-manager-priv.xml"/>
+    <xi:include href="xml/glide-inspector-slide-priv.xml"/>
+    <xi:include href="xml/glide-inspector-image-priv.xml"/>
+
+  </chapter>
+  <chapter id="object-tree">
+    <title>Object Hierarchy</title>
+     <xi:include href="xml/tree_index.sgml"/>
+  </chapter>
+  <index id="api-index-full">
+    <title>API Index</title>
+    <xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
+  </index>
+
+  <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
+</book>
diff --git a/docs/reference/glide-sections.txt b/docs/reference/glide-sections.txt
new file mode 100644
index 0000000..b0bfb63
--- /dev/null
+++ b/docs/reference/glide-sections.txt
@@ -0,0 +1,669 @@
+<SECTION>
+<FILE>glide-slide</FILE>
+<TITLE>GlideSlide</TITLE>
+GlideSlideClass
+GlideSlidePrivate
+GlideSlide
+glide_slide_new
+glide_slide_construct_from_json
+glide_slide_set_background
+glide_slide_get_background
+glide_slide_set_animation
+glide_slide_get_animation
+glide_slide_add_actor_content
+glide_slide_get_contents
+glide_slide_set_color
+glide_slide_get_color
+glide_slide_resize
+glide_slide_get_index
+glide_slide_set_index
+<SUBSECTION Standard>
+GLIDE_SLIDE
+GLIDE_IS_SLIDE
+GLIDE_TYPE_SLIDE
+glide_slide_get_type
+GLIDE_SLIDE_CLASS
+GLIDE_IS_SLIDE_CLASS
+GLIDE_SLIDE_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>glide-document</FILE>
+<TITLE>GlideDocument</TITLE>
+GlideDocumentPrivate
+GlideDocument
+GlideDocumentClass
+glide_document_new
+glide_document_get_name
+glide_document_get_path
+glide_document_set_path
+glide_document_get_n_slides
+glide_document_get_nth_slide
+glide_document_append_slide
+glide_document_insert_slide
+glide_document_remove_slide
+glide_document_serialize
+glide_document_get_height
+glide_document_get_width
+glide_document_get_size
+glide_document_resize
+glide_document_get_dirty
+glide_document_set_dirty
+glide_document_write_archive
+glide_document_write_json
+glide_document_load_archive
+glide_document_add_resource
+glide_document_get_resource_path
+<SUBSECTION Standard>
+GLIDE_DOCUMENT
+GLIDE_IS_DOCUMENT
+GLIDE_TYPE_DOCUMENT
+glide_document_get_type
+GLIDE_DOCUMENT_CLASS
+GLIDE_IS_DOCUMENT_CLASS
+GLIDE_DOCUMENT_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>glide-window</FILE>
+<TITLE>GlideWindow</TITLE>
+GlideWindowPrivate
+GlideWindow
+GlideWindowClass
+glide_window_new
+glide_window_open_document
+<SUBSECTION Standard>
+GLIDE_WINDOW
+GLIDE_IS_WINDOW
+GLIDE_TYPE_WINDOW
+glide_window_get_type
+GLIDE_WINDOW_CLASS
+GLIDE_IS_WINDOW_CLASS
+GLIDE_WINDOW_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>glide-inspector-text</FILE>
+<TITLE>GlideInspectorText</TITLE>
+GlideInspectorTextPrivate
+GlideInspectorText
+GlideInspectorTextClass
+glide_inspector_text_new
+glide_inspector_text_get_actor
+glide_inspector_text_set_actor
+glide_inspector_text_get_font_name
+glide_inspector_text_get_color
+<SUBSECTION Standard>
+GLIDE_INSPECTOR_TEXT
+GLIDE_IS_INSPECTOR_TEXT
+GLIDE_TYPE_INSPECTOR_TEXT
+glide_inspector_text_get_type
+GLIDE_INSPECTOR_TEXT_CLASS
+GLIDE_IS_INSPECTOR_TEXT_CLASS
+GLIDE_INSPECTOR_TEXT_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>glide-inspector-slide</FILE>
+<TITLE>GlideInspectorSlide</TITLE>
+GlideInspectorSlidePrivate
+GlideInspectorSlide
+GlideInspectorSlideClass
+glide_inspector_slide_new
+glide_inspector_slide_get_actor
+glide_inspector_slide_set_actor
+<SUBSECTION Standard>
+GLIDE_INSPECTOR_SLIDE
+GLIDE_IS_INSPECTOR_SLIDE
+GLIDE_TYPE_INSPECTOR_SLIDE
+glide_inspector_slide_get_type
+GLIDE_INSPECTOR_SLIDE_CLASS
+GLIDE_IS_INSPECTOR_SLIDE_CLASS
+GLIDE_INSPECTOR_SLIDE_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>glide-stage-manager</FILE>
+<TITLE>GlideStageManager</TITLE>
+GlideStageManagerPrivate
+GlideStageManager
+GlideStageManagerClass
+glide_stage_manager_new
+glide_stage_manager_get_stage
+glide_stage_manager_get_document
+glide_stage_manager_get_selection
+glide_stage_manager_set_selection
+glide_stage_manager_get_manipulator
+glide_stage_manager_add_actor
+glide_stage_manager_set_slide_prev
+glide_stage_manager_set_slide_next
+glide_stage_manager_get_current_slide
+glide_stage_manager_set_current_slide
+glide_stage_manager_load_slides
+glide_stage_manager_get_presenting
+glide_stage_manager_set_presenting
+glide_stage_manager_set_slide_background
+glide_stage_manager_delete_selection
+glide_stage_manager_set_undo_manager
+glide_stage_manager_get_undo_manager
+<SUBSECTION Standard>
+GLIDE_STAGE_MANAGER
+GLIDE_IS_STAGE_MANAGER
+GLIDE_TYPE_STAGE_MANAGER
+glide_stage_manager_get_type
+GLIDE_STAGE_MANAGER_CLASS
+GLIDE_IS_STAGE_MANAGER_CLASS
+GLIDE_STAGE_MANAGER_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>glide-inspector-notebook</FILE>
+<TITLE>GlideInspectorNotebook</TITLE>
+GlideInspectorNotebookPrivate
+GlideInspectorNotebook
+GlideInspectorNotebookClass
+glide_inspector_notebook_new
+glide_inspector_notebook_get_stage_manager
+glide_inspector_notebook_set_stage_manager
+glide_inspector_notebook_get_text_color
+glide_inspector_notebook_get_font_name
+<SUBSECTION Standard>
+GLIDE_INSPECTOR_NOTEBOOK
+GLIDE_IS_INSPECTOR_NOTEBOOK
+GLIDE_TYPE_INSPECTOR_NOTEBOOK
+glide_inspector_notebook_get_type
+GLIDE_INSPECTOR_NOTEBOOK_CLASS
+GLIDE_IS_INSPECTOR_NOTEBOOK_CLASS
+GLIDE_INSPECTOR_NOTEBOOK_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>glide-slide-box</FILE>
+<TITLE>GlideSlideBox</TITLE>
+GlideSlideBoxPrivate
+GlideSlideBox
+GlideSlideBoxClass
+glide_slide_box_new
+glide_slide_box_get_stage_manager
+glide_slide_box_set_stage_manager
+<SUBSECTION Standard>
+GLIDE_SLIDE_BOX
+GLIDE_IS_SLIDE_BOX
+GLIDE_TYPE_SLIDE_BOX
+glide_slide_box_get_type
+GLIDE_SLIDE_BOX_CLASS
+GLIDE_IS_SLIDE_BOX_CLASS
+GLIDE_SLIDE_BOX_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>glide-animation-manager</FILE>
+GlideAnimationInfo
+GlideAnimation
+GlideAnimationCallback
+GlideAnimationListOptionsCallback
+glide_animation_manager_register_animation
+glide_animation_manager_get_animations
+glide_animation_manager_get_animation
+glide_animation_manager_do_animation
+glide_animation_manager_register_animations
+GLIDE_TYPE_ANIMATION_INFO
+glide_animation_info_new
+glide_animation_info_copy
+glide_animation_info_free
+GLIDE_TYPE_PARAM_ANIMATION_INFO
+GLIDE_VALUE_HOLDS_ANIMATION_INFO
+GlideParamSpecAnimationInfo
+glide_value_set_animation_info
+glide_value_get_animation_info
+glide_param_animation_info_get_type
+glide_param_spec_animation_info
+glide_animation_manager_free_options
+<SUBSECTION Standard>
+GLIDE_PARAM_SPEC_ANIMATION_INFO
+GLIDE_IS_PARAM_SPEC_ANIMATION_INFO
+glide_animation_info_get_type
+</SECTION>
+
+<SECTION>
+<FILE>glide-actor</FILE>
+<TITLE>GlideActor</TITLE>
+GlideActorPrivate
+GlideActor
+GlideActorClass
+GLIDE_ACTOR_DISPLAY_NAME
+glide_actor_get_stage_manager
+glide_actor_set_stage_manager
+glide_actor_get_selected
+glide_actor_serialize
+glide_actor_construct_from_json
+glide_actor_deserialize
+glide_actor_get_undo_manager
+glide_actor_print
+glide_actor_add_resource
+glide_actor_get_resource_path
+glide_actor_start_undo
+glide_actor_end_undo
+<SUBSECTION Standard>
+GLIDE_ACTOR
+GLIDE_IS_ACTOR
+GLIDE_TYPE_ACTOR
+glide_actor_get_type
+GLIDE_ACTOR_CLASS
+GLIDE_IS_ACTOR_CLASS
+GLIDE_ACTOR_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>glide-inspector-actor</FILE>
+<TITLE>GlideInspectorActor</TITLE>
+GlideInspectorActorPrivate
+GlideInspectorActor
+GlideInspectorActorClass
+glide_inspector_actor_new
+glide_inspector_actor_get_actor
+glide_inspector_actor_set_actor
+<SUBSECTION Standard>
+GLIDE_INSPECTOR_ACTOR
+GLIDE_IS_INSPECTOR_ACTOR
+GLIDE_TYPE_INSPECTOR_ACTOR
+glide_inspector_actor_get_type
+GLIDE_INSPECTOR_ACTOR_CLASS
+GLIDE_IS_INSPECTOR_ACTOR_CLASS
+GLIDE_INSPECTOR_ACTOR_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>glide-rectangle</FILE>
+<TITLE>GlideRectangle</TITLE>
+GlideRectangle
+GlideRectangleClass
+glide_rectangle_new
+<SUBSECTION Standard>
+GLIDE_RECTANGLE
+GLIDE_IS_RECTANGLE
+GLIDE_TYPE_RECTANGLE
+glide_rectangle_get_type
+GLIDE_RECTANGLE_CLASS
+GLIDE_IS_RECTANGLE_CLASS
+GLIDE_RECTANGLE_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>glide-inspector-animation</FILE>
+<TITLE>GlideInspectorAnimation</TITLE>
+GlideInspectorAnimationPrivate
+GlideInspectorAnimation
+GlideInspectorAnimationClass
+glide_inspector_animation_new
+glide_inspector_animation_get_actor
+glide_inspector_animation_set_actor
+<SUBSECTION Standard>
+GLIDE_INSPECTOR_ANIMATION
+GLIDE_IS_INSPECTOR_ANIMATION
+GLIDE_TYPE_INSPECTOR_ANIMATION
+glide_inspector_animation_get_type
+GLIDE_INSPECTOR_ANIMATION_CLASS
+GLIDE_IS_INSPECTOR_ANIMATION_CLASS
+GLIDE_INSPECTOR_ANIMATION_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>glide-manipulator</FILE>
+<TITLE>GlideManipulator</TITLE>
+GlideManipulatorPrivate
+GlideManipulator
+GlideManipulatorClass
+glide_manipulator_new
+glide_manipulator_get_target
+glide_manipulator_set_target
+glide_manipulator_set_width_only
+glide_manipulator_get_width_only
+<SUBSECTION Standard>
+GLIDE_MANIPULATOR
+GLIDE_IS_MANIPULATOR
+GLIDE_TYPE_MANIPULATOR
+glide_manipulator_get_type
+GLIDE_MANIPULATOR_CLASS
+GLIDE_IS_MANIPULATOR_CLASS
+GLIDE_MANIPULATOR_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>glide-slide-button</FILE>
+<TITLE>GlideSlideButton</TITLE>
+GlideSlideButtonPrivate
+GlideSlideButton
+GlideSlideButtonClass
+glide_slide_button_new
+glide_slide_button_get_slide
+glide_slide_button_set_slide
+<SUBSECTION Standard>
+GLIDE_SLIDE_BUTTON
+GLIDE_IS_SLIDE_BUTTON
+GLIDE_TYPE_SLIDE_BUTTON
+glide_slide_button_get_type
+GLIDE_SLIDE_BUTTON_CLASS
+GLIDE_IS_SLIDE_BUTTON_CLASS
+GLIDE_SLIDE_BUTTON_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>glide-text</FILE>
+<TITLE>GlideText</TITLE>
+GlideText
+GlideTextPrivate
+GlideTextClass
+glide_text_new
+glide_text_new_full
+glide_text_new_with_text
+glide_text_get_text
+glide_text_set_text
+glide_text_set_markup
+glide_text_set_color
+glide_text_get_color
+glide_text_set_font_name
+glide_text_get_font_name
+glide_text_set_font_description
+glide_text_get_font_description
+glide_text_set_ellipsize
+glide_text_get_ellipsize
+glide_text_set_line_wrap
+glide_text_get_line_wrap
+glide_text_set_line_wrap_mode
+glide_text_get_line_wrap_mode
+glide_text_get_layout
+glide_text_set_attributes
+glide_text_get_attributes
+glide_text_set_use_markup
+glide_text_get_use_markup
+glide_text_set_line_alignment
+glide_text_get_line_alignment
+glide_text_set_justify
+glide_text_get_justify
+glide_text_insert_unichar
+glide_text_delete_chars
+glide_text_insert_text
+glide_text_delete_text
+glide_text_get_chars
+glide_text_set_editable
+glide_text_get_editable
+glide_text_set_activatable
+glide_text_get_activatable
+glide_text_get_cursor_position
+glide_text_set_cursor_position
+glide_text_set_cursor_visible
+glide_text_get_cursor_visible
+glide_text_set_cursor_color
+glide_text_get_cursor_color
+glide_text_set_cursor_size
+glide_text_get_cursor_size
+glide_text_set_selectable
+glide_text_get_selectable
+glide_text_set_selection_bound
+glide_text_get_selection_bound
+glide_text_set_selection
+glide_text_get_selection
+glide_text_set_selection_color
+glide_text_get_selection_color
+glide_text_delete_selection
+glide_text_set_password_char
+glide_text_get_password_char
+glide_text_set_max_length
+glide_text_get_max_length
+glide_text_set_single_line_mode
+glide_text_get_single_line_mode
+glide_text_activate
+glide_text_position_to_coords
+glide_text_set_preedit_string
+glide_text_set_font_size
+glide_text_get_font_size
+glide_text_update_actor_size
+<SUBSECTION Standard>
+GLIDE_TEXT
+GLIDE_IS_TEXT
+GLIDE_TYPE_TEXT
+glide_text_get_type
+GLIDE_TEXT_CLASS
+GLIDE_IS_TEXT_CLASS
+GLIDE_TEXT_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>glide-image</FILE>
+<TITLE>GlideImage</TITLE>
+GlideImage
+GlideImageClass
+GlideImagePrivate
+glide_image_new
+glide_image_new_from_file
+glide_image_set_from_file
+glide_image_set_cogl_texture
+glide_image_get_filename
+<SUBSECTION Standard>
+GLIDE_IMAGE
+GLIDE_IS_IMAGE
+GLIDE_TYPE_IMAGE
+glide_image_get_type
+GLIDE_IMAGE_CLASS
+GLIDE_IS_IMAGE_CLASS
+GLIDE_IMAGE_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>glide-inspector-image</FILE>
+<TITLE>GlideInspectorImage</TITLE>
+GlideInspectorImagePrivate
+GlideInspectorImage
+GlideInspectorImageClass
+glide_inspector_image_new
+glide_inspector_image_get_actor
+glide_inspector_image_set_actor
+<SUBSECTION Standard>
+GLIDE_INSPECTOR_IMAGE
+GLIDE_IS_INSPECTOR_IMAGE
+GLIDE_TYPE_INSPECTOR_IMAGE
+glide_inspector_image_get_type
+GLIDE_INSPECTOR_IMAGE_CLASS
+GLIDE_IS_INSPECTOR_IMAGE_CLASS
+GLIDE_INSPECTOR_IMAGE_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>glide-undo-manager</FILE>
+<TITLE>GlideUndoManager</TITLE>
+GlideUndoManagerPrivate
+GlideUndoManager
+GlideUndoManagerClass
+GlideUndoInfo
+GlideUndoActionCallback
+GlideUndoInfoFreeCallback
+glide_undo_manager_new
+glide_undo_manager_append_info
+glide_undo_manager_undo
+glide_undo_manager_redo
+glide_undo_manager_start_actor_action
+glide_undo_manager_end_actor_action
+glide_undo_manager_start_slide_action
+glide_undo_manager_end_slide_action
+glide_undo_manager_append_delete
+glide_undo_manager_append_insert
+glide_undo_manager_cancel_actor_action
+glide_undo_manager_get_can_undo
+glide_undo_manager_get_can_redo
+glide_undo_manager_get_undo_label
+glide_undo_manager_get_redo_label
+<SUBSECTION Standard>
+GLIDE_UNDO_MANAGER
+GLIDE_IS_UNDO_MANAGER
+GLIDE_TYPE_UNDO_MANAGER
+glide_undo_manager_get_type
+GLIDE_UNDO_MANAGER_CLASS
+GLIDE_IS_UNDO_MANAGER_CLASS
+GLIDE_UNDO_MANAGER_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>glide-slide-priv</FILE>
+GlideSlidePrivate
+</SECTION>
+
+<SECTION>
+<FILE>glide-slide-box-priv</FILE>
+GlideSlideBoxPrivate
+</SECTION>
+
+<SECTION>
+<FILE>glide-gtk-util</FILE>
+glide_gtk_util_show_image_dialog
+glide_gtk_util_show_file_dialog
+glide_gtk_util_show_save_dialog
+glide_gtk_util_get_clipboard_text
+glide_gdk_color_from_clutter_color
+glide_clutter_color_from_gdk_color
+glide_gtk_util_show_error_dialog
+glide_gtk_util_set_widget_font_small
+</SECTION>
+
+<SECTION>
+<FILE>glide-actor-priv</FILE>
+GlideActorPrivate
+</SECTION>
+
+<SECTION>
+<FILE>glide-inspector-animation-priv</FILE>
+GlideInspectorAnimationPrivate
+</SECTION>
+
+<SECTION>
+<FILE>glide-inspector-notebook-priv</FILE>
+GlideInspectorNotebookPrivate
+</SECTION>
+
+<SECTION>
+<FILE>glide-inspector-actor-priv</FILE>
+GlideInspectorActorPrivate
+</SECTION>
+
+<SECTION>
+<FILE>glide-types</FILE>
+GlideActor
+GlideSlide
+</SECTION>
+
+<SECTION>
+<FILE>glide-slide-button-priv</FILE>
+GlideSlideButtonPrivate
+</SECTION>
+
+<SECTION>
+<FILE>glide-json-util</FILE>
+glide_json_object_set_string
+glide_json_object_get_string
+glide_json_object_set_double
+glide_json_object_get_double
+glide_json_object_add_actor_geometry
+glide_json_object_restore_actor_geometry
+glide_json_object_set_animation
+glide_json_object_get_animation
+</SECTION>
+
+<SECTION>
+<FILE>glide-image-priv</FILE>
+GlideImagePrivate
+</SECTION>
+
+<SECTION>
+<FILE>glide-document-priv</FILE>
+GlideDocumentPrivate
+</SECTION>
+
+<SECTION>
+<FILE>glide-window-private</FILE>
+GlideWindowPrivate
+</SECTION>
+
+<SECTION>
+<FILE>glide-stage-manager-priv</FILE>
+GlideStageManagerPrivate
+</SECTION>
+
+<SECTION>
+<FILE>glide-inspector-text-priv</FILE>
+GlideInspectorTextPrivate
+</SECTION>
+
+<SECTION>
+<FILE>glide-animations</FILE>
+glide_animations_animate_fade
+glide_animations_animate_drop
+glide_animations_animate_zoom
+glide_animations_animate_zoom_contents
+glide_animations_animate_pivot
+glide_animations_animate_slide
+glide_animations_animate_doorway
+</SECTION>
+
+<SECTION>
+<FILE>glide-vala-animations</FILE>
+glide_animate_fade
+glide_animate_slide_list_options
+glide_animate_slide
+glide_animate_drop
+glide_animate_pivot_list_options
+glide_animate_pivot
+glide_animate_fall
+glide_animate_zoom_list_options
+glide_animate_zoom
+glide_animate_panel_list_options
+glide_animate_panel
+</SECTION>
+
+<SECTION>
+<FILE>glide-debug</FILE>
+GlideDebugFlag
+GLIDE_NOTE
+GLIDE_MARK
+GLIDE_DBG
+glide_debug_flags
+</SECTION>
+
+<SECTION>
+<FILE>glide-cairo-util</FILE>
+glide_cairo_set_clutter_color
+</SECTION>
+
+<SECTION>
+<FILE>glide-pdf-exporter</FILE>
+glide_pdf_exporter_export
+</SECTION>
+
+<SECTION>
+<FILE>glide-dirs</FILE>
+glide_dirs_get_glide_data_dir
+glide_dirs_get_glide_image_dir
+glide_dirs_get_glide_ui_dir
+</SECTION>
+
+<SECTION>
+<FILE>glide-manipulator-priv</FILE>
+GlideManipulatorWidget
+GlideManipulatorWidgetMode
+GlideManipulatorPrivate
+</SECTION>
+
+<SECTION>
+<FILE>glide-undo-manager-priv</FILE>
+GlideUndoManagerPrivate
+</SECTION>
+
+<SECTION>
+<FILE>glide-inspector-slide-priv</FILE>
+GlideInspectorSlidePrivate
+</SECTION>
+
+<SECTION>
+<FILE>glide-inspector-image-priv</FILE>
+GlideInspectorImagePrivate
+</SECTION>
+
diff --git a/docs/reference/glide.types b/docs/reference/glide.types
new file mode 100644
index 0000000..9d0af79
--- /dev/null
+++ b/docs/reference/glide.types
@@ -0,0 +1,20 @@
+glide_actor_get_type
+glide_animation_info_get_type
+glide_document_get_type
+glide_image_get_type
+glide_inspector_actor_get_type
+glide_inspector_animation_get_type
+glide_inspector_image_get_type
+glide_inspector_notebook_get_type
+glide_inspector_slide_get_type
+glide_inspector_text_get_type
+glide_manipulator_get_type
+glide_param_animation_info_get_type
+glide_rectangle_get_type
+glide_slide_box_get_type
+glide_slide_button_get_type
+glide_slide_get_type
+glide_stage_manager_get_type
+glide_text_get_type
+glide_undo_manager_get_type
+glide_window_get_type
diff --git a/libglide/Makefile.am b/libglide/Makefile.am
index 9173947..0086410 100644
--- a/libglide/Makefile.am
+++ b/libglide/Makefile.am
@@ -51,6 +51,7 @@ glideheaders_HEADERS = \
 	glide-actor.h \
 	glide-manipulator.h \
 	glide-window.h \
+	glide.h \
 	$(glide_VALABUILTHEADERS)
 
 glideheadersdir = $(pkgincludedir)
@@ -81,6 +82,7 @@ libglide_la_SOURCES = \
 	glide-inspector-slide.c \
 	glide-inspector-image.c \
 	glide-inspector-text.c \
+	glide.c \
 	$(glide_VALABUILTSOURCES)
 
 libglide_la_CFLAGS = \
diff --git a/libglide/glide.c b/libglide/glide.c
new file mode 100644
index 0000000..7a14658
--- /dev/null
+++ b/libglide/glide.c
@@ -0,0 +1,114 @@
+/*
+ * glide.c
+ * Copyright (C) Robert Carr 2010 <racarr gnome org>
+ * 
+ * Glide is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ * 
+ * Glide is distributed in the hope that it will be useful, but
+ * WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU General Public License for more details.
+ * 
+ * You should have received a copy of the GNU General Public License along
+ * with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include "glide.h"
+#include "glide-animation-manager.h"
+#include "glide-debug.h"
+
+guint glide_debug_flags = 0;
+
+#ifdef GLIDE_ENABLE_DEBUG
+static const GDebugKey glide_debug_keys[] = {
+  {"misc", GLIDE_DEBUG_MISC},
+  {"image", GLIDE_DEBUG_IMAGE},
+  {"manipulator", GLIDE_DEBUG_MANIPULATOR},
+  {"stage-manager", GLIDE_DEBUG_STAGE_MANAGER},
+  {"window", GLIDE_DEBUG_WINDOW},
+  {"paint", GLIDE_DEBUG_PAINT},
+  {"text", GLIDE_DEBUG_TEXT},
+  {"document", GLIDE_DEBUG_DOCUMENT}
+};
+
+static gboolean
+glide_arg_debug_cb (const char *key, const char *value, gpointer user_data)
+{
+  glide_debug_flags |=
+	g_parse_debug_string (value, glide_debug_keys, G_N_ELEMENTS (glide_debug_keys));
+  return TRUE;
+}
+
+static gboolean
+glide_arg_no_debug_cb (const char *key, const char *value, gpointer user_data)
+{
+  glide_debug_flags &=
+	~g_parse_debug_string (value, glide_debug_keys, G_N_ELEMENTS (glide_debug_keys));
+  return TRUE;
+}
+#endif
+
+static GOptionEntry glide_args[] = {
+#ifdef GLIDE_ENABLE_DEBUG
+  {"glide-debug", 0, 0, G_OPTION_ARG_CALLBACK, glide_arg_debug_cb,
+   "Glide debugging messages to show. Comma seperated list of: all, misc, image, manipulator, stage-manager, window, text, document, or paint",
+   "FLAGS"},
+  {"glide-no-debug", 0, 0, G_OPTION_ARG_CALLBACK, glide_arg_no_debug_cb,
+   "Disable glide debugging", "FLAGS"},
+#endif
+  {NULL,},
+};
+
+GOptionGroup *
+glide_get_option_group (void)
+{
+  GOptionGroup *group;
+	
+  group = g_option_group_new ("glide", "Glide Options",
+							  "Show Glide Options", NULL, NULL);
+  g_option_group_add_entries (group, glide_args);
+	
+  return group;
+}
+
+static gboolean
+glide_parse_args (int *argc, char ***argv)
+{
+  GOptionContext *option_context;
+  GOptionGroup *glide_group;
+  GError *error = NULL;
+  gboolean ret = TRUE;
+  
+  option_context = g_option_context_new (NULL);
+  g_option_context_set_ignore_unknown_options (option_context, TRUE);
+  g_option_context_set_help_enabled (option_context, TRUE);
+  
+  glide_group = glide_get_option_group ();
+  g_option_context_add_group (option_context, glide_group);
+  
+  if (!g_option_context_parse (option_context, argc, argv, &error))
+	{
+	  if (error)
+		{
+		  g_warning ("%s", error->message);
+		  g_error_free (error);
+		}
+	  
+	  ret = FALSE;
+	}
+  g_option_context_free (option_context);
+  
+  return ret;
+}
+
+gboolean
+glide_init (int *argc, char ***argv)
+{
+  gboolean res = glide_parse_args (argc, argv);
+
+  glide_animation_manager_register_animations ();
+  return res;
+}
diff --git a/libglide/glide.h b/libglide/glide.h
new file mode 100644
index 0000000..c0c0699
--- /dev/null
+++ b/libglide/glide.h
@@ -0,0 +1,28 @@
+/*
+ * glide.h
+ * Copyright (C) Robert Carr 2010 <racarr gnome org>
+ * 
+ * Glide is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License as published by the
+ * Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ * 
+ * Glide is distributed in the hope that it will be useful, but
+ * WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the GNU General Public License for more details.
+ * 
+ * You should have received a copy of the GNU General Public License along
+ * with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef __GLIDE_H__
+#define __GLIDE_H__
+#include <glib.h>
+
+G_BEGIN_DECLS
+GOptionGroup *glide_get_option_group (void);
+gboolean glide_init (int *argc, char ***argv);
+G_END_DECLS
+
+#endif
diff --git a/src/main.c b/src/main.c
index 0d6ae29..d3a8f58 100644
--- a/src/main.c
+++ b/src/main.c
@@ -32,92 +32,7 @@
 #include <glib/gi18n.h>
 
 #include "../libglide/glide-window.h"
-#include "../libglide/glide-animation-manager.h"
-#include "../libglide/glide-debug.h"
-
-guint glide_debug_flags = 0;
-
-#ifdef GLIDE_ENABLE_DEBUG
-static const GDebugKey glide_debug_keys[] = {
-  {"misc", GLIDE_DEBUG_MISC},
-  {"image", GLIDE_DEBUG_IMAGE},
-  {"manipulator", GLIDE_DEBUG_MANIPULATOR},
-  {"stage-manager", GLIDE_DEBUG_STAGE_MANAGER},
-  {"window", GLIDE_DEBUG_WINDOW},
-  {"paint", GLIDE_DEBUG_PAINT},
-  {"text", GLIDE_DEBUG_TEXT},
-  {"document", GLIDE_DEBUG_DOCUMENT}
-};
-
-static gboolean
-glide_arg_debug_cb (const char *key, const char *value, gpointer user_data)
-{
-  glide_debug_flags |=
-	g_parse_debug_string (value, glide_debug_keys, G_N_ELEMENTS (glide_debug_keys));
-  return TRUE;
-}
-
-static gboolean
-glide_arg_no_debug_cb (const char *key, const char *value, gpointer user_data)
-{
-  glide_debug_flags &=
-	~g_parse_debug_string (value, glide_debug_keys, G_N_ELEMENTS (glide_debug_keys));
-  return TRUE;
-}
-#endif
-
-static GOptionEntry glide_args[] = {
-#ifdef GLIDE_ENABLE_DEBUG
-  {"glide-debug", 0, 0, G_OPTION_ARG_CALLBACK, glide_arg_debug_cb,
-   "Glide debugging messages to show. Comma seperated list of: all, misc, image, manipulator, stage-manager, window, text, document, or paint",
-   "FLAGS"},
-  {"glide-no-debug", 0, 0, G_OPTION_ARG_CALLBACK, glide_arg_no_debug_cb,
-   "Disable glide debugging", "FLAGS"},
-#endif
-  {NULL,},
-};
-
-GOptionGroup *
-glide_get_option_group (void)
-{
-  GOptionGroup *group;
-	
-  group = g_option_group_new ("glide", "Glide Options",
-							  "Show Glide Options", NULL, NULL);
-  g_option_group_add_entries (group, glide_args);
-	
-  return group;
-}
-
-static gboolean
-glide_parse_args (int *argc, char ***argv)
-{
-  GOptionContext *option_context;
-  GOptionGroup *glide_group;
-  GError *error = NULL;
-  gboolean ret = TRUE;
-  
-  option_context = g_option_context_new (NULL);
-  g_option_context_set_ignore_unknown_options (option_context, TRUE);
-  g_option_context_set_help_enabled (option_context, TRUE);
-  
-  glide_group = glide_get_option_group ();
-  g_option_context_add_group (option_context, glide_group);
-  
-  if (!g_option_context_parse (option_context, argc, argv, &error))
-	{
-	  if (error)
-		{
-		  g_warning ("%s", error->message);
-		  g_error_free (error);
-		}
-	  
-	  ret = FALSE;
-	}
-  g_option_context_free (option_context);
-  
-  return ret;
-}
+#include "../libglide/glide.h"
 
 int
 main (int argc, char *argv[])
@@ -128,18 +43,10 @@ main (int argc, char *argv[])
   gtk_init (&argc, &argv);
   gtk_clutter_init (&argc, &argv);
   
-  g_set_application_name ("Glide");
+  glide_init (&argc, &argv);
   
-  if (glide_parse_args (&argc, &argv) == FALSE)
-	{
-	  g_critical ("Failed to parse arguments");
-	  return 1;
-	}
+  g_set_application_name ("Glide");
   
-  GLIDE_NOTE (MISC, "Starting Glide");
-
-  glide_animation_manager_register_animations ();
-
   window = glide_window_new ();
   if (argc >= 2)
     glide_window_open_document (GLIDE_WINDOW (window), argv[1]);
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]