summaryrefslogtreecommitdiff
path: root/gtk
diff options
context:
space:
mode:
authorWilliam Jon McCann <william.jon.mccann@gmail.com>2014-02-04 21:00:58 -0500
committerWilliam Jon McCann <william.jon.mccann@gmail.com>2014-02-04 21:00:58 -0500
commit3b3d8ca45697781bf1a191d248a7d9d4cb5ebfe2 (patch)
tree12197053b6fc681aa2ce39258cf2a3b92ee639f5 /gtk
parentc6ef8bdc9c128c4b91a000221a9f4e8e9b525534 (diff)
downloadgtk+-3b3d8ca45697781bf1a191d248a7d9d4cb5ebfe2.tar.gz
docs: Use "#" for refsect2 instead of ##
Diffstat (limited to 'gtk')
-rw-r--r--gtk/gtkaccelmap.c6
-rw-r--r--gtk/gtkassistant.c2
-rw-r--r--gtk/gtkbindings.c9
-rw-r--r--gtk/gtkbuilder.c6
-rw-r--r--gtk/gtkcellarea.c22
-rw-r--r--gtk/gtkcelllayout.c9
-rw-r--r--gtk/gtkcomboboxtext.c2
-rw-r--r--gtk/gtkcontainer.c6
-rw-r--r--gtk/gtkcssprovider.c33
-rw-r--r--gtk/gtkdialog.c2
-rw-r--r--gtk/gtkdrawingarea.c2
-rw-r--r--gtk/gtkexpander.c4
-rw-r--r--gtk/gtkfilechooser.c8
-rw-r--r--gtk/gtkfilefilter.c2
-rw-r--r--gtk/gtkfontchooserdialog.c2
-rw-r--r--gtk/gtkframe.c2
-rw-r--r--gtk/gtkinfobar.c2
-rw-r--r--gtk/gtklabel.c12
-rw-r--r--gtk/gtkliststore.c6
-rw-r--r--gtk/gtkmenuitem.c2
-rw-r--r--gtk/gtkmenushell.c2
-rw-r--r--gtk/gtkmenutoolbutton.c2
-rw-r--r--gtk/gtkmessagedialog.c2
-rw-r--r--gtk/gtknotebook.c2
-rw-r--r--gtk/gtkoverlay.c2
-rw-r--r--gtk/gtkprintoperation.c2
-rw-r--r--gtk/gtkprintunixdialog.c2
-rw-r--r--gtk/gtkscale.c2
-rw-r--r--gtk/gtksizegroup.c2
-rw-r--r--gtk/gtkstylecontext.c2
-rw-r--r--gtk/gtktexttagtable.c2
-rw-r--r--gtk/gtktreestore.c2
-rw-r--r--gtk/gtktreeview.c2
-rw-r--r--gtk/gtkwidget.c6
-rw-r--r--gtk/gtkwindow.c2
35 files changed, 98 insertions, 75 deletions
diff --git a/gtk/gtkaccelmap.c b/gtk/gtkaccelmap.c
index c62753a9ca..d7b77b8783 100644
--- a/gtk/gtkaccelmap.c
+++ b/gtk/gtkaccelmap.c
@@ -69,7 +69,7 @@
* linkend="monitoring-changes">Monitoring changes</link> for additional
* details.
*
- * ## Manipulating accelerators
+ * # Manipulating accelerators
*
* New accelerators can be added using gtk_accel_map_add_entry().
* To search for specific accelerator, use gtk_accel_map_lookup_entry().
@@ -80,7 +80,7 @@
* locked using gtk_accel_map_lock_path(). Unlocking is done using
* 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
* resource. For simple saving and loading from file,
@@ -88,7 +88,7 @@
* Saving and loading can also be done by providing file descriptor
* 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
* accelerators. By connecting to #GtkAccelMap::changed signal, one
diff --git a/gtk/gtkassistant.c b/gtk/gtkassistant.c
index e0b3fe5472..2a8e7d9927 100644
--- a/gtk/gtkassistant.c
+++ b/gtk/gtkassistant.c
@@ -41,7 +41,7 @@
* handling buttons, you can use the #GTK_ASSISTANT_PAGE_CUSTOM page
* type and handle buttons yourself.
*
- * ## GtkAssistant as GtkBuildable
+ * # GtkAssistant as GtkBuildable
*
* The GtkAssistant implementation of the #GtkBuildable interface
* exposes the @action_area as internal children with the name
diff --git a/gtk/gtkbindings.c b/gtk/gtkbindings.c
index 0647491a07..4ad9c9a813 100644
--- a/gtk/gtkbindings.c
+++ b/gtk/gtkbindings.c
@@ -47,7 +47,7 @@
* with high key binding configurability which requires no application
* 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
* statement to apply the binding set to specific widget types. Details
@@ -68,6 +68,7 @@
* of a #GtkEntry widget to the #GtkEntry::move-cursor signal (so
* movement occurs in 3-character steps), the following binding can be
* used:
+ *
* |[
* @binding-set MoveCursor3
* {
@@ -80,7 +81,7 @@
* }
* ]|
*
- * ## Unbinding existing key bindings
+ * # Unbinding existing key bindings
*
* GTK+ already defines a number of useful bindings for the widgets
* it provides. Because custom bindings set up in CSS files take
@@ -89,6 +90,7 @@
* <link linkend="gtk-bindings-install">Installing a key binding</link>
* works as expected. The same mechanism can not be used to "unbind"
* existing bindings, however.
+ *
* |[
* @binding-set MoveCursor3
* {
@@ -100,6 +102,7 @@
* gtk-key-bindings: MoveCursor3;
* }
* ]|
+ *
* The above example will not have the desired effect of causing
* "&lt;Control&gt;Right" and "&lt;Control&gt;Left" key presses to
* be ignored by GTK+. Instead, it just causes any existing bindings
@@ -110,6 +113,7 @@
* will eventually lookup and find the default GTK+ bindings for
* entries which implement word movement. To keep GTK+ from activating
* its default bindings, the "unbind" keyword can be used like this:
+ *
* |[
* @binding-set MoveCursor3
* {
@@ -121,6 +125,7 @@
* gtk-key-bindings: MoveCursor3;
* }
* ]|
+ *
* 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
* bindings, and the match instructs it to abort ("unbind") the search,
diff --git a/gtk/gtkbuilder.c b/gtk/gtkbuilder.c
index a140b0da1a..77504621fd 100644
--- a/gtk/gtkbuilder.c
+++ b/gtk/gtkbuilder.c
@@ -56,7 +56,7 @@
* The function gtk_builder_connect_signals() and variants thereof can be
* 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
* specified in an XML format which can be roughly described by the
@@ -68,11 +68,13 @@
* are more limited in scope. It is common to use `.ui`
* as the filename extension for files containing GtkBuilder UI
* definitions.
+ *
* |[
* <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:include>
* ]|
+ *
* The toplevel element is &lt;interface&gt;. It optionally takes a
* "domain" attribute, which will make the builder look for translated
* strings using dgettext() in the domain specified. This can also be
@@ -163,7 +165,7 @@
* The possible values for the "type" attribute are described in the
* sections describing the widget-specific portions of UI definitions.
*
- * ## A GtkBuilder UI Definition
+ * # A GtkBuilder UI Definition
*
* |[
* <interface>
diff --git a/gtk/gtkcellarea.c b/gtk/gtkcellarea.c
index 8ae91ebc75..2cdca2c250 100644
--- a/gtk/gtkcellarea.c
+++ b/gtk/gtkcellarea.c
@@ -35,8 +35,8 @@
* Usually users dont have to interact with the #GtkCellArea directly
* unless they are implementing a cell-layouting widget themselves.
*
- * ## Requesting area sizes
- *
+ * # Requesting area sizes
+ *
* As outlined in <link linkend="geometry-management">GtkWidget's
* geometry management section</link>, GTK+ uses a height-for-width
* geometry management system to compute the sizes of widgets and user
@@ -71,6 +71,7 @@
*
* In order to request the width of all the rows at the root level
* of a #GtkTreeModel one would do the following:
+ *
* |[<!-- language="C" -->
* GtkTreeIter iter;
* gint minimum_width;
@@ -86,6 +87,7 @@
* }
* gtk_cell_area_context_get_preferred_width (context, &minimum_width, &natural_width);
* ]|
+ *
* Note that in this example it's not important to observe the
* returned minimum and natural width of the area for each row
* unless the cell-layouting object is actually interested in the
@@ -104,6 +106,7 @@
*
* A simple example where rows are rendered from top to bottom and
* take up the full width of the layouting widget would look like:
+ *
* |[<!-- language="C" -->
* static void
* foo_get_preferred_width (GtkWidget *widget,
@@ -118,6 +121,7 @@
* 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
* row sizes have been calculated (the amount of rows that Foo judged
* was appropriate to request space for in a single timeout iteration)
@@ -133,6 +137,7 @@
*
* In order to request the height for width of all the rows at the
* root level of a #GtkTreeModel one would do the following:
+ *
* |[<!-- language="C" -->
* GtkTreeIter iter;
* gint minimum_height;
@@ -156,6 +161,7 @@
* valid = gtk_tree_model_iter_next (model, &iter);
* }
* ]|
+ *
* 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
* areas for each row. However we would only want to really cache the
@@ -176,8 +182,8 @@
* from a scrolled window it simply continues to drive the scrollbar
* values while more and more height is required for the row heights
* that are calculated in the background.
- *
- * ## Rendering Areas
+ *
+ * # Rendering Areas
*
* Once area sizes have been aquired at least for the rows in the
* visible area of the layouting widget they can be rendered at
@@ -185,6 +191,7 @@
*
* A crude example of how to render all the rows at the root level
* runs as follows:
+ *
* |[<!-- language="C" -->
* GtkAllocation allocation;
* GdkRectangle cell_area = { 0, };
@@ -209,6 +216,7 @@
* valid = gtk_tree_model_iter_next (model, &iter);
* }
* ]|
+ *
* Note that the cached height in this example really depends on how
* the layouting widget works. The layouting widget might decide to
* give every row its minimum or natural height or, if the model content
@@ -216,7 +224,7 @@
* would make sense to calculate the allocation for each row at
* #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
* normal widget and then passing them to the gtk_cell_area_event()
@@ -245,6 +253,7 @@
*
* A basic example of how the #GtkWidgetClass.focus() virtual method
* should be implemented:
+ *
* |[<!-- language="C" -->
* static gboolean
* foo_focus (GtkWidget *widget,
@@ -302,10 +311,11 @@
* return have_focus;
* }
* ]|
+ *
* Note that the layouting widget is responsible for matching the
* GtkDirectionType values to the way it lays out its cells.
*
- * ## Cell Properties
+ * # Cell Properties
*
* The #GtkCellArea introduces cell properties for #GtkCellRenderers
* in very much the same way that #GtkContainer introduces
diff --git a/gtk/gtkcelllayout.c b/gtk/gtkcelllayout.c
index 777a32cd38..9a43649ef3 100644
--- a/gtk/gtkcelllayout.c
+++ b/gtk/gtkcelllayout.c
@@ -34,7 +34,7 @@
* gtk_cell_layout_set_cell_data_func() that is called to determine the
* value of the attribute for each cell that is rendered.
*
- * ## GtkCellLayouts as GtkBuildable
+ * # GtkCellLayouts as GtkBuildable
*
* Implementations of GtkCellLayout which also implement the GtkBuildable
* interface (#GtkCellView, #GtkIconView, #GtkComboBox,
@@ -65,6 +65,7 @@
* &lt;property&gt; elements defined in the normal way.
*
* Here is a UI definition fragment specifying cell properties:
+ *
* |[
* <object class="GtkTreeViewColumn">
* <child>
@@ -77,16 +78,18 @@
* </object>
* ]|
*
- * ## Subclassing GtkCellLayout implementations
+ * # Subclassing GtkCellLayout implementations
*
* When subclassing a widget that implements #GtkCellLayout like
* #GtkIconView or #GtkComboBox, there are some considerations related
* to the fact that these widgets internally use a #GtkCellArea.
* The cell area is exposed as a construct-only property by these
* widgets. This means that it is possible to e.g. do
+ *
* |[<!-- language="C" -->
* 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
* are only initialized after instance init()
* functions have run, which means that using functions which rely on
@@ -94,6 +97,7 @@
* cause the default cell area to be instantiated. In this case, a provided
* construct property value will be ignored (with a warning, to alert
* you to the problem).
+ *
* |[<!-- language="C" -->
* static void
* my_combo_box_init (MyComboBox *b)
@@ -117,6 +121,7 @@
* return g_object_new (MY_TYPE_COMBO_BOX, "cell-area", area, NULL);
* }
* ]|
+ *
* If supporting alternative cell areas with your derived widget is
* 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
diff --git a/gtk/gtkcomboboxtext.c b/gtk/gtkcomboboxtext.c
index 3fecdc9497..bff81952d6 100644
--- a/gtk/gtkcomboboxtext.c
+++ b/gtk/gtkcomboboxtext.c
@@ -52,7 +52,7 @@
* You should not call gtk_combo_box_set_model() or attempt to pack more cells
* into this combo box via its GtkCellLayout interface.
*
- * ## GtkComboBoxText as GtkBuildable
+ * # GtkComboBoxText as GtkBuildable
*
* The GtkComboBoxText implementation of the GtkBuildable interface
* supports adding items directly using the &lt;items&gt; element
diff --git a/gtk/gtkcontainer.c b/gtk/gtkcontainer.c
index 805fbb2a20..f719544b5c 100644
--- a/gtk/gtkcontainer.c
+++ b/gtk/gtkcontainer.c
@@ -78,7 +78,7 @@
* children in a horizontal row, and a #GtkGrid arranges the widgets it contains
* 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.
* Height-for-width means that a widget can change how much vertical space it needs,
@@ -180,7 +180,7 @@
* See <link linkend="geometry-management">GtkWidget's geometry management section</link>
* to learn more about implementing height-for-width geometry management for widgets.
*
- * ## Child properties
+ * # Child properties
*
* GtkContainer introduces child properties.
* These are object properties that are not specific
@@ -200,7 +200,7 @@
* gtk_container_child_get_valist(). To emit notification about child property
* changes, use gtk_widget_child_notify().
*
- * ## GtkContainer as GtkBuildable
+ * # GtkContainer as GtkBuildable
*
* The GtkContainer implementation of the GtkBuildable interface
* supports a &lt;packing&gt; element for children, which can
diff --git a/gtk/gtkcssprovider.c b/gtk/gtkcssprovider.c
index f00f22d047..e4db4d3381 100644
--- a/gtk/gtkcssprovider.c
+++ b/gtk/gtkcssprovider.c
@@ -70,8 +70,8 @@
* (see the #GtkSettings:gtk-theme-name setting) and datadir
* is the prefix configured when GTK+ was compiled, unless overridden by the
* `GTK_DATA_PREFIX` environment variable.
- *
- * ## Style sheets
+ *
+ * # Style sheets
*
* The basic structure of the style sheets understood by this provider is
* a series of statements, which are either rule sets or '@-rules', separated
@@ -116,6 +116,7 @@
* GtkLabel widgets that are direct children of a GtkNotebook.
*
* An example of widget classes and names in selectors:
+ *
* |[
* /&ast; Theme labels that are descendants of a window &ast;/
* GtkWindow GtkLabel {
@@ -219,7 +220,7 @@
* pseudo-classes in CSS. The available pseudo-classes for widget states
* are :active, :prelight (or :hover), :insensitive, :selected, :focused
* and :inconsistent.
- *
+ *
* And example for styling specific widget states:
* |[
* /&ast; Theme active (pressed) buttons &ast;/
@@ -263,8 +264,8 @@
* sets are merged. As in CSS, rules apply by specificity, so the rules
* whose selectors more closely match a widget path will take precedence
* over the others.
- *
- * ## &commat; Rules
+ *
+ * # &commat; Rules
*
* GTK+'s CSS supports the &commat;import rule, in order to load another
* CSS style sheet in addition to the currently parsed one.
@@ -317,7 +318,7 @@
* }
* ]|
*
- * ## Symbolic colors
+ * # Symbolic colors
*
* Besides being able to define color names, the CSS parser is also able
* to read different color expressions, which can also be nested, providing
@@ -411,7 +412,7 @@
* </tgroup>
* </informaltable>
*
- * ## Gradients
+ * # Gradients
*
* Linear or radial Gradients can be used as background images.
*
@@ -476,7 +477,7 @@
* color-stop (0.2, &commat;yellow),
* color-stop (1, &commat;green))</literallayout>
*
- * ## Text shadow
+ * # Text shadow
*
* A shadow list can be applied to text or symbolic icons, using the CSS3
* text-shadow syntax, as defined in the
@@ -496,8 +497,8 @@
* 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
* 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,
* as defined in the
@@ -517,8 +518,8 @@
* 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
* overlap other boxes or other shadows.
- *
- * ## Border images
+ *
+ * # Border images
*
* Images and gradients can also be used in slices for the purpose of creating
* scalable borders.
@@ -583,7 +584,7 @@
* This border image was specified with
* <literallayout>url("gradient1.png") 10 10 10 10 stretch</literallayout>
*
- * ## Transitions
+ * # Transitions
*
* Styles can specify transitions that will be used to create a gradual
* change in the appearance when a widget state changes. The following
@@ -595,7 +596,7 @@
* The option after the duration determines the transition function from a
* small set of predefined functions.
*
- * ## Linear transition
+ * # Linear transition
*
* ![](linear.png)
*
@@ -615,13 +616,13 @@
*
* ![](ease-out.png)
*
- * ## Supported properties
+ * # Supported properties
*
* Properties are the part that differ the most to common CSS,
* not all properties are supported (some are planned to be
* supported eventually, some others are meaningless or don't
* map intuitively in a widget based environment).
- *
+ *
* The currently supported properties are:
* <informaltable>
* <tgroup cols="4">
diff --git a/gtk/gtkdialog.c b/gtk/gtkdialog.c
index 49590e2666..adee554b7d 100644
--- a/gtk/gtkdialog.c
+++ b/gtk/gtkdialog.c
@@ -128,7 +128,7 @@
* }
* ]|
*
- * ## GtkDialog as GtkBuildable
+ * # GtkDialog as GtkBuildable
*
* The GtkDialog implementation of the #GtkBuildable interface exposes the
* @vbox and @action_area as internal children with the names "vbox" and
diff --git a/gtk/gtkdrawingarea.c b/gtk/gtkdrawingarea.c
index 79d58928cd..5d341516db 100644
--- a/gtk/gtkdrawingarea.c
+++ b/gtk/gtkdrawingarea.c
@@ -45,7 +45,7 @@
* - The #GtkWidget::realize signal to take any necessary actions
* when the widget is instantiated on a particular display.
* (Create GDK resources in response to this signal.)
- *
+ *
* - The #GtkWidget::configure-event signal to take any necessary
* actions when the widget changes size.
*
diff --git a/gtk/gtkexpander.c b/gtk/gtkexpander.c
index 41c6979095..7df1dda8a1 100644
--- a/gtk/gtkexpander.c
+++ b/gtk/gtkexpander.c
@@ -32,7 +32,7 @@
* to add it to the expander. When the expander is toggled, it will take
* 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
* expanded widget yourself, such as when you want to actually create
@@ -69,7 +69,7 @@
* }
* ]|
*
- * ## GtkExpander as GtkBuildable
+ * # GtkExpander as GtkBuildable
*
* The GtkExpander implementation of the GtkBuildable interface
* supports placing a child in the label position by specifying
diff --git a/gtk/gtkfilechooser.c b/gtk/gtkfilechooser.c
index 3c1ed7542f..40787fbe78 100644
--- a/gtk/gtkfilechooser.c
+++ b/gtk/gtkfilechooser.c
@@ -55,7 +55,7 @@
* - Volumes: are provided by the underlying filesystem abstraction. They are
* the "roots" of the filesystem.
*
- * ## File Names and Encodings
+ * # File Names and Encodings
*
* When the user is finished selecting files in a
* #GtkFileChooser, your program can get the selected names
@@ -75,7 +75,7 @@
* to convert filenames into strings that can be passed to GTK+
* widgets.
*
- * ## Adding a Preview Widget
+ * # Adding a Preview Widget
*
* You can add a custom preview widget to a file chooser and then
* get notification about when the preview needs to be updated.
@@ -129,7 +129,7 @@
* }
* ]|
*
- * ## Adding Extra Widgets
+ * # Adding Extra Widgets
*
* You can add extra widgets to a file chooser to provide options
* that are not present in the default design. For example, you
@@ -150,7 +150,7 @@
* gtk_file_chooser_set_extra_widget (my_file_chooser, toggle);
* }
* ]|
- *
+ *
* If you want to set more than one extra widget in the file
* chooser, you can a container such as a #GtkBox or a #GtkGrid
* and include your widgets in it. Then, set the container as
diff --git a/gtk/gtkfilefilter.c b/gtk/gtkfilefilter.c
index cf57597e06..d02c65bbc2 100644
--- a/gtk/gtkfilefilter.c
+++ b/gtk/gtkfilefilter.c
@@ -38,7 +38,7 @@
* see gtk_file_chooser_add_filter(), but it is also possible
* to manually use a filter on a file with gtk_file_filter_filter().
*
- * ## GtkFileFilter as GtkBuildable
+ * # GtkFileFilter as GtkBuildable
*
* The GtkFileFilter implementation of the GtkBuildable interface
* supports adding rules using the &lt;mime-types&gt;, &lt;patterns&gt;
diff --git a/gtk/gtkfontchooserdialog.c b/gtk/gtkfontchooserdialog.c
index 17c575e978..86cd219db9 100644
--- a/gtk/gtkfontchooserdialog.c
+++ b/gtk/gtkfontchooserdialog.c
@@ -54,7 +54,7 @@ struct _GtkFontChooserDialogPrivate
* The #GtkFontChooserDialog widget is a dialog for selecting a font.
* It implements the #GtkFontChooser interface.
*
- * ## GtkFontChooserDialog as GtkBuildable
+ * # GtkFontChooserDialog as GtkBuildable
*
* The GtkFontChooserDialog implementation of the #GtkBuildable
* interface exposes the buttons with the names "select_button"
diff --git a/gtk/gtkframe.c b/gtk/gtkframe.c
index 32b35a6c5a..3d8b3ad39b 100644
--- a/gtk/gtkframe.c
+++ b/gtk/gtkframe.c
@@ -45,7 +45,7 @@
* top side of the frame. The position of the
* label can be controlled with gtk_frame_set_label_align().
*
- * ## GtkFrame as GtkBuildable
+ * # GtkFrame as GtkBuildable
*
* The GtkFrame implementation of the GtkBuildable interface
* supports placing a child in the label position by specifying
diff --git a/gtk/gtkinfobar.c b/gtk/gtkinfobar.c
index 07fa6d4722..42b01613f2 100644
--- a/gtk/gtkinfobar.c
+++ b/gtk/gtkinfobar.c
@@ -98,7 +98,7 @@
* gtk_widget_show (info_bar);
* ]|
*
- * ## GtkInfoBar as GtkBuildable
+ * # GtkInfoBar as GtkBuildable
*
* The GtkInfoBar implementation of the GtkBuildable interface exposes
* the content area and action area as internal children with the names
diff --git a/gtk/gtklabel.c b/gtk/gtklabel.c
index ca846faa04..3a6422cb95 100644
--- a/gtk/gtklabel.c
+++ b/gtk/gtklabel.c
@@ -67,7 +67,7 @@
* implies, most labels are used to label another widget such as a
* #GtkButton, a #GtkMenuItem, or a #GtkComboBox.
*
- * ## GtkLabel as GtkBuildable
+ * # GtkLabel as GtkBuildable
*
* The GtkLabel implementation of the GtkBuildable interface supports a
* custom &lt;attributes&gt; element, which supports any number of &lt;attribute&gt;
@@ -90,7 +90,7 @@
* sense with translatable attributes. Use markup embedded in the translatable
* content instead.
*
- * ## Mnemonics
+ * # Mnemonics
*
* Labels may contain “mnemonics”. Mnemonics are
* underlined characters in the label, used for keyboard navigation.
@@ -131,7 +131,7 @@
* gtk_label_set_mnemonic_widget (GTK_LABEL (label), entry);
* ]|
*
- * ## Markup (styled text)
+ * # Markup (styled text)
*
* To make it easy to format text in a label (changing colors,
* fonts, etc.), label text can be provided in a simple <link
@@ -162,14 +162,14 @@
* end_index for a #PangoAttribute requires knowledge of the exact string
* being displayed, so translations will cause problems.
*
- * ## Selectable labels
+ * # Selectable labels
*
* Labels can be made selectable with gtk_label_set_selectable().
* Selectable labels allow the user to copy the label contents to
* the clipboard. Only labels that contain useful-to-copy information
* &mdash; such as error messages &mdash; should be made selectable.
*
- * ## Text layout
+ * # Text layout
*
* A label can contain any number of paragraphs, but will have
* performance problems if it contains more than a small number.
@@ -196,7 +196,7 @@
* #GtkLabel:max-width-chars has changed a bit with the introduction of
* <link linkend="geometry-management">width-for-height geometry management.</link>
*
- * ## Links
+ * # Links
*
* Since 2.18, GTK+ supports markup for clickable hyperlinks in addition
* to regular Pango markup. The markup for links is borrowed from HTML, using the
diff --git a/gtk/gtkliststore.c b/gtk/gtkliststore.c
index 46e3ab891e..a52c5b85d3 100644
--- a/gtk/gtkliststore.c
+++ b/gtk/gtkliststore.c
@@ -105,7 +105,7 @@
* }
* ]|
*
- * ## Performance Considerations
+ * # Performance Considerations
*
* Internally, the #GtkListStore was implemented with a linked list with
* a tail pointer prior to GTK+ 2.6. As a result, it was fast at data
@@ -115,7 +115,7 @@
* access to a particular row is needed often and your code is expected to
* run on older versions of GTK+, it is worth keeping the iter around.
*
- * ## Atomic Operations
+ * # Atomic Operations
*
* It is important to note that only the methods
* gtk_list_store_insert_with_values() and gtk_list_store_insert_with_valuesv()
@@ -132,7 +132,7 @@
* #GtkTreeModelFilterVisibleFunc to be visited with an empty row first; the
* function must be prepared for that.
*
- * ## GtkListStore as GtkBuildable
+ * # GtkListStore as GtkBuildable
*
* The GtkListStore implementation of the GtkBuildable interface allows
* to specify the model columns with a &lt;columns&gt; element that may
diff --git a/gtk/gtkmenuitem.c b/gtk/gtkmenuitem.c
index 6d365c161d..0bdd589312 100644
--- a/gtk/gtkmenuitem.c
+++ b/gtk/gtkmenuitem.c
@@ -71,7 +71,7 @@
* gtk_accel_label_set_accel (GTK_ACCEL_LABEL (child), GDK_KEY_1, 0);
* ]|
*
- * ## GtkMenuItem as GtkBuildable
+ * # GtkMenuItem as GtkBuildable
*
* The GtkMenuItem implementation of the #GtkBuildable interface
* supports adding a submenu by specifying "submenu" as the "type"
diff --git a/gtk/gtkmenushell.c b/gtk/gtkmenushell.c
index e1eb806334..168ce56577 100644
--- a/gtk/gtkmenushell.c
+++ b/gtk/gtkmenushell.c
@@ -35,7 +35,7 @@
* user to perform application functions. A #GtkMenuItem can have a
* submenu associated with it, allowing for nested hierarchical menus.
*
- * ## Terminology
+ * # Terminology
*
* A menu item can be "selected", this means that it is displayed
* in the prelight state, and if it has a submenu, that submenu
diff --git a/gtk/gtkmenutoolbutton.c b/gtk/gtkmenutoolbutton.c
index 6269a83a38..3d6e833274 100644
--- a/gtk/gtkmenutoolbutton.c
+++ b/gtk/gtkmenutoolbutton.c
@@ -48,7 +48,7 @@
* Use gtk_menu_tool_button_new() to create a new
* #GtkMenuToolButton.
*
- * ## GtkMenuToolButton as GtkBuildable
+ * # GtkMenuToolButton as GtkBuildable
*
* The GtkMenuToolButton implementation of the GtkBuildable interface
* supports adding a menu by specifying "menu" as the "type"
diff --git a/gtk/gtkmessagedialog.c b/gtk/gtkmessagedialog.c
index 2c96334955..53491e203e 100644
--- a/gtk/gtkmessagedialog.c
+++ b/gtk/gtkmessagedialog.c
@@ -87,7 +87,7 @@
* dialog);
* ]|
*
- * ## GtkMessageDialog as GtkBuildable
+ * # GtkMessageDialog as GtkBuildable
*
* The GtkMessageDialog implementation of the GtkBuildable interface exposes
* the message area as an internal child with the name "message_area".
diff --git a/gtk/gtknotebook.c b/gtk/gtknotebook.c
index 1092ab0d2b..70b9dfc725 100644
--- a/gtk/gtknotebook.c
+++ b/gtk/gtknotebook.c
@@ -64,7 +64,7 @@
* will be a popup menu allowing the users to switch pages.
* (see gtk_notebook_popup_enable(), gtk_notebook_popup_disable())
*
- * ## GtkNotebook as GtkBuildable
+ * # GtkNotebook as GtkBuildable
*
* The GtkNotebook implementation of the #GtkBuildable interface
* supports placing children into tabs by specifying "tab" as the
diff --git a/gtk/gtkoverlay.c b/gtk/gtkoverlay.c
index eea5ac25f6..9e3f40d5c3 100644
--- a/gtk/gtkoverlay.c
+++ b/gtk/gtkoverlay.c
@@ -46,7 +46,7 @@
* More complicated placement of overlays is possible by connecting
* to the #GtkOverlay::get-child-position signal.
*
- * ## GtkOverlay as GtkBuildable
+ * # GtkOverlay as GtkBuildable
*
* The GtkOverlay implementation of the GtkBuildable interface
* supports placing a child as an overlay by specifying "overlay" as
diff --git a/gtk/gtkprintoperation.c b/gtk/gtkprintoperation.c
index 30195a9a4e..f464e86551 100644
--- a/gtk/gtkprintoperation.c
+++ b/gtk/gtkprintoperation.c
@@ -59,7 +59,7 @@
* #GtkPrintOperation::draw-page, which you are supposed to catch
* and render the page on the provided #GtkPrintContext using Cairo.
*
- * ## The high-level printing API
+ * # The high-level printing API
*
* |[<!-- language="C" -->
* static GtkPrintSettings *settings = NULL;
diff --git a/gtk/gtkprintunixdialog.c b/gtk/gtkprintunixdialog.c
index a9b115c293..77e5bf8969 100644
--- a/gtk/gtkprintunixdialog.c
+++ b/gtk/gtkprintunixdialog.c
@@ -82,7 +82,7 @@
*
* Printing support was added in GTK+ 2.10.
*
- * ## GtkPrintUnixDialog as GtkBuildable
+ * # GtkPrintUnixDialog as GtkBuildable
*
* The GtkPrintUnixDialog implementation of the GtkBuildable interface exposes its
* @notebook internal children with the name "notebook".
diff --git a/gtk/gtkscale.c b/gtk/gtkscale.c
index 589b106ee0..ef703bc819 100644
--- a/gtk/gtkscale.c
+++ b/gtk/gtkscale.c
@@ -61,7 +61,7 @@
* applications that want to show an undeterminate value on the scale, without
* changing the layout of the application (such as movie or music players).
*
- * ## GtkScale as GtkBuildable
+ * # GtkScale as GtkBuildable
*
* GtkScale supports a custom &lt;marks&gt; element, which
* can contain multiple &lt;mark&gt; elements. The "value" and "position"
diff --git a/gtk/gtksizegroup.c b/gtk/gtksizegroup.c
index 11786694df..86984c22cc 100644
--- a/gtk/gtksizegroup.c
+++ b/gtk/gtksizegroup.c
@@ -82,7 +82,7 @@
* by way of #GtkLabel:width-chars for instance. Widgets with static sizes as well
* as widgets that grow (such as ellipsizing text) need no such considerations.
*
- * ## GtkSizeGroup as GtkBuildable
+ * # GtkSizeGroup as GtkBuildable
*
* Size groups can be specified in a UI definition by placing an
* &lt;object&gt; element with `class="GtkSizeGroup"`
diff --git a/gtk/gtkstylecontext.c b/gtk/gtkstylecontext.c
index 552802bae6..eda92b3945 100644
--- a/gtk/gtkstylecontext.c
+++ b/gtk/gtkstylecontext.c
@@ -219,7 +219,7 @@
* </tgroup>
* </informaltable>
*
- * ## Custom styling in UI libraries and applications
+ * # Custom styling in UI libraries and applications
*
* If you are developing a library with custom #GtkWidget<!-- -->s that
* render differently than standard components, you may need to add a
diff --git a/gtk/gtktexttagtable.c b/gtk/gtktexttagtable.c
index 4032af04c2..15cdee4400 100644
--- a/gtk/gtktexttagtable.c
+++ b/gtk/gtktexttagtable.c
@@ -44,7 +44,7 @@
* conceptual overview</link> which gives an overview of all the objects and
* data types related to the text widget and how they work together.
*
- * ## GtkTextTagTables as GtkBuildable
+ * # GtkTextTagTables as GtkBuildable
*
* The GtkTextTagTable implementation of the GtkBuildable interface
* supports adding tags by specifying "tag" as the "type"
diff --git a/gtk/gtktreestore.c b/gtk/gtktreestore.c
index a9242f56bf..a1aa611809 100644
--- a/gtk/gtktreestore.c
+++ b/gtk/gtktreestore.c
@@ -41,7 +41,7 @@
* <link linkend="gtk3-GtkTreeView-drag-and-drop">drag and drop</link>
* interfaces.
*
- * ## GtkTreeStore as GtkBuildable
+ * # GtkTreeStore as GtkBuildable
*
* The GtkTreeStore implementation of the #GtkBuildable interface allows
* to specify the model columns with a &lt;columns&gt; element that may
diff --git a/gtk/gtktreeview.c b/gtk/gtktreeview.c
index a119e0d414..bba913bf19 100644
--- a/gtk/gtktreeview.c
+++ b/gtk/gtktreeview.c
@@ -95,7 +95,7 @@
* (and vice versa), for the latter gtk_tree_view_convert_bin_window_to_tree_coords()
* (and vice versa).
*
- * ## GtkTreeView as GtkBuildable
+ * # GtkTreeView as GtkBuildable
*
* The GtkTreeView implementation of the GtkBuildable interface accepts
* #GtkTreeViewColumn objects as &lt;child&gt; elements and exposes the
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index d8c46ec75a..d9fd94769e 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -239,7 +239,7 @@
* If this has a value other than -1 you need to align the widget such that the baseline
* appears at the position.
*
- * ## Style Properties
+ * # Style Properties
*
* #GtkWidget introduces “style
* properties” - these are basically object properties that are stored
@@ -255,7 +255,7 @@
* 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.
*
- * ## GtkWidget as GtkBuildable
+ * # GtkWidget as GtkBuildable
*
* The GtkWidget implementation of the GtkBuildable interface supports a
* custom &lt;accelerator&gt; element, which has attributes named key,
@@ -302,7 +302,7 @@
* </object>
* ]|
*
- * ## Building composite widgets from template XML
+ * # Building composite widgets from template XML
*
* GtkWidget exposes some facilities to automate the proceedure
* of creating composite widgets using #GtkBuilder interface description
diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c
index cf65f34d96..b11c61d796 100644
--- a/gtk/gtkwindow.c
+++ b/gtk/gtkwindow.c
@@ -89,7 +89,7 @@
* control whether a window has a resize grip, use
* gtk_window_set_has_resize_grip().
*
- * ## GtkWindow as GtkBuildable
+ * # GtkWindow as GtkBuildable
*
* The GtkWindow implementation of the GtkBuildable interface supports a
* custom `&lt;accel-groups&gt;` element, which supports