Commit 3b3d8ca4 authored by William Jon McCann's avatar William Jon McCann

docs: Use "#" for refsect2 instead of ##

parent c6ef8bdc
...@@ -77,7 +77,7 @@ ...@@ -77,7 +77,7 @@
* be controlling each of these virtual devices. Physical devices may also * be controlling each of these virtual devices. Physical devices may also
* be "floating", which means they are not attached to any virtual device. * be "floating", which means they are not attached to any virtual device.
* *
* ## Master and slave devices * # Master and slave devices
* *
* |[ * |[
* carlos@sacarino:~$ xinput list * carlos@sacarino:~$ xinput list
......
...@@ -69,7 +69,7 @@ ...@@ -69,7 +69,7 @@
* linkend="monitoring-changes">Monitoring changes</link> for additional * linkend="monitoring-changes">Monitoring changes</link> for additional
* details. * details.
* *
* ## Manipulating accelerators * # Manipulating accelerators
* *
* New accelerators can be added using gtk_accel_map_add_entry(). * New accelerators can be added using gtk_accel_map_add_entry().
* To search for specific accelerator, use gtk_accel_map_lookup_entry(). * To search for specific accelerator, use gtk_accel_map_lookup_entry().
...@@ -80,7 +80,7 @@ ...@@ -80,7 +80,7 @@
* locked using gtk_accel_map_lock_path(). Unlocking is done using * locked using gtk_accel_map_lock_path(). Unlocking is done using
* gtk_accel_map_unlock_path(). * gtk_accel_map_unlock_path().
* *
* ## Saving and loading accelerator maps * # Saving and loading accelerator maps
* *
* Accelerator maps can be saved to and loaded from some external * Accelerator maps can be saved to and loaded from some external
* resource. For simple saving and loading from file, * resource. For simple saving and loading from file,
...@@ -88,7 +88,7 @@ ...@@ -88,7 +88,7 @@
* Saving and loading can also be done by providing file descriptor * Saving and loading can also be done by providing file descriptor
* to gtk_accel_map_save_fd() and gtk_accel_map_load_fd(). * to gtk_accel_map_save_fd() and gtk_accel_map_load_fd().
* *
* ## Monitoring changes * # Monitoring changes
* *
* #GtkAccelMap object is only useful for monitoring changes of * #GtkAccelMap object is only useful for monitoring changes of
* accelerators. By connecting to #GtkAccelMap::changed signal, one * accelerators. By connecting to #GtkAccelMap::changed signal, one
......
...@@ -41,7 +41,7 @@ ...@@ -41,7 +41,7 @@
* handling buttons, you can use the #GTK_ASSISTANT_PAGE_CUSTOM page * handling buttons, you can use the #GTK_ASSISTANT_PAGE_CUSTOM page
* type and handle buttons yourself. * type and handle buttons yourself.
* *
* ## GtkAssistant as GtkBuildable * # GtkAssistant as GtkBuildable
* *
* The GtkAssistant implementation of the #GtkBuildable interface * The GtkAssistant implementation of the #GtkBuildable interface
* exposes the @action_area as internal children with the name * exposes the @action_area as internal children with the name
......
...@@ -47,7 +47,7 @@ ...@@ -47,7 +47,7 @@
* with high key binding configurability which requires no application * with high key binding configurability which requires no application
* or toolkit side changes. * or toolkit side changes.
* *
* ## Installing a key binding * # Installing a key binding
* *
* A CSS file binding consists of a 'binding-set' definition and a match * A CSS file binding consists of a 'binding-set' definition and a match
* statement to apply the binding set to specific widget types. Details * statement to apply the binding set to specific widget types. Details
...@@ -68,6 +68,7 @@ ...@@ -68,6 +68,7 @@
* of a #GtkEntry widget to the #GtkEntry::move-cursor signal (so * of a #GtkEntry widget to the #GtkEntry::move-cursor signal (so
* movement occurs in 3-character steps), the following binding can be * movement occurs in 3-character steps), the following binding can be
* used: * used:
*
* |[ * |[
* @binding-set MoveCursor3 * @binding-set MoveCursor3
* { * {
...@@ -80,7 +81,7 @@ ...@@ -80,7 +81,7 @@
* } * }
* ]| * ]|
* *
* ## Unbinding existing key bindings * # Unbinding existing key bindings
* *
* GTK+ already defines a number of useful bindings for the widgets * GTK+ already defines a number of useful bindings for the widgets
* it provides. Because custom bindings set up in CSS files take * it provides. Because custom bindings set up in CSS files take
...@@ -89,6 +90,7 @@ ...@@ -89,6 +90,7 @@
* <link linkend="gtk-bindings-install">Installing a key binding</link> * <link linkend="gtk-bindings-install">Installing a key binding</link>
* works as expected. The same mechanism can not be used to "unbind" * works as expected. The same mechanism can not be used to "unbind"
* existing bindings, however. * existing bindings, however.
*
* |[ * |[
* @binding-set MoveCursor3 * @binding-set MoveCursor3
* { * {
...@@ -100,6 +102,7 @@ ...@@ -100,6 +102,7 @@
* gtk-key-bindings: MoveCursor3; * gtk-key-bindings: MoveCursor3;
* } * }
* ]| * ]|
*
* The above example will not have the desired effect of causing * The above example will not have the desired effect of causing
* "&lt;Control&gt;Right" and "&lt;Control&gt;Left" key presses to * "&lt;Control&gt;Right" and "&lt;Control&gt;Left" key presses to
* be ignored by GTK+. Instead, it just causes any existing bindings * be ignored by GTK+. Instead, it just causes any existing bindings
...@@ -110,6 +113,7 @@ ...@@ -110,6 +113,7 @@
* will eventually lookup and find the default GTK+ bindings for * will eventually lookup and find the default GTK+ bindings for
* entries which implement word movement. To keep GTK+ from activating * entries which implement word movement. To keep GTK+ from activating
* its default bindings, the "unbind" keyword can be used like this: * its default bindings, the "unbind" keyword can be used like this:
*
* |[ * |[
* @binding-set MoveCursor3 * @binding-set MoveCursor3
* { * {
...@@ -121,6 +125,7 @@ ...@@ -121,6 +125,7 @@
* gtk-key-bindings: MoveCursor3; * gtk-key-bindings: MoveCursor3;
* } * }
* ]| * ]|
*
* Now, GTK+ will find a match when looking up "&lt;Control&gt;Right" * Now, GTK+ will find a match when looking up "&lt;Control&gt;Right"
* and "&lt;Control&gt;Left" key presses before it resorts to its default * and "&lt;Control&gt;Left" key presses before it resorts to its default
* bindings, and the match instructs it to abort ("unbind") the search, * bindings, and the match instructs it to abort ("unbind") the search,
......
...@@ -56,7 +56,7 @@ ...@@ -56,7 +56,7 @@
* The function gtk_builder_connect_signals() and variants thereof can be * The function gtk_builder_connect_signals() and variants thereof can be
* used to connect handlers to the named signals in the description. * used to connect handlers to the named signals in the description.
* *
* ## GtkBuilder UI Definitions * # GtkBuilder UI Definitions
* *
* GtkBuilder parses textual descriptions of user interfaces which are * GtkBuilder parses textual descriptions of user interfaces which are
* specified in an XML format which can be roughly described by the * specified in an XML format which can be roughly described by the
...@@ -68,11 +68,13 @@ ...@@ -68,11 +68,13 @@
* are more limited in scope. It is common to use `.ui` * are more limited in scope. It is common to use `.ui`
* as the filename extension for files containing GtkBuilder UI * as the filename extension for files containing GtkBuilder UI
* definitions. * definitions.
*
* |[ * |[
* <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="text" href="../../../../gtk/gtkbuilder.rnc"> * <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="text" href="../../../../gtk/gtkbuilder.rnc">
* <xi:fallback>FIXME: MISSING XINCLUDE CONTENT</xi:fallback> * <xi:fallback>FIXME: MISSING XINCLUDE CONTENT</xi:fallback>
* </xi:include> * </xi:include>
* ]| * ]|
*
* The toplevel element is &lt;interface&gt;. It optionally takes a * The toplevel element is &lt;interface&gt;. It optionally takes a
* "domain" attribute, which will make the builder look for translated * "domain" attribute, which will make the builder look for translated
* strings using dgettext() in the domain specified. This can also be * strings using dgettext() in the domain specified. This can also be
...@@ -163,7 +165,7 @@ ...@@ -163,7 +165,7 @@
* The possible values for the "type" attribute are described in the * The possible values for the "type" attribute are described in the
* sections describing the widget-specific portions of UI definitions. * sections describing the widget-specific portions of UI definitions.
* *
* ## A GtkBuilder UI Definition * # A GtkBuilder UI Definition
* *
* |[ * |[
* <interface> * <interface>
......
...@@ -35,8 +35,8 @@ ...@@ -35,8 +35,8 @@
* Usually users dont have to interact with the #GtkCellArea directly * Usually users dont have to interact with the #GtkCellArea directly
* unless they are implementing a cell-layouting widget themselves. * unless they are implementing a cell-layouting widget themselves.
* *
* ## Requesting area sizes * # Requesting area sizes
* *
* As outlined in <link linkend="geometry-management">GtkWidget's * As outlined in <link linkend="geometry-management">GtkWidget's
* geometry management section</link>, GTK+ uses a height-for-width * geometry management section</link>, GTK+ uses a height-for-width
* geometry management system to compute the sizes of widgets and user * geometry management system to compute the sizes of widgets and user
...@@ -71,6 +71,7 @@ ...@@ -71,6 +71,7 @@
* *
* In order to request the width of all the rows at the root level * In order to request the width of all the rows at the root level
* of a #GtkTreeModel one would do the following: * of a #GtkTreeModel one would do the following:
*
* |[<!-- language="C" --> * |[<!-- language="C" -->
* GtkTreeIter iter; * GtkTreeIter iter;
* gint minimum_width; * gint minimum_width;
...@@ -86,6 +87,7 @@ ...@@ -86,6 +87,7 @@
* } * }
* gtk_cell_area_context_get_preferred_width (context, &minimum_width, &natural_width); * gtk_cell_area_context_get_preferred_width (context, &minimum_width, &natural_width);
* ]| * ]|
*
* Note that in this example it's not important to observe the * Note that in this example it's not important to observe the
* returned minimum and natural width of the area for each row * returned minimum and natural width of the area for each row
* unless the cell-layouting object is actually interested in the * unless the cell-layouting object is actually interested in the
...@@ -104,6 +106,7 @@ ...@@ -104,6 +106,7 @@
* *
* A simple example where rows are rendered from top to bottom and * A simple example where rows are rendered from top to bottom and
* take up the full width of the layouting widget would look like: * take up the full width of the layouting widget would look like:
*
* |[<!-- language="C" --> * |[<!-- language="C" -->
* static void * static void
* foo_get_preferred_width (GtkWidget *widget, * foo_get_preferred_width (GtkWidget *widget,
...@@ -118,6 +121,7 @@ ...@@ -118,6 +121,7 @@
* gtk_cell_area_context_get_preferred_width (priv->context, minimum_size, natural_size); * gtk_cell_area_context_get_preferred_width (priv->context, minimum_size, natural_size);
* } * }
* ]| * ]|
*
* In the above example the Foo widget has to make sure that some * In the above example the Foo widget has to make sure that some
* row sizes have been calculated (the amount of rows that Foo judged * row sizes have been calculated (the amount of rows that Foo judged
* was appropriate to request space for in a single timeout iteration) * was appropriate to request space for in a single timeout iteration)
...@@ -133,6 +137,7 @@ ...@@ -133,6 +137,7 @@
* *
* In order to request the height for width of all the rows at the * In order to request the height for width of all the rows at the
* root level of a #GtkTreeModel one would do the following: * root level of a #GtkTreeModel one would do the following:
*
* |[<!-- language="C" --> * |[<!-- language="C" -->
* GtkTreeIter iter; * GtkTreeIter iter;
* gint minimum_height; * gint minimum_height;
...@@ -156,6 +161,7 @@ ...@@ -156,6 +161,7 @@
* valid = gtk_tree_model_iter_next (model, &iter); * valid = gtk_tree_model_iter_next (model, &iter);
* } * }
* ]| * ]|
*
* Note that in the above example we would need to cache the heights * Note that in the above example we would need to cache the heights
* returned for each row so that we would know what sizes to render the * returned for each row so that we would know what sizes to render the
* areas for each row. However we would only want to really cache the * areas for each row. However we would only want to really cache the
...@@ -176,8 +182,8 @@ ...@@ -176,8 +182,8 @@
* from a scrolled window it simply continues to drive the scrollbar * from a scrolled window it simply continues to drive the scrollbar
* values while more and more height is required for the row heights * values while more and more height is required for the row heights
* that are calculated in the background. * that are calculated in the background.
* *
* ## Rendering Areas * # Rendering Areas
* *
* Once area sizes have been aquired at least for the rows in the * Once area sizes have been aquired at least for the rows in the
* visible area of the layouting widget they can be rendered at * visible area of the layouting widget they can be rendered at
...@@ -185,6 +191,7 @@ ...@@ -185,6 +191,7 @@
* *
* A crude example of how to render all the rows at the root level * A crude example of how to render all the rows at the root level
* runs as follows: * runs as follows:
*
* |[<!-- language="C" --> * |[<!-- language="C" -->
* GtkAllocation allocation; * GtkAllocation allocation;
* GdkRectangle cell_area = { 0, }; * GdkRectangle cell_area = { 0, };
...@@ -209,6 +216,7 @@ ...@@ -209,6 +216,7 @@
* valid = gtk_tree_model_iter_next (model, &iter); * valid = gtk_tree_model_iter_next (model, &iter);
* } * }
* ]| * ]|
*
* Note that the cached height in this example really depends on how * Note that the cached height in this example really depends on how
* the layouting widget works. The layouting widget might decide to * the layouting widget works. The layouting widget might decide to
* give every row its minimum or natural height or, if the model content * give every row its minimum or natural height or, if the model content
...@@ -216,7 +224,7 @@ ...@@ -216,7 +224,7 @@
* would make sense to calculate the allocation for each row at * would make sense to calculate the allocation for each row at
* #GtkWidget::size-allocate time using gtk_distribute_natural_allocation(). * #GtkWidget::size-allocate time using gtk_distribute_natural_allocation().
* *
* ## Handling Events and Driving Keyboard Focus * # Handling Events and Driving Keyboard Focus
* *
* Passing events to the area is as simple as handling events on any * Passing events to the area is as simple as handling events on any
* normal widget and then passing them to the gtk_cell_area_event() * normal widget and then passing them to the gtk_cell_area_event()
...@@ -245,6 +253,7 @@ ...@@ -245,6 +253,7 @@
* *
* A basic example of how the #GtkWidgetClass.focus() virtual method * A basic example of how the #GtkWidgetClass.focus() virtual method
* should be implemented: * should be implemented:
*
* |[<!-- language="C" --> * |[<!-- language="C" -->
* static gboolean * static gboolean
* foo_focus (GtkWidget *widget, * foo_focus (GtkWidget *widget,
...@@ -302,10 +311,11 @@ ...@@ -302,10 +311,11 @@
* return have_focus; * return have_focus;
* } * }
* ]| * ]|
*
* Note that the layouting widget is responsible for matching the * Note that the layouting widget is responsible for matching the
* GtkDirectionType values to the way it lays out its cells. * GtkDirectionType values to the way it lays out its cells.
* *
* ## Cell Properties * # Cell Properties
* *
* The #GtkCellArea introduces cell properties for #GtkCellRenderers * The #GtkCellArea introduces cell properties for #GtkCellRenderers
* in very much the same way that #GtkContainer introduces * in very much the same way that #GtkContainer introduces
......
...@@ -34,7 +34,7 @@ ...@@ -34,7 +34,7 @@
* gtk_cell_layout_set_cell_data_func() that is called to determine the * gtk_cell_layout_set_cell_data_func() that is called to determine the
* value of the attribute for each cell that is rendered. * value of the attribute for each cell that is rendered.
* *
* ## GtkCellLayouts as GtkBuildable * # GtkCellLayouts as GtkBuildable
* *
* Implementations of GtkCellLayout which also implement the GtkBuildable * Implementations of GtkCellLayout which also implement the GtkBuildable
* interface (#GtkCellView, #GtkIconView, #GtkComboBox, * interface (#GtkCellView, #GtkIconView, #GtkComboBox,
...@@ -65,6 +65,7 @@ ...@@ -65,6 +65,7 @@
* &lt;property&gt; elements defined in the normal way. * &lt;property&gt; elements defined in the normal way.
* *
* Here is a UI definition fragment specifying cell properties: * Here is a UI definition fragment specifying cell properties:
*
* |[ * |[
* <object class="GtkTreeViewColumn"> * <object class="GtkTreeViewColumn">
* <child> * <child>
...@@ -77,16 +78,18 @@ ...@@ -77,16 +78,18 @@
* </object> * </object>
* ]| * ]|
* *
* ## Subclassing GtkCellLayout implementations * # Subclassing GtkCellLayout implementations
* *
* When subclassing a widget that implements #GtkCellLayout like * When subclassing a widget that implements #GtkCellLayout like
* #GtkIconView or #GtkComboBox, there are some considerations related * #GtkIconView or #GtkComboBox, there are some considerations related
* to the fact that these widgets internally use a #GtkCellArea. * to the fact that these widgets internally use a #GtkCellArea.
* The cell area is exposed as a construct-only property by these * The cell area is exposed as a construct-only property by these
* widgets. This means that it is possible to e.g. do * widgets. This means that it is possible to e.g. do
*
* |[<!-- language="C" --> * |[<!-- language="C" -->
* combo = g_object_new (GTK_TYPE_COMBO_BOX, "cell-area", my_cell_area, NULL); * combo = g_object_new (GTK_TYPE_COMBO_BOX, "cell-area", my_cell_area, NULL);
* ]| * ]|
*
* to use a custom cell area with a combo box. But construct properties * to use a custom cell area with a combo box. But construct properties
* are only initialized after instance init() * are only initialized after instance init()
* functions have run, which means that using functions which rely on * functions have run, which means that using functions which rely on
...@@ -94,6 +97,7 @@ ...@@ -94,6 +97,7 @@
* cause the default cell area to be instantiated. In this case, a provided * cause the default cell area to be instantiated. In this case, a provided
* construct property value will be ignored (with a warning, to alert * construct property value will be ignored (with a warning, to alert
* you to the problem). * you to the problem).
*
* |[<!-- language="C" --> * |[<!-- language="C" -->
* static void * static void
* my_combo_box_init (MyComboBox *b) * my_combo_box_init (MyComboBox *b)
...@@ -117,6 +121,7 @@ ...@@ -117,6 +121,7 @@
* return g_object_new (MY_TYPE_COMBO_BOX, "cell-area", area, NULL); * return g_object_new (MY_TYPE_COMBO_BOX, "cell-area", area, NULL);
* } * }
* ]| * ]|
*
* If supporting alternative cell areas with your derived widget is * If supporting alternative cell areas with your derived widget is
* not important, then this does not have to concern you. If you want * not important, then this does not have to concern you. If you want
* to support alternative cell areas, you can do so by moving the * to support alternative cell areas, you can do so by moving the
......
...@@ -52,7 +52,7 @@ ...@@ -52,7 +52,7 @@
* You should not call gtk_combo_box_set_model() or attempt to pack more cells * You should not call gtk_combo_box_set_model() or attempt to pack more cells
* into this combo box via its GtkCellLayout interface. * into this combo box via its GtkCellLayout interface.
* *
* ## GtkComboBoxText as GtkBuildable * # GtkComboBoxText as GtkBuildable
* *
* The GtkComboBoxText implementation of the GtkBuildable interface * The GtkComboBoxText implementation of the GtkBuildable interface
* supports adding items directly using the &lt;items&gt; element * supports adding items directly using the &lt;items&gt; element
......
...@@ -78,7 +78,7 @@ ...@@ -78,7 +78,7 @@
* children in a horizontal row, and a #GtkGrid arranges the widgets it contains * children in a horizontal row, and a #GtkGrid arranges the widgets it contains
* in a two-dimensional grid. * in a two-dimensional grid.
* *
* ## Height for width geometry management * # Height for width geometry management
* *
* GTK+ uses a height-for-width (and width-for-height) geometry management system. * GTK+ uses a height-for-width (and width-for-height) geometry management system.
* Height-for-width means that a widget can change how much vertical space it needs, * Height-for-width means that a widget can change how much vertical space it needs,
...@@ -180,7 +180,7 @@ ...@@ -180,7 +180,7 @@
* See <link linkend="geometry-management">GtkWidget's geometry management section</link> * See <link linkend="geometry-management">GtkWidget's geometry management section</link>
* to learn more about implementing height-for-width geometry management for widgets. * to learn more about implementing height-for-width geometry management for widgets.
* *
* ## Child properties * # Child properties
* *
* GtkContainer introduces child properties. * GtkContainer introduces child properties.
* These are object properties that are not specific * These are object properties that are not specific
...@@ -200,7 +200,7 @@ ...@@ -200,7 +200,7 @@
* gtk_container_child_get_valist(). To emit notification about child property * gtk_container_child_get_valist(). To emit notification about child property
* changes, use gtk_widget_child_notify(). * changes, use gtk_widget_child_notify().
* *
* ## GtkContainer as GtkBuildable * # GtkContainer as GtkBuildable
* *
* The GtkContainer implementation of the GtkBuildable interface * The GtkContainer implementation of the GtkBuildable interface
* supports a &lt;packing&gt; element for children, which can * supports a &lt;packing&gt; element for children, which can
......
...@@ -70,8 +70,8 @@ ...@@ -70,8 +70,8 @@
* (see the #GtkSettings:gtk-theme-name setting) and datadir * (see the #GtkSettings:gtk-theme-name setting) and datadir
* is the prefix configured when GTK+ was compiled, unless overridden by the * is the prefix configured when GTK+ was compiled, unless overridden by the
* `GTK_DATA_PREFIX` environment variable. * `GTK_DATA_PREFIX` environment variable.
* *
* ## Style sheets * # Style sheets
* *
* The basic structure of the style sheets understood by this provider is * The basic structure of the style sheets understood by this provider is
* a series of statements, which are either rule sets or '@-rules', separated * a series of statements, which are either rule sets or '@-rules', separated
...@@ -116,6 +116,7 @@ ...@@ -116,6 +116,7 @@
* GtkLabel widgets that are direct children of a GtkNotebook. * GtkLabel widgets that are direct children of a GtkNotebook.
* *
* An example of widget classes and names in selectors: * An example of widget classes and names in selectors:
*
* |[ * |[
* /&ast; Theme labels that are descendants of a window &ast;/ * /&ast; Theme labels that are descendants of a window &ast;/
* GtkWindow GtkLabel { * GtkWindow GtkLabel {
...@@ -219,7 +220,7 @@ ...@@ -219,7 +220,7 @@
* pseudo-classes in CSS. The available pseudo-classes for widget states * pseudo-classes in CSS. The available pseudo-classes for widget states
* are :active, :prelight (or :hover), :insensitive, :selected, :focused * are :active, :prelight (or :hover), :insensitive, :selected, :focused
* and :inconsistent. * and :inconsistent.
* *
* And example for styling specific widget states: * And example for styling specific widget states:
* |[ * |[
* /&ast; Theme active (pressed) buttons &ast;/ * /&ast; Theme active (pressed) buttons &ast;/
...@@ -263,8 +264,8 @@ ...@@ -263,8 +264,8 @@
* sets are merged. As in CSS, rules apply by specificity, so the rules * sets are merged. As in CSS, rules apply by specificity, so the rules
* whose selectors more closely match a widget path will take precedence * whose selectors more closely match a widget path will take precedence
* over the others. * over the others.
* *
* ## &commat; Rules * # &commat; Rules
* *
* GTK+'s CSS supports the &commat;import rule, in order to load another * GTK+'s CSS supports the &commat;import rule, in order to load another
* CSS style sheet in addition to the currently parsed one. * CSS style sheet in addition to the currently parsed one.
...@@ -317,7 +318,7 @@ ...@@ -317,7 +318,7 @@
* } * }
* ]| * ]|
* *
* ## Symbolic colors * # Symbolic colors
* *
* Besides being able to define color names, the CSS parser is also able * Besides being able to define color names, the CSS parser is also able
* to read different color expressions, which can also be nested, providing * to read different color expressions, which can also be nested, providing
...@@ -411,7 +412,7 @@ ...@@ -411,7 +412,7 @@
* </tgroup> * </tgroup>
* </informaltable> * </informaltable>
* *
* ## Gradients * # Gradients
* *
* Linear or radial Gradients can be used as background images. * Linear or radial Gradients can be used as background images.
* *
...@@ -476,7 +477,7 @@ ...@@ -476,7 +477,7 @@
* color-stop (0.2, &commat;yellow), * color-stop (0.2, &commat;yellow),
* color-stop (1, &commat;green))</literallayout> * color-stop (1, &commat;green))</literallayout>
* *
* ## Text shadow * # Text shadow
* *
* A shadow list can be applied to text or symbolic icons, using the CSS3 * A shadow list can be applied to text or symbolic icons, using the CSS3
* text-shadow syntax, as defined in the * text-shadow syntax, as defined in the
...@@ -496,8 +497,8 @@ ...@@ -496,8 +497,8 @@
* always rendered front-back, i.e. the first shadow specified is on top of the * always rendered front-back, i.e. the first shadow specified is on top of the
* others. Shadows can thus overlay each other, but they can never overlay the * others. Shadows can thus overlay each other, but they can never overlay the
* text or icon itself, which is always rendered on top of the shadow layer. * text or icon itself, which is always rendered on top of the shadow layer.
* *
* ## Box shadow * # Box shadow
* *
* Themes can apply shadows on framed elements using the CSS3 box-shadow syntax, * Themes can apply shadows on framed elements using the CSS3 box-shadow syntax,
* as defined in the * as defined in the
...@@ -517,8 +518,8 @@ ...@@ -517,8 +518,8 @@
* of shadow elements in the box-shadow property. Shadows are always rendered * of shadow elements in the box-shadow property. Shadows are always rendered
* front-back, i.e. the first shadow specified is on top of the others, so they may * front-back, i.e. the first shadow specified is on top of the others, so they may
* overlap other boxes or other shadows. * overlap other boxes or other shadows.
* *
* ## Border images * # Border images
* *
* Images and gradients can also be used in slices for the purpose of creating * Images and gradients can also be used in slices for the purpose of creating
* scalable borders. * scalable borders.
...@@ -583,7 +584,7 @@ ...@@ -583,7 +584,7 @@
* This border image was specified with * This border image was specified with
* <literallayout>url("gradient1.png") 10 10 10 10 stretch</literallayout> * <literallayout>url("gradient1.png") 10 10 10 10 stretch</literallayout>
* *
* ## Transitions * # Transitions
* *
* Styles can specify transitions that will be used to create a gradual * Styles can specify transitions that will be used to create a gradual
* change in the appearance when a widget state changes. The following * change in the appearance when a widget state changes. The following
...@@ -595,7 +596,7 @@ ...@@ -595,7 +596,7 @@
* The option after the duration determines the transition function from a * The option after the duration determines the transition function from a
* small set of predefined functions. * small set of predefined functions.
* *
* ## Linear transition * # Linear transition
* *
* ![](linear.png) * ![](linear.png)
* *
...@@ -615,13 +616,13 @@ ...@@ -615,13 +616,13 @@
* *
* ![](ease-out.png) * ![](ease-out.png)
* *
* ## Supported properties * # Supported properties
* *
* Properties are the part that differ the most to common CSS, * Properties are the part that differ the most to common CSS,
* not all properties are supported (some are planned to be * not all properties are supported (some are planned to be
* supported eventually, some others are meaningless or don't * supported eventually, some others are meaningless or don't
* map intuitively in a widget based environment). * map intuitively in a widget based environment).
* *
* The currently supported properties are: * The currently supported properties are:
* <informaltable> * <informaltable>
* <tgroup cols="4"> * <tgroup cols="4">
......
...@@ -128,7 +128,7 @@ ...@@ -128,7 +128,7 @@
* } * }
* ]| * ]|
* *
* ## GtkDialog as GtkBuildable * # GtkDialog as GtkBuildable
* *
* The GtkDialog implementation of the #GtkBuildable interface exposes the * The GtkDialog implementation of the #GtkBuildable interface exposes the
* @vbox and @action_area as internal children with the names "vbox" and * @vbox and @action_area as internal children with the names "vbox" and
......
...@@ -45,7 +45,7 @@ ...@@ -45,7 +45,7 @@
* - The #GtkWidget::realize signal to take any necessary actions * - The #GtkWidget::realize signal to take any necessary actions
* when the widget is instantiated on a particular display. * when the widget is instantiated on a particular display.
* (Create GDK resources in response to this signal.) * (Create GDK resources in response to this signal.)
* *
* - The #GtkWidget::configure-event signal to take any necessary * - The #GtkWidget::configure-event signal to take any necessary
* actions when the widget changes size. * actions when the widget changes size.
* *
......
...@@ -32,7 +32,7 @@ ...@@ -32,7 +32,7 @@
* to add it to the expander. When the expander is toggled, it will take * to add it to the expander. When the expander is toggled, it will take
* care of showing and hiding the child automatically. * care of showing and hiding the child automatically.
* *
* ## Special Usage * # Special Usage
* *
* There are situations in which you may prefer to show and hide the * There are situations in which you may prefer to show and hide the
* expanded widget yourself, such as when you want to actually create * expanded widget yourself, such as when you want to actually create
...@@ -69,7 +69,7 @@ ...@@ -69,7 +69,7 @@
* } * }
* ]| * ]|
* *
* ## GtkExpander as GtkBuildable * # GtkExpander as GtkBuildable
* *
* The GtkExpander implementation of the GtkBuildable interface * The GtkExpander implementation of the GtkBuildable interface
* supports placing a child in the label position by specifying * supports placing a child in the label position by specifying
......
...@@ -55,7 +55,7 @@ ...@@ -55,7 +55,7 @@
* - Volumes: are provided by the underlying filesystem abstraction. They are * - Volumes: are provided by the underlying filesystem abstraction. They are
* the "roots" of the filesystem. * the "roots" of the filesystem.
* *
* ## File Names and Encodings * # File Names and Encodings
* *
* When the user is finished selecting files in a * When the user is finished selecting files in a
* #GtkFileChooser, your program can get the selected names * #GtkFileChooser, your program can get the selected names
...@@ -75,7 +75,7 @@ ...@@ -75,7 +75,7 @@
* to convert filenames into strings that can be passed to GTK+ * to convert filenames into strings that can be passed to GTK+
* widgets. * widgets.
* *
* ## Adding a Preview Widget * # Adding a Preview Widget
* *
* You can add a custom preview widget to a file chooser and then * You can add a custom preview widget to a file chooser and then
* get notification about when the preview needs to be updated. * get notification about when the preview needs to be updated.
...@@ -129,7 +129,7 @@ ...@@ -129,7 +129,7 @@
* } * }
* ]| * ]|
* *
* ## Adding Extra Widgets * # Adding Extra Widgets