RubyGems - glib2 - Versions diffs - 3.2.1-x86-mingw32 → 3.2.2-x86-mingw32 - Mend

glib2 3.2.1-x86-mingw32 → 3.2.2-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 (927) hide show

data/vendor/local/share/gtk-doc/html/glib/glib-Testing.html CHANGED

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-utilities.html" title="GLib Utilities">
 <link rel="prev" href="glib-Bookmark-file-parser.html" title="Bookmark file parser">
 <link rel="next" href="glib-UNIX-specific-utilities-and-integration.html" title="UNIX-specific utilities and integration">
-<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -592,6 +592,7 @@
 <div class="refsect1">
 <a name="glib-Testing.includes"></a><h2>Includes</h2>
 <pre class="synopsis">#include &lt;glib.h&gt;
+#include &lt;glib/gi18n.h&gt;
 </pre>
 </div>
 <div class="refsect1">
@@ -619,7 +620,7 @@ and test cases implicitly. A simple call like</p>
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Testing.html#g-test-add-func">g_test_add_func</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;/misc/assertions&quot;</span><span class="gtkdoc opt">,</span> test_assertions<span class="gtkdoc opt">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Testing.html#g-test-add-func">g_test_add_func</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"/misc/assertions"</span><span class="symbol">,</span><span class="normal"> test_assertions</span><span class="symbol">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -634,9 +635,6 @@ an extended set of assertions for comparisons: <a class="link" href="glib-Testin
 <a class="link" href="glib-Testing.html#g-assert-cmpstr" title="g_assert_cmpstr()"><code class="function">g_assert_cmpstr()</code></a>, and <a class="link" href="glib-Testing.html#g-assert-cmpmem" title="g_assert_cmpmem()"><code class="function">g_assert_cmpmem()</code></a>. The advantage of these
 variants over plain <a class="link" href="glib-Testing.html#g-assert" title="g_assert()"><code class="function">g_assert()</code></a> is that the assertion messages can be
 more elaborate, and include the values of the compared entities.</p>
-<p>GLib ships with two utilities called gtester and
-gtester-report to facilitate running tests and producing
-nicely formatted test reports.</p>
 <p>A full example of creating a test suite with two tests using fixtures:</p>
 <div class="informalexample">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
@@ -702,72 +700,194 @@ nicely formatted test reports.</p>
 58
 59
 60</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc ppc">#include &lt;glib.h&gt;</span>
-<span class="gtkdoc ppc">#include &lt;locale.h&gt;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="preproc">#include</span><span class="normal"> </span><span class="string">&lt;glib.h&gt;</span>
+<span class="preproc">#include</span><span class="normal"> </span><span class="string">&lt;locale.h&gt;</span>
-<span class="gtkdoc kwc">typedef</span> <span class="gtkdoc kwb">struct</span> <span class="gtkdoc opt">{</span>
-  MyObject <span class="gtkdoc opt">*</span>obj<span class="gtkdoc opt">;</span>
-  OtherObject <span class="gtkdoc opt">*</span>helper<span class="gtkdoc opt">;</span>
-<span class="gtkdoc opt">}</span> MyObjectFixture<span class="gtkdoc opt">;</span>
+<span class="keyword">typedef</span><span class="normal"> </span><span class="keyword">struct</span><span class="normal"> </span><span class="cbracket">{</span>
+<span class="normal">  </span><span class="usertype">MyObject</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">obj</span><span class="symbol">;</span>
+<span class="normal">  </span><span class="usertype">OtherObject</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">helper</span><span class="symbol">;</span>
+<span class="cbracket">}</span><span class="normal"> MyObjectFixture</span><span class="symbol">;</span>
-<span class="gtkdoc kwb">static void</span>
-<span class="function">my_object_fixture_set_up</span> <span class="gtkdoc opt">(</span>MyObjectFixture <span class="gtkdoc opt">*</span>fixture<span class="gtkdoc opt">,</span>
-                          gconstpointer user_data<span class="gtkdoc opt">)</span>
-<span class="gtkdoc opt">{</span>
-  fixture<span class="gtkdoc opt">-&gt;</span>obj <span class="gtkdoc opt">=</span> <span class="function">my_object_new</span> <span class="gtkdoc opt">();</span>
-  <span class="function">my_object_set_prop1</span> <span class="gtkdoc opt">(</span>fixture<span class="gtkdoc opt">-&gt;</span>obj<span class="gtkdoc opt">,</span> <span class="string">&quot;some-value&quot;</span><span class="gtkdoc opt">);</span>
-  <span class="function">my_object_do_some_complex_setup</span> <span class="gtkdoc opt">(</span>fixture<span class="gtkdoc opt">-&gt;</span>obj<span class="gtkdoc opt">,</span> user_data<span class="gtkdoc opt">);</span>
+<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
+<span class="function">my_object_fixture_set_up</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">MyObjectFixture</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">fixture</span><span class="symbol">,</span>
+<span class="normal">                          </span><span class="usertype">gconstpointer</span><span class="normal"> user_data</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  fixture</span><span class="symbol">-&gt;</span><span class="normal">obj </span><span class="symbol">=</span><span class="normal"> </span><span class="function">my_object_new</span><span class="normal"> </span><span class="symbol">();</span>
+<span class="normal">  </span><span class="function">my_object_set_prop1</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">fixture</span><span class="symbol">-&gt;</span><span class="normal">obj</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"some-value"</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function">my_object_do_some_complex_setup</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">fixture</span><span class="symbol">-&gt;</span><span class="normal">obj</span><span class="symbol">,</span><span class="normal"> user_data</span><span class="symbol">);</span>
-  fixture<span class="gtkdoc opt">-&gt;</span>helper <span class="gtkdoc opt">=</span> <span class="function">other_object_new</span> <span class="gtkdoc opt">();</span>
-<span class="gtkdoc opt">}</span>
+<span class="normal">  fixture</span><span class="symbol">-&gt;</span><span class="normal">helper </span><span class="symbol">=</span><span class="normal"> </span><span class="function">other_object_new</span><span class="normal"> </span><span class="symbol">();</span>
+<span class="cbracket">}</span>
-<span class="gtkdoc kwb">static void</span>
-<span class="function">my_object_fixture_tear_down</span> <span class="gtkdoc opt">(</span>MyObjectFixture <span class="gtkdoc opt">*</span>fixture<span class="gtkdoc opt">,</span>
-                             gconstpointer user_data<span class="gtkdoc opt">)</span>
-<span class="gtkdoc opt">{</span>
-  <span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-clear-object">g_clear_object</a></span> <span class="gtkdoc opt">(&amp;</span>fixture<span class="gtkdoc opt">-&gt;</span>helper<span class="gtkdoc opt">);</span>
-  <span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-clear-object">g_clear_object</a></span> <span class="gtkdoc opt">(&amp;</span>fixture<span class="gtkdoc opt">-&gt;</span>obj<span class="gtkdoc opt">);</span>
-<span class="gtkdoc opt">}</span>
+<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
+<span class="function">my_object_fixture_tear_down</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">MyObjectFixture</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">fixture</span><span class="symbol">,</span>
+<span class="normal">                             </span><span class="usertype">gconstpointer</span><span class="normal"> user_data</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="function"><a href="../gobject-The-Base-Object-Type.html#g-clear-object">g_clear_object</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">fixture</span><span class="symbol">-&gt;</span><span class="normal">helper</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function"><a href="../gobject-The-Base-Object-Type.html#g-clear-object">g_clear_object</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">fixture</span><span class="symbol">-&gt;</span><span class="normal">obj</span><span class="symbol">);</span>
+<span class="cbracket">}</span>
-<span class="gtkdoc kwb">static void</span>
-<span class="function">test_my_object_test1</span> <span class="gtkdoc opt">(</span>MyObjectFixture <span class="gtkdoc opt">*</span>fixture<span class="gtkdoc opt">,</span>
-                      gconstpointer user_data<span class="gtkdoc opt">)</span>
-<span class="gtkdoc opt">{</span>
-  <span class="function"><a href="glib-Testing.html#g-assert-cmpstr">g_assert_cmpstr</a></span> <span class="gtkdoc opt">(</span><span class="function">my_object_get_property</span> <span class="gtkdoc opt">(</span>fixture<span class="gtkdoc opt">-&gt;</span>obj<span class="gtkdoc opt">), ==,</span> <span class="string">&quot;initial-value&quot;</span><span class="gtkdoc opt">);</span>
-<span class="gtkdoc opt">}</span>
+<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
+<span class="function">test_my_object_test1</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">MyObjectFixture</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">fixture</span><span class="symbol">,</span>
+<span class="normal">                      </span><span class="usertype">gconstpointer</span><span class="normal"> user_data</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="function"><a href="glib-Testing.html#g-assert-cmpstr">g_assert_cmpstr</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">my_object_get_property</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">fixture</span><span class="symbol">-&gt;</span><span class="normal">obj</span><span class="symbol">),</span><span class="normal"> </span><span class="symbol">==,</span><span class="normal"> </span><span class="string">"initial-value"</span><span class="symbol">);</span>
+<span class="cbracket">}</span>
-<span class="gtkdoc kwb">static void</span>
-<span class="function">test_my_object_test2</span> <span class="gtkdoc opt">(</span>MyObjectFixture <span class="gtkdoc opt">*</span>fixture<span class="gtkdoc opt">,</span>
-                      gconstpointer user_data<span class="gtkdoc opt">)</span>
-<span class="gtkdoc opt">{</span>
-  <span class="function">my_object_do_some_work_using_helper</span> <span class="gtkdoc opt">(</span>fixture<span class="gtkdoc opt">-&gt;</span>obj<span class="gtkdoc opt">,</span> fixture<span class="gtkdoc opt">-&gt;</span>helper<span class="gtkdoc opt">);</span>
-  <span class="function"><a href="glib-Testing.html#g-assert-cmpstr">g_assert_cmpstr</a></span> <span class="gtkdoc opt">(</span><span class="function">my_object_get_property</span> <span class="gtkdoc opt">(</span>fixture<span class="gtkdoc opt">-&gt;</span>obj<span class="gtkdoc opt">), ==,</span> <span class="string">&quot;updated-value&quot;</span><span class="gtkdoc opt">);</span>
-<span class="gtkdoc opt">}</span>
+<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
+<span class="function">test_my_object_test2</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">MyObjectFixture</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">fixture</span><span class="symbol">,</span>
+<span class="normal">                      </span><span class="usertype">gconstpointer</span><span class="normal"> user_data</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="function">my_object_do_some_work_using_helper</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">fixture</span><span class="symbol">-&gt;</span><span class="normal">obj</span><span class="symbol">,</span><span class="normal"> fixture</span><span class="symbol">-&gt;</span><span class="normal">helper</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function"><a href="glib-Testing.html#g-assert-cmpstr">g_assert_cmpstr</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">my_object_get_property</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">fixture</span><span class="symbol">-&gt;</span><span class="normal">obj</span><span class="symbol">),</span><span class="normal"> </span><span class="symbol">==,</span><span class="normal"> </span><span class="string">"updated-value"</span><span class="symbol">);</span>
+<span class="cbracket">}</span>
-<span class="gtkdoc kwb">int</span>
-<span class="function">main</span> <span class="gtkdoc opt">(</span><span class="gtkdoc kwb">int</span> argc<span class="gtkdoc opt">,</span> <span class="gtkdoc kwb">char</span> <span class="gtkdoc opt">*</span>argv<span class="gtkdoc opt">[])</span>
-<span class="gtkdoc opt">{</span>
-  <span class="function">setlocale</span> <span class="gtkdoc opt">(</span>LC_ALL<span class="gtkdoc opt">,</span> <span class="string">&quot;&quot;</span><span class="gtkdoc opt">);</span>
+<span class="type">int</span>
+<span class="function">main</span><span class="normal"> </span><span class="symbol">(</span><span class="type">int</span><span class="normal"> argc</span><span class="symbol">,</span><span class="normal"> </span><span class="type">char</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">argv</span><span class="symbol">[])</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="function">setlocale</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">LC_ALL</span><span class="symbol">,</span><span class="normal"> </span><span class="string">""</span><span class="symbol">);</span>
-  <span class="function"><a href="glib-Testing.html#g-test-init">g_test_init</a></span> <span class="gtkdoc opt">(&amp;</span>argc<span class="gtkdoc opt">, &amp;</span>argv<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">);</span>
-  <span class="function"><a href="glib-Testing.html#g-test-bug-base">g_test_bug_base</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;http://bugzilla.gnome.org/show_bug.cgi?id=&quot;</span><span class="gtkdoc opt">);</span>
+<span class="normal">  </span><span class="function"><a href="glib-Testing.html#g-test-init">g_test_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">argc</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">argv</span><span class="symbol">,</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function"><a href="glib-Testing.html#g-test-bug-base">g_test_bug_base</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"http://bugzilla.gnome.org/show_bug.cgi?id="</span><span class="symbol">);</span>
-  <span class="gtkdoc slc">// Define the tests.</span>
-  <span class="function"><a href="glib-Testing.html#g-test-add">g_test_add</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;/my-object/test1&quot;</span><span class="gtkdoc opt">,</span> MyObjectFixture<span class="gtkdoc opt">,</span> <span class="string">&quot;some-user-data&quot;</span><span class="gtkdoc opt">,</span>
-              my_object_fixture_set_up<span class="gtkdoc opt">,</span> test_my_object_test1<span class="gtkdoc opt">,</span>
-              my_object_fixture_tear_down<span class="gtkdoc opt">);</span>
-  <span class="function"><a href="glib-Testing.html#g-test-add">g_test_add</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;/my-object/test2&quot;</span><span class="gtkdoc opt">,</span> MyObjectFixture<span class="gtkdoc opt">,</span> <span class="string">&quot;some-user-data&quot;</span><span class="gtkdoc opt">,</span>
-              my_object_fixture_set_up<span class="gtkdoc opt">,</span> test_my_object_test2<span class="gtkdoc opt">,</span>
-              my_object_fixture_tear_down<span class="gtkdoc opt">);</span>
+<span class="normal">  </span><span class="comment">// Define the tests.</span>
+<span class="normal">  </span><span class="function"><a href="glib-Testing.html#g-test-add">g_test_add</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"/my-object/test1"</span><span class="symbol">,</span><span class="normal"> MyObjectFixture</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"some-user-data"</span><span class="symbol">,</span>
+<span class="normal">              my_object_fixture_set_up</span><span class="symbol">,</span><span class="normal"> test_my_object_test1</span><span class="symbol">,</span>
+<span class="normal">              my_object_fixture_tear_down</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function"><a href="glib-Testing.html#g-test-add">g_test_add</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"/my-object/test2"</span><span class="symbol">,</span><span class="normal"> MyObjectFixture</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"some-user-data"</span><span class="symbol">,</span>
+<span class="normal">              my_object_fixture_set_up</span><span class="symbol">,</span><span class="normal"> test_my_object_test2</span><span class="symbol">,</span>
+<span class="normal">              my_object_fixture_tear_down</span><span class="symbol">);</span>
-  <span class="keyword">return</span> <span class="function"><a href="glib-Testing.html#g-test-run">g_test_run</a></span> <span class="gtkdoc opt">();</span>
-<span class="gtkdoc opt">}</span></pre></td>
+<span class="normal">  </span><span class="keyword">return</span><span class="normal"> </span><span class="function"><a href="glib-Testing.html#g-test-run">g_test_run</a></span><span class="normal"> </span><span class="symbol">();</span>
+<span class="cbracket">}</span></pre></td>
       </tr>
     </tbody>
   </table>
 </div>
 <p></p>
+<p>### Integrating GTest in your project</p>
+<p>If you are using the <a class="ulink" href="http://mesonbuild.com" target="_top">Meson</a> build system, you will
+typically use the provided <code class="literal"><code class="function">test()</code></code> primitive to call the test binaries,
+e.g.:</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
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16
+17</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="function">test</span><span class="symbol">(</span>
+<span class="normal">  </span><span class="string">'foo'</span><span class="symbol">,</span>
+<span class="normal">  </span><span class="function">executable</span><span class="symbol">(</span><span class="string">'foo'</span><span class="symbol">,</span><span class="normal"> </span><span class="string">'foo.c'</span><span class="symbol">,</span><span class="normal"> dependencies</span><span class="symbol">:</span><span class="normal"> deps</span><span class="symbol">),</span>
+<span class="normal">  env</span><span class="symbol">:</span><span class="normal"> </span><span class="symbol">[</span>
+<span class="normal">    </span><span class="string">'G_TEST_SRCDIR=@0@'</span><span class="symbol">.</span><span class="function">format</span><span class="symbol">(</span><span class="normal">meson</span><span class="symbol">.</span><span class="function">current_source_dir</span><span class="symbol">()),</span>
+<span class="normal">    </span><span class="string">'G_TEST_BUILDDIR=@0@'</span><span class="symbol">.</span><span class="function">format</span><span class="symbol">(</span><span class="normal">meson</span><span class="symbol">.</span><span class="function">current_build_dir</span><span class="symbol">()),</span>
+<span class="normal">  </span><span class="symbol">],</span>
+<span class="symbol">)</span>
+<span class="function">test</span><span class="symbol">(</span>
+<span class="normal">  </span><span class="string">'bar'</span><span class="symbol">,</span>
+<span class="normal">  </span><span class="function">executable</span><span class="symbol">(</span><span class="string">'bar'</span><span class="symbol">,</span><span class="normal"> </span><span class="string">'bar.c'</span><span class="symbol">,</span><span class="normal"> dependencies</span><span class="symbol">:</span><span class="normal"> deps</span><span class="symbol">),</span>
+<span class="normal">  env</span><span class="symbol">:</span><span class="normal"> </span><span class="symbol">[</span>
+<span class="normal">    </span><span class="string">'G_TEST_SRCDIR=@0@'</span><span class="symbol">.</span><span class="function">format</span><span class="symbol">(</span><span class="normal">meson</span><span class="symbol">.</span><span class="function">current_source_dir</span><span class="symbol">()),</span>
+<span class="normal">    </span><span class="string">'G_TEST_BUILDDIR=@0@'</span><span class="symbol">.</span><span class="function">format</span><span class="symbol">(</span><span class="normal">meson</span><span class="symbol">.</span><span class="function">current_build_dir</span><span class="symbol">()),</span>
+<span class="normal">  </span><span class="symbol">],</span>
+<span class="symbol">)</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p></p>
+<p>If you are using Autotools, you're strongly encouraged to use the Automake
+<a class="ulink" href="https://testanything.org/" target="_top">TAP</a> harness; GLib provides template files for
+easily integrating with it:</p>
+<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
+<li class="listitem"><p><a class="ulink" href="https://git.gnome.org/browse/glib/tree/glib-tap.mk" target="_top">glib-tap.mk</a></p></li>
+<li class="listitem"><p><a class="ulink" href="https://git.gnome.org/browse/glib/tree/tap-test" target="_top">tap-test</a></p></li>
+<li class="listitem"><p><a class="ulink" href="https://git.gnome.org/browse/glib/tree/tap-driver.sh" target="_top">tap-driver.sh</a></p></li>
+</ul></div>
+<p>You can copy these files in your own project's root directory, and then
+set up your <code class="literal">Makefile.am</code> file to reference them, for instance:</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
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="normal">include $</span><span class="symbol">(</span><span class="normal">top_srcdir</span><span class="symbol">)/</span><span class="normal">glib</span><span class="symbol">-</span><span class="normal">tap</span><span class="symbol">.</span><span class="normal">mk</span>
+<span class="preproc"># test</span><span class="normal"> binaries</span>
+<span class="normal">test_programs </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">\</span>
+<span class="normal">  foo </span><span class="symbol">\</span>
+<span class="normal">  bar</span>
+<span class="preproc"># data</span><span class="normal"> distributed in the tarball</span>
+<span class="normal">dist_test_data </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">\</span>
+<span class="normal">  foo</span><span class="symbol">.</span><span class="normal">data</span><span class="symbol">.</span><span class="normal">txt </span><span class="symbol">\</span>
+<span class="normal">  bar</span><span class="symbol">.</span><span class="normal">data</span><span class="symbol">.</span><span class="normal">txt</span>
+<span class="preproc"># data</span><span class="normal"> not distributed in the tarball</span>
+<span class="normal">test_data </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">\</span>
+<span class="normal">  blah</span><span class="symbol">.</span><span class="normal">data</span><span class="symbol">.</span><span class="normal">txt</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p></p>
+<p>Make sure to distribute the TAP files, using something like the following
+in your top-level <code class="literal">Makefile.am</code>:</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"><span class="normal">EXTRA_DIST </span><span class="symbol">+=</span><span class="normal"> </span><span class="symbol">\</span>
+<span class="normal">  tap</span><span class="symbol">-</span><span class="normal">driver</span><span class="symbol">.</span><span class="normal">sh </span><span class="symbol">\</span>
+<span class="normal">  tap</span><span class="symbol">-</span><span class="normal">test</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+<p></p>
+<p><code class="literal">glib-tap.mk</code> will be distributed implicitly due to being included in a
+<code class="literal">Makefile.am</code>. All three files should be added to version control.</p>
+<p>If you don't have access to the Autotools TAP harness, you can use the
+gtester and gtester-report tools, and use
+the <a class="ulink" href="https://git.gnome.org/browse/glib/tree/glib.mk" target="_top">glib.mk</a> Automake
+template provided by GLib.</p>
 </div>
 <div class="refsect1">
 <a name="glib-Testing.functions_details"></a><h2>Functions</h2>
@@ -877,12 +997,13 @@ This can also be used to force a test to run that would otherwise
 be skipped (ie, a test whose name contains "/subprocess").</p></li>
 <li class="listitem">
 <p><code class="literal">-m {perf|slow|thorough|quick|undefined|no-undefined}</code>: Execute tests according to these test modes:</p>
-<p><code class="literal">perf</code>: Performance tests, may take long and report results.</p>
-<p><code class="literal">slow</code>, <code class="literal">thorough</code>: Slow and thorough tests, may take quite long and maximize coverage.</p>
-<p><code class="literal">quick</code>: Quick tests, should run really quickly and give good coverage.</p>
+<p><code class="literal">perf</code>: Performance tests, may take long and report results (off by default).</p>
+<p><code class="literal">slow</code>, <code class="literal">thorough</code>: Slow and thorough tests, may take quite long and maximize coverage
+(off by default).</p>
+<p><code class="literal">quick</code>: Quick tests, should run really quickly and give good coverage (the default).</p>
 <p><code class="literal">undefined</code>: Tests for undefined behaviour, may provoke programming errors
 under <a class="link" href="glib-Testing.html#g-test-trap-subprocess" title="g_test_trap_subprocess ()"><code class="function">g_test_trap_subprocess()</code></a> or <a class="link" href="glib-Testing.html#g-test-expect-message" title="g_test_expect_message ()"><code class="function">g_test_expect_message()</code></a> to check
-that appropriate assertions or warnings are given</p>
+that appropriate assertions or warnings are given (the default).</p>
 <p><code class="literal">no-undefined</code>: Avoid tests for undefined behaviour</p>
 </li>
 <li class="listitem"><p><code class="literal">--debug-log</code>: Debug test logging output.</p></li>
@@ -940,6 +1061,9 @@ will cause <a class="link" href="glib-Testing.html#g-test-init" title="g_test_in
 <p>Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if tests are run in quick mode.
 Exactly one of <a class="link" href="glib-Testing.html#g-test-quick" title="g_test_quick"><code class="function">g_test_quick()</code></a> and <a class="link" href="glib-Testing.html#g-test-slow" title="g_test_slow"><code class="function">g_test_slow()</code></a> is active in any run;
 there is no "medium speed".</p>
+<p>By default, tests are run in quick mode. In tests that use
+<a class="link" href="glib-Testing.html#g-test-init" title="g_test_init ()"><code class="function">g_test_init()</code></a>, the options <code class="literal">-m quick</code>, <code class="literal">-m slow</code> and <code class="literal">-m thorough</code>
+can be used to change this.</p>
 <div class="refsect3">
 <a name="g-test-quick.returns"></a><h4>Returns</h4>
 <p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if in quick mode</p>
@@ -952,6 +1076,9 @@ there is no "medium speed".</p>
 <p>Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if tests are run in slow mode.
 Exactly one of <a class="link" href="glib-Testing.html#g-test-quick" title="g_test_quick"><code class="function">g_test_quick()</code></a> and <a class="link" href="glib-Testing.html#g-test-slow" title="g_test_slow"><code class="function">g_test_slow()</code></a> is active in any run;
 there is no "medium speed".</p>
+<p>By default, tests are run in quick mode. In tests that use
+<a class="link" href="glib-Testing.html#g-test-init" title="g_test_init ()"><code class="function">g_test_init()</code></a>, the options <code class="literal">-m quick</code>, <code class="literal">-m slow</code> and <code class="literal">-m thorough</code>
+can be used to change this.</p>
 <div class="refsect3">
 <a name="g-test-slow.returns"></a><h4>Returns</h4>
 <p> the opposite of <a class="link" href="glib-Testing.html#g-test-quick" title="g_test_quick"><code class="function">g_test_quick()</code></a></p>
@@ -963,6 +1090,9 @@ there is no "medium speed".</p>
 <pre class="programlisting">#define             g_test_thorough()</pre>
 <p>Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if tests are run in thorough mode, equivalent to
 <a class="link" href="glib-Testing.html#g-test-slow" title="g_test_slow"><code class="function">g_test_slow()</code></a>.</p>
+<p>By default, tests are run in quick mode. In tests that use
+<a class="link" href="glib-Testing.html#g-test-init" title="g_test_init ()"><code class="function">g_test_init()</code></a>, the options <code class="literal">-m quick</code>, <code class="literal">-m slow</code> and <code class="literal">-m thorough</code>
+can be used to change this.</p>
 <div class="refsect3">
 <a name="g-test-thorough.returns"></a><h4>Returns</h4>
 <p> the same thing as <a class="link" href="glib-Testing.html#g-test-slow" title="g_test_slow"><code class="function">g_test_slow()</code></a></p>
@@ -973,6 +1103,9 @@ there is no "medium speed".</p>
 <a name="g-test-perf"></a><h3>g_test_perf</h3>
 <pre class="programlisting">#define             g_test_perf()</pre>
 <p>Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if tests are run in performance mode.</p>
+<p>By default, tests are run in quick mode. In tests that use
+<a class="link" href="glib-Testing.html#g-test-init" title="g_test_init ()"><code class="function">g_test_init()</code></a>, the option <code class="literal">-m perf</code> enables performance tests, while
+<code class="literal">-m quick</code> disables them.</p>
 <div class="refsect3">
 <a name="g-test-perf.returns"></a><h4>Returns</h4>
 <p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if in performance mode</p>
@@ -983,6 +1116,8 @@ there is no "medium speed".</p>
 <a name="g-test-verbose"></a><h3>g_test_verbose</h3>
 <pre class="programlisting">#define             g_test_verbose()</pre>
 <p>Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if tests are run in verbose mode.
+In tests that use <a class="link" href="glib-Testing.html#g-test-init" title="g_test_init ()"><code class="function">g_test_init()</code></a>, the option <code class="literal">--verbose</code> enables this,
+while <code class="literal">-q</code> or <code class="literal">--quiet</code> disables it.
 The default is neither <a class="link" href="glib-Testing.html#g-test-verbose" title="g_test_verbose"><code class="function">g_test_verbose()</code></a> nor <a class="link" href="glib-Testing.html#g-test-quiet" title="g_test_quiet"><code class="function">g_test_quiet()</code></a>.</p>
 <div class="refsect3">
 <a name="g-test-verbose.returns"></a><h4>Returns</h4>
@@ -995,7 +1130,10 @@ The default is neither <a class="link" href="glib-Testing.html#g-test-verbose" t
 <pre class="programlisting">#define             g_test_undefined()</pre>
 <p>Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if tests may provoke assertions and other formally-undefined
 behaviour, to verify that appropriate warnings are given. It might, in some
-cases, be useful to turn this off if running tests under valgrind.</p>
+cases, be useful to turn this off with if running tests under valgrind;
+in tests that use <a class="link" href="glib-Testing.html#g-test-init" title="g_test_init ()"><code class="function">g_test_init()</code></a>, the option <code class="literal">-m no-undefined</code> disables
+those tests, while <code class="literal">-m undefined</code> explicitly enables them (the default
+behaviour).</p>
 <div class="refsect3">
 <a name="g-test-undefined.returns"></a><h4>Returns</h4>
 <p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if tests may provoke programming errors</p>
@@ -1006,6 +1144,8 @@ cases, be useful to turn this off if running tests under valgrind.</p>
 <a name="g-test-quiet"></a><h3>g_test_quiet</h3>
 <pre class="programlisting">#define             g_test_quiet()</pre>
 <p>Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if tests are run in quiet mode.
+In tests that use <a class="link" href="glib-Testing.html#g-test-init" title="g_test_init ()"><code class="function">g_test_init()</code></a>, the option <code class="literal">-q</code> or <code class="literal">--quiet</code> enables
+this, while <code class="literal">--verbose</code> disables it.
 The default is neither <a class="link" href="glib-Testing.html#g-test-verbose" title="g_test_verbose"><code class="function">g_test_verbose()</code></a> nor <a class="link" href="glib-Testing.html#g-test-quiet" title="g_test_quiet"><code class="function">g_test_quiet()</code></a>.</p>
 <div class="refsect3">
 <a name="g-test-quiet.returns"></a><h4>Returns</h4>
@@ -1105,7 +1245,7 @@ required via the <code class="literal">-p</code> command-line option or <a class
 </tr>
 <tr>
 <td class="parameter_name"><p>test_func</p></td>
-<td class="parameter_description"><p>  The test function to invoke for this test. </p></td>
+<td class="parameter_description"><p>The test function to invoke for this test. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td>
 </tr>
 </tbody>
@@ -1177,7 +1317,7 @@ required via the <code class="literal">-p</code> command-line option or <a class
 </tr>
 <tr>
 <td class="parameter_name"><p>test_func</p></td>
-<td class="parameter_description"><p> The test function to invoke for this test. </p></td>
+<td class="parameter_description"><p>The test function to invoke for this test. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td>
 </tr>
 </tbody>
@@ -1422,7 +1562,7 @@ but you don't need to free the return value.</p>
 </div>
 <div class="refsect3">
 <a name="g-test-get-dir.returns"></a><h4>Returns</h4>
-<p> the path of the directory, owned by GLib. </p>
+<p>the path of the directory, owned by GLib. </p>
 <p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> filename]</span></p>
 </div>
 <p class="since">Since: <a class="link" href="api-index-2-38.html#api-index-2.38">2.38</a></p>
@@ -1465,7 +1605,7 @@ the test.</p>
 </colgroup>
 <tbody><tr>
 <td class="parameter_name"><p>msg</p></td>
-<td class="parameter_description"><p> explanation. </p></td>
+<td class="parameter_description"><p>explanation. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
 </tr></tbody>
 </table></div>
@@ -1495,7 +1635,7 @@ the test.</p>
 </colgroup>
 <tbody><tr>
 <td class="parameter_name"><p>msg</p></td>
-<td class="parameter_description"><p> explanation. </p></td>
+<td class="parameter_description"><p>explanation. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
 </tr></tbody>
 </table></div>
@@ -1683,7 +1823,7 @@ function which needs the special behavior.</p>
 <a class="link" href="glib-Message-Logging.html#g-log-structured" title="g_log_structured ()"><code class="function">g_log_structured()</code></a> or <a class="link" href="glib-Message-Logging.html#g-log-structured-array" title="g_log_structured_array ()"><code class="function">g_log_structured_array()</code></a>). To change the fatal
 behaviour for specific log messages, programs must install a custom log
 writer function using <a class="link" href="glib-Message-Logging.html#g-log-set-writer-func" title="g_log_set_writer_func ()"><code class="function">g_log_set_writer_func()</code></a>.See
-Using Structured Logging.</p>
+<a class="link" href="glib-Message-Logging.html#using-structured-logging" title="Using Structured Logging">Using Structured Logging</a>.</p>
 <div class="refsect3">
 <a name="g-test-log-set-fatal-handler.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -1807,9 +1947,9 @@ callback A before callback B will cause <code class="function">B()</code> to be
 <div class="refsect2">
 <a name="g-test-queue-unref"></a><h3>g_test_queue_unref()</h3>
 <pre class="programlisting">#define             g_test_queue_unref(gobject)</pre>
-<p>Enqueue an object to be released with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> during
+<p>Enqueue an object to be released with <a href="../gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> during
 the next teardown phase. This is equivalent to calling
-<a class="link" href="glib-Testing.html#g-test-queue-destroy" title="g_test_queue_destroy ()"><code class="function">g_test_queue_destroy()</code></a> with a destroy callback of <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
+<a class="link" href="glib-Testing.html#g-test-queue-destroy" title="g_test_queue_destroy ()"><code class="function">g_test_queue_destroy()</code></a> with a destroy callback of <a href="../gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</p>
 <div class="refsect3">
 <a name="g-test-queue-unref.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
@@ -1843,7 +1983,7 @@ message is logged, it will not be printed, and the test case will
 not abort.</p>
 <p>This API may only be used with the old logging API (<a class="link" href="glib-Message-Logging.html#g-log" title="g_log ()"><code class="function">g_log()</code></a> without
 <code class="literal">G_LOG_USE_STRUCTURED</code> defined). It will not work with the structured logging
-API. See Testing for Messages.</p>
+API. See <a class="link" href="glib-Message-Logging.html#testing-for-messages" title="Testing for Messages">Testing for Messages</a>.</p>
 <p>Use <a class="link" href="glib-Testing.html#g-test-assert-expected-messages" title="g_test_assert_expected_messages"><code class="function">g_test_assert_expected_messages()</code></a> to assert that all
 previously-expected messages have been seen and suppressed.</p>
 <p>You can call this multiple times in a row, if multiple messages are
@@ -1861,13 +2001,13 @@ the same order as the calls to <a class="link" href="glib-Testing.html#g-test-ex
 5
 6
 7</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc slc">// g_main_context_push_thread_default() should fail if the</span>
-<span class="gtkdoc slc">// context is already owned by another thread.</span>
-<span class="function"><a href="glib-Testing.html#g-test-expect-message">g_test_expect_message</a></span> <span class="gtkdoc opt">(</span>G_LOG_DOMAIN<span class="gtkdoc opt">,</span>
-                       G_LOG_LEVEL_CRITICAL<span class="gtkdoc opt">,</span>
-                       <span class="string">&quot;assertion*acquired_context*failed&quot;</span><span class="gtkdoc opt">);</span>
-<span class="function"><a href="glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">g_main_context_push_thread_default</a></span> <span class="gtkdoc opt">(</span>bad_context<span class="gtkdoc opt">);</span>
-<span class="function"><a href="glib-Testing.html#g-test-assert-expected-messages">g_test_assert_expected_messages</a></span> <span class="gtkdoc opt">();</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="comment">// g_main_context_push_thread_default() should fail if the</span>
+<span class="comment">// context is already owned by another thread.</span>
+<span class="function"><a href="glib-Testing.html#g-test-expect-message">g_test_expect_message</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="glib-Message-Logging.html#G-LOG-DOMAIN:CAPS">G_LOG_DOMAIN</a></span><span class="symbol">,</span>
+<span class="normal">                       <a href="glib-Message-Logging.html#G-LOG-LEVEL-CRITICAL:CAPS">G_LOG_LEVEL_CRITICAL</a></span><span class="symbol">,</span>
+<span class="normal">                       </span><span class="string">"assertion*acquired_context*failed"</span><span class="symbol">);</span>
+<span class="function"><a href="glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">g_main_context_push_thread_default</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">bad_context</span><span class="symbol">);</span>
+<span class="function"><a href="glib-Testing.html#g-test-assert-expected-messages">g_test_assert_expected_messages</a></span><span class="normal"> </span><span class="symbol">();</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -1890,7 +2030,7 @@ expected via <a class="link" href="glib-Testing.html#g-test-expect-message" titl
 <tbody>
 <tr>
 <td class="parameter_name"><p>log_domain</p></td>
-<td class="parameter_description"><p> the log domain of the message. </p></td>
+<td class="parameter_description"><p>the log domain of the message. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
 </tr>
 <tr>
@@ -1916,7 +2056,7 @@ expected via <a class="link" href="glib-Testing.html#g-test-expect-message" titl
 <a class="link" href="glib-Testing.html#g-test-expect-message" title="g_test_expect_message ()"><code class="function">g_test_expect_message()</code></a> have been seen and suppressed.</p>
 <p>This API may only be used with the old logging API (<a class="link" href="glib-Message-Logging.html#g-log" title="g_log ()"><code class="function">g_log()</code></a> without
 <code class="literal">G_LOG_USE_STRUCTURED</code> defined). It will not work with the structured logging
-API. See Testing for Messages.</p>
+API. See <a class="link" href="glib-Message-Logging.html#testing-for-messages" title="Testing for Messages">Testing for Messages</a>.</p>
 <p>If messages at <a class="link" href="glib-Message-Logging.html#G-LOG-LEVEL-DEBUG:CAPS"><code class="literal">G_LOG_LEVEL_DEBUG</code></a> are emitted, but not explicitly
 expected via <a class="link" href="glib-Testing.html#g-test-expect-message" title="g_test_expect_message ()"><code class="function">g_test_expect_message()</code></a> then they will be ignored.</p>
 <p class="since">Since: <a class="link" href="api-index-2-34.html#api-index-2.34">2.34</a></p>
@@ -1988,30 +2128,30 @@ message.</p>
 22
 23
 24</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">static void</span>
-<span class="function">test_create_large_object</span> <span class="gtkdoc opt">(</span><span class="gtkdoc kwb">void</span><span class="gtkdoc opt">)</span>
-<span class="gtkdoc opt">{</span>
-  <span class="keyword">if</span> <span class="gtkdoc opt">(</span><span class="function"><a href="glib-Testing.html#g-test-subprocess">g_test_subprocess</a></span> <span class="gtkdoc opt">())</span>
-    <span class="gtkdoc opt">{</span>
-      <span class="function">my_object_new</span> <span class="gtkdoc opt">(</span><span class="number">1000000</span><span class="gtkdoc opt">);</span>
-      <span class="keyword">return</span><span class="gtkdoc opt">;</span>
-    <span class="gtkdoc opt">}</span>
+        <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
+<span class="function">test_create_large_object</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="glib-Testing.html#g-test-subprocess">g_test_subprocess</a></span><span class="normal"> </span><span class="symbol">())</span>
+<span class="normal">    </span><span class="cbracket">{</span>
+<span class="normal">      </span><span class="function">my_object_new</span><span class="normal"> </span><span class="symbol">(</span><span class="number">1000000</span><span class="symbol">);</span>
+<span class="normal">      </span><span class="keyword">return</span><span class="symbol">;</span>
+<span class="normal">    </span><span class="cbracket">}</span>
-  <span class="gtkdoc slc">// Reruns this same test in a subprocess</span>
-  <span class="function"><a href="glib-Testing.html#g-test-trap-subprocess">g_test_trap_subprocess</a></span> <span class="gtkdoc opt">(</span>NULL<span class="gtkdoc opt">,</span> <span class="number">0</span><span class="gtkdoc opt">,</span> <span class="number">0</span><span class="gtkdoc opt">);</span>
-  <span class="function"><a href="glib-Testing.html#g-test-trap-assert-failed">g_test_trap_assert_failed</a></span> <span class="gtkdoc opt">();</span>
-  <span class="function"><a href="glib-Testing.html#g-test-trap-assert-stderr">g_test_trap_assert_stderr</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;*ERROR*too large*&quot;</span><span class="gtkdoc opt">);</span>
-<span class="gtkdoc opt">}</span>
+<span class="normal">  </span><span class="comment">// Reruns this same test in a subprocess</span>
+<span class="normal">  </span><span class="function"><a href="glib-Testing.html#g-test-trap-subprocess">g_test_trap_subprocess</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function"><a href="glib-Testing.html#g-test-trap-assert-failed">g_test_trap_assert_failed</a></span><span class="normal"> </span><span class="symbol">();</span>
+<span class="normal">  </span><span class="function"><a href="glib-Testing.html#g-test-trap-assert-stderr">g_test_trap_assert_stderr</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"*ERROR*too large*"</span><span class="symbol">);</span>
+<span class="cbracket">}</span>
-<span class="gtkdoc kwb">int</span>
-<span class="function">main</span> <span class="gtkdoc opt">(</span><span class="gtkdoc kwb">int</span> argc<span class="gtkdoc opt">,</span> <span class="gtkdoc kwb">char</span> <span class="gtkdoc opt">**</span>argv<span class="gtkdoc opt">)</span>
-<span class="gtkdoc opt">{</span>
-  <span class="function"><a href="glib-Testing.html#g-test-init">g_test_init</a></span> <span class="gtkdoc opt">(&amp;</span>argc<span class="gtkdoc opt">, &amp;</span>argv<span class="gtkdoc opt">,</span> NULL<span class="gtkdoc opt">);</span>
+<span class="type">int</span>
+<span class="function">main</span><span class="normal"> </span><span class="symbol">(</span><span class="type">int</span><span class="normal"> argc</span><span class="symbol">,</span><span class="normal"> </span><span class="type">char</span><span class="normal"> </span><span class="symbol">**</span><span class="normal">argv</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="function"><a href="glib-Testing.html#g-test-init">g_test_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">argc</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">argv</span><span class="symbol">,</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
-  <span class="function"><a href="glib-Testing.html#g-test-add-func">g_test_add_func</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;/myobject/create_large_object&quot;</span><span class="gtkdoc opt">,</span>
-                   test_create_large_object<span class="gtkdoc opt">);</span>
-  <span class="keyword">return</span> <span class="function"><a href="glib-Testing.html#g-test-run">g_test_run</a></span> <span class="gtkdoc opt">();</span>
-<span class="gtkdoc opt">}</span></pre></td>
+<span class="normal">  </span><span class="function"><a href="glib-Testing.html#g-test-add-func">g_test_add_func</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"/myobject/create_large_object"</span><span class="symbol">,</span>
+<span class="normal">                   test_create_large_object</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="keyword">return</span><span class="normal"> </span><span class="function"><a href="glib-Testing.html#g-test-run">g_test_run</a></span><span class="normal"> </span><span class="symbol">();</span>
+<span class="cbracket">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -2029,7 +2169,7 @@ message.</p>
 <tbody>
 <tr>
 <td class="parameter_name"><p>test_path</p></td>
-<td class="parameter_description"><p> Test to run in a subprocess. </p></td>
+<td class="parameter_description"><p>Test to run in a subprocess. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></td>
 </tr>
 <tr>
@@ -2233,19 +2373,19 @@ termination and validates child program outputs.</p>
 11
 12
 13</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="gtkdoc kwb">static void</span>
-<span class="function">test_fork_patterns</span> <span class="gtkdoc opt">(</span><span class="gtkdoc kwb">void</span><span class="gtkdoc opt">)</span>
-<span class="gtkdoc opt">{</span>
-  <span class="keyword">if</span> <span class="gtkdoc opt">(</span><span class="function"><a href="glib-Testing.html#g-test-trap-fork">g_test_trap_fork</a></span> <span class="gtkdoc opt">(</span><span class="number">0</span><span class="gtkdoc opt">,</span> G_TEST_TRAP_SILENCE_STDOUT <span class="gtkdoc opt">|</span> G_TEST_TRAP_SILENCE_STDERR<span class="gtkdoc opt">))</span>
-    <span class="gtkdoc opt">{</span>
-      <span class="function"><a href="glib-Warnings-and-Assertions.html#g-print">g_print</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;some stdout text: somagic17</span><span class="gtkdoc esc">\n</span><span class="string">&quot;</span><span class="gtkdoc opt">);</span>
-      <span class="function"><a href="glib-Warnings-and-Assertions.html#g-printerr">g_printerr</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;some stderr text: semagic43</span><span class="gtkdoc esc">\n</span><span class="string">&quot;</span><span class="gtkdoc opt">);</span>
-      <span class="function">exit</span> <span class="gtkdoc opt">(</span><span class="number">0</span><span class="gtkdoc opt">);</span> <span class="gtkdoc slc">// successful test run</span>
-    <span class="gtkdoc opt">}</span>
-  <span class="function"><a href="glib-Testing.html#g-test-trap-assert-passed">g_test_trap_assert_passed</a></span> <span class="gtkdoc opt">();</span>
-  <span class="function"><a href="glib-Testing.html#g-test-trap-assert-stdout">g_test_trap_assert_stdout</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;*somagic17*&quot;</span><span class="gtkdoc opt">);</span>
-  <span class="function"><a href="glib-Testing.html#g-test-trap-assert-stderr">g_test_trap_assert_stderr</a></span> <span class="gtkdoc opt">(</span><span class="string">&quot;*semagic43*&quot;</span><span class="gtkdoc opt">);</span>
-<span class="gtkdoc opt">}</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
+<span class="function">test_fork_patterns</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
+<span class="cbracket">{</span>
+<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="glib-Testing.html#g-test-trap-fork">g_test_trap_fork</a></span><span class="normal"> </span><span class="symbol">(</span><span class="number">0</span><span class="symbol">,</span><span class="normal"> <a href="glib-Testing.html#G-TEST-TRAP-SILENCE-STDOUT:CAPS">G_TEST_TRAP_SILENCE_STDOUT</a> </span><span class="symbol">|</span><span class="normal"> <a href="glib-Testing.html#G-TEST-TRAP-SILENCE-STDERR:CAPS">G_TEST_TRAP_SILENCE_STDERR</a></span><span class="symbol">))</span>
+<span class="normal">    </span><span class="cbracket">{</span>
+<span class="normal">      </span><span class="function"><a href="glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"some stdout text: somagic17</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">);</span>
+<span class="normal">      </span><span class="function"><a href="glib-Warnings-and-Assertions.html#g-printerr">g_printerr</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"some stderr text: semagic43</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">);</span>
+<span class="normal">      </span><span class="function">exit</span><span class="normal"> </span><span class="symbol">(</span><span class="number">0</span><span class="symbol">);</span><span class="normal"> </span><span class="comment">// successful test run</span>
+<span class="normal">    </span><span class="cbracket">}</span>
+<span class="normal">  </span><span class="function"><a href="glib-Testing.html#g-test-trap-assert-passed">g_test_trap_assert_passed</a></span><span class="normal"> </span><span class="symbol">();</span>
+<span class="normal">  </span><span class="function"><a href="glib-Testing.html#g-test-trap-assert-stdout">g_test_trap_assert_stdout</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"*somagic17*"</span><span class="symbol">);</span>
+<span class="normal">  </span><span class="function"><a href="glib-Testing.html#g-test-trap-assert-stderr">g_test_trap_assert_stderr</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"*semagic43*"</span><span class="symbol">);</span>
+<span class="cbracket">}</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -2451,7 +2591,7 @@ includes the actual values of <em class="parameter"><code>s1</code></em>
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Testing.html#g-assert-cmpstr">g_assert_cmpstr</a></span> <span class="gtkdoc opt">(</span>mystring<span class="gtkdoc opt">, ==,</span> <span class="string">&quot;fubar&quot;</span><span class="gtkdoc opt">);</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Testing.html#g-assert-cmpstr">g_assert_cmpstr</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">mystring</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">==,</span><span class="normal"> </span><span class="string">"fubar"</span><span class="symbol">);</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -2656,7 +2796,7 @@ One of ==, !=, &lt;, &gt;, &lt;=, &gt;=.</p></td>
 an error message is logged and the application is either terminated
 or the testcase marked as failed.</p>
 <p>The effect of <code class="literal">g_assert_cmpmem (m1, l1, m2, l2)</code> is
-the same as <code class="literal">g_assert_true (l1 == l2 &amp;&amp; memcmp (m1, m2, l1) == 0)</code>.
+the same as <code class="literal">g_assert_true (l1 == l2 &amp;amp;&amp;amp; memcmp (m1, m2, l1) == 0)</code>.
 The advantage of this macro is that it can produce a message that
 includes the actual values of <em class="parameter"><code>l1</code></em>
  and <em class="parameter"><code>l2</code></em>
@@ -2666,7 +2806,7 @@ includes the actual values of <em class="parameter"><code>l1</code></em>
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Testing.html#g-assert-cmpmem">g_assert_cmpmem</a></span> <span class="gtkdoc opt">(</span>buf<span class="gtkdoc opt">-&gt;</span>data<span class="gtkdoc opt">,</span> buf<span class="gtkdoc opt">-&gt;</span>len<span class="gtkdoc opt">,</span> expected<span class="gtkdoc opt">,</span> <span class="keyword">sizeof</span> <span class="gtkdoc opt">(</span>expected<span class="gtkdoc opt">));</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Testing.html#g-assert-cmpmem">g_assert_cmpmem</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">buf</span><span class="symbol">-&gt;</span><span class="normal">data</span><span class="symbol">,</span><span class="normal"> buf</span><span class="symbol">-&gt;</span><span class="normal">len</span><span class="symbol">,</span><span class="normal"> expected</span><span class="symbol">,</span><span class="normal"> </span><span class="keyword">sizeof</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">expected</span><span class="symbol">));</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -2742,8 +2882,8 @@ the error message and code.</p>
 <p>Debugging macro to check that a method has returned
 the correct <a class="link" href="glib-Error-Reporting.html#GError" title="struct GError"><span class="type">GError</span></a>.</p>
 <p>The effect of <code class="literal">g_assert_error (err, dom, c)</code> is
-the same as <code class="literal">g_assert_true (err != NULL &amp;&amp; err-&gt;domain
-== dom &amp;&amp; err-&gt;code == c)</code>. The advantage of this
+the same as <code class="literal">g_assert_true (err != NULL &amp;amp;&amp;amp; err-&gt;domain
+== dom &amp;amp;&amp;amp; err-&gt;code == c)</code>. The advantage of this
 macro is that it can produce a message that includes the incorrect
 error message and code.</p>
 <p>This can only be used to test for a specific error. If you want to
@@ -2930,7 +3070,7 @@ zero then <em class="parameter"><code>fixture</code></em>
 <tbody>
 <tr>
 <td class="parameter_name"><p>fixture</p></td>
-<td class="parameter_description"><p> the test fixture. </p></td>
+<td class="parameter_description"><p>the test fixture. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL must not be passed as the value in, out, in-out; or as a return value."><span class="acronym">not nullable</span></acronym>]</span></td>
 </tr>
 <tr>
@@ -2999,17 +3139,17 @@ called with the same fixture, but varying <em class="parameter"><code>test_name<
 </tr>
 <tr>
 <td class="parameter_name"><p>data_setup</p></td>
-<td class="parameter_description"><p> the function to set up the fixture data. </p></td>
+<td class="parameter_description"><p>the function to set up the fixture data. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>data_test</p></td>
-<td class="parameter_description"><p> the actual test function. </p></td>
+<td class="parameter_description"><p>the actual test function. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>data_teardown</p></td>
-<td class="parameter_description"><p> the function to teardown the fixture data. </p></td>
+<td class="parameter_description"><p>the function to teardown the fixture data. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid until first called."><span class="acronym">scope async</span></acronym>]</span></td>
 </tr>
 </tbody>
@@ -3215,7 +3355,7 @@ build from git) and are considered as distributed files.</p>
 <p><code class="literal">GTestTrapFlags</code> is deprecated and should not be used in newly-written code.</p>
 <p><a class="link" href="glib-Testing.html#GTestTrapFlags" title="enum GTestTrapFlags"><span class="type">GTestTrapFlags</span></a> is used only with <a class="link" href="glib-Testing.html#g-test-trap-fork" title="g_test_trap_fork ()"><code class="function">g_test_trap_fork()</code></a>,
 which is deprecated. <a class="link" href="glib-Testing.html#g-test-trap-subprocess" title="g_test_trap_subprocess ()"><code class="function">g_test_trap_subprocess()</code></a> uses
-<span class="type">GTestTrapSubprocessFlags</span>.</p>
+<a class="link" href="glib-Testing.html#GTestSubprocessFlags" title="enum GTestSubprocessFlags"><span class="type">GTestSubprocessFlags</span></a>.</p>
 </div>
 <p>Test traps are guards around forked tests.
 These flags determine what traps to set.</p>
@@ -3330,6 +3470,6 @@ not show stdout and stderr.</p>
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.25.1</div>
+<hr>Generated by GTK-Doc V1.27</div>
 </body>
 </html>