docs: let go of *

[platform/upstream/glib.git] / gio / gsimpleasyncresult.c

diff --git a/gio/gsimpleasyncresult.c b/gio/gsimpleasyncresult.c
index aa413a7..63ad6f5 100644 (file)
--- a/gio/gsimpleasyncresult.c
+++ b/gio/gsimpleasyncresult.c
@@ -111,9 +111,8 @@
  * baked_cb (Cake    *cake,
  *           gpointer user_data)
  * {
- *   /* In this example, this callback is not given a reference to the cake, so
- *    * the GSimpleAsyncResult has to take a reference to it.
- *    */
+ *   // In this example, this callback is not given a reference to the cake,
+ *   // so the GSimpleAsyncResult has to take a reference to it.
  *   GSimpleAsyncResult *result = user_data;
  *
  *   if (cake == NULL)
@@ -127,12 +126,11 @@
  *                                                g_object_unref);
  *
  *
- *   /* In this example, we assume that baked_cb is called as a callback from
- *    * the mainloop, so it's safe to complete the operation synchronously here.
- *    * If, however, _baker_prepare_cake () might call its callback without
- *    * first returning to the mainloop — inadvisable, but some APIs do so —
- *    * we would need to use g_simple_async_result_complete_in_idle().
- *    */
+ *   // In this example, we assume that baked_cb is called as a callback from
+ *   // the mainloop, so it's safe to complete the operation synchronously here.
+ *   // If, however, _baker_prepare_cake () might call its callback without
+ *   // first returning to the mainloop — inadvisable, but some APIs do so —
+ *   // we would need to use g_simple_async_result_complete_in_idle().
  *   g_simple_async_result_complete (result);
  *   g_object_unref (result);
  * }
@@ -171,9 +169,8 @@
  *                                                  g_object_unref);
  *       g_simple_async_result_complete_in_idle (simple);
  *       g_object_unref (simple);
- *       /* Drop the reference returned by _baker_get_cached_cake(); the
- *        * GSimpleAsyncResult has taken its own reference.
- *        */
+ *       // Drop the reference returned by _baker_get_cached_cake();
+ *       // the GSimpleAsyncResult has taken its own reference.
  *       g_object_unref (cake);
  *       return;
  *     }