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

glib2 3.2.1-x64-mingw32 → 3.2.2-x64-mingw32

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>