RubyGems - glib2 - Versions diffs - 1.2.5-x86-mingw32 → 1.2.6-x86-mingw32 - Mend

glib2 1.2.5-x86-mingw32 → 1.2.6-x86-mingw32

Files changed (1752) hide show

data/vendor/local/share/gtk-doc/html/gio/GTcpConnection.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="highlevel-socket.html" title="High-level network functionallity">
 <link rel="prev" href="GUnixConnection.html" title="GUnixConnection">
 <link rel="next" href="GTcpWrapperConnection.html" title="GTcpWrapperConnection">
-<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -44,15 +44,15 @@
 <pre class="synopsis">                    <a class="link" href="GTcpConnection.html#GTcpConnection-struct" title="GTcpConnection">GTcpConnection</a>;
 <span class="returnvalue">void</span>                <a class="link" href="GTcpConnection.html#g-tcp-connection-set-graceful-disconnect" title="g_tcp_connection_set_graceful_disconnect ()">g_tcp_connection_set_graceful_disconnect</a>
                                                         (<em class="parameter"><code><a class="link" href="GTcpConnection.html" title="GTcpConnection"><span class="type">GTcpConnection</span></a> *connection</code></em>,
-                                                         <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> graceful_disconnect</code></em>);
-<a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GTcpConnection.html#g-tcp-connection-get-graceful-disconnect" title="g_tcp_connection_get_graceful_disconnect ()">g_tcp_connection_get_graceful_disconnect</a>
+                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> graceful_disconnect</code></em>);
+<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GTcpConnection.html#g-tcp-connection-get-graceful-disconnect" title="g_tcp_connection_get_graceful_disconnect ()">g_tcp_connection_get_graceful_disconnect</a>
                                                         (<em class="parameter"><code><a class="link" href="GTcpConnection.html" title="GTcpConnection"><span class="type">GTcpConnection</span></a> *connection</code></em>);
 </pre>
 </div>
 <div class="refsect1">
 <a name="GTcpConnection.object-hierarchy"></a><h2>Object Hierarchy</h2>
 <pre class="synopsis">
-  <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
+  <a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
    +----<a class="link" href="GIOStream.html" title="GIOStream">GIOStream</a>
          +----<a class="link" href="GSocketConnection.html" title="GSocketConnection">GSocketConnection</a>
                +----GTcpConnection
@@ -62,7 +62,7 @@
 <div class="refsect1">
 <a name="GTcpConnection.properties"></a><h2>Properties</h2>
 <pre class="synopsis">
-  "<a class="link" href="GTcpConnection.html#GTcpConnection--graceful-disconnect" title='The "graceful-disconnect" property'>graceful-disconnect</a>"      <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
+  "<a class="link" href="GTcpConnection.html#GTcpConnection--graceful-disconnect" title='The "graceful-disconnect" property'>graceful-disconnect</a>"      <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 </pre>
 </div>
 <div class="refsect1">
@@ -87,7 +87,7 @@ A <a class="link" href="GSocketConnection.html" title="GSocketConnection"><span
 <a name="g-tcp-connection-set-graceful-disconnect"></a><h3>g_tcp_connection_set_graceful_disconnect ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                g_tcp_connection_set_graceful_disconnect
                                                         (<em class="parameter"><code><a class="link" href="GTcpConnection.html" title="GTcpConnection"><span class="type">GTcpConnection</span></a> *connection</code></em>,
-                                                         <em class="parameter"><code><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> graceful_disconnect</code></em>);</pre>
+                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> graceful_disconnect</code></em>);</pre>
 <p>
 This enabled graceful disconnects on close. A graceful disconnect
 means that we signal the receiving end that the connection is terminated
@@ -122,7 +122,7 @@ take a while. For this reason it is disabled by default.
 <hr>
 <div class="refsect2">
 <a name="g-tcp-connection-get-graceful-disconnect"></a><h3>g_tcp_connection_get_graceful_disconnect ()</h3>
-<pre class="programlisting"><a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            g_tcp_connection_get_graceful_disconnect
+<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            g_tcp_connection_get_graceful_disconnect
                                                         (<em class="parameter"><code><a class="link" href="GTcpConnection.html" title="GTcpConnection"><span class="type">GTcpConnection</span></a> *connection</code></em>);</pre>
 <p>
 Checks if graceful disconnects are used. See
@@ -142,7 +142,7 @@ Checks if graceful disconnects are used. See
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 <td>
-<a href="./../glib/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if graceful disconnect is used on close, <a href="./../glib/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</td>
+<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if graceful disconnect is used on close, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</td>
 </tr>
 </tbody>
 </table></div>
@@ -153,7 +153,7 @@ Checks if graceful disconnects are used. See
 <a name="GTcpConnection.property-details"></a><h2>Property Details</h2>
 <div class="refsect2">
 <a name="GTcpConnection--graceful-disconnect"></a><h3>The <code class="literal">"graceful-disconnect"</code> property</h3>
-<pre class="programlisting">  "graceful-disconnect"      <a href="./../glib/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
+<pre class="programlisting">  "graceful-disconnect"      <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 <p>Whether or not close does a graceful disconnect.</p>
 <p>Default value: FALSE</p>
 </div>
@@ -165,6 +165,6 @@ Checks if graceful disconnects are used. See
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.18</div>
+          Generated by GTK-Doc V1.18.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/gio/GTcpWrapperConnection.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="highlevel-socket.html" title="High-level network functionallity">
 <link rel="prev" href="GTcpConnection.html" title="GTcpConnection">
 <link rel="next" href="GSocketListener.html" title="GSocketListener">
-<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -51,7 +51,7 @@
 <div class="refsect1">
 <a name="GTcpWrapperConnection.object-hierarchy"></a><h2>Object Hierarchy</h2>
 <pre class="synopsis">
-  <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
+  <a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
    +----<a class="link" href="GIOStream.html" title="GIOStream">GIOStream</a>
          +----<a class="link" href="GSocketConnection.html" title="GSocketConnection">GSocketConnection</a>
                +----<a class="link" href="GTcpConnection.html" title="GTcpConnection">GTcpConnection</a>
@@ -155,6 +155,6 @@ Get's <em class="parameter"><code>conn</code></em>'s base <a class="link" href="
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.18</div>
+          Generated by GTK-Doc V1.18.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/gio/GTestDBus.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="testing.html" title="GIO Testing">
 <link rel="prev" href="testing.html" title="GIO Testing">
 <link rel="next" href="migrating.html" title="Part III. Migrating to GIO">
-<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -48,9 +48,9 @@
 enum                <a class="link" href="GTestDBus.html#GTestDBusFlags-enum" title="enum GTestDBusFlags">GTestDBusFlags</a>;
 <a class="link" href="GTestDBus.html" title="GTestDBus"><span class="returnvalue">GTestDBus</span></a> *         <a class="link" href="GTestDBus.html#g-test-dbus-new" title="g_test_dbus_new ()">g_test_dbus_new</a>                     (<em class="parameter"><code><a class="link" href="GTestDBus.html#GTestDBusFlags"><span class="type">GTestDBusFlags</span></a> flags</code></em>);
 <a class="link" href="GTestDBus.html#GTestDBusFlags"><span class="returnvalue">GTestDBusFlags</span></a>      <a class="link" href="GTestDBus.html#g-test-dbus-get-flags" title="g_test_dbus_get_flags ()">g_test_dbus_get_flags</a>               (<em class="parameter"><code><a class="link" href="GTestDBus.html" title="GTestDBus"><span class="type">GTestDBus</span></a> *self</code></em>);
-const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="GTestDBus.html#g-test-dbus-get-bus-address" title="g_test_dbus_get_bus_address ()">g_test_dbus_get_bus_address</a>         (<em class="parameter"><code><a class="link" href="GTestDBus.html" title="GTestDBus"><span class="type">GTestDBus</span></a> *self</code></em>);
+const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="GTestDBus.html#g-test-dbus-get-bus-address" title="g_test_dbus_get_bus_address ()">g_test_dbus_get_bus_address</a>         (<em class="parameter"><code><a class="link" href="GTestDBus.html" title="GTestDBus"><span class="type">GTestDBus</span></a> *self</code></em>);
 <span class="returnvalue">void</span>                <a class="link" href="GTestDBus.html#g-test-dbus-add-service-dir" title="g_test_dbus_add_service_dir ()">g_test_dbus_add_service_dir</a>         (<em class="parameter"><code><a class="link" href="GTestDBus.html" title="GTestDBus"><span class="type">GTestDBus</span></a> *self</code></em>,
-                                                         <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>);
+                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>);
 <span class="returnvalue">void</span>                <a class="link" href="GTestDBus.html#g-test-dbus-up" title="g_test_dbus_up ()">g_test_dbus_up</a>                      (<em class="parameter"><code><a class="link" href="GTestDBus.html" title="GTestDBus"><span class="type">GTestDBus</span></a> *self</code></em>);
 <span class="returnvalue">void</span>                <a class="link" href="GTestDBus.html#g-test-dbus-stop" title="g_test_dbus_stop ()">g_test_dbus_stop</a>                    (<em class="parameter"><code><a class="link" href="GTestDBus.html" title="GTestDBus"><span class="type">GTestDBus</span></a> *self</code></em>);
 <span class="returnvalue">void</span>                <a class="link" href="GTestDBus.html#g-test-dbus-down" title="g_test_dbus_down ()">g_test_dbus_down</a>                    (<em class="parameter"><code><a class="link" href="GTestDBus.html" title="GTestDBus"><span class="type">GTestDBus</span></a> *self</code></em>);
@@ -60,7 +60,7 @@ const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnva
 <div class="refsect1">
 <a name="GTestDBus.object-hierarchy"></a><h2>Object Hierarchy</h2>
 <pre class="synopsis">
-  <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
+  <a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
    +----GTestDBus
 </pre>
 <pre class="synopsis">
@@ -77,7 +77,317 @@ const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnva
 <div class="refsect1">
 <a name="GTestDBus.description"></a><h2>Description</h2>
 <p>
-Helper to test D-Bus code wihtout messing up with user' session bus.
+A helper class for testing code which uses D-Bus without touching the user's
+session bus.
+</p>
+<p>
+</p>
+<div class="refsect2">
+<a name="gio-D-Bus-Test-Scaffolding"></a><h3>Creating unit tests using GTestDBus</h3>
+<p>
+    Testing of D-Bus services can be tricky because normally we only ever run
+    D-Bus services over an existing instance of the D-Bus daemon thus we
+    usually don't activate D-Bus services that are not yet installed into the
+    target system. The <a class="link" href="GTestDBus.html" title="GTestDBus"><span class="type">GTestDBus</span></a> object makes this easier for us by taking care
+    of the lower level tasks such as running a private D-Bus daemon and looking
+    up uninstalled services in customizable locations, typically in your source code tree.
+  </p>
+<p>
+    The first thing you will need is a separate service description file for the
+    D-Bus daemon. Typically a 'services' subdirectory of your 'tests' directory
+    is a good place to put this file.
+  </p>
+<p>
+    The service file should list your service along with an absolute path to the
+    uninstalled service executable in your source tree. Using autotools we would
+    achieve this by adding a file such as 'my-server.service.in' in the services
+    directory and have it processed by configure.
+    </p>
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3</pre></td>
+        <td class="listing_code"><pre class="programlisting">[D-BUS Service]
+    Name=org.gtk.GDBus.Examples.ObjectManager
+    Exec=@abs_top_builddir@/gio/tests/gdbus-example-objectmanager-server</pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p>
+    You will also need to indicate this service directory in your test
+    fixtures, so you will need to pass the path while compiling your
+    test cases. Typically this is done with autotools with an added
+    preprocessor flag specified to compile your tests such as:
+    </p>
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1</pre></td>
+        <td class="listing_code"><pre class="programlisting">-DTEST_SERVICES=\<span class="number">&quot;&quot;</span>$(abs_top_builddir)/tests/services<span class="number">&quot;</span><span class="symbol">\&quot;</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p>
+  </p>
+<p>
+    Once you have a service definition file which is local to your source tree,
+    you can proceed to setup a GTest fixture using the GTestDBus scaffolding.
+    </p>
+<div class="example">
+<a name="gdbus-test-fixture"></a><p class="title"><b>Example 27. Test Fixture for D-Bus services</b></p>
+<div class="example-contents">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
+35
+36
+37
+38
+39
+40
+41
+42
+43
+44
+45
+46
+47
+48
+49
+50
+51
+52
+53
+54
+55
+56
+57
+58
+59
+60
+61
+62
+63
+64
+65
+66
+67
+68
+69
+70
+71
+72
+73
+74
+75
+76
+77
+78
+79
+80
+81
+82
+83
+84
+85
+86
+87
+88
+89
+90
+91
+92
+93
+94
+95</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="preproc">#include </span><span class="number">&quot;gdbus-example-objectmanager-generated.h&quot;</span>
+<span class="comment">/*</span><span class="comment"> ---------------------------------------------------------------------------------------------------- </span><span class="comment">*/</span>
+<span class="comment">/*</span><span class="comment"> The fixture contains a GTestDBus object and</span>
+<span class="comment"> * a proxy to the service we're going to be testing.</span>
+<span class="comment"> </span><span class="comment">*/</span>
+<span class="type">typedef</span> <span class="type">struct</span> {
+  GTestDBus *dbus;
+  GDBusObjectManager *manager;
+} TestFixture;
+<span class="type">static</span> <span class="type">void</span>
+fixture_setup (TestFixture *fixture, <span class="type">gconstpointer</span> unused)
+{
+  <span class="type">GError</span> *error = <span class="number">NULL</span>;
+  <span class="comment">/*</span><span class="comment"> Create the global dbus-daemon for this test suite</span>
+<span class="comment">   </span><span class="comment">*/</span>
+  fixture-&gt;dbus = g_test_dbus_new (G_TEST_DBUS_NONE);
+  <span class="comment">/*</span><span class="comment"> Add the private directory with our in-tree service files, </span>
+<span class="comment">   * TEST_SERVICES is defined by the build system to point</span>
+<span class="comment">   * to the right directory.</span>
+<span class="comment">   </span><span class="comment">*/</span>
+  g_test_dbus_add_service_dir (fixture-&gt;dbus, TEST_SERVICES);
+  <span class="comment">/*</span><span class="comment"> Start the private D-Bus daemon</span>
+<span class="comment">   </span><span class="comment">*/</span>
+  g_test_dbus_up (fixture-&gt;dbus);
+  <span class="comment">/*</span><span class="comment"> Create the proxy that we're going to test</span>
+<span class="comment">   </span><span class="comment">*/</span>
+  fixture-&gt;manager =
+    example_object_manager_client_new_for_bus_sync (<span class="number">G_BUS_TYPE_SESSION</span>,
+                                                    G_DBUS_OBJECT_MANAGER_CLIENT_FLAGS_NONE,
+                                                    <span class="number">&quot;org.gtk.GDBus.Examples.ObjectManager&quot;</span>,
+                                                    <span class="number">&quot;/example/Animals&quot;</span>,
+                                                    <span class="number">NULL</span>, <span class="comment">/*</span><span class="comment"> GCancellable </span><span class="comment">*/</span>
+                                                    &amp;error);
+  <span class="keyword">if</span> (fixture-&gt;manager == <span class="number">NULL</span>)
+    <span class="preproc">g_error</span> (<span class="number">&quot;Error getting object manager client: </span><span class="symbol">%s</span><span class="number">&quot;</span>, error-&gt;message);
+}
+<span class="type">static</span> <span class="type">void</span>
+fixture_teardown (TestFixture *fixture, <span class="type">gconstpointer</span> unused)
+{
+  <span class="comment">/*</span><span class="comment"> Tear down the proxy</span>
+<span class="comment">   </span><span class="comment">*/</span>
+  <span class="keyword">if</span> (fixture-&gt;manager)
+    <span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> (fixture-&gt;manager);
+  <span class="comment">/*</span><span class="comment"> Stop the private D-Bus daemon</span>
+<span class="comment">   </span><span class="comment">*/</span>
+  g_test_dbus_down (fixture-&gt;dbus);
+  <span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span> (fixture-&gt;dbus);
+}
+<span class="comment">/*</span><span class="comment"> The gdbus-example-objectmanager-server exports 10 objects,</span>
+<span class="comment"> * to test the server has actually activated, let's ensure</span>
+<span class="comment"> * that 10 objects exist.</span>
+<span class="comment"> </span><span class="comment">*/</span>
+<span class="type">static</span> <span class="type">void</span>
+test_gtest_dbus (TestFixture *fixture, <span class="type">gconstpointer</span> unused)
+{
+  <span class="type">GList</span> *objects;
+  objects = g_dbus_object_manager_get_objects (fixture-&gt;manager);
+  <span class="preproc">g_assert_cmpint</span> (<span class="function"><a href="../glib/glib-Doubly-Linked-Lists.html#g-list-length">g_list_length</a></span> (objects), ==, <span class="number">10</span>);
+  <span class="function"><a href="../glib/glib-Doubly-Linked-Lists.html#g-list-free-full">g_list_free_full</a></span> (objects, <span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span>);
+}
+<span class="type">int</span>
+main (<span class="type">int</span>   argc,
+      <span class="type">char</span> *argv[])
+{
+  <span class="function"><a href="../glib/glib-Testing.html#g-test-init">g_test_init</a></span> (&amp;argc, &amp;argv, <span class="number">NULL</span>);
+  <span class="comment">/*</span><span class="comment"> This test simply ensures that we can bring the GTestDBus up and down a hand</span>
+<span class="comment">   * full of times in a row, each time successfully activating the in-tree service</span>
+<span class="comment">   </span><span class="comment">*/</span>
+  <span class="preproc">g_test_add</span> (<span class="number">&quot;/GTestDBus/Cycle1&quot;</span>, TestFixture, <span class="number">NULL</span>,
+              fixture_setup, test_gtest_dbus, fixture_teardown);
+  <span class="preproc">g_test_add</span> (<span class="number">&quot;/GTestDBus/Cycle2&quot;</span>, TestFixture, <span class="number">NULL</span>,
+              fixture_setup, test_gtest_dbus, fixture_teardown);
+  <span class="preproc">g_test_add</span> (<span class="number">&quot;/GTestDBus/Cycle3&quot;</span>, TestFixture, <span class="number">NULL</span>,
+              fixture_setup, test_gtest_dbus, fixture_teardown);
+  <span class="preproc">g_test_add</span> (<span class="number">&quot;/GTestDBus/Cycle4&quot;</span>, TestFixture, <span class="number">NULL</span>,
+              fixture_setup, test_gtest_dbus, fixture_teardown);
+  <span class="preproc">g_test_add</span> (<span class="number">&quot;/GTestDBus/Cycle5&quot;</span>, TestFixture, <span class="number">NULL</span>,
+              fixture_setup, test_gtest_dbus, fixture_teardown);
+  <span class="keyword">return</span> <span class="function"><a href="../glib/glib-Testing.html#g-test-run">g_test_run</a></span> ();
+}</pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+</div>
+<p><br class="example-break">
+  </p>
+<p>
+    Note that these examples only deal with isolating the D-Bus aspect of your
+    service. To successfully run isolated unit tests on your service you may need
+    some additional modifications to your test case fixture. For example; if your
+    service uses GSettings and installs a schema then it is important that your test service
+    not load the schema in the ordinary installed location (chances are that your service
+    and schema files are not yet installed, or worse; there is an older version of the
+    schema file sitting in the install location).
+  </p>
+<p>
+    Most of the time we can work around these obstacles using the environment. Since the
+    environment is inherited by the D-Bus daemon created by GTestDBus and then in turn
+    inherited by any services the D-Bus daemon activates, using the setup routine for your
+    fixture is a practical place to help sandbox your runtime environment. For the rather
+    typical GSettings case we can work around this by setting GSETTINGS_SCHEMA_DIR to the
+    in tree directory holding your schemas in the above <code class="function">fixture_setup()</code> routine.
+  </p>
+<p>
+    The GSettings schemas need to be locally pre-compiled for this to work. This can be achieved
+    by compiling the schemas locally as a step before running test cases, an autotools setup might
+    do the following in the directory holding schemas:
+    </p>
+<div class="informalexample">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4</pre></td>
+        <td class="listing_code"><pre class="programlisting">all-am:
+            $(GLIB_COMPILE_SCHEMAS) .
+    CLEANFILES += gschemas.compiled</pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p>
+  </p>
+</div>
+<p>
 </p>
 </div>
 <div class="refsect1">
@@ -168,10 +478,10 @@ Gets the flags of the <a class="link" href="GTestDBus.html" title="GTestDBus"><s
 <hr>
 <div class="refsect2">
 <a name="g-test-dbus-get-bus-address"></a><h3>g_test_dbus_get_bus_address ()</h3>
-<pre class="programlisting">const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       g_test_dbus_get_bus_address         (<em class="parameter"><code><a class="link" href="GTestDBus.html" title="GTestDBus"><span class="type">GTestDBus</span></a> *self</code></em>);</pre>
+<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       g_test_dbus_get_bus_address         (<em class="parameter"><code><a class="link" href="GTestDBus.html" title="GTestDBus"><span class="type">GTestDBus</span></a> *self</code></em>);</pre>
 <p>
 Get the address on which dbus-daemon is running. if <a class="link" href="GTestDBus.html#g-test-dbus-up" title="g_test_dbus_up ()"><code class="function">g_test_dbus_up()</code></a> has not
-been called yet, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned. This can be used with
+been called yet, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned. This can be used with
 <a class="link" href="GDBusConnection.html#g-dbus-connection-new-for-address" title="g_dbus_connection_new_for_address ()"><code class="function">g_dbus_connection_new_for_address()</code></a>
 </p>
 <div class="variablelist"><table border="0" class="variablelist">
@@ -187,7 +497,7 @@ been called yet, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><c
 </tr>
 <tr>
 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
-<td>the address of the bus, or <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
+<td>the address of the bus, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
 </tr>
 </tbody>
 </table></div>
@@ -196,7 +506,7 @@ been called yet, <a href="./../glib/glib/glib-Standard-Macros.html#NULL:CAPS"><c
 <div class="refsect2">
 <a name="g-test-dbus-add-service-dir"></a><h3>g_test_dbus_add_service_dir ()</h3>
 <pre class="programlisting"><span class="returnvalue">void</span>                g_test_dbus_add_service_dir         (<em class="parameter"><code><a class="link" href="GTestDBus.html" title="GTestDBus"><span class="type">GTestDBus</span></a> *self</code></em>,
-                                                         <em class="parameter"><code>const <a href="./../glib/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>);</pre>
+                                                         <em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>);</pre>
 <p>
 Add a path where dbus-daemon will lookup for .services files. This can't be
 called after <a class="link" href="GTestDBus.html#g-test-dbus-up" title="g_test_dbus_up ()"><code class="function">g_test_dbus_up()</code></a>.
@@ -225,15 +535,15 @@ called after <a class="link" href="GTestDBus.html#g-test-dbus-up" title="g_test_
 <pre class="programlisting"><span class="returnvalue">void</span>                g_test_dbus_up                      (<em class="parameter"><code><a class="link" href="GTestDBus.html" title="GTestDBus"><span class="type">GTestDBus</span></a> *self</code></em>);</pre>
 <p>
 Start a dbus-daemon instance and set DBUS_SESSION_BUS_ADDRESS. After this
-call, it is safe for unit tests to start sending messages on the session bug.
+call, it is safe for unit tests to start sending messages on the session bus.
 </p>
 <p>
-If this function is called from setup callback of <a href="./../glib/glib/glib-Testing.html#g-test-add"><code class="function">g_test_add()</code></a>,
+If this function is called from setup callback of <a href="../glib/glib-Testing.html#g-test-add"><code class="function">g_test_add()</code></a>,
 <a class="link" href="GTestDBus.html#g-test-dbus-down" title="g_test_dbus_down ()"><code class="function">g_test_dbus_down()</code></a> must be called in its teardown callback.
 </p>
 <p>
 If this function is called from unit test's <code class="function">main()</code>, then <a class="link" href="GTestDBus.html#g-test-dbus-down" title="g_test_dbus_down ()"><code class="function">g_test_dbus_down()</code></a>
-must be called after <a href="./../glib/glib/glib-Testing.html#g-test-run"><code class="function">g_test_run()</code></a>.
+must be called after <a href="../glib/glib-Testing.html#g-test-run"><code class="function">g_test_run()</code></a>.
 </p>
 <div class="variablelist"><table border="0" class="variablelist">
 <colgroup>
@@ -325,6 +635,6 @@ bus is running. It is not necessary to call this if unit test already calls
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.18</div>
+          Generated by GTK-Doc V1.18.1</div>
 </body>
 </html>