[gtkmm] Regenerate docs once more to fix comment errors.

[José Alburquerque <jaalburqu src gnome org>]

commit 8dffcee8316871a5cbd410bb95e53c711e1b9dfb
Author: José Alburquerque <jaalburqu svn gnome org>
Date:   Sun Apr 11 17:53:43 2010 -0400

    	Regenerate docs once more to fix comment errors.
    
    	* gdk/src/gdk_docs.xml:
    	* gtk/src/gtk_docs.xml: Regenerated after fixing the
    	docextract_to_xml.py script to handle C++ multi-line comments in
    	function descriptions that include sample C++ code.

 ChangeLog            |    9 +++++++++
 gdk/src/gdk_docs.xml |   16 ++++++++--------
 gtk/src/gtk_docs.xml |   22 +++++++++++-----------
 3 files changed, 28 insertions(+), 19 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index aa5c8d1..e814b3d 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,14 @@
 2010-04-11  José Alburquerque  <jaalburqu svn gnome org>
 
+	Regenerate docs once more to fix comment errors.
+
+	* gdk/src/gdk_docs.xml:
+	* gtk/src/gtk_docs.xml: Regenerated after fixing the
+	docextract_to_xml.py script to handle C++ multi-line comments in
+	function descriptions that include sample C++ code.
+
+2010-04-11  José Alburquerque  <jaalburqu svn gnome org>
+
 	Regenerate docs with the new docextract_to_xml.py script.
 
 	* atk/src/atk_docs.xml:
diff --git a/gdk/src/gdk_docs.xml b/gdk/src/gdk_docs.xml
index 157916a..6b3af6d 100644
--- a/gdk/src/gdk_docs.xml
+++ b/gdk/src/gdk_docs.xml
@@ -2219,7 +2219,7 @@ static gboolean timeout_callback (gpointer data)
 {
 SomeWidget *self = data;
 
-/* do stuff with self */
+/ * do stuff with self * /
 
 self-&gt;timeout_id = 0;
 
@@ -6293,14 +6293,14 @@ in thread B:
 static gboolean
 idle_callback (gpointer data)
 {
-/* gdk_threads_enter(); would be needed for g_idle_add() */
+/ * gdk_threads_enter(); would be needed for g_idle_add() * /
 
 SomeWidget *self = data;
-/* do stuff with self */
+/ * do stuff with self * /
 
 self-&gt;idle_id = 0;
 
-/* gdk_threads_leave(); would be needed for g_idle_add() */
+/ * gdk_threads_leave(); would be needed for g_idle_add() * /
 return FALSE;
 }
 
@@ -6308,7 +6308,7 @@ static void
 some_widget_do_stuff_later (SomeWidget *self)
 {
 self-&gt;idle_id = gdk_threads_add_idle (idle_callback, self)
-/* using g_idle_add() here would require thread protection in the callback */
+/ * using g_idle_add() here would require thread protection in the callback * /
 }
 
 static void
@@ -13387,11 +13387,11 @@ motion events from a %GDK_MOTION_NOTIFY event usually works like this:
 
 |[
 { 
-/* motion_event handler */
+/ * motion_event handler * /
 x = motion_event-&gt;x;
 y = motion_event-&gt;y;
-/* handle (x,y) motion */
-gdk_event_request_motions (motion_event); /* handles is_hint events */
+/ * handle (x,y) motion * /
+gdk_event_request_motions (motion_event); / * handles is_hint events * /
 }
 ]|
 
diff --git a/gtk/src/gtk_docs.xml b/gtk/src/gtk_docs.xml
index c5b0cc8..c543b9a 100644
--- a/gtk/src/gtk_docs.xml
+++ b/gtk/src/gtk_docs.xml
@@ -23995,7 +23995,7 @@ visible_func (GtkTreeModel *model,
 GtkTreeIter  *iter,
 gpointer      data)
 {
-/* Visible if row is non-empty and first column is &quot;HI&quot; */
+/ * Visible if row is non-empty and first column is &quot;HI&quot; * /
 gchar *str;
 gboolean visible = FALSE;
 
@@ -25303,7 +25303,7 @@ is set on the result.
 GtkWidget *toplevel = gtk_widget_get_toplevel (widget);
 if (gtk_widget_is_toplevel (toplevel))
 {
-/* Perform action on toplevel. */
+/ * Perform action on toplevel. * /
 }
 ]|
 
@@ -29399,7 +29399,7 @@ on the window.
 static void
 fill_with_content (GtkWidget *vbox)
 {
-/* fill with content... */
+/ * fill with content... * /
 }
 
 int
@@ -32783,13 +32783,13 @@ Instead, use something similar to this:
 |[
 if (document_is_new)
 {
-/* the user just created a new document */
+/ * the user just created a new document * /
 gtk_file_chooser_set_current_folder (chooser, default_folder_for_saving);
 gtk_file_chooser_set_current_name (chooser, &quot;Untitled document&quot;);
 }
 else
 {
-/* the user edited an existing document */ 
+/ * the user edited an existing document * / 
 gtk_file_chooser_set_filename (chooser, existing_filename);
 }
 ]|
@@ -36898,7 +36898,7 @@ A common way to set up a group of radio group is the following:
 GSList *group = NULL;
 GtkRadioAction *action;
 
-while (/* more actions to add */)
+while (/ * more actions to add * /)
 {
 action = gtk_radio_action_new (...);
 
@@ -40430,7 +40430,7 @@ gchar *msgctxt = data;
 return (gchar*)g_dpgettext2 (GETTEXT_PACKAGE, msgctxt, msgid);
 }
 
-/* ... */
+/ * ... * /
 
 gtk_stock_add (items, G_N_ELEMENTS (items));
 gtk_stock_set_translate_func (&quot;odd-item-domain&quot;, my_translate_func, &quot;odd items&quot;); 
@@ -56397,13 +56397,13 @@ Instead, use something similar to this:
 |[
 if (document_is_new)
 {
-/* the user just created a new document */
+/ * the user just created a new document * /
 gtk_file_chooser_set_current_folder_uri (chooser, default_folder_for_saving);
 gtk_file_chooser_set_current_name (chooser, &quot;Untitled document&quot;);
 }
 else
 {
-/* the user edited an existing document */ 
+/ * the user edited an existing document * / 
 gtk_file_chooser_set_uri (chooser, existing_uri);
 }
 ]|
@@ -68340,13 +68340,13 @@ Instead, use something similar to this:
 |[
 if (document_is_new)
 {
-/* the user just created a new document */
+/ * the user just created a new document * /
 gtk_file_chooser_set_current_folder_file (chooser, default_file_for_saving);
 gtk_file_chooser_set_current_name (chooser, &quot;Untitled document&quot;);
 }
 else
 {
-/* the user edited an existing document */
+/ * the user edited an existing document * /
 gtk_file_chooser_set_file (chooser, existing_file);
 }
 ]|