Additions
authorMatthias Clasen <matthiasc@src.gnome.org>
Sun, 15 Jun 2008 01:50:24 +0000 (01:50 +0000)
committerMatthias Clasen <matthiasc@src.gnome.org>
Sun, 15 Jun 2008 01:50:24 +0000 (01:50 +0000)
svn path=/trunk/; revision=7042

docs/reference/ChangeLog
docs/reference/glib/tmpl/macros_misc.sgml
docs/reference/glib/tmpl/testing.sgml

index 64ed900..ce2e0a6 100644 (file)
@@ -1,6 +1,8 @@
 2008-06-14  Matthias Clasen  <mclasen@redhat.com>
 
-       * glib/tmpl/testing.sgml: Move docs around
+       * glib/tmpl/macros_misc.sgml: Document G_GNUC_MAY_ALIAS
+
+       * glib/tmpl/testing.sgml: Move docs around, and add more
 
        * glib/tmpl/unicode.sgml: Document break types
 
index 5ee1ee8..cbb7eea 100644 (file)
@@ -362,9 +362,14 @@ Since: 2.6
 
 <!-- ##### MACRO G_GNUC_MAY_ALIAS ##### -->
 <para>
-
+Expands to the GNU C <literal>may_alias</literal> type attribute 
+if the compiler is <command>gcc</command>. Types with this attribute 
+will not be subjected to type-based alias analysis, but are assumed
+to alias with any other type, just like char.
+See the GNU C documentation for details. 
 </para>
 
+Since: 2.14
 
 
 <!-- ##### FUNCTION G_LIKELY ##### -->
index bb442b5..797fef4 100644 (file)
@@ -245,10 +245,13 @@ Returns %TRUE if tests are run in quite mode.
 
 <!-- ##### MACRO g_test_queue_unref ##### -->
 <para>
-
+Enqueue an object to be released with g_object_unref() during
+the next teardown phase. This is equivalent to calling g_test_queue_destroy()
+with a destroy callback of g_object_unref().
 </para>
 
-@gobject: 
+@gobject: the object to unref
+@Since: 2.16
 
 
 <!-- ##### ENUM GTestTrapFlags ##### -->
@@ -300,55 +303,67 @@ determine what traps to set.
 
 <!-- ##### MACRO g_test_trap_assert_passed ##### -->
 <para>
-
+Assert that the last forked test passed. See g_test_trap_fork().
 </para>
 
+@Since: 2.16
 
 
 <!-- ##### MACRO g_test_trap_assert_failed ##### -->
 <para>
-
+Assert that the last forked test failed. See g_test_trap_fork().
 </para>
 
+@Since: 2.16
 
 
 <!-- ##### MACRO g_test_trap_assert_stdout ##### -->
 <para>
-
+Assert that the stdout output of the last forked test matches @soutpattern. 
+See g_test_trap_fork().
 </para>
 
-@soutpattern: 
+@soutpattern: a glob-style <link linkend="glib-Glob-style-pattern-matching">pattern</link>
+@Since: 2.16
 
 
 <!-- ##### MACRO g_test_trap_assert_stdout_unmatched ##### -->
 <para>
-
+Assert that the stdout output of the last forked test does not match 
+@soutpattern.  See g_test_trap_fork().
 </para>
 
-@soutpattern: 
+@soutpattern: a glob-style <link linkend="glib-Glob-style-pattern-matching">pattern</link>
+@Since: 2.16
 
 
 <!-- ##### MACRO g_test_trap_assert_stderr ##### -->
 <para>
-
+Assert that the stderr output of the last forked test matches @serrpattern. 
+See g_test_trap_fork().
 </para>
 
-@serrpattern: 
+@serrpattern: a glob-style <link linkend="glib-Glob-style-pattern-matching">pattern</link>
+@Since: 2.16
 
 
 <!-- ##### MACRO g_test_trap_assert_stderr_unmatched ##### -->
 <para>
-
+Assert that the stderr output of the last forked test does not match 
+@serrpattern.  See g_test_trap_fork().
 </para>
 
-@serrpattern: 
+@serrpattern: a glob-style <link linkend="glib-Glob-style-pattern-matching">pattern</link>
+@Since: 2.16
 
 
 <!-- ##### MACRO g_test_rand_bit ##### -->
 <para>
-
+Get a reproducible random bit (0 or 1),
+see g_test_rand_int() for details on test case random numbers.
 </para>
 
+@Since: 2.16
 
 
 <!-- ##### FUNCTION g_test_rand_int ##### -->
@@ -432,7 +447,7 @@ and @s2.
 @s1: a string (may be %NULL)
 @cmp: The comparsion operator to use. One of ==, !=, &lt;, &gt;, &lt;=, &gt;=.
 @s2: another string (may be %NULL)
-Since: 2.16
+@Since: 2.16
 
 
 <!-- ##### MACRO g_assert_cmpint ##### -->
@@ -450,7 +465,7 @@ and @n2.
 @n1: an integer
 @cmp: The comparsion operator to use. One of ==, !=, &lt;, &gt;, &lt;=, &gt;=.
 @n2: another integer
-Since: 2.16
+@Since: 2.16
 
 
 <!-- ##### MACRO g_assert_cmpuint ##### -->
@@ -468,7 +483,7 @@ and @n2.
 @n1: an unsigned integer
 @cmp: The comparsion operator to use. One of ==, !=, &lt;, &gt;, &lt;=, &gt;=.
 @n2: another unsigned integer
-Since: 2.16
+@Since: 2.16
 
 
 <!-- ##### MACRO g_assert_cmphex ##### -->
@@ -482,7 +497,7 @@ in the message.
 @n1: an unsigned integer
 @cmp: The comparsion operator to use. One of ==, !=, &lt;, &gt;, &lt;=, &gt;=.
 @n2: another unsigned integer
-Since: 2.16
+@Since: 2.16
 
 
 <!-- ##### MACRO g_assert_cmpfloat ##### -->
@@ -500,7 +515,7 @@ and @n2.
 @n1: an floating point number
 @cmp: The comparsion operator to use. One of ==, !=, &lt;, &gt;, &lt;=, &gt;=.
 @n2: another floating point number
-Since: 2.16
+@Since: 2.16
 
 
 <!-- ##### FUNCTION g_strcmp0 ##### -->