diff --git a/glib/docs.c b/glib/docs.c
index 875504a1d..781869d72 100644
--- a/glib/docs.c
+++ b/glib/docs.c
@@ -2587,9 +2587,9 @@
  *
  *   membuf = g_malloc (8192);
  *
- *   /* Some computation on membuf */
+ *   /<!-- -->* Some computation on membuf *<!-- -->/
  *
- *   /* membuf will be automatically freed here */
+ *   /<!-- -->* membuf will be automatically freed here *<!-- -->/
  *   return TRUE;
  * }
  * ]|