* source to fire (automatically using the correct #GMainContext
* and priority).
* </para>
- *
+ * <para>
* Here is an example for chained asynchronous operations:
* |[
* typedef struct {
* return g_task_propagate_pointer (G_TASK (result), error);
* }
* ]|
+ * </para>
* </refsect2>
* <refsect2>
* <title>Asynchronous operations from synchronous ones</title>
* which will then dispatch the result back to the caller's
* #GMainContext when it completes.
* </para>
- *
+ * <para>
* Running a task in a thread:
* |[
* typedef struct {
* return g_task_propagate_pointer (G_TASK (result), error);
* }
* ]|
+ * </para>
* </refsect2>
* <refsect2>
* <title>Adding cancellability to uncancellable tasks</title>
* to make "GLib-friendly" asynchronous and cancellable
* synchronous variants of blocking APIs.
* </para>
- *
+ * <para>
* Cancelling a task:
* |[
* static void
* return cake;
* }
* ]|
+ * </para>
* </refsect2>
* <refsect2>
* <title>Porting from <literal>GSimpleAsyncResult</literal></title>
* 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 <filename>my-server.service.in</filename>
- * in the services
- * directory and have it processed by configure.
+ * in the services directory and have it processed by configure.
* |[
* [D-BUS Service]
* Name=org.gtk.GDBus.Examples.ObjectManager
* <para>
* Once you have a service definition file which is local to your source tree,
* you can proceed to set up a GTest fixture using the #GTestDBus scaffolding.
+ * <example>
* <title>Test Fixture for D-Bus services</title>
* <programlisting>
* <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="text" href="../../../../gio/tests/gdbus-test-fixture.c">