include initialization_versions.sgml, file-saving.sgml and

        * gdk-pixbuf/gdk-pixbuf.sgml: include initialization_versions.sgml,
        file-saving.sgml and module_interface.sgml.

        * gdk-pixbuf/tmpl/module_interface.sgml: add short description.

        * gtk/tmpl/gtkarg.sgml, gtk/tmpl/gtkdata.sgml,
        gtk/tmpl/gtkcellrenderertextpixbuf.sgml: removed, since they described
        no longer existent stuff and aren't included anymore.

        * gdk/tmpl/color_contexts.sgml, gdk/tmpl/input_contexts.sgml,
        gdk/tmpl/input_methods.sgml: removed, since they described no longer
        existent stuff and aren't included anymore.

9 files changed, 23 insertions, 398 deletions

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 6d748cf57..3238c1abc 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,5 +1,20 @@
 2001-10-31  Matthias Clasen  <matthiasc@poet.de>
 
+	* gdk-pixbuf/gdk-pixbuf.sgml: include initialization_versions.sgml,
+	file-saving.sgml and module_interface.sgml.
+
+	* gdk-pixbuf/tmpl/module_interface.sgml: add short description.
+
+	* gtk/tmpl/gtkarg.sgml, gtk/tmpl/gtkdata.sgml, 
+	gtk/tmpl/gtkcellrenderertextpixbuf.sgml: removed, since they described 
+	no longer existent stuff and aren't included anymore.
+
+	* gdk/tmpl/color_contexts.sgml, gdk/tmpl/input_contexts.sgml, 
+	gdk/tmpl/input_methods.sgml: removed, since they described no longer 
+	existent stuff and aren't included anymore.
+
+2001-10-31  Matthias Clasen  <matthiasc@poet.de>
+
 	* gdk-pixbuf/gdk-pixbuf-sections.txt,
 	gdk-pixbuf/tmpl/animation.sgml, 
 	gdk-pixbuf/tmpl/module_interface.sgml: Updates. (#63293)
diff --git a/docs/reference/gdk-pixbuf/gdk-pixbuf.sgml b/docs/reference/gdk-pixbuf/gdk-pixbuf.sgml
index 4c7006504..b19896b08 100644
--- a/docs/reference/gdk-pixbuf/gdk-pixbuf.sgml
+++ b/docs/reference/gdk-pixbuf/gdk-pixbuf.sgml
@@ -3,12 +3,15 @@
 <!entity gdk-pixbuf-gdk-pixbuf SYSTEM "sgml/gdk-pixbuf.sgml">
 <!entity gdk-pixbuf-refcounting SYSTEM "sgml/refcounting.sgml">
 <!entity gdk-pixbuf-file-loading SYSTEM "sgml/file-loading.sgml">
+<!entity gdk-pixbuf-file-saving SYSTEM "sgml/file-saving.sgml">
 <!entity gdk-pixbuf-creating SYSTEM "sgml/creating.sgml">
 <!entity gdk-pixbuf-inline SYSTEM "sgml/inline.sgml">
 <!entity gdk-pixbuf-scaling SYSTEM "sgml/scaling.sgml">
 <!entity gdk-pixbuf-util SYSTEM "sgml/util.sgml">
 <!entity gdk-pixbuf-animation SYSTEM "sgml/animation.sgml">
 <!entity GdkPixbufLoader SYSTEM "sgml/gdk-pixbuf-loader.sgml">
+<!entity module_interface SYSTEM "sgml/module_interface.sgml">
+<!entity initialization_versions SYSTEM "sgml/initialization_versions.sgml">
 <!entity gdk-pixbuf-gdk-pixbuf-xlib-init SYSTEM "sgml/gdk-pixbuf-xlib-init.sgml">
 <!entity gdk-pixbuf-gdk-pixbuf-xlib-rendering SYSTEM "sgml/gdk-pixbuf-xlib-rendering.sgml">
 <!entity gdk-pixbuf-gdk-pixbuf-xlib-from-drawables SYSTEM "sgml/gdk-pixbuf-xlib-from-drawables.sgml">
@@ -84,9 +87,12 @@
       </para>
     </partintro>
 
+    &initialization_versions;
+
     &gdk-pixbuf-gdk-pixbuf;
     &gdk-pixbuf-refcounting;
     &gdk-pixbuf-file-loading;
+    &gdk-pixbuf-file-saving;
     &gdk-pixbuf-creating;
     &gdk-pixbuf-inline;
     &gdk-pixbuf-scaling;
@@ -94,6 +100,7 @@
     &gdk-pixbuf-animation;
 
     &GdkPixbufLoader;
+    &module_interface;
 
     &gdk-pixbuf-gdk-pixbuf-xlib-init;
     &gdk-pixbuf-gdk-pixbuf-xlib-rendering;
diff --git a/docs/reference/gdk-pixbuf/tmpl/module_interface.sgml b/docs/reference/gdk-pixbuf/tmpl/module_interface.sgml
index 5b0a95bc0..b39ee2f2a 100644
--- a/docs/reference/gdk-pixbuf/tmpl/module_interface.sgml
+++ b/docs/reference/gdk-pixbuf/tmpl/module_interface.sgml
@@ -2,7 +2,7 @@
 Module Interface
 
 <!-- ##### SECTION Short_Description ##### -->
-
+extending &gdk-pixbuf;
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gdk/tmpl/color_contexts.sgml b/docs/reference/gdk/tmpl/color_contexts.sgml
deleted file mode 100644
index af6455024..000000000
--- a/docs/reference/gdk/tmpl/color_contexts.sgml
+++ /dev/null
@@ -1,207 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-Color Contexts
-
-<!-- ##### SECTION Short_Description ##### -->
-routines for allocating colors (deprecated).
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-The #GdkColorContext type is used for allocating groups of colors.
-</para>
-<para>
-It is now deprecated in favor of the gdk_colormap_*() functions described in
-the <link linkend="gdk-Colormaps-and-Colors">Colormaps and Colors</link>
-section.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### STRUCT GdkColorContext ##### -->
-<para>
-
-</para>
-
-@visual: 
-@colormap: 
-@num_colors: 
-@max_colors: 
-@num_allocated: 
-@mode: 
-@need_to_free_colormap: 
-@std_cmap_atom: 
-@clut: 
-@cmap: 
-@color_hash: 
-@palette: 
-@num_palette: 
-@fast_dither: 
-
-<!-- ##### STRUCT GdkColorContextDither ##### -->
-<para>
-
-</para>
-
-@fast_rgb: 
-@fast_err: 
-@fast_erg: 
-@fast_erb: 
-
-<!-- ##### ENUM GdkColorContextMode ##### -->
-<para>
-
-</para>
-
-@GDK_CC_MODE_UNDEFINED: 
-@GDK_CC_MODE_BW: 
-@GDK_CC_MODE_STD_CMAP: 
-@GDK_CC_MODE_TRUE: 
-@GDK_CC_MODE_MY_GRAY: 
-@GDK_CC_MODE_PALETTE: 
-
-<!-- ##### FUNCTION gdk_color_context_new ##### -->
-<para>
-
-</para>
-
-@visual: 
-@colormap: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_color_context_new_mono ##### -->
-<para>
-
-</para>
-
-@visual: 
-@colormap: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_color_context_free ##### -->
-<para>
-
-</para>
-
-@cc: 
-
-
-<!-- ##### FUNCTION gdk_color_context_get_pixel ##### -->
-<para>
-
-</para>
-
-@cc: 
-@red: 
-@green: 
-@blue: 
-@failed: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_color_context_get_pixels ##### -->
-<para>
-
-</para>
-
-@cc: 
-@reds: 
-@greens: 
-@blues: 
-@ncolors: 
-@colors: 
-@nallocated: 
-
-
-<!-- ##### FUNCTION gdk_color_context_get_pixels_incremental ##### -->
-<para>
-
-</para>
-
-@cc: 
-@reds: 
-@greens: 
-@blues: 
-@ncolors: 
-@used: 
-@colors: 
-@nallocated: 
-
-
-<!-- ##### FUNCTION gdk_color_context_query_color ##### -->
-<para>
-
-</para>
-
-@cc: 
-@color: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_color_context_query_colors ##### -->
-<para>
-
-</para>
-
-@cc: 
-@colors: 
-@num_colors: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_color_context_add_palette ##### -->
-<para>
-
-</para>
-
-@cc: 
-@palette: 
-@num_palette: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_color_context_init_dither ##### -->
-<para>
-
-</para>
-
-@cc: 
-
-
-<!-- ##### FUNCTION gdk_color_context_free_dither ##### -->
-<para>
-
-</para>
-
-@cc: 
-
-
-<!-- ##### FUNCTION gdk_color_context_get_pixel_from_palette ##### -->
-<para>
-
-</para>
-
-@cc: 
-@red: 
-@green: 
-@blue: 
-@failed: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_color_context_get_index_from_palette ##### -->
-<para>
-
-</para>
-
-@cc: 
-@red: 
-@green: 
-@blue: 
-@failed: 
-@Returns: 
-
-
diff --git a/docs/reference/gdk/tmpl/input_contexts.sgml b/docs/reference/gdk/tmpl/input_contexts.sgml
deleted file mode 100644
index 683017ba2..000000000
--- a/docs/reference/gdk/tmpl/input_contexts.sgml
+++ /dev/null
@@ -1,19 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-Input Contexts
-
-<!-- ##### SECTION Short_Description ##### -->
-internationalized text input properties.
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-A #GdkIC input context is used for each user interface element which supports
-internationalized text input. See the
-<link linkend="gdk-Input-Methods">Input Methods</link> section for an overview
-of how internationalized text input works in GTK+.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
diff --git a/docs/reference/gdk/tmpl/input_methods.sgml b/docs/reference/gdk/tmpl/input_methods.sgml
deleted file mode 100644
index 7346e1c5a..000000000
--- a/docs/reference/gdk/tmpl/input_methods.sgml
+++ /dev/null
@@ -1,88 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-Input Methods
-
-<!-- ##### SECTION Short_Description ##### -->
-support for internationalized text input.
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-Input Methods provide a way for complex character sets to be used in GTK+.
-Languages such as Chinese, Japanese, and Korean (often abbreviated to CJK)
-use a large number of ideographs, making it impossible to support all
-characters with a simple keyboard. Instead, text is usually
-<emphasis>pre-edited</emphasis> using a phonetic alphabet and then
-<emphasis>composed</emphasis> to form the ideographs.
-</para>
-<para>
-GTK+ makes use of the input method mechanism provided by the X Windows
-platform. When a GTK+ application is started, it opens a connection to the
-input method appropriate for the current locale (if any). 
-</para>
-<para>
-Widgets which handle textual input, such as #GtkEntry, need to do a number of
-things to support internationalized text input:
-<variablelist>
-<varlistentry>
-<term>When the widget is realized:</term>
-<listitem><para>Check if an input method is being used with gdk_im_ready().
-If it is, create a new <link linkend="gdk-Input-Contexts">Input Context</link>
-using gdk_ic_new(). Find out which events the
-<link linkend="gdk-Input-Contexts">Input Context</link> needs to receive
-with gdk_ic_get_events(), and make sure that the widget's window receives
-these events using gdk_window_set_events().
-</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term>When the widget's size, state or cursor position changes:</term>
-<listitem><para>
-Update the appropriate
-<link linkend="gdk-Input-Contexts">Input Context</link> attributes
-using gdk_ic_set_attr().
-</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term>When the keyboard focus enters or leaves the widget:</term>
-<listitem><para>
-Call gdk_im_begin() or gdk_im_end() to start or finish editing the text.
-</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term>When the widget receives a key_press event:</term>
-<listitem><para>
-The <structfield>string</structfield> and <structfield>length</structfield>
-fields of the #GdkEventKey struct should be used to insert the composed text
-into the widget.
-</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term>When the widget is unrealized:</term>
-<listitem><para>
-Destroy the <link linkend="gdk-Input-Contexts">Input Context</link>.
-</para></listitem>
-</varlistentry>
-</variablelist>
-
-</para>
-<para>
-See the XLib reference manual for more detailed information on input methods,
-and the #GtkEntry and #GtkText widgets for some example code.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-<variablelist>
-<varlistentry>
-<term><link linkend="gdk-Input-Contexts">Input Contexts</link></term>
-<listitem><para>
-Used for each widget that handles internationalized text input using the
-global input method.
-</para></listitem>
-</varlistentry>
-</variablelist>
-
-</para>
-
diff --git a/docs/reference/gtk/tmpl/gtkarg.sgml b/docs/reference/gtk/tmpl/gtkarg.sgml
deleted file mode 100644
index 7c2d95061..000000000
--- a/docs/reference/gtk/tmpl/gtkarg.sgml
+++ /dev/null
@@ -1,43 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-Implementation of Object Properties
-
-<!-- ##### SECTION Short_Description ##### -->
-Utility function to manipulate lists of named, typed arguments.
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-All the functions in here are marked a Non-public.
-We describe it anyway because it is occasionally useful
-to understand how the work is done.
-</para>
-<para>
-Arguments are a way of describing a named parameter to a function.
-They have two important roles within gtk+:
-<itemizedlist>
-<listitem>
-<para>
-they describe <wordasword>object properties</wordasword>.
-This means that they present an interface to get and set a named-type
-for any type of object in a consistent way.
-(All the relevant functions to do this start with gtk_object_set
-or gtk_object_get).
-</para>
-</listitem>
-<listitem>
-<para>
-they describe <wordasword>signal arguments</wordasword>.
-This is a lot less often needed but still useful.
-Usually if you are just emitting or creating a particular signal
-it is more convenient to just use gtk_signal_emit() or gtk_signal_new().
-However if you are writing a function to emit or create an arbitrary
-signal, you must use gtk_signal_emitv() or gtk_signal_newv().
-</para>
-</listitem>
-</itemizedlist>
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-#GtkObject.
-</para>
-
diff --git a/docs/reference/gtk/tmpl/gtkcellrenderertextpixbuf.sgml b/docs/reference/gtk/tmpl/gtkcellrenderertextpixbuf.sgml
deleted file mode 100644
index 7350e49a1..000000000
--- a/docs/reference/gtk/tmpl/gtkcellrenderertextpixbuf.sgml
+++ /dev/null
@@ -1,16 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkCellRendererTextPixbuf
-
-<!-- ##### SECTION Short_Description ##### -->
-
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
diff --git a/docs/reference/gtk/tmpl/gtkdata.sgml b/docs/reference/gtk/tmpl/gtkdata.sgml
deleted file mode 100644
index 09e9d453c..000000000
--- a/docs/reference/gtk/tmpl/gtkdata.sgml
+++ /dev/null
@@ -1,24 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkData
-
-<!-- ##### SECTION Short_Description ##### -->
-abstract base class for objects containing data.
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-The #GtkData object is a very simple object intended to be used as a base
-class for objects which contain data (i.e. the 'Model' in the object-oriented
-Model/View/Controller framework).
-</para>
-<para>
-Currently it is not very useful since all it provides is a "disconnect" signal.
-This signal could be emitted by a #GtkData subclass to notify any 'Views'
-that they should disconnect from the #GtkData (the 'Model'), possibly just
-before the #GtkData is destroyed.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-