Fix a few doc comments. Link to style properties.

2002-12-17  Matthias Clasen  <maclas@gmx.de>

	* gtk/gtkcontainer.c: Fix a few doc comments.
	* 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.
This commit is contained in:
Matthias Clasen 2002-12-17 02:07:57 +00:00 committed by Matthias Clasen
parent 7ed6dc1da8
commit 5d347cad8e
18 changed files with 84 additions and 15 deletions

View File

@ -1,3 +1,7 @@
2002-12-17 Matthias Clasen <maclas@gmx.de>
* gtk/gtkcontainer.c: Fix a few doc comments.
2002-12-17 Tor Lillqvist <tml@iki.fi> 2002-12-17 Tor Lillqvist <tml@iki.fi>
* gdk/win32/gdkglobals-win32.c: Minor cosmetics. * gdk/win32/gdkglobals-win32.c: Minor cosmetics.

View File

@ -1,3 +1,7 @@
2002-12-17 Matthias Clasen <maclas@gmx.de>
* gtk/gtkcontainer.c: Fix a few doc comments.
2002-12-17 Tor Lillqvist <tml@iki.fi> 2002-12-17 Tor Lillqvist <tml@iki.fi>
* gdk/win32/gdkglobals-win32.c: Minor cosmetics. * gdk/win32/gdkglobals-win32.c: Minor cosmetics.

View File

@ -1,3 +1,7 @@
2002-12-17 Matthias Clasen <maclas@gmx.de>
* gtk/gtkcontainer.c: Fix a few doc comments.
2002-12-17 Tor Lillqvist <tml@iki.fi> 2002-12-17 Tor Lillqvist <tml@iki.fi>
* gdk/win32/gdkglobals-win32.c: Minor cosmetics. * gdk/win32/gdkglobals-win32.c: Minor cosmetics.

View File

@ -1,3 +1,7 @@
2002-12-17 Matthias Clasen <maclas@gmx.de>
* gtk/gtkcontainer.c: Fix a few doc comments.
2002-12-17 Tor Lillqvist <tml@iki.fi> 2002-12-17 Tor Lillqvist <tml@iki.fi>
* gdk/win32/gdkglobals-win32.c: Minor cosmetics. * gdk/win32/gdkglobals-win32.c: Minor cosmetics.

View File

@ -1,3 +1,7 @@
2002-12-17 Matthias Clasen <maclas@gmx.de>
* gtk/gtkcontainer.c: Fix a few doc comments.
2002-12-17 Tor Lillqvist <tml@iki.fi> 2002-12-17 Tor Lillqvist <tml@iki.fi>
* gdk/win32/gdkglobals-win32.c: Minor cosmetics. * gdk/win32/gdkglobals-win32.c: Minor cosmetics.

View File

@ -1,3 +1,7 @@
2002-12-17 Matthias Clasen <maclas@gmx.de>
* gtk/gtkcontainer.c: Fix a few doc comments.
2002-12-17 Tor Lillqvist <tml@iki.fi> 2002-12-17 Tor Lillqvist <tml@iki.fi>
* gdk/win32/gdkglobals-win32.c: Minor cosmetics. * gdk/win32/gdkglobals-win32.c: Minor cosmetics.

View File

@ -1,3 +1,21 @@
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> 2002-12-16 Matthias Clasen <maclas@gmx.de>
* gtk/tmpl/gtkradiomenuitem.sgml: * gtk/tmpl/gtkradiomenuitem.sgml:

View File

@ -26,7 +26,7 @@ more information.
</para> </para>
<!-- ##### STRUCT GdkDrawable ##### --> <!-- ##### STRUCT GdkDrawable ##### -->
<para><anchor id="GdkDrawable"/> <para>
An opaque structure representing an object that can be An opaque structure representing an object that can be
drawn onto. This can be a #GdkPixmap, a #GdkBitmap, drawn onto. This can be a #GdkPixmap, a #GdkBitmap,
or a #GdkWindow. or a #GdkWindow.

View File

@ -31,7 +31,7 @@ be set by the latter method.
</para> </para>
<!-- ##### STRUCT GdkGC ##### --> <!-- ##### STRUCT GdkGC ##### -->
<para><anchor id="GdkGC"/> <para>
The #GdkGC structure represents a graphics context. The #GdkGC structure represents a graphics context.
It is an opaque structure with no user-visible It is an opaque structure with no user-visible
elements. elements.

View File

@ -19,7 +19,7 @@ pixel can be either on or off).
</para> </para>
<!-- ##### STRUCT GdkPixmap ##### --> <!-- ##### STRUCT GdkPixmap ##### -->
<para><anchor id="GdkPixmap"/> <para>
An opaque structure representing an offscreen drawable. An opaque structure representing an offscreen drawable.
Pointers to structures of type #GdkPixmap, #GdkBitmap, Pointers to structures of type #GdkPixmap, #GdkBitmap,
and #GdkWindow, can often be used interchangeably. and #GdkWindow, can often be used interchangeably.

View File

@ -19,7 +19,7 @@ For example, each #GtkButton has a #GdkWindow associated with it.
</para> </para>
<!-- ##### STRUCT GdkWindow ##### --> <!-- ##### STRUCT GdkWindow ##### -->
<para><anchor id="GdkWindow"/> <para>
An opaque structure representing an onscreen drawable. An opaque structure representing an onscreen drawable.
Pointers to structures of type #GdkPixmap, #GdkBitmap, Pointers to structures of type #GdkPixmap, #GdkBitmap,
and #GdkWindow, can often be used interchangeably. and #GdkWindow, can often be used interchangeably.

View File

@ -5,7 +5,7 @@ Accelerator Groups
Groups of global keyboard accelerators for an entire GtkWindow Groups of global keyboard accelerators for an entire GtkWindow
<!-- ##### SECTION Long_Description ##### --> <!-- ##### SECTION Long_Description ##### -->
<para id="GtkAccelGroup"> <para>
A #GtkAccelGroup represents a group of keyboard accelerators, A #GtkAccelGroup represents a group of keyboard accelerators,
typically attached to a toplevel #GtkWindow (with typically attached to a toplevel #GtkWindow (with
gtk_window_add_accel_group()). Usually you won't need to create a gtk_window_add_accel_group()). Usually you won't need to create a

View File

@ -5,8 +5,21 @@ GtkContainer
Base class for widgets which contain other widgets Base class for widgets which contain other widgets
<!-- ##### SECTION Long_Description ##### --> <!-- ##### SECTION Long_Description ##### -->
<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> <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> </para>
<!-- ##### SECTION See_Also ##### --> <!-- ##### SECTION See_Also ##### -->

View File

@ -8,7 +8,7 @@ Manipulating stock icons
<!-- ##### SECTION Long_Description ##### --> <!-- ##### SECTION Long_Description ##### -->
<para id="GtkIconFactory"> <para>
Browse the available stock icons in the list of stock IDs found <link Browse the available stock icons in the list of stock IDs found <link
linkend="gtk-Stock-Items">here</link>. You can also use linkend="gtk-Stock-Items">here</link>. You can also use
the <application>gtk-demo</application> application for this purpose. the <application>gtk-demo</application> application for this purpose.

View File

@ -5,7 +5,7 @@ Resource Files
Routines for handling resource files Routines for handling resource files
<!-- ##### SECTION Long_Description ##### --> <!-- ##### SECTION Long_Description ##### -->
<para id="GtkRcStyle"> <para>
GTK+ provides resource file mechanism for configuring GTK+ provides resource file mechanism for configuring
various aspects of the operation of a GTK+ program various aspects of the operation of a GTK+ program
at runtime. at runtime.
@ -310,7 +310,7 @@ settings</replaceable> }</literal></term>
<term><literal><replaceable>class</replaceable>::<replaceable>property</replaceable> = <replaceable>value</replaceable></literal></term> <term><literal><replaceable>class</replaceable>::<replaceable>property</replaceable> = <replaceable>value</replaceable></literal></term>
<listitem> <listitem>
<para> <para>
Sets a style property for a widget class. Sets a <link linkend="style-property">style property</link> for a widget class.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>

View File

@ -324,7 +324,7 @@ types related to the text widget and how they work together.
<!-- ##### STRUCT GtkTextChildAnchor ##### --> <!-- ##### STRUCT GtkTextChildAnchor ##### -->
<para id="GtkTextChildAnchor"> <para>
A <structname>GtkTextChildAnchor</structname> is a spot in the buffer A <structname>GtkTextChildAnchor</structname> is a spot in the buffer
where child widgets can be "anchored" (inserted inline, as if they were where child widgets can be "anchored" (inserted inline, as if they were
characters). The anchor can have multiple widgets anchored, to allow for characters). The anchor can have multiple widgets anchored, to allow for

View File

@ -5,8 +5,21 @@ GtkWidget
Base class for all widgets Base class for all widgets
<!-- ##### SECTION Long_Description ##### --> <!-- ##### 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> <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> </para>
<!-- ##### SECTION See_Also ##### --> <!-- ##### SECTION See_Also ##### -->
@ -36,6 +49,7 @@ handles the emission.
Implementation of this signal is optional. Implementation of this signal is optional.
</para> </para>
@parent_class:
@activate_signal: @activate_signal:
@set_scroll_adjustments_signal: @set_scroll_adjustments_signal:

View File

@ -338,8 +338,8 @@ container_set_child_property (GtkContainer *container,
* gtk_container_child_get_valist: * gtk_container_child_get_valist:
* @container: a #GtkContainer * @container: a #GtkContainer
* @child: a widget which is a child of @container * @child: a widget which is a child of @container
* @first_prop_name: the name of the first property to get * @first_property_name: the name of the first property to get
* @va_list: a %NULL-terminated list of property names and #GValue*, * @var_args: a %NULL-terminated list of property names and #GValue*,
* starting with @first_prop_name. * starting with @first_prop_name.
* *
* Gets the values of one or more child properties for @child and @container. * Gets the values of one or more child properties for @child and @container.
@ -482,8 +482,8 @@ gtk_container_child_get_property (GtkContainer *container,
* gtk_container_child_set_valist: * gtk_container_child_set_valist:
* @container: a #GtkContainer * @container: a #GtkContainer
* @child: a widget which is a child of @container * @child: a widget which is a child of @container
* @first_prop_name: the name of the first property to set * @first_property_name: the name of the first property to set
* @va_list: a %NULL-terminated list of property names and values, starting * @var_args: a %NULL-terminated list of property names and values, starting
* with @first_prop_name. * with @first_prop_name.
* *
* Sets one or more child properties for @child and @container. * Sets one or more child properties for @child and @container.