[gok] Minor API reference update and fix doc build warnings

[Gerd Kohlberger <gerdk src gnome org>]

commit eae684a9a3699815a1c78d26794d6ee13d58adb0
Author: Gerd Kohlberger <gerdk src gnome org>
Date:   Sun Apr 26 18:09:47 2009 +0200

    Minor API reference update and fix doc build warnings
    
    - Make sure ENTITY and chapter references match.
    - Remove command prediction files from 'internal api' chapter,
    they have a dedicated chapter.
    - Remove non-existent gok-file-util from sections.
    - Update gok-sound section.
    - Update templates.
---
 docs/reference/gok-docs.sgml            |   12 ++----------
 docs/reference/gok-sections.txt         |   10 +---------
 docs/reference/tmpl/gok-gconf-keys.sgml |    3 +++
 docs/reference/tmpl/gok-sound.sgml      |    8 +-------
 docs/reference/tmpl/gok-unused.sgml     |   26 --------------------------
 5 files changed, 7 insertions(+), 52 deletions(-)

diff --git a/docs/reference/gok-docs.sgml b/docs/reference/gok-docs.sgml
index 9cd5da9..457f8a0 100644
--- a/docs/reference/gok-docs.sgml
+++ b/docs/reference/gok-docs.sgml
@@ -20,6 +20,7 @@
 <!ENTITY gok-gok-editor SYSTEM "xml/gok-editor.xml">
 <!ENTITY gok-gok-feedback SYSTEM "xml/gok-feedback.xml">
 <!ENTITY gok-gok-gconf SYSTEM "xml/gok-gconf.xml">
+<!ENTITY gok-gok-gconf-keys SYSTEM "xml/gok-gconf-keys.xml">
 <!ENTITY gok-gok-key SYSTEM "xml/gok-key.xml">
 <!ENTITY gok-gok-keyboard SYSTEM "xml/gok-keyboard.xml">
 <!ENTITY gok-gok-keyslotter SYSTEM "xml/gok-keyslotter.xml">
@@ -55,19 +56,10 @@
 
   <chapter>
     <title>GOK Internal API</title>
-    &gok-arraylist;
     &gok-callbacks;
-    &gok-command-common;
-    &gok-command-edge-data;
-    &gok-command-edge;
-    &gok-command-graph;
-    &gok-command-predictor;
-    &gok-command-vertex-data;
-    &gok-command-vertex;
-    &gok-global;
     &gok-gok-action;
     &gok-gok-branchback-stack;
-    &gok-GokButton;
+    &gok-gok-button;
     &gok-gok-chunker;
     &gok-gok-control;
     &gok-gok-data;
diff --git a/docs/reference/gok-sections.txt b/docs/reference/gok-sections.txt
index 0f5524e..efe3283 100644
--- a/docs/reference/gok-sections.txt
+++ b/docs/reference/gok-sections.txt
@@ -441,12 +441,7 @@ GOK_GCONF_ROOT
 GOK_GCONF_LAYOUT
 GOK_GCONF_KEY_SPACING
 GOK_GCONF_KEY_WIDTH
-GOK_GCONF_KEY_HEIGHT<SECTION>
-<FILE>gok-file-util</FILE>
-gok_file_dir_concat
-</SECTION>
-
-
+GOK_GCONF_KEY_HEIGHT
 GOK_GCONF_KEYBOARD_X
 GOK_GCONF_KEYBOARD_Y
 GOK_GCONF_ACCESS_METHOD
@@ -834,10 +829,7 @@ gok_settingsdialog_get_window
 
 <SECTION>
 <FILE>gok-sound</FILE>
-gok_sound_events
 gok_sound_initialize
-gok_sound_shutdown
-gok_sound_load
 gok_sound_play
 </SECTION>
 
diff --git a/docs/reference/tmpl/gok-gconf-keys.sgml b/docs/reference/tmpl/gok-gconf-keys.sgml
index 68ef752..76ee38d 100644
--- a/docs/reference/tmpl/gok-gconf-keys.sgml
+++ b/docs/reference/tmpl/gok-gconf-keys.sgml
@@ -14,6 +14,9 @@ gok-gconf-keys
 
 </para>
 
+<!-- ##### SECTION Stability_Level ##### -->
+
+
 <!-- ##### MACRO GOK_GCONF_ROOT ##### -->
 <para>
 
diff --git a/docs/reference/tmpl/gok-sound.sgml b/docs/reference/tmpl/gok-sound.sgml
index 0da0a84..1b0a4f3 100644
--- a/docs/reference/tmpl/gok-sound.sgml
+++ b/docs/reference/tmpl/gok-sound.sgml
@@ -24,18 +24,12 @@ gok-sound
 
 
 
-<!-- ##### FUNCTION gok_sound_shutdown ##### -->
-<para>
-
-</para>
-
-
-
 <!-- ##### FUNCTION gok_sound_play ##### -->
 <para>
 
 </para>
 
 @soundfile: 
+ Returns: 
 
 
diff --git a/docs/reference/tmpl/gok-unused.sgml b/docs/reference/tmpl/gok-unused.sgml
index 59d39a1..8e8d986 100644
--- a/docs/reference/tmpl/gok-unused.sgml
+++ b/docs/reference/tmpl/gok-unused.sgml
@@ -1,29 +1,3 @@
-<!-- ##### SECTION ./tmpl/gok-gconf-keys.sgml:Long_Description ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SECTION ./tmpl/gok-gconf-keys.sgml:See_Also ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SECTION ./tmpl/gok-gconf-keys.sgml:Short_Description ##### -->
-
-
-
-<!-- ##### SECTION ./tmpl/gok-gconf-keys.sgml:Title ##### -->
-gok-gconf-keys
-
-
-<!-- ##### MACRO GOK_GCONF_KEY_HEIGHT ##### -->
-<para>
-
-</para>
-
-
 <!-- ##### MACRO MAXWORDLENGTH ##### -->
 <para>