2003-04-13 Matthias Clasen <maclas@gmx.de>
+ * gtk/tmpl/gtkenums.sgml: Additions.
+
+ * gtk/tmpl/gtkvruler.sgml:
+ * gtk/tmpl/gtkhruler.sgml:
+ * gtk/tmpl/gtkgamma.sgml:
+ * gtk/tmpl/gtkcurve.sgml:
+ * gtk/tmpl/gtkruler.sgml: Fix some typos and add some markup.
+
* gtk/gtk-sections.txt: Add a bunch of new functions.
2003-04-09 Matthias Clasen <maclas@gmx.de>
allows direct editing of a curve.
<!-- ##### SECTION Long_Description ##### -->
+<note>
<para>
- NOTE this widget is considered too specialized/little-used for
+ This widget is considered too specialized/little-used for
GTK+, and will in the future be moved to some other package. If
your application needs this widget, feel free to use it, as the
widget does work and is useful in some applications; it's just not
the widget, and it will eventually move out of the GTK+
distribution.
</para>
+</note>
<para>
The #GtkCurve widget allows the user to edit a curve covering a range of
values. It is typically used to fine-tune color balances in graphics
<!-- ##### ENUM GtkExpanderStyle ##### -->
<para>
-
+Used to specify the style of the expanders drawn by a #GtkTreeView.
</para>
-@GTK_EXPANDER_COLLAPSED:
-@GTK_EXPANDER_SEMI_COLLAPSED:
-@GTK_EXPANDER_SEMI_EXPANDED:
-@GTK_EXPANDER_EXPANDED:
+@GTK_EXPANDER_COLLAPSED: The style used for a collapsed subtree.
+@GTK_EXPANDER_SEMI_COLLAPSED: Intermediate style used during animation.
+@GTK_EXPANDER_SEMI_EXPANDED: Intermediate style used during animation.
+@GTK_EXPANDER_EXPANDED: The style used for an expanded subtree.
<!-- ##### ENUM GtkIMPreeditStyle ##### -->
<para>
<!-- ##### ENUM GtkMetricType ##### -->
<para>
-
+Used to indicate which metric is used by a #GtkRuler.
</para>
-@GTK_PIXELS:
-@GTK_INCHES:
-@GTK_CENTIMETERS:
+@GTK_PIXELS: Pixels.
+@GTK_INCHES: Inches.
+@GTK_CENTIMETERS: Centimeters.
<!-- ##### ENUM GtkMovementStep ##### -->
<para>
<!-- ##### ENUM GtkOrientation ##### -->
<para>
-
+Represents the orientation of widgets which can be switched between horizontal
+and vertical orientation on the fly, like #GtkToolbar.
</para>
-@GTK_ORIENTATION_HORIZONTAL:
-@GTK_ORIENTATION_VERTICAL:
+@GTK_ORIENTATION_HORIZONTAL: The widget is in horizontal orientation.
+@GTK_ORIENTATION_VERTICAL: The widget is in vertical orientation.
<!-- ##### ENUM GtkPackType ##### -->
<para>
<!-- ##### ENUM GtkPositionType ##### -->
<para>
-
+Describes which edge of a widget a certain feature is positioned at, e.g. the
+tabs of a #GtkNotebook, the handle of a #GtkHandleBox or the label of a
+#GtkScale.
</para>
-@GTK_POS_LEFT:
-@GTK_POS_RIGHT:
-@GTK_POS_TOP:
-@GTK_POS_BOTTOM:
+@GTK_POS_LEFT: The feature is at the left edge.
+@GTK_POS_RIGHT: The feature is at the right edge.
+@GTK_POS_TOP: The feature is at the top edge.
+@GTK_POS_BOTTOM: The feature is at the bottom edge.
<!-- ##### ENUM GtkPreviewType ##### -->
<para>
<!-- ##### ENUM GtkReliefStyle ##### -->
<para>
-
+Indicated the relief to be drawn around a #GtkButton.
</para>
-@GTK_RELIEF_NORMAL:
-@GTK_RELIEF_HALF:
-@GTK_RELIEF_NONE:
+@GTK_RELIEF_NORMAL: Draw a normal relief.
+@GTK_RELIEF_HALF: A half relief.
+@GTK_RELIEF_NONE: No relief.
<!-- ##### ENUM GtkResizeMode ##### -->
<para>
<!-- ##### ENUM GtkVisibility ##### -->
<para>
-
+Used by #GtkCList and #GtkCTree to indicate whether a row is visible.
</para>
-@GTK_VISIBILITY_NONE:
-@GTK_VISIBILITY_PARTIAL:
-@GTK_VISIBILITY_FULL:
+@GTK_VISIBILITY_NONE: The row is not visible.
+@GTK_VISIBILITY_PARTIAL: The row is partially visible.
+@GTK_VISIBILITY_FULL: The row is fully visible.
<!-- ##### ENUM GtkWindowPosition ##### -->
<para>
a subclass of #GtkCurve for editing gamma curves.
<!-- ##### SECTION Long_Description ##### -->
+<note>
<para>
- NOTE this widget is considered too specialized/little-used for
+ This widget is considered too specialized/little-used for
GTK+, and will in the future be moved to some other package. If
your application needs this widget, feel free to use it, as the
widget does work and is useful in some applications; it's just not
the widget, and it will eventually move out of the GTK+
distribution.
</para>
+</note>
<para>
The #GtkGammaCurve widget is a variant of #GtkCurve specifically for
editing gamma curves, which are used in graphics applications such as the
A horizontal ruler.
<!-- ##### SECTION Long_Description ##### -->
+<note>
<para>
- NOTE this widget is considered too specialized/little-used for
+ This widget is considered too specialized/little-used for
GTK+, and will in the future be moved to some other package. If
your application needs this widget, feel free to use it, as the
widget does work and is useful in some applications; it's just not
the widget, and it will eventually move out of the GTK+
distribution.
</para>
+</note>
<para>
The HRuler widget is a widget arranged horizontally creating a ruler that is
utilized around other widgets such as a text widget. The ruler is used to show
Base class for horizontal or vertical rulers
<!-- ##### SECTION Long_Description ##### -->
+<note>
<para>
- NOTE this widget is considered too specialized/little-used for
+ This widget is considered too specialized/little-used for
GTK+, and will in the future be moved to some other package. If
your application needs this widget, feel free to use it, as the
widget does work and is useful in some applications; it's just not
the widget, and it will eventually move out of the GTK+
distribution.
</para>
+</note>
<para>
The GTKRuler widget is a base class for horizontal and vertical rulers. Rulers
are used to show the mouse pointer's location in a window. The ruler can either
be horizontal or vertical on the window. Within the ruler a small triangle
-indicates the location of the mouse relative to the horixontal or vertical
+indicates the location of the mouse relative to the horizontal or vertical
ruler. See #GtkHRuler to learn how to create a new horizontal ruler. See
#GtkVRuler to learn how to create a new vertical ruler.
</para>
A vertical ruler.
<!-- ##### SECTION Long_Description ##### -->
+<note>
<para>
- NOTE this widget is considered too specialized/little-used for
+ This widget is considered too specialized/little-used for
GTK+, and will in the future be moved to some other package. If
your application needs this widget, feel free to use it, as the
widget does work and is useful in some applications; it's just not
the widget, and it will eventually move out of the GTK+
distribution.
</para>
+</note>
<para>
The VRuler widget is a widget arranged vertically creating a ruler that is
utilized around other widgets such as a text widget. The ruler is used to show