+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,
<!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">
</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;
&gdk-pixbuf-animation;
&GdkPixbufLoader;
+ &module_interface;
&gdk-pixbuf-gdk-pixbuf-xlib-init;
&gdk-pixbuf-gdk-pixbuf-xlib-rendering;
Module Interface
<!-- ##### SECTION Short_Description ##### -->
-
+extending &gdk-pixbuf;
<!-- ##### SECTION Long_Description ##### -->
<para>
+++ /dev/null
-<!-- ##### 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:
-
-
+++ /dev/null
-<!-- ##### 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>
-
+++ /dev/null
-<!-- ##### 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>
-
+++ /dev/null
-<!-- ##### 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>
-
+++ /dev/null
-<!-- ##### SECTION Title ##### -->
-GtkCellRendererTextPixbuf
-
-<!-- ##### SECTION Short_Description ##### -->
-
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
+++ /dev/null
-<!-- ##### 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>
-
projects / ~andy / gtk / commitdiff