Clarified/added docs for G_STRINGIFY, G_PASTE and G_STATIC_ASSERT, based

2008-10-29 16:04:38  Tim Janik  <timj@gtk.org>

        * glib/tmpl/macros_misc.sgml: Clarified/added docs for
        G_STRINGIFY, G_PASTE and G_STATIC_ASSERT, based on
        patches from Christian Persch and  Christian Dywan.

svn path=/trunk/; revision=7634

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 8a5c1e36706b01af995e3c1899ad57957a86696a..f280c2290366eca86f7b9cdbc568f394fc1133a2 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,9 @@
+2008-10-29 16:04:38  Tim Janik  <timj@gtk.org>
+
+       * glib/tmpl/macros_misc.sgml: Clarified/added docs for
+       G_STRINGIFY, G_PASTE and G_STATIC_ASSERT, based on
+       patches from Christian Persch and  Christian Dywan.
+
 2008-10-21  Alexander Larsson  <alexl@redhat.com>
 
         * gio/gio-sections.txt:

diff --git a/docs/reference/glib/tmpl/macros_misc.sgml b/docs/reference/glib/tmpl/macros_misc.sgml
index b84b5b93e98bef82af206769a3b17df662892ea8..31d7c9f1a987584d9665552305bff515fa75d42d 100644 (file)
--- a/docs/reference/glib/tmpl/macros_misc.sgml
+++ b/docs/reference/glib/tmpl/macros_misc.sgml
@@ -96,12 +96,36 @@ does not include <function>string.h</function> for you.
 
 <!-- ##### MACRO G_STRINGIFY ##### -->
 <para>
-Accepts a macro or a string and converts it into a string.
+Accepts a macro or a string and converts it into a string after
+preprocessor argument expansion.
 </para>
 
 @macro_or_string: a macro or a string.
 
 
+<!-- ##### MACRO G_PASTE ##### -->
+<para>
+Yields a new preprocessor pasted identifier 'identifier1identifier2'
+from its expanded arguments 'identifier1' and 'identifier2'.
+</para>
+
+@identifier1: an identifier
+@identifier2: an identifier
+@Since: 2.20
+
+
+<!-- ##### MACRO G_STATIC_ASSERT ##### -->
+<para>
+The G_STATIC_ASSERT macro lets the programmer check a condition at compile time,
+the condition needs to be compile time computable.
+The macro can be used in any place where a <literal>typedef</literal> is valid.
+The macro should only be used once per source code line.
+</para>
+
+@expr: a constant expression.
+@Since: 2.20
+
+
 <!-- ##### MACRO G_GNUC_EXTENSION ##### -->
 <para>
 Expands to <literal>__extension__</literal> when <command>gcc</command> is