docs: let go of *

Since we are no longer using sgml mode, using /* */ to
escape block comments inside examples does not work anymore.
Switch to using line comments with //
This commit is contained in:
Matthias Clasen
2014-02-14 21:33:36 -05:00
parent 450e7b1036
commit bc6ee788b4
31 changed files with 162 additions and 175 deletions

View File

@@ -155,7 +155,7 @@ enum {
* struct _MyClosure
* {
* GClosure closure;
* /* extra data goes here */
* // extra data goes here
* };
*
* static void
@@ -164,7 +164,7 @@ enum {
* {
* MyClosure *my_closure = (MyClosure *)closure;
*
* /* free extra data here */
* // free extra data here
* }
*
* MyClosure *my_closure_new (gpointer data)
@@ -175,7 +175,7 @@ enum {
* closure = g_closure_new_simple (sizeof (MyClosure), data);
* my_closure = (MyClosure *) closure;
*
* /* initialize extra data here */
* // initialize extra data here
*
* g_closure_add_finalize_notifier (closure, notify_data,
* my_closure_finalize);
@@ -609,7 +609,7 @@ g_closure_unref (GClosure *closure)
* |[<!-- language="C" -->
* closure = g_cclosure_new (cb_func, cb_data);
* g_source_set_closure (source, closure);
* g_closure_unref (closure); /&ast; GObject doesn't really need this &ast;/
* g_closure_unref (closure); // GObject doesn't really need this
* ]|
* Because g_source_set_closure() (and similar functions) take ownership of the
* initial reference count, if it is unowned, we instead can write: