RubyGems - gdk3 - Versions diffs - 2.0.2-x86-mingw32 → 2.0.3-x86-mingw32 - Mend

gdk3 2.0.2-x86-mingw32 → 2.0.3-x86-mingw32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (939) hide show

data/vendor/local/share/gtk-doc/html/gtk3/GtkAssistant.html CHANGED

@@ -2,26 +2,19 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>GtkAssistant</title>
+<title>GTK+ 3 Reference Manual: GtkAssistant</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
 <link rel="up" href="WindowWidgets.html" title="Windows">
 <link rel="prev" href="GtkAboutDialog.html" title="GtkAboutDialog">
-<link rel="next" href="GtkOffscreenWindow.html" title="GtkOffscreenWindow">
-<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
+<link rel="next" href="GtkWindow.html" title="GtkWindow">
+<meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
-<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
-<tr valign="middle">
-<td><a accesskey="p" href="GtkAboutDialog.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
-<td><a accesskey="u" href="WindowWidgets.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
-<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
-<th width="100%" align="center">GTK+ 3 Reference Manual</th>
-<td><a accesskey="n" href="GtkOffscreenWindow.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
-</tr>
-<tr><td colspan="5" class="shortcuts">
-<a href="#GtkAssistant.synopsis" class="shortcut">Top</a>
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
+<td width="100%" align="left">
+<a href="#" class="shortcut">Top</a>
                    |
                   <a href="#GtkAssistant.description" class="shortcut">Description</a>
                    |
@@ -34,8 +27,12 @@
                   <a href="#GtkAssistant.style-properties" class="shortcut">Style Properties</a>
                    |
                   <a href="#GtkAssistant.signals" class="shortcut">Signals</a>
-</td></tr>
-</table>
+</td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
+<td><a accesskey="u" href="WindowWidgets.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
+<td><a accesskey="p" href="GtkAboutDialog.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
+<td><a accesskey="n" href="GtkWindow.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
+</tr></table>
 <div class="refentry">
 <a name="GtkAssistant"></a><div class="titlepage"></div>
 <div class="refnamediv"><table width="100%"><tr>
@@ -772,7 +769,7 @@ Gets the title for <em class="parameter"><code>page</code></em>.
 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_assistant_set_page_header_image (<em class="parameter"><code><a class="link" href="GtkAssistant.html" title="GtkAssistant"><span class="type">GtkAssistant</span></a> *assistant</code></em>,
                                                          <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *page</code></em>,
                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre>
-<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
+<div class="warning">
 <h3 class="title">Warning</h3>
 <p><code class="literal">gtk_assistant_set_page_header_image</code> has been deprecated since version 3.2 and should not be used in newly-written code. Since GTK+ 3.2, a header is no longer shown;
     add your header decoration to the page content instead.</p>
@@ -810,7 +807,7 @@ Sets a header image for <em class="parameter"><code>page</code></em>.
 <a name="gtk-assistant-get-page-header-image"></a><h3>gtk_assistant_get_page_header_image ()</h3>
 <pre class="programlisting"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *         gtk_assistant_get_page_header_image (<em class="parameter"><code><a class="link" href="GtkAssistant.html" title="GtkAssistant"><span class="type">GtkAssistant</span></a> *assistant</code></em>,
                                                          <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *page</code></em>);</pre>
-<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
+<div class="warning">
 <h3 class="title">Warning</h3>
 <p><code class="literal">gtk_assistant_get_page_header_image</code> has been deprecated since version 3.2 and should not be used in newly-written code. Since GTK+ 3.2, a header is no longer shown;
     add your header decoration to the page content instead.</p>
@@ -850,7 +847,7 @@ or <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-d
 <pre class="programlisting"><span class="returnvalue">void</span>                gtk_assistant_set_page_side_image   (<em class="parameter"><code><a class="link" href="GtkAssistant.html" title="GtkAssistant"><span class="type">GtkAssistant</span></a> *assistant</code></em>,
                                                          <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *page</code></em>,
                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>);</pre>
-<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
+<div class="warning">
 <h3 class="title">Warning</h3>
 <p><code class="literal">gtk_assistant_set_page_side_image</code> has been deprecated since version 3.2 and should not be used in newly-written code. Since GTK+ 3.2, sidebar images are not
     shown anymore.</p>
@@ -892,7 +889,7 @@ when <em class="parameter"><code>page</code></em> is the current page.
 <a name="gtk-assistant-get-page-side-image"></a><h3>gtk_assistant_get_page_side_image ()</h3>
 <pre class="programlisting"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *         gtk_assistant_get_page_side_image   (<em class="parameter"><code><a class="link" href="GtkAssistant.html" title="GtkAssistant"><span class="type">GtkAssistant</span></a> *assistant</code></em>,
                                                          <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *page</code></em>);</pre>
-<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
+<div class="warning">
 <h3 class="title">Warning</h3>
 <p><code class="literal">gtk_assistant_get_page_side_image</code> has been deprecated since version 3.2 and should not be used in newly-written code. Since GTK+ 3.2, sidebar images are not
     shown anymore.</p>
@@ -1185,7 +1182,7 @@ this information to control the sensitivity of the navigation buttons.
 <div class="refsect2">
 <a name="GtkAssistant--c-header-image"></a><h3>The <code class="literal">"header-image"</code> child property</h3>
 <pre class="programlisting">  "header-image"             <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>*            : Read / Write</pre>
-<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
+<div class="warning">
 <h3 class="title">Warning</h3>
 <p><code class="literal">GtkAssistant:header-image</code> has been deprecated since version 3.2 and should not be used in newly-written code. Since GTK+ 3.2, a header is no longer shown;
     add your header decoration to the page content instead.</p>
@@ -1209,7 +1206,7 @@ The type of the assistant page.
 <div class="refsect2">
 <a name="GtkAssistant--c-sidebar-image"></a><h3>The <code class="literal">"sidebar-image"</code> child property</h3>
 <pre class="programlisting">  "sidebar-image"            <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a>*            : Read / Write</pre>
-<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
+<div class="warning">
 <h3 class="title">Warning</h3>
 <p><code class="literal">GtkAssistant:sidebar-image</code> has been deprecated since version 3.2 and should not be used in newly-written code. Since GTK+ 3.2, the sidebar image is no longer shown.</p>
 </div>
@@ -1384,6 +1381,6 @@ necessary before showing <em class="parameter"><code>page</code></em>.
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.18.1</div>
+          Generated by GTK-Doc V1.19.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/gtk3/GtkBin.html CHANGED

@@ -2,34 +2,31 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>GtkBin</title>
+<title>GTK+ 3 Reference Manual: GtkBin</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
 <link rel="up" href="AbstractObjects.html" title="Abstract Base Classes">
 <link rel="prev" href="GtkContainer.html" title="GtkContainer">
 <link rel="next" href="GtkMenuShell.html" title="GtkMenuShell">
-<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
-<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
-<tr valign="middle">
-<td><a accesskey="p" href="GtkContainer.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
-<td><a accesskey="u" href="AbstractObjects.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
-<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
-<th width="100%" align="center">GTK+ 3 Reference Manual</th>
-<td><a accesskey="n" href="GtkMenuShell.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
-</tr>
-<tr><td colspan="5" class="shortcuts">
-<a href="#GtkBin.synopsis" class="shortcut">Top</a>
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
+<td width="100%" align="left">
+<a href="#" class="shortcut">Top</a>
                    |
                   <a href="#GtkBin.description" class="shortcut">Description</a>
                    |
                   <a href="#GtkBin.object-hierarchy" class="shortcut">Object Hierarchy</a>
                    |
                   <a href="#GtkBin.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
-</td></tr>
-</table>
+</td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
+<td><a accesskey="u" href="AbstractObjects.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
+<td><a accesskey="p" href="GtkContainer.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
+<td><a accesskey="n" href="GtkMenuShell.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
+</tr></table>
 <div class="refentry">
 <a name="GtkBin"></a><div class="titlepage"></div>
 <div class="refnamediv"><table width="100%"><tr>
@@ -65,9 +62,12 @@ struct              <a class="link" href="GtkBin.html#GtkBin-struct" title="stru
                            +----<a class="link" href="GtkEventBox.html" title="GtkEventBox">GtkEventBox</a>
                            +----<a class="link" href="GtkExpander.html" title="GtkExpander">GtkExpander</a>
                            +----<a class="link" href="GtkHandleBox.html" title="GtkHandleBox">GtkHandleBox</a>
+                           +----<a class="link" href="GtkListBox.html#GtkListBoxRow">GtkListBoxRow</a>
                            +----<a class="link" href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a>
                            +----<a class="link" href="GtkOverlay.html" title="GtkOverlay">GtkOverlay</a>
                            +----<a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow">GtkScrolledWindow</a>
+                           +----<a class="link" href="GtkRevealer.html" title="GtkRevealer">GtkRevealer</a>
+                           +----<a class="link" href="GtkSearchBar.html" title="GtkSearchBar">GtkSearchBar</a>
                            +----<a class="link" href="GtkViewport.html" title="GtkViewport">GtkViewport</a>
 </pre>
 </div>
@@ -127,6 +127,6 @@ added, so you do not need to unref it.
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.18.1</div>
+          Generated by GTK-Doc V1.19.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/gtk3/GtkBox.html CHANGED

@@ -2,26 +2,19 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>GtkBox</title>
+<title>GTK+ 3 Reference Manual: GtkBox</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
 <link rel="up" href="LayoutContainers.html" title="Layout Containers">
-<link rel="prev" href="GtkAspectFrame.html" title="GtkAspectFrame">
-<link rel="next" href="GtkButtonBox.html" title="GtkButtonBox">
-<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
+<link rel="prev" href="LayoutContainers.html" title="Layout Containers">
+<link rel="next" href="GtkGrid.html" title="GtkGrid">
+<meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
-<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
-<tr valign="middle">
-<td><a accesskey="p" href="GtkAspectFrame.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
-<td><a accesskey="u" href="LayoutContainers.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
-<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
-<th width="100%" align="center">GTK+ 3 Reference Manual</th>
-<td><a accesskey="n" href="GtkButtonBox.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
-</tr>
-<tr><td colspan="5" class="shortcuts">
-<a href="#GtkBox.synopsis" class="shortcut">Top</a>
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
+<td width="100%" align="left">
+<a href="#" class="shortcut">Top</a>
                    |
                   <a href="#GtkBox.description" class="shortcut">Description</a>
                    |
@@ -32,8 +25,12 @@
                   <a href="#GtkBox.properties" class="shortcut">Properties</a>
                    |
                   <a href="#GtkBox.child-properties" class="shortcut">Child Properties</a>
-</td></tr>
-</table>
+</td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
+<td><a accesskey="u" href="LayoutContainers.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
+<td><a accesskey="p" href="LayoutContainers.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
+<td><a accesskey="n" href="GtkGrid.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
+</tr></table>
 <div class="refentry">
 <a name="GtkBox"></a><div class="titlepage"></div>
 <div class="refnamediv"><table width="100%"><tr>
@@ -82,6 +79,9 @@ struct              <a class="link" href="GtkBox.html#GtkBox-struct" title="stru
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> fill</code></em>,
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> padding</code></em>,
                                                          <em class="parameter"><code><a class="link" href="gtk3-Standard-Enumerations.html#GtkPackType" title="enum GtkPackType"><span class="type">GtkPackType</span></a> pack_type</code></em>);
+<span class="returnvalue">GtkBaselinePosition</span> <a class="link" href="GtkBox.html#gtk-box-get-baseline-position" title="gtk_box_get_baseline_position ()">gtk_box_get_baseline_position</a>       (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkBox.html#gtk-box-set-baseline-position" title="gtk_box_set_baseline_position ()">gtk_box_set_baseline_position</a>       (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</code></em>,
+                                                         <em class="parameter"><code><span class="type">GtkBaselinePosition</span> position</code></em>);
 </pre>
 </div>
 <div class="refsect1">
@@ -103,6 +103,7 @@ struct              <a class="link" href="GtkBox.html#GtkBox-struct" title="stru
                            +----<a class="link" href="GtkHBox.html" title="GtkHBox">GtkHBox</a>
                            +----<a class="link" href="GtkInfoBar.html" title="GtkInfoBar">GtkInfoBar</a>
                            +----<a class="link" href="GtkRecentChooserWidget.html" title="GtkRecentChooserWidget">GtkRecentChooserWidget</a>
+                           +----<a class="link" href="GtkStackSwitcher.html" title="GtkStackSwitcher">GtkStackSwitcher</a>
                            +----<a class="link" href="GtkStatusbar.html" title="GtkStatusbar">GtkStatusbar</a>
                            +----<a class="link" href="GtkVBox.html" title="GtkVBox">GtkVBox</a>
 </pre>
@@ -116,6 +117,7 @@ GtkBox implements
 <div class="refsect1">
 <a name="GtkBox.properties"></a><h2>Properties</h2>
 <pre class="synopsis">
+  "<a class="link" href="GtkBox.html#GtkBox--baseline-position" title='The "baseline-position" property'>baseline-position</a>"        <span class="type">GtkBaselinePosition</span>   : Read / Write
   "<a class="link" href="GtkBox.html#GtkBox--homogeneous" title='The "homogeneous" property'>homogeneous</a>"              <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
   "<a class="link" href="GtkBox.html#GtkBox--spacing" title='The "spacing" property'>spacing</a>"                  <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
 </pre>
@@ -184,7 +186,7 @@ Use <a class="link" href="GtkBox.html#gtk-box-query-child-packing" title="gtk_bo
 </p>
 <p>
 </p>
-<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
+<div class="note">
 <h3 class="title">Note</h3>
 <p>
 Note that a single-row or single-column <a class="link" href="GtkGrid.html" title="GtkGrid"><span class="type">GtkGrid</span></a> provides exactly
@@ -595,10 +597,76 @@ Sets the way <em class="parameter"><code>child</code></em> is packed into <em cl
 </tbody>
 </table></div>
 </div>
+<hr>
+<div class="refsect2">
+<a name="gtk-box-get-baseline-position"></a><h3>gtk_box_get_baseline_position ()</h3>
+<pre class="programlisting"><span class="returnvalue">GtkBaselinePosition</span> gtk_box_get_baseline_position       (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</code></em>);</pre>
+<p>
+Gets the value set by <a class="link" href="GtkBox.html#gtk-box-set-baseline-position" title="gtk_box_set_baseline_position ()"><code class="function">gtk_box_set_baseline_position()</code></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>box</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the baseline position</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-box-set-baseline-position"></a><h3>gtk_box_set_baseline_position ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_box_set_baseline_position       (<em class="parameter"><code><a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a> *box</code></em>,
+                                                         <em class="parameter"><code><span class="type">GtkBaselinePosition</span> position</code></em>);</pre>
+<p>
+Sets the baseline position of a box. This affects
+only horizontal boxes with at least one baseline aligned
+child. If there is more vertical space availible than requested,
+and the baseline is not allocated by the parent then
+<em class="parameter"><code>position</code></em> is used to allocate the baseline wrt the
+extra space available.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>box</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkBox.html" title="GtkBox"><span class="type">GtkBox</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
+<td>a <span class="type">GtkBaselinePosition</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
 </div>
 <div class="refsect1">
 <a name="GtkBox.property-details"></a><h2>Property Details</h2>
 <div class="refsect2">
+<a name="GtkBox--baseline-position"></a><h3>The <code class="literal">"baseline-position"</code> property</h3>
+<pre class="programlisting">  "baseline-position"        <span class="type">GtkBaselinePosition</span>   : Read / Write</pre>
+<p>The position of the baseline aligned widgets if extra space is available.</p>
+<p>Default value: GTK_BASELINE_POSITION_CENTER</p>
+</div>
+<hr>
+<div class="refsect2">
 <a name="GtkBox--homogeneous"></a><h3>The <code class="literal">"homogeneous"</code> property</h3>
 <pre class="programlisting">  "homogeneous"              <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 <p>Whether the children should all be the same size.</p>
@@ -631,6 +699,10 @@ Note that the <a class="link" href="GtkWidget.html#GtkWidget--halign" title='The
 and <a class="link" href="GtkWidget.html#GtkWidget--vexpand" title='The "vexpand" property'><span class="type">"vexpand"</span></a> properties are the preferred way to influence
 child size allocation in containers.
 </p>
+<p>
+In contrast to <span class="type">"hexpand"</span>, the expand child property does
+not cause the box to expand itself.
+</p>
 <p>Default value: FALSE</p>
 </div>
 <hr>
@@ -667,7 +739,7 @@ child size allocation in containers.
 <a name="GtkBox--c-position"></a><h3>The <code class="literal">"position"</code> child property</h3>
 <pre class="programlisting">  "position"                 <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
 <p>The index of the child in the parent.</p>
-<p>Allowed values: &gt;= G_MAXULONG</p>
+<p>Allowed values: &gt;= -1</p>
 <p>Default value: 0</p>
 </div>
 </div>
@@ -678,6 +750,6 @@ child size allocation in containers.
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.18.1</div>
+          Generated by GTK-Doc V1.19.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/gtk3/GtkBuildable.html CHANGED

@@ -2,26 +2,19 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>GtkBuildable</title>
+<title>GTK+ 3 Reference Manual: GtkBuildable</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
 <link rel="up" href="Builder.html" title="Interface builder">
-<link rel="prev" href="Builder.html" title="Interface builder">
-<link rel="next" href="GtkBuilder.html" title="GtkBuilder">
-<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
+<link rel="prev" href="GtkBuilder.html" title="GtkBuilder">
+<link rel="next" href="WindowWidgets.html" title="Windows">
+<meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
-<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
-<tr valign="middle">
-<td><a accesskey="p" href="Builder.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
-<td><a accesskey="u" href="Builder.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
-<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
-<th width="100%" align="center">GTK+ 3 Reference Manual</th>
-<td><a accesskey="n" href="GtkBuilder.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
-</tr>
-<tr><td colspan="5" class="shortcuts">
-<a href="#GtkBuildable.synopsis" class="shortcut">Top</a>
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
+<td width="100%" align="left">
+<a href="#" class="shortcut">Top</a>
                    |
                   <a href="#GtkBuildable.description" class="shortcut">Description</a>
                    |
@@ -30,8 +23,12 @@
                   <a href="#GtkBuildable.prerequisites" class="shortcut">Prerequisites</a>
                    |
                   <a href="#GtkBuildable.implementations" class="shortcut">Known Implementations</a>
-</td></tr>
-</table>
+</td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
+<td><a accesskey="u" href="Builder.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
+<td><a accesskey="p" href="GtkBuilder.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
+<td><a accesskey="n" href="WindowWidgets.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
+</tr></table>
 <div class="refentry">
 <a name="GtkBuildable"></a><div class="titlepage"></div>
 <div class="refnamediv"><table width="100%"><tr>
@@ -103,7 +100,7 @@ GtkBuildable requires
 <a name="GtkBuildable.implementations"></a><h2>Known Implementations</h2>
 <p>
 GtkBuildable is implemented by
- <a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog">GtkAboutDialog</a>,  <a class="link" href="GtkAccelLabel.html" title="GtkAccelLabel">GtkAccelLabel</a>,  <a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a>,  <a class="link" href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a>,  <a class="link" href="GtkAlignment.html" title="GtkAlignment">GtkAlignment</a>,  <a class="link" href="GtkAppChooserButton.html" title="GtkAppChooserButton">GtkAppChooserButton</a>,  <a class="link" href="GtkAppChooserDialog.html" title="GtkAppChooserDialog">GtkAppChooserDialog</a>,  <a class="link" href="GtkAppChooserWidget.html" title="GtkAppChooserWidget">GtkAppChooserWidget</a>,  <a class="link" href="GtkApplicationWindow.html" title="GtkApplicationWindow">GtkApplicationWindow</a>,  <a class="link" href="GtkArrow.html" title="GtkArrow">GtkArrow</a>,  <a class="link" href="GtkAspectFrame.html" title="GtkAspectFrame">GtkAspectFrame</a>,  <a class="link" href="GtkAssistant.html" title="GtkAssistant">GtkAssistant</a>,  <a class="link" href="GtkBin.html" title="GtkBin">GtkBin</a>,  <a class="link" href="GtkBox.html" title="GtkBox">GtkBox</a>,  <a class="link" href="GtkButton.html" title="GtkButton">GtkButton</a>,  <a class="link" href="GtkButtonBox.html" title="GtkButtonBox">GtkButtonBox</a>,  <a class="link" href="GtkCalendar.html" title="GtkCalendar">GtkCalendar</a>,  <a class="link" href="GtkCellArea.html" title="GtkCellArea">GtkCellArea</a>,  <a class="link" href="GtkCellAreaBox.html" title="GtkCellAreaBox">GtkCellAreaBox</a>,  <a class="link" href="GtkCellView.html" title="GtkCellView">GtkCellView</a>,  <a class="link" href="GtkCheckButton.html" title="GtkCheckButton">GtkCheckButton</a>,  <a class="link" href="GtkCheckMenuItem.html" title="GtkCheckMenuItem">GtkCheckMenuItem</a>,  <a class="link" href="GtkColorButton.html" title="GtkColorButton">GtkColorButton</a>,  <a class="link" href="GtkColorChooserDialog.html" title="GtkColorChooserDialog">GtkColorChooserDialog</a>,  <a class="link" href="GtkColorChooserWidget.html" title="GtkColorChooserWidget">GtkColorChooserWidget</a>,  <a class="link" href="GtkColorSelection.html" title="GtkColorSelection">GtkColorSelection</a>,  <a class="link" href="GtkColorSelectionDialog.html" title="GtkColorSelectionDialog">GtkColorSelectionDialog</a>,  <a class="link" href="GtkComboBox.html" title="GtkComboBox">GtkComboBox</a>,  <a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText">GtkComboBoxText</a>,  <a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>,  <a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a>,  <a class="link" href="GtkDrawingArea.html" title="GtkDrawingArea">GtkDrawingArea</a>,  <a class="link" href="GtkEntry.html" title="GtkEntry">GtkEntry</a>,  <a class="link" href="GtkEntryCompletion.html" title="GtkEntryCompletion">GtkEntryCompletion</a>,  <a class="link" href="GtkEventBox.html" title="GtkEventBox">GtkEventBox</a>,  <a class="link" href="GtkExpander.html" title="GtkExpander">GtkExpander</a>,  <a class="link" href="GtkFileChooserButton.html" title="GtkFileChooserButton">GtkFileChooserButton</a>,  <a class="link" href="GtkFileChooserDialog.html" title="GtkFileChooserDialog">GtkFileChooserDialog</a>,  <a class="link" href="GtkFileChooserWidget.html" title="GtkFileChooserWidget">GtkFileChooserWidget</a>,  <a class="link" href="GtkFileFilter.html" title="GtkFileFilter">GtkFileFilter</a>,  <a class="link" href="GtkFixed.html" title="GtkFixed">GtkFixed</a>,  <a class="link" href="GtkFontButton.html" title="GtkFontButton">GtkFontButton</a>,  <a class="link" href="GtkFontChooserDialog.html" title="GtkFontChooserDialog">GtkFontChooserDialog</a>,  <a class="link" href="GtkFontChooserWidget.html" title="GtkFontChooserWidget">GtkFontChooserWidget</a>,  <a class="link" href="GtkFontSelection.html" title="GtkFontSelection">GtkFontSelection</a>,  <a class="link" href="GtkFontSelectionDialog.html" title="GtkFontSelectionDialog">GtkFontSelectionDialog</a>,  <a class="link" href="GtkFrame.html" title="GtkFrame">GtkFrame</a>,  <a class="link" href="GtkGrid.html" title="GtkGrid">GtkGrid</a>,  <a class="link" href="GtkHBox.html" title="GtkHBox">GtkHBox</a>,  <a class="link" href="GtkHButtonBox.html" title="GtkHButtonBox">GtkHButtonBox</a>,  <a class="link" href="GtkHPaned.html" title="GtkHPaned">GtkHPaned</a>,  <a class="link" href="GtkHSV.html" title="GtkHSV">GtkHSV</a>,  <a class="link" href="GtkHScale.html" title="GtkHScale">GtkHScale</a>,  <a class="link" href="GtkHScrollbar.html" title="GtkHScrollbar">GtkHScrollbar</a>,  <a class="link" href="GtkHSeparator.html" title="GtkHSeparator">GtkHSeparator</a>,  <a class="link" href="GtkHandleBox.html" title="GtkHandleBox">GtkHandleBox</a>,  <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory">GtkIconFactory</a>,  <a class="link" href="GtkIconView.html" title="GtkIconView">GtkIconView</a>,  <a class="link" href="GtkImage.html" title="GtkImage">GtkImage</a>,  <a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem">GtkImageMenuItem</a>,  <a class="link" href="GtkInfoBar.html" title="GtkInfoBar">GtkInfoBar</a>,  <a class="link" href="GtkInvisible.html" title="GtkInvisible">GtkInvisible</a>,  <a class="link" href="GtkLabel.html" title="GtkLabel">GtkLabel</a>,  <a class="link" href="GtkLayout.html" title="GtkLayout">GtkLayout</a>,  <a class="link" href="GtkLevelBar.html" title="GtkLevelBar">GtkLevelBar</a>,  <a class="link" href="GtkLinkButton.html" title="GtkLinkButton">GtkLinkButton</a>,  <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>,  <a class="link" href="GtkLockButton.html" title="GtkLockButton">GtkLockButton</a>,  <a class="link" href="GtkMenu.html" title="GtkMenu">GtkMenu</a>,  <a class="link" href="GtkMenuBar.html" title="GtkMenuBar">GtkMenuBar</a>,  <a class="link" href="GtkMenuButton.html" title="GtkMenuButton">GtkMenuButton</a>,  <a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a>,  <a class="link" href="GtkMenuShell.html" title="GtkMenuShell">GtkMenuShell</a>,  <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton">GtkMenuToolButton</a>,  <a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog">GtkMessageDialog</a>,  <a class="link" href="GtkMisc.html" title="GtkMisc">GtkMisc</a>,  <a class="link" href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a>,  <a class="link" href="GtkOffscreenWindow.html" title="GtkOffscreenWindow">GtkOffscreenWindow</a>,  <a class="link" href="GtkOverlay.html" title="GtkOverlay">GtkOverlay</a>,  <a class="link" href="GtkPageSetupUnixDialog.html" title="GtkPageSetupUnixDialog">GtkPageSetupUnixDialog</a>,  <a class="link" href="GtkPaned.html" title="GtkPaned">GtkPaned</a>,  <a class="link" href="GtkPlug.html" title="GtkPlug">GtkPlug</a>,  <a class="link" href="GtkPrintUnixDialog.html" title="GtkPrintUnixDialog">GtkPrintUnixDialog</a>,  <a class="link" href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a>,  <a class="link" href="GtkRadioAction.html" title="GtkRadioAction">GtkRadioAction</a>,  <a class="link" href="GtkRadioButton.html" title="GtkRadioButton">GtkRadioButton</a>,  <a class="link" href="GtkRadioMenuItem.html" title="GtkRadioMenuItem">GtkRadioMenuItem</a>,  <a class="link" href="GtkRadioToolButton.html" title="GtkRadioToolButton">GtkRadioToolButton</a>,  <a class="link" href="GtkRange.html" title="GtkRange">GtkRange</a>,  <a class="link" href="GtkRecentAction.html" title="GtkRecentAction">GtkRecentAction</a>,  <a class="link" href="GtkRecentChooserDialog.html" title="GtkRecentChooserDialog">GtkRecentChooserDialog</a>,  <a class="link" href="GtkRecentChooserMenu.html" title="GtkRecentChooserMenu">GtkRecentChooserMenu</a>,  <a class="link" href="GtkRecentChooserWidget.html" title="GtkRecentChooserWidget">GtkRecentChooserWidget</a>,  <a class="link" href="GtkRecentFilter.html" title="GtkRecentFilter">GtkRecentFilter</a>,  <a class="link" href="GtkScale.html" title="GtkScale">GtkScale</a>,  <a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a>,  <a class="link" href="GtkScrollbar.html" title="GtkScrollbar">GtkScrollbar</a>,  <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow">GtkScrolledWindow</a>,  <a class="link" href="GtkSearchEntry.html" title="GtkSearchEntry">GtkSearchEntry</a>,  <a class="link" href="GtkSeparator.html" title="GtkSeparator">GtkSeparator</a>,  <a class="link" href="GtkSeparatorMenuItem.html" title="GtkSeparatorMenuItem">GtkSeparatorMenuItem</a>,  <a class="link" href="GtkSeparatorToolItem.html" title="GtkSeparatorToolItem">GtkSeparatorToolItem</a>,  <a class="link" href="GtkSizeGroup.html" title="GtkSizeGroup">GtkSizeGroup</a>,  <a class="link" href="GtkSocket.html" title="GtkSocket">GtkSocket</a>,  <a class="link" href="GtkSpinButton.html" title="GtkSpinButton">GtkSpinButton</a>,  <a class="link" href="GtkSpinner.html" title="GtkSpinner">GtkSpinner</a>,  <a class="link" href="GtkStatusbar.html" title="GtkStatusbar">GtkStatusbar</a>,  <a class="link" href="GtkSwitch.html" title="GtkSwitch">GtkSwitch</a>,  <a class="link" href="GtkTable.html" title="GtkTable">GtkTable</a>,  <a class="link" href="GtkTearoffMenuItem.html" title="GtkTearoffMenuItem">GtkTearoffMenuItem</a>,  <a class="link" href="GtkTextTagTable.html" title="GtkTextTagTable">GtkTextTagTable</a>,  <a class="link" href="GtkTextView.html" title="GtkTextView">GtkTextView</a>,  <a class="link" href="GtkToggleAction.html" title="GtkToggleAction">GtkToggleAction</a>,  <a class="link" href="GtkToggleButton.html" title="GtkToggleButton">GtkToggleButton</a>,  <a class="link" href="GtkToggleToolButton.html" title="GtkToggleToolButton">GtkToggleToolButton</a>,  <a class="link" href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a>,  <a class="link" href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a>,  <a class="link" href="GtkToolItemGroup.html" title="GtkToolItemGroup">GtkToolItemGroup</a>,  <a class="link" href="GtkToolPalette.html" title="GtkToolPalette">GtkToolPalette</a>,  <a class="link" href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a>,  <a class="link" href="GtkTreeStore.html" title="GtkTreeStore">GtkTreeStore</a>,  <a class="link" href="GtkTreeView.html" title="GtkTreeView">GtkTreeView</a>,  <a class="link" href="GtkTreeViewColumn.html" title="GtkTreeViewColumn">GtkTreeViewColumn</a>,  <a class="link" href="GtkUIManager.html" title="GtkUIManager">GtkUIManager</a>,  <a class="link" href="GtkVBox.html" title="GtkVBox">GtkVBox</a>,  <a class="link" href="GtkVButtonBox.html" title="GtkVButtonBox">GtkVButtonBox</a>,  <a class="link" href="GtkVPaned.html" title="GtkVPaned">GtkVPaned</a>,  <a class="link" href="GtkVScale.html" title="GtkVScale">GtkVScale</a>,  <a class="link" href="GtkVScrollbar.html" title="GtkVScrollbar">GtkVScrollbar</a>,  <a class="link" href="GtkVSeparator.html" title="GtkVSeparator">GtkVSeparator</a>,  <a class="link" href="GtkViewport.html" title="GtkViewport">GtkViewport</a>,  <a class="link" href="GtkVolumeButton.html" title="GtkVolumeButton">GtkVolumeButton</a>,  <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> and  <a class="link" href="GtkWindow.html" title="GtkWindow">GtkWindow</a>.</p>
+ <a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog">GtkAboutDialog</a>,  <a class="link" href="GtkAccelLabel.html" title="GtkAccelLabel">GtkAccelLabel</a>,  <a class="link" href="GtkAction.html" title="GtkAction">GtkAction</a>,  <a class="link" href="GtkActionGroup.html" title="GtkActionGroup">GtkActionGroup</a>,  <a class="link" href="GtkAlignment.html" title="GtkAlignment">GtkAlignment</a>,  <a class="link" href="GtkAppChooserButton.html" title="GtkAppChooserButton">GtkAppChooserButton</a>,  <a class="link" href="GtkAppChooserDialog.html" title="GtkAppChooserDialog">GtkAppChooserDialog</a>,  <a class="link" href="GtkAppChooserWidget.html" title="GtkAppChooserWidget">GtkAppChooserWidget</a>,  <a class="link" href="GtkApplicationWindow.html" title="GtkApplicationWindow">GtkApplicationWindow</a>,  <a class="link" href="GtkArrow.html" title="GtkArrow">GtkArrow</a>,  <a class="link" href="GtkAspectFrame.html" title="GtkAspectFrame">GtkAspectFrame</a>,  <a class="link" href="GtkAssistant.html" title="GtkAssistant">GtkAssistant</a>,  <a class="link" href="GtkBin.html" title="GtkBin">GtkBin</a>,  <a class="link" href="GtkBox.html" title="GtkBox">GtkBox</a>,  <a class="link" href="GtkButton.html" title="GtkButton">GtkButton</a>,  <a class="link" href="GtkButtonBox.html" title="GtkButtonBox">GtkButtonBox</a>,  <a class="link" href="GtkCalendar.html" title="GtkCalendar">GtkCalendar</a>,  <a class="link" href="GtkCellArea.html" title="GtkCellArea">GtkCellArea</a>,  <a class="link" href="GtkCellAreaBox.html" title="GtkCellAreaBox">GtkCellAreaBox</a>,  <a class="link" href="GtkCellView.html" title="GtkCellView">GtkCellView</a>,  <a class="link" href="GtkCheckButton.html" title="GtkCheckButton">GtkCheckButton</a>,  <a class="link" href="GtkCheckMenuItem.html" title="GtkCheckMenuItem">GtkCheckMenuItem</a>,  <a class="link" href="GtkColorButton.html" title="GtkColorButton">GtkColorButton</a>,  <a class="link" href="GtkColorChooserDialog.html" title="GtkColorChooserDialog">GtkColorChooserDialog</a>,  <a class="link" href="GtkColorChooserWidget.html" title="GtkColorChooserWidget">GtkColorChooserWidget</a>,  <a class="link" href="GtkColorSelection.html" title="GtkColorSelection">GtkColorSelection</a>,  <a class="link" href="GtkColorSelectionDialog.html" title="GtkColorSelectionDialog">GtkColorSelectionDialog</a>,  <a class="link" href="GtkComboBox.html" title="GtkComboBox">GtkComboBox</a>,  <a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText">GtkComboBoxText</a>,  <a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>,  <a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a>,  <a class="link" href="GtkDrawingArea.html" title="GtkDrawingArea">GtkDrawingArea</a>,  <a class="link" href="GtkEntry.html" title="GtkEntry">GtkEntry</a>,  <a class="link" href="GtkEntryCompletion.html" title="GtkEntryCompletion">GtkEntryCompletion</a>,  <a class="link" href="GtkEventBox.html" title="GtkEventBox">GtkEventBox</a>,  <a class="link" href="GtkExpander.html" title="GtkExpander">GtkExpander</a>,  <a class="link" href="GtkFileChooserButton.html" title="GtkFileChooserButton">GtkFileChooserButton</a>,  <a class="link" href="GtkFileChooserDialog.html" title="GtkFileChooserDialog">GtkFileChooserDialog</a>,  <a class="link" href="GtkFileChooserWidget.html" title="GtkFileChooserWidget">GtkFileChooserWidget</a>,  <a class="link" href="GtkFileFilter.html" title="GtkFileFilter">GtkFileFilter</a>,  <a class="link" href="GtkFixed.html" title="GtkFixed">GtkFixed</a>,  <a class="link" href="GtkFontButton.html" title="GtkFontButton">GtkFontButton</a>,  <a class="link" href="GtkFontChooserDialog.html" title="GtkFontChooserDialog">GtkFontChooserDialog</a>,  <a class="link" href="GtkFontChooserWidget.html" title="GtkFontChooserWidget">GtkFontChooserWidget</a>,  <a class="link" href="GtkFontSelection.html" title="GtkFontSelection">GtkFontSelection</a>,  <a class="link" href="GtkFontSelectionDialog.html" title="GtkFontSelectionDialog">GtkFontSelectionDialog</a>,  <a class="link" href="GtkFrame.html" title="GtkFrame">GtkFrame</a>,  <a class="link" href="GtkGrid.html" title="GtkGrid">GtkGrid</a>,  <a class="link" href="GtkHBox.html" title="GtkHBox">GtkHBox</a>,  <a class="link" href="GtkHButtonBox.html" title="GtkHButtonBox">GtkHButtonBox</a>,  <a class="link" href="GtkHPaned.html" title="GtkHPaned">GtkHPaned</a>,  <a class="link" href="GtkHSV.html" title="GtkHSV">GtkHSV</a>,  <a class="link" href="GtkHScale.html" title="GtkHScale">GtkHScale</a>,  <a class="link" href="GtkHScrollbar.html" title="GtkHScrollbar">GtkHScrollbar</a>,  <a class="link" href="GtkHSeparator.html" title="GtkHSeparator">GtkHSeparator</a>,  <a class="link" href="GtkHandleBox.html" title="GtkHandleBox">GtkHandleBox</a>,  <a class="link" href="GtkHeaderBar.html" title="GtkHeaderBar">GtkHeaderBar</a>,  <a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconFactory">GtkIconFactory</a>,  <a class="link" href="GtkIconView.html" title="GtkIconView">GtkIconView</a>,  <a class="link" href="GtkImage.html" title="GtkImage">GtkImage</a>,  <a class="link" href="GtkImageMenuItem.html" title="GtkImageMenuItem">GtkImageMenuItem</a>,  <a class="link" href="GtkInfoBar.html" title="GtkInfoBar">GtkInfoBar</a>,  <a class="link" href="GtkInvisible.html" title="GtkInvisible">GtkInvisible</a>,  <a class="link" href="GtkLabel.html" title="GtkLabel">GtkLabel</a>,  <a class="link" href="GtkLayout.html" title="GtkLayout">GtkLayout</a>,  <a class="link" href="GtkLevelBar.html" title="GtkLevelBar">GtkLevelBar</a>,  <a class="link" href="GtkLinkButton.html" title="GtkLinkButton">GtkLinkButton</a>,  <a class="link" href="GtkListBox.html" title="GtkListBox">GtkListBox</a>,  <a class="link" href="GtkListBox.html#GtkListBoxRow">GtkListBoxRow</a>,  <a class="link" href="GtkListStore.html" title="GtkListStore">GtkListStore</a>,  <a class="link" href="GtkLockButton.html" title="GtkLockButton">GtkLockButton</a>,  <a class="link" href="GtkMenu.html" title="GtkMenu">GtkMenu</a>,  <a class="link" href="GtkMenuBar.html" title="GtkMenuBar">GtkMenuBar</a>,  <a class="link" href="GtkMenuButton.html" title="GtkMenuButton">GtkMenuButton</a>,  <a class="link" href="GtkMenuItem.html" title="GtkMenuItem">GtkMenuItem</a>,  <a class="link" href="GtkMenuShell.html" title="GtkMenuShell">GtkMenuShell</a>,  <a class="link" href="GtkMenuToolButton.html" title="GtkMenuToolButton">GtkMenuToolButton</a>,  <a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog">GtkMessageDialog</a>,  <a class="link" href="GtkMisc.html" title="GtkMisc">GtkMisc</a>,  <a class="link" href="GtkNotebook.html" title="GtkNotebook">GtkNotebook</a>,  <a class="link" href="GtkOffscreenWindow.html" title="GtkOffscreenWindow">GtkOffscreenWindow</a>,  <a class="link" href="GtkOverlay.html" title="GtkOverlay">GtkOverlay</a>,  <a class="link" href="GtkPageSetupUnixDialog.html" title="GtkPageSetupUnixDialog">GtkPageSetupUnixDialog</a>,  <a class="link" href="GtkPaned.html" title="GtkPaned">GtkPaned</a>,  <a class="link" href="GtkPlacesSidebar.html" title="GtkPlacesSidebar">GtkPlacesSidebar</a>,  <a class="link" href="GtkPrintUnixDialog.html" title="GtkPrintUnixDialog">GtkPrintUnixDialog</a>,  <a class="link" href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a>,  <a class="link" href="GtkRadioAction.html" title="GtkRadioAction">GtkRadioAction</a>,  <a class="link" href="GtkRadioButton.html" title="GtkRadioButton">GtkRadioButton</a>,  <a class="link" href="GtkRadioMenuItem.html" title="GtkRadioMenuItem">GtkRadioMenuItem</a>,  <a class="link" href="GtkRadioToolButton.html" title="GtkRadioToolButton">GtkRadioToolButton</a>,  <a class="link" href="GtkRange.html" title="GtkRange">GtkRange</a>,  <a class="link" href="GtkRecentAction.html" title="GtkRecentAction">GtkRecentAction</a>,  <a class="link" href="GtkRecentChooserDialog.html" title="GtkRecentChooserDialog">GtkRecentChooserDialog</a>,  <a class="link" href="GtkRecentChooserMenu.html" title="GtkRecentChooserMenu">GtkRecentChooserMenu</a>,  <a class="link" href="GtkRecentChooserWidget.html" title="GtkRecentChooserWidget">GtkRecentChooserWidget</a>,  <a class="link" href="GtkRecentFilter.html" title="GtkRecentFilter">GtkRecentFilter</a>,  <a class="link" href="GtkRevealer.html" title="GtkRevealer">GtkRevealer</a>,  <a class="link" href="GtkScale.html" title="GtkScale">GtkScale</a>,  <a class="link" href="GtkScaleButton.html" title="GtkScaleButton">GtkScaleButton</a>,  <a class="link" href="GtkScrollbar.html" title="GtkScrollbar">GtkScrollbar</a>,  <a class="link" href="GtkScrolledWindow.html" title="GtkScrolledWindow">GtkScrolledWindow</a>,  <a class="link" href="GtkSearchBar.html" title="GtkSearchBar">GtkSearchBar</a>,  <a class="link" href="GtkSearchEntry.html" title="GtkSearchEntry">GtkSearchEntry</a>,  <a class="link" href="GtkSeparator.html" title="GtkSeparator">GtkSeparator</a>,  <a class="link" href="GtkSeparatorMenuItem.html" title="GtkSeparatorMenuItem">GtkSeparatorMenuItem</a>,  <a class="link" href="GtkSeparatorToolItem.html" title="GtkSeparatorToolItem">GtkSeparatorToolItem</a>,  <a class="link" href="GtkSizeGroup.html" title="GtkSizeGroup">GtkSizeGroup</a>,  <a class="link" href="GtkSpinButton.html" title="GtkSpinButton">GtkSpinButton</a>,  <a class="link" href="GtkSpinner.html" title="GtkSpinner">GtkSpinner</a>,  <a class="link" href="GtkStack.html" title="GtkStack">GtkStack</a>,  <a class="link" href="GtkStackSwitcher.html" title="GtkStackSwitcher">GtkStackSwitcher</a>,  <a class="link" href="GtkStatusbar.html" title="GtkStatusbar">GtkStatusbar</a>,  <a class="link" href="GtkSwitch.html" title="GtkSwitch">GtkSwitch</a>,  <a class="link" href="GtkTable.html" title="GtkTable">GtkTable</a>,  <a class="link" href="GtkTearoffMenuItem.html" title="GtkTearoffMenuItem">GtkTearoffMenuItem</a>,  <a class="link" href="GtkTextTagTable.html" title="GtkTextTagTable">GtkTextTagTable</a>,  <a class="link" href="GtkTextView.html" title="GtkTextView">GtkTextView</a>,  <a class="link" href="GtkToggleAction.html" title="GtkToggleAction">GtkToggleAction</a>,  <a class="link" href="GtkToggleButton.html" title="GtkToggleButton">GtkToggleButton</a>,  <a class="link" href="GtkToggleToolButton.html" title="GtkToggleToolButton">GtkToggleToolButton</a>,  <a class="link" href="GtkToolButton.html" title="GtkToolButton">GtkToolButton</a>,  <a class="link" href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a>,  <a class="link" href="GtkToolItemGroup.html" title="GtkToolItemGroup">GtkToolItemGroup</a>,  <a class="link" href="GtkToolPalette.html" title="GtkToolPalette">GtkToolPalette</a>,  <a class="link" href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a>,  <a class="link" href="GtkTreeStore.html" title="GtkTreeStore">GtkTreeStore</a>,  <a class="link" href="GtkTreeView.html" title="GtkTreeView">GtkTreeView</a>,  <a class="link" href="GtkTreeViewColumn.html" title="GtkTreeViewColumn">GtkTreeViewColumn</a>,  <a class="link" href="GtkUIManager.html" title="GtkUIManager">GtkUIManager</a>,  <a class="link" href="GtkVBox.html" title="GtkVBox">GtkVBox</a>,  <a class="link" href="GtkVButtonBox.html" title="GtkVButtonBox">GtkVButtonBox</a>,  <a class="link" href="GtkVPaned.html" title="GtkVPaned">GtkVPaned</a>,  <a class="link" href="GtkVScale.html" title="GtkVScale">GtkVScale</a>,  <a class="link" href="GtkVScrollbar.html" title="GtkVScrollbar">GtkVScrollbar</a>,  <a class="link" href="GtkVSeparator.html" title="GtkVSeparator">GtkVSeparator</a>,  <a class="link" href="GtkViewport.html" title="GtkViewport">GtkViewport</a>,  <a class="link" href="GtkVolumeButton.html" title="GtkVolumeButton">GtkVolumeButton</a>,  <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> and  <a class="link" href="GtkWindow.html" title="GtkWindow">GtkWindow</a>.</p>
 </div>
 <div class="refsect1">
 <a name="GtkBuildable.description"></a><h2>Description</h2>
@@ -122,7 +119,7 @@ very little need for applications to call any
 </p>
 <p>
 </p>
-<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
+<div class="note">
 <h3 class="title">Note</h3>
 <p>An object only needs to implement this interface if it needs
 to extend the <a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> format or run any extra routines at deserialization time</p>
@@ -672,6 +669,6 @@ Get the internal child called <em class="parameter"><code>childname</code></em>
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.18.1</div>
+          Generated by GTK-Doc V1.19.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/gtk3/GtkBuilder.html CHANGED

@@ -2,34 +2,31 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>GtkBuilder</title>
+<title>GTK+ 3 Reference Manual: GtkBuilder</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
 <link rel="up" href="Builder.html" title="Interface builder">
-<link rel="prev" href="GtkBuildable.html" title="GtkBuildable">
-<link rel="next" href="Application.html" title="Application support">
-<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
+<link rel="prev" href="Builder.html" title="Interface builder">
+<link rel="next" href="GtkBuildable.html" title="GtkBuildable">
+<meta name="generator" content="GTK-Doc V1.19.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
-<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
-<tr valign="middle">
-<td><a accesskey="p" href="GtkBuildable.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
-<td><a accesskey="u" href="Builder.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
-<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
-<th width="100%" align="center">GTK+ 3 Reference Manual</th>
-<td><a accesskey="n" href="Application.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
-</tr>
-<tr><td colspan="5" class="shortcuts">
-<a href="#GtkBuilder.synopsis" class="shortcut">Top</a>
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
+<td width="100%" align="left">
+<a href="#" class="shortcut">Top</a>
                    |
                   <a href="#GtkBuilder.description" class="shortcut">Description</a>
                    |
                   <a href="#GtkBuilder.object-hierarchy" class="shortcut">Object Hierarchy</a>
                    |
                   <a href="#GtkBuilder.properties" class="shortcut">Properties</a>
-</td></tr>
-</table>
+</td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
+<td><a accesskey="u" href="Builder.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
+<td><a accesskey="p" href="Builder.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
+<td><a accesskey="n" href="GtkBuildable.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
+</tr></table>
 <div class="refentry">
 <a name="GtkBuilder"></a><div class="titlepage"></div>
 <div class="refnamediv"><table width="100%"><tr>
@@ -44,7 +41,7 @@
 <pre class="synopsis">
 #include &lt;gtk/gtk.h&gt;
-struct              <a class="link" href="GtkBuilder.html#GtkBuilder-struct" title="struct GtkBuilder">GtkBuilder</a>;
+                    <a class="link" href="GtkBuilder.html#GtkBuilder-struct" title="GtkBuilder">GtkBuilder</a>;
 <span class="returnvalue">void</span>                (<a class="link" href="GtkBuilder.html#GtkBuilderConnectFunc" title="GtkBuilderConnectFunc ()">*GtkBuilderConnectFunc</a>)            (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> *object</code></em>,
                                                          <em class="parameter"><code>const <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *signal_name</code></em>,
@@ -54,6 +51,19 @@ struct              <a class="link" href="GtkBuilder.html#GtkBuilder-struct" tit
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
 enum                <a class="link" href="GtkBuilder.html#GtkBuilderError" title="enum GtkBuilderError">GtkBuilderError</a>;
 <a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="returnvalue">GtkBuilder</span></a> *        <a class="link" href="GtkBuilder.html#gtk-builder-new" title="gtk_builder_new ()">gtk_builder_new</a>                     (<em class="parameter"><code><span class="type">void</span></code></em>);
+<a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="returnvalue">GtkBuilder</span></a> *        <a class="link" href="GtkBuilder.html#gtk-builder-new-from-file" title="gtk_builder_new_from_file ()">gtk_builder_new_from_file</a>           (<em class="parameter"><code>const <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>);
+<a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="returnvalue">GtkBuilder</span></a> *        <a class="link" href="GtkBuilder.html#gtk-builder-new-from-resource" title="gtk_builder_new_from_resource ()">gtk_builder_new_from_resource</a>       (<em class="parameter"><code>const <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *resource_path</code></em>);
+<a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="returnvalue">GtkBuilder</span></a> *        <a class="link" href="GtkBuilder.html#gtk-builder-new-from-string" title="gtk_builder_new_from_string ()">gtk_builder_new_from_string</a>         (<em class="parameter"><code>const <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gssize"><span class="type">gssize</span></a> length</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkBuilder.html#gtk-builder-add-callback-symbol" title="gtk_builder_add_callback_symbol ()">gtk_builder_add_callback_symbol</a>     (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
+                                                         <em class="parameter"><code>const <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *callback_name</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> callback_symbol</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="GtkBuilder.html#gtk-builder-add-callback-symbols" title="gtk_builder_add_callback_symbols ()">gtk_builder_add_callback_symbols</a>    (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
+                                                         <em class="parameter"><code>const <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_callback_name</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> first_callback_symbol</code></em>,
+                                                         <em class="parameter"><code>...</code></em>);
+<a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"><span class="returnvalue">GCallback</span></a>           <a class="link" href="GtkBuilder.html#gtk-builder-lookup-callback-symbol" title="gtk_builder_lookup_callback_symbol ()">gtk_builder_lookup_callback_symbol</a>  (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
+                                                         <em class="parameter"><code>const <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *callback_name</code></em>);
 <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="GtkBuilder.html#gtk-builder-add-from-file" title="gtk_builder_add_from_file ()">gtk_builder_add_from_file</a>           (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
                                                          <em class="parameter"><code>const <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>,
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
@@ -126,10 +136,17 @@ const <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gt
 <a name="GtkBuilder.description"></a><h2>Description</h2>
 <p>
 A GtkBuilder is an auxiliary object that reads textual descriptions
-of a user interface and instantiates the described objects. To pass a
-description to a GtkBuilder, call <a class="link" href="GtkBuilder.html#gtk-builder-add-from-file" title="gtk_builder_add_from_file ()"><code class="function">gtk_builder_add_from_file()</code></a> or
-<a class="link" href="GtkBuilder.html#gtk-builder-add-from-string" title="gtk_builder_add_from_string ()"><code class="function">gtk_builder_add_from_string()</code></a>. These functions can be called multiple
-times; the builder merges the content of all descriptions.
+of a user interface and instantiates the described objects. To create
+a GtkBuilder from a user interface description, call
+<a class="link" href="GtkBuilder.html#gtk-builder-new-from-file" title="gtk_builder_new_from_file ()"><code class="function">gtk_builder_new_from_file()</code></a>, <a class="link" href="GtkBuilder.html#gtk-builder-new-from-resource" title="gtk_builder_new_from_resource ()"><code class="function">gtk_builder_new_from_resource()</code></a> or
+<a class="link" href="GtkBuilder.html#gtk-builder-new-from-string" title="gtk_builder_new_from_string ()"><code class="function">gtk_builder_new_from_string()</code></a>.
+</p>
+<p>
+In the (unusual) case that you want to add user interface
+descriptions from multiple sources to the same GtkBuilder you can
+call <a class="link" href="GtkBuilder.html#gtk-builder-new" title="gtk_builder_new ()"><code class="function">gtk_builder_new()</code></a> to get an empty builder and populate it by
+(multiple) calls to <a class="link" href="GtkBuilder.html#gtk-builder-add-from-file" title="gtk_builder_add_from_file ()"><code class="function">gtk_builder_add_from_file()</code></a>,
+<a class="link" href="GtkBuilder.html#gtk-builder-add-from-resource" title="gtk_builder_add_from_resource ()"><code class="function">gtk_builder_add_from_resource()</code></a> or <a class="link" href="GtkBuilder.html#gtk-builder-add-from-string" title="gtk_builder_add_from_string ()"><code class="function">gtk_builder_add_from_string()</code></a>.
 </p>
 <p>
 A GtkBuilder holds a reference to all objects that it has constructed
@@ -171,7 +188,7 @@ limited in scope. It is common to use <code class="filename">.ui</code> as the f
 <pre class="programlisting">
 start = element interface {
   attribute domain { text } ?,
-  ( requires | object | menu ) *
+  ( requires | object | template | menu ) *
 }
 requires = element requires {
@@ -187,6 +204,12 @@ object = element object {
   (property | signal | child | ANY) *
 }
+template = element template {
+  attribute class { text },
+  attribute parent { text },
+  (property | signal | child | ANY) *
+}
 property = element property {
   attribute name { text },
   attribute translatable { "yes" | "no" } ?,
@@ -247,7 +270,7 @@ section = element section {
   (attribute_ | item | submenu | section) *
 }
-ANY = element * - (interface | requires | object | property | signal | child | menu | item | attribute | link | submenu | section) {
+ANY = element * - (interface | requires | object | template | property | signal | child | menu | item | attribute | link | submenu | section) {
   attribute * { text } *,
   (ALL * &amp; text ?)
 }
@@ -292,7 +315,7 @@ application to retrieve them from the builder with <a class="link" href="GtkBuil
 An id is also necessary to use the object as property value in other parts of
 the UI definition.
 </p>
-<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
+<div class="note">
 <h3 class="title">Note</h3>
 <p>
 Prior to 2.20, GtkBuilder was setting the "name" property of constructed widgets to the
@@ -357,7 +380,7 @@ for the "type" attribute are described in the sections describing the
 widget-specific portions of UI definitions.
 </p>
 <div class="example">
-<a name="id-1.5.22.3.6.6.1.14"></a><p class="title"><b>Example 110. A GtkBuilder UI Definition</b></p>
+<a name="id-1.3.5.2.6.7.1.14"></a><p class="title"><b>Example 9. A GtkBuilder UI Definition</b></p>
 <div class="example-contents">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -446,12 +469,16 @@ objects, see
 <a class="link" href="GtkFileFilter.html#GtkFileFilter-BUILDER-UI" title="GtkFileFilter as GtkBuildable">GtkFileFilter</a>,
 <a class="link" href="GtkTextTagTable.html#GtkTextTagTable-BUILDER-UI" title="GtkTextTagTables as GtkBuildable">GtkTextTagTable</a>.
 </p>
+<p>
+Additionally, since 3.10 a special &lt;template&gt; tag has been added to the format
+allowing one to <a class="link" href="GtkWidget.html#GtkWidget-BUILDER-TEMPLATES" title="Building composite widgets from template XML">define a widget class's components</a>.
+</p>
 </div>
 <p>
 </p>
 <hr>
 <div class="refsect2">
-<a name="id-1.5.22.3.6.6.2"></a><h3>Embedding other XML</h3>
+<a name="id-1.3.5.2.6.7.2"></a><h3>Embedding other XML</h3>
 <p>
 Apart from the language for UI descriptions that has been explained
 in the previous section, GtkBuilder can also parse XML fragments
@@ -466,8 +493,8 @@ of GMenu markup. The resulting
 <div class="refsect1">
 <a name="GtkBuilder.details"></a><h2>Details</h2>
 <div class="refsect2">
-<a name="GtkBuilder-struct"></a><h3>struct GtkBuilder</h3>
-<pre class="programlisting">struct GtkBuilder;</pre>
+<a name="GtkBuilder-struct"></a><h3>GtkBuilder</h3>
+<pre class="programlisting">typedef struct _GtkBuilder GtkBuilder;</pre>
 </div>
 <hr>
 <div class="refsect2">
@@ -540,7 +567,9 @@ subsequent calls will do nothing.
   GTK_BUILDER_ERROR_MISSING_PROPERTY_VALUE,
   GTK_BUILDER_ERROR_INVALID_VALUE,
   GTK_BUILDER_ERROR_VERSION_MISMATCH,
-  GTK_BUILDER_ERROR_DUPLICATE_ID
+  GTK_BUILDER_ERROR_DUPLICATE_ID,
+  GTK_BUILDER_ERROR_OBJECT_TYPE_REFUSED,
+  GTK_BUILDER_ERROR_TEMPLATE_MISMATCH
 } GtkBuilderError;
 </pre>
 <p>
@@ -609,6 +638,17 @@ Error codes that identify various errors that can occur while using
 <td>An object id occurred twice.
 </td>
 </tr>
+<tr>
+<td><p><a name="GTK-BUILDER-ERROR-OBJECT-TYPE-REFUSED:CAPS"></a><span class="term"><code class="literal">GTK_BUILDER_ERROR_OBJECT_TYPE_REFUSED</code></span></p></td>
+<td>A specified object type is of the same type or
+ derived from the type of the composite class being extended with builder XML.
+</td>
+</tr>
+<tr>
+<td><p><a name="GTK-BUILDER-ERROR-TEMPLATE-MISMATCH:CAPS"></a><span class="term"><code class="literal">GTK_BUILDER_ERROR_TEMPLATE_MISMATCH</code></span></p></td>
+<td>The wrong type was specified in a composite class's template XML
+</td>
+</tr>
 </tbody>
 </table></div>
 </div>
@@ -617,7 +657,17 @@ Error codes that identify various errors that can occur while using
 <a name="gtk-builder-new"></a><h3>gtk_builder_new ()</h3>
 <pre class="programlisting"><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="returnvalue">GtkBuilder</span></a> *        gtk_builder_new                     (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 <p>
-Creates a new builder object.
+Creates a new empty builder object.
+</p>
+<p>
+This function is only useful if you intend to make multiple calls to
+<a class="link" href="GtkBuilder.html#gtk-builder-add-from-file" title="gtk_builder_add_from_file ()"><code class="function">gtk_builder_add_from_file()</code></a>, <a class="link" href="GtkBuilder.html#gtk-builder-add-from-resource" title="gtk_builder_add_from_resource ()"><code class="function">gtk_builder_add_from_resource()</code></a> or
+<a class="link" href="GtkBuilder.html#gtk-builder-add-from-string" title="gtk_builder_add_from_string ()"><code class="function">gtk_builder_add_from_string()</code></a> in order to merge multiple UI
+descriptions into a single builder.
+</p>
+<p>
+Most users will probably want to use <a class="link" href="GtkBuilder.html#gtk-builder-new-from-file" title="gtk_builder_new_from_file ()"><code class="function">gtk_builder_new_from_file()</code></a>,
+<a class="link" href="GtkBuilder.html#gtk-builder-new-from-resource" title="gtk_builder_new_from_resource ()"><code class="function">gtk_builder_new_from_resource()</code></a> or <a class="link" href="GtkBuilder.html#gtk-builder-new-from-string" title="gtk_builder_new_from_string ()"><code class="function">gtk_builder_new_from_string()</code></a>.
 </p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
@@ -626,26 +676,255 @@ Creates a new builder object.
 </colgroup>
 <tbody><tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td>a new <a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> object</td>
+<td>a new (empty) <a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> object</td>
 </tr></tbody>
 </table></div>
 <p class="since">Since 2.12</p>
 </div>
 <hr>
 <div class="refsect2">
+<a name="gtk-builder-new-from-file"></a><h3>gtk_builder_new_from_file ()</h3>
+<pre class="programlisting"><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="returnvalue">GtkBuilder</span></a> *        gtk_builder_new_from_file           (<em class="parameter"><code>const <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>);</pre>
+<p>
+Builds the <a class="link" href="GtkBuilder.html#BUILDER-UI" title="GtkBuilder UI Definitions">GtkBuilder UI definition</a>
+in the file <em class="parameter"><code>filename</code></em>.
+</p>
+<p>
+If there is an error opening the file or parsing the description then
+the program will be aborted.  You should only ever attempt to parse
+user interface descriptions that are shipped as part of your program.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
+<td>filename of user interface description file</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a <span class="type">Gtkbuilder</span> containing the described interface</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-builder-new-from-resource"></a><h3>gtk_builder_new_from_resource ()</h3>
+<pre class="programlisting"><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="returnvalue">GtkBuilder</span></a> *        gtk_builder_new_from_resource       (<em class="parameter"><code>const <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *resource_path</code></em>);</pre>
+<p>
+Builds the <a class="link" href="GtkBuilder.html#BUILDER-UI" title="GtkBuilder UI Definitions">GtkBuilder UI definition</a>
+at <em class="parameter"><code>resource_path</code></em>.
+</p>
+<p>
+If there is an error locating the resurce or parsing the description
+then the program will be aborted.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>resource_path</code></em> :</span></p></td>
+<td>a <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/gio-GResource.html#GResource"><span class="type">GResource</span></a> resource path</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a <span class="type">Gtkbuilder</span> containing the described interface</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-builder-new-from-string"></a><h3>gtk_builder_new_from_string ()</h3>
+<pre class="programlisting"><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="returnvalue">GtkBuilder</span></a> *        gtk_builder_new_from_string         (<em class="parameter"><code>const <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *string</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gssize"><span class="type">gssize</span></a> length</code></em>);</pre>
+<p>
+Builds the user interface described by <em class="parameter"><code>string</code></em> (in the <a class="link" href="GtkBuilder.html#BUILDER-UI" title="GtkBuilder UI Definitions">GtkBuilder UI definition</a> format).
+</p>
+<p>
+If <em class="parameter"><code>string</code></em> is <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated then <em class="parameter"><code>length</code></em> should be -1.  If <em class="parameter"><code>length</code></em>
+is not -1 then it is the length of <em class="parameter"><code>string</code></em>.
+</p>
+<p>
+If there is an error parsing <em class="parameter"><code>string</code></em> then the program will be
+aborted.  You should not attempt to parse user interface description
+from untrusted sources.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
+<td>a user interface (XML) description</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
+<td>the length of <em class="parameter"><code>string</code></em>, or -1</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>a <span class="type">Gtkbuilder</span> containing the interface described by <em class="parameter"><code>string</code></em>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-builder-add-callback-symbol"></a><h3>gtk_builder_add_callback_symbol ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_builder_add_callback_symbol     (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
+                                                         <em class="parameter"><code>const <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *callback_name</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> callback_symbol</code></em>);</pre>
+<p>
+Adds the <em class="parameter"><code>callback_symbol</code></em> to the scope of <em class="parameter"><code>builder</code></em> under the given <em class="parameter"><code>callback_name</code></em>.
+</p>
+<p>
+Using this function overrides the behavior of <a class="link" href="GtkBuilder.html#gtk-builder-connect-signals" title="gtk_builder_connect_signals ()"><code class="function">gtk_builder_connect_signals()</code></a>
+for any callback symbols that are added. Using this method allows for better
+encapsulation as it does not require that callback symbols be declared in
+the global namespace.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>callback_name</code></em> :</span></p></td>
+<td>The name of the callback, as expected in the XML</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>callback_symbol</code></em> :</span></p></td>
+<td>The callback pointer. <span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-builder-add-callback-symbols"></a><h3>gtk_builder_add_callback_symbols ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gtk_builder_add_callback_symbols    (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
+                                                         <em class="parameter"><code>const <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_callback_name</code></em>,
+                                                         <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"><span class="type">GCallback</span></a> first_callback_symbol</code></em>,
+                                                         <em class="parameter"><code>...</code></em>);</pre>
+<p>
+A convenience function to add many callbacks instead of calling
+<a class="link" href="GtkBuilder.html#gtk-builder-add-callback-symbol" title="gtk_builder_add_callback_symbol ()"><code class="function">gtk_builder_add_callback_symbol()</code></a> for each symbol.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>first_callback_name</code></em> :</span></p></td>
+<td>The name of the callback, as expected in the XML</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>first_callback_symbol</code></em> :</span></p></td>
+<td>The callback pointer. <span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
+<td>A list of callback name and callback symbol pairs terminated with <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gtk-builder-lookup-callback-symbol"></a><h3>gtk_builder_lookup_callback_symbol ()</h3>
+<pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"><span class="returnvalue">GCallback</span></a>           gtk_builder_lookup_callback_symbol  (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
+                                                         <em class="parameter"><code>const <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *callback_name</code></em>);</pre>
+<p>
+Fetches a symbol previously added to <em class="parameter"><code>builder</code></em>
+with <a class="link" href="GtkBuilder.html#gtk-builder-add-callback-symbols" title="gtk_builder_add_callback_symbols ()"><code class="function">gtk_builder_add_callback_symbols()</code></a>
+</p>
+<p>
+This function is intended for possible use in language bindings
+or for any case that one might be cusomizing signal connections
+using <a class="link" href="GtkBuilder.html#gtk-builder-connect-signals-full" title="gtk_builder_connect_signals_full ()"><code class="function">gtk_builder_connect_signals_full()</code></a>
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>builder</code></em> :</span></p></td>
+<td>a <a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>callback_name</code></em> :</span></p></td>
+<td>The name of the callback</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>The callback symbol in <em class="parameter"><code>builder</code></em> for <em class="parameter"><code>callback_name</code></em>, or <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 3.10</p>
+</div>
+<hr>
+<div class="refsect2">
 <a name="gtk-builder-add-from-file"></a><h3>gtk_builder_add_from_file ()</h3>
 <pre class="programlisting"><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gtk_builder_add_from_file           (<em class="parameter"><code><a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a> *builder</code></em>,
                                                          <em class="parameter"><code>const <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>,
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
 <p>
 Parses a file containing a <a class="link" href="GtkBuilder.html#BUILDER-UI" title="GtkBuilder UI Definitions">GtkBuilder
-UI definition</a> and merges it with the current contents of <em class="parameter"><code>builder</code></em>.
+UI definition</a> and merges it with the current contents of <em class="parameter"><code>builder</code></em>.
+</p>
+<p>
+Most users will probably want to use <a class="link" href="GtkBuilder.html#gtk-builder-new-from-file" title="gtk_builder_new_from_file ()"><code class="function">gtk_builder_new_from_file()</code></a>.
 </p>
 <p>
 Upon errors 0 will be returned and <em class="parameter"><code>error</code></em> will be assigned a
 <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR"><span class="type">GTK_BUILDER_ERROR</span></a>, <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html#G-MARKUP-ERROR:CAPS"><span class="type">G_MARKUP_ERROR</span></a> or <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-File-Utilities.html#G-FILE-ERROR:CAPS"><span class="type">G_FILE_ERROR</span></a>
 domain.
 </p>
+<p>
+It's not really reasonable to attempt to handle failures of this
+call.  You should not use this function with untrusted files (ie:
+files that are not part of your application).  Broken <a class="link" href="GtkBuilder.html" title="GtkBuilder"><span class="type">GtkBuilder</span></a>
+files can easily crash your program, and it's possible that memory
+was leaked leading up to the reported failure.  The only reasonable
+thing to do when an error is detected is to call <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Message-Logging.html#g-error"><code class="function">g_error()</code></a>.
+</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -685,10 +964,18 @@ Parses a resource file containing a <a class="link" href="GtkBuilder.html#BUILDE
 UI definition</a> and merges it with the current contents of <em class="parameter"><code>builder</code></em>.
 </p>
 <p>
+Most users will probably want to use <a class="link" href="GtkBuilder.html#gtk-builder-new-from-resource" title="gtk_builder_new_from_resource ()"><code class="function">gtk_builder_new_from_resource()</code></a>.
+</p>
+<p>
 Upon errors 0 will be returned and <em class="parameter"><code>error</code></em> will be assigned a
 <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR"><span class="type">GTK_BUILDER_ERROR</span></a>, <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html#G-MARKUP-ERROR:CAPS"><span class="type">G_MARKUP_ERROR</span></a> or <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/gio/gio-GResource.html#G-RESOURCE-ERROR:CAPS"><span class="type">G_RESOURCE_ERROR</span></a>
 domain.
 </p>
+<p>
+It's not really reasonable to attempt to handle failures of this
+call.  The only reasonable thing to do when an error is detected is
+to call <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Message-Logging.html#g-error"><code class="function">g_error()</code></a>.
+</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -729,9 +1016,17 @@ Parses a string containing a <a class="link" href="GtkBuilder.html#BUILDER-UI" t
 UI definition</a> and merges it with the current contents of <em class="parameter"><code>builder</code></em>.
 </p>
 <p>
+Most users will probably want to use <a class="link" href="GtkBuilder.html#gtk-builder-new-from-string" title="gtk_builder_new_from_string ()"><code class="function">gtk_builder_new_from_string()</code></a>.
+</p>
+<p>
 Upon errors 0 will be returned and <em class="parameter"><code>error</code></em> will be assigned a
 <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> from the <a class="link" href="GtkBuilder.html#GTK-BUILDER-ERROR:CAPS" title="GTK_BUILDER_ERROR"><span class="type">GTK_BUILDER_ERROR</span></a> or <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html#G-MARKUP-ERROR:CAPS"><span class="type">G_MARKUP_ERROR</span></a> domain.
 </p>
+<p>
+It's not really reasonable to attempt to handle failures of this
+call.  The only reasonable thing to do when an error is detected is
+to call <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Message-Logging.html#g-error"><code class="function">g_error()</code></a>.
+</p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
 <col align="left" valign="top">
@@ -783,7 +1078,7 @@ domain.
 </p>
 <p>
 </p>
-<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
+<div class="note">
 <h3 class="title">Note</h3>
 <p>
 If you are adding an object that depends on an object that is not
@@ -845,7 +1140,7 @@ Upon errors 0 will be returned and <em class="parameter"><code>error</code></em>
 </p>
 <p>
 </p>
-<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
+<div class="note">
 <h3 class="title">Note</h3>
 <p>
 If you are adding an object that depends on an object that is not
@@ -912,7 +1207,7 @@ domain.
 </p>
 <p>
 </p>
-<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
+<div class="note">
 <h3 class="title">Note</h3>
 <p>
 If you are adding an object that depends on an object that is not
@@ -1060,15 +1355,22 @@ other object built by builder.
                                                          <em class="parameter"><code><a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 <p>
 This method is a simpler variation of <a class="link" href="GtkBuilder.html#gtk-builder-connect-signals-full" title="gtk_builder_connect_signals_full ()"><code class="function">gtk_builder_connect_signals_full()</code></a>.
-It uses <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Dynamic-Loading-of-Modules.html#GModule"><span class="type">GModule</span></a>'s introspective features (by opening the module <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>)
+It uses symbols explicitly added to <em class="parameter"><code>builder</code></em> with prior calls to
+<a class="link" href="GtkBuilder.html#gtk-builder-add-callback-symbol" title="gtk_builder_add_callback_symbol ()"><code class="function">gtk_builder_add_callback_symbol()</code></a>. In the case that symbols are not
+explicitly added; it uses <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Dynamic-Loading-of-Modules.html#GModule"><span class="type">GModule</span></a>'s introspective features (by opening the module <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>)
 to look at the application's symbol table. From here it tries to match
 the signal handler names given in the interface description with
 symbols in the application and connects the signals. Note that this
 function can only be called once, subsequent calls will do nothing.
 </p>
 <p>
-Note that this function will not work correctly if <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Dynamic-Loading-of-Modules.html#GModule"><span class="type">GModule</span></a> is not
-supported on the platform.
+Note that unless <a class="link" href="GtkBuilder.html#gtk-builder-add-callback-symbol" title="gtk_builder_add_callback_symbol ()"><code class="function">gtk_builder_add_callback_symbol()</code></a> is called for
+all signal callbacks which are referenced by the loaded XML, this
+function will require that <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Dynamic-Loading-of-Modules.html#GModule"><span class="type">GModule</span></a> be supported on the platform.
+</p>
+<p>
+If you rely on <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Dynamic-Loading-of-Modules.html#GModule"><span class="type">GModule</span></a> support to lookup callbacks in the symbol table,
+the following details should be noted:
 </p>
 <p>
 When compiling applications for Windows, you must declare signal callbacks
@@ -1388,6 +1690,6 @@ otherwise <a href="/home/kou/work/ruby/ruby-gnome2.win32/glib2/vendor/local/shar
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.18.1</div>
+          Generated by GTK-Doc V1.19.1</div>
 </body>
 </html>