+2002-12-17 Matthias Clasen <maclas@gmx.de>
+
+ * gtk/gtkcontainer.c: Fix a few doc comments.
+
2002-12-17 Tor Lillqvist <tml@iki.fi>
* gdk/win32/gdkglobals-win32.c: Minor cosmetics.
+2002-12-17 Matthias Clasen <maclas@gmx.de>
+
+ * gtk/gtkcontainer.c: Fix a few doc comments.
+
2002-12-17 Tor Lillqvist <tml@iki.fi>
* gdk/win32/gdkglobals-win32.c: Minor cosmetics.
+2002-12-17 Matthias Clasen <maclas@gmx.de>
+
+ * gtk/gtkcontainer.c: Fix a few doc comments.
+
2002-12-17 Tor Lillqvist <tml@iki.fi>
* gdk/win32/gdkglobals-win32.c: Minor cosmetics.
+2002-12-17 Matthias Clasen <maclas@gmx.de>
+
+ * gtk/gtkcontainer.c: Fix a few doc comments.
+
2002-12-17 Tor Lillqvist <tml@iki.fi>
* gdk/win32/gdkglobals-win32.c: Minor cosmetics.
+2002-12-17 Matthias Clasen <maclas@gmx.de>
+
+ * gtk/gtkcontainer.c: Fix a few doc comments.
+
2002-12-17 Tor Lillqvist <tml@iki.fi>
* gdk/win32/gdkglobals-win32.c: Minor cosmetics.
+2002-12-17 Matthias Clasen <maclas@gmx.de>
+
+ * gtk/gtkcontainer.c: Fix a few doc comments.
+
2002-12-17 Tor Lillqvist <tml@iki.fi>
* gdk/win32/gdkglobals-win32.c: Minor cosmetics.
+2002-12-17 Matthias Clasen <maclas@gmx.de>
+
+ * gtk/tmpl/gtkrc.sgml: Link to style properties.
+
+ * gtk/tmpl/gtkcontainer.sgml: Add bits about child properties.
+
+ * gtk/tmpl/gtkwidget.sgml: Add bits about style properties.
+
+ * gdk/tmpl/pixmaps.sgml:
+ * gdk/tmpl/windows.sgml:
+ * gdk/tmpl/drawing.sgml:
+ * gdk/tmpl/gcs.sgml:
+ * gtk/tmpl/gtktextview.sgml:
+ * gtk/tmpl/gtkrc.sgml:
+ * gtk/tmpl/gtkiconfactory.sgml:
+ * gtk/tmpl/gtkaccelgroup.sgml: Remove ids which are now
+ generated by gtk-doc.
+
2002-12-16 Matthias Clasen <maclas@gmx.de>
* gtk/tmpl/gtkradiomenuitem.sgml:
</para>
<!-- ##### STRUCT GdkDrawable ##### -->
-<para><anchor id="GdkDrawable"/>
+<para>
An opaque structure representing an object that can be
drawn onto. This can be a #GdkPixmap, a #GdkBitmap,
or a #GdkWindow.
</para>
<!-- ##### STRUCT GdkGC ##### -->
-<para><anchor id="GdkGC"/>
+<para>
The #GdkGC structure represents a graphics context.
It is an opaque structure with no user-visible
elements.
</para>
<!-- ##### STRUCT GdkPixmap ##### -->
-<para><anchor id="GdkPixmap"/>
+<para>
An opaque structure representing an offscreen drawable.
Pointers to structures of type #GdkPixmap, #GdkBitmap,
and #GdkWindow, can often be used interchangeably.
</para>
<!-- ##### STRUCT GdkWindow ##### -->
-<para><anchor id="GdkWindow"/>
+<para>
An opaque structure representing an onscreen drawable.
Pointers to structures of type #GdkPixmap, #GdkBitmap,
and #GdkWindow, can often be used interchangeably.
Groups of global keyboard accelerators for an entire GtkWindow
<!-- ##### SECTION Long_Description ##### -->
-<para id="GtkAccelGroup">
+<para>
A #GtkAccelGroup represents a group of keyboard accelerators,
typically attached to a toplevel #GtkWindow (with
gtk_window_add_accel_group()). Usually you won't need to create a
Base class for widgets which contain other widgets
<!-- ##### SECTION Long_Description ##### -->
-<para>
-
+<para id="child-properties">
+<structname>GtkContainer</structname> introduces <firstterm>child
+properties</firstterm> - these are object properties that are not specific
+to either the container or the contained widget, but rather to their relation.
+Typical examples of child properties are the position or pack-type of a widget
+which is contained in a #GtkBox.</para>
+<para>
+Use gtk_container_class_install_child_property() to install child properties
+for a container class and gtk_container_class_find_child_property() or
+gtk_container_class_list_child_properties() to get information about existing
+child properties. To set the value of a child property, use
+gtk_container_child_set_property(), gtk_container_child_set() or
+gtk_container_child_set_valist(). To obtain the value of a child property,
+use gtk_container_child_get_property(), gtk_container_child_get() or
+gtk_container_child_get_valist().
</para>
<!-- ##### SECTION See_Also ##### -->
<!-- ##### SECTION Long_Description ##### -->
-<para id="GtkIconFactory">
+<para>
Browse the available stock icons in the list of stock IDs found <link
linkend="gtk-Stock-Items">here</link>. You can also use
the <application>gtk-demo</application> application for this purpose.
Routines for handling resource files
<!-- ##### SECTION Long_Description ##### -->
-<para id="GtkRcStyle">
+<para>
GTK+ provides resource file mechanism for configuring
various aspects of the operation of a GTK+ program
at runtime.
<term><literal><replaceable>class</replaceable>::<replaceable>property</replaceable> = <replaceable>value</replaceable></literal></term>
<listitem>
<para>
- Sets a style property for a widget class.
+ Sets a <link linkend="style-property">style property</link> for a widget class.
</para>
</listitem>
</varlistentry>
<!-- ##### STRUCT GtkTextChildAnchor ##### -->
-<para id="GtkTextChildAnchor">
+<para>
A <structname>GtkTextChildAnchor</structname> is a spot in the buffer
where child widgets can be "anchored" (inserted inline, as if they were
characters). The anchor can have multiple widgets anchored, to allow for
Base class for all widgets
<!-- ##### SECTION Long_Description ##### -->
+<para id="style-properties">
+<structname>GtkWidget</structname> introduces <firstterm>style
+properties</firstterm> - these are basically object properties that are stored
+not on the object, but in the style object associated to the widget. Style
+properties are set in <link linkend="gtk-Resource-Files">resource files</link>.
+This mechanism is used for configuring such things as the location of the
+scrollbar arrows through the theme, giving theme authors more control over the
+look of applications without the need to write a theme engine in C.
+</para>
<para>
-
+Use gtk_widget_class_install_style_property() to install style properties for
+a widget class, gtk_widget_class_find_style_property() or
+gtk_widget_class_list_style_properties() to get information about existing
+style properties and gtk_widget_style_get_property(), gtk_widget_style_get() or
+gtk_widget_style_get_valist() to obtain the value of a style property.
</para>
<!-- ##### SECTION See_Also ##### -->
Implementation of this signal is optional.
</para>
+@parent_class:
@activate_signal:
@set_scroll_adjustments_signal:
* gtk_container_child_get_valist:
* @container: a #GtkContainer
* @child: a widget which is a child of @container
- * @first_prop_name: the name of the first property to get
- * @va_list: a %NULL-terminated list of property names and #GValue*,
+ * @first_property_name: the name of the first property to get
+ * @var_args: a %NULL-terminated list of property names and #GValue*,
* starting with @first_prop_name.
*
* Gets the values of one or more child properties for @child and @container.
* gtk_container_child_set_valist:
* @container: a #GtkContainer
* @child: a widget which is a child of @container
- * @first_prop_name: the name of the first property to set
- * @va_list: a %NULL-terminated list of property names and values, starting
+ * @first_property_name: the name of the first property to set
+ * @var_args: a %NULL-terminated list of property names and values, starting
* with @first_prop_name.
*
* Sets one or more child properties for @child and @container.