Update the comment in gmarshal.list
authorEmmanuele Bassi <ebassi@gnome.org>
Thu, 31 May 2012 22:48:35 +0000 (23:48 +0100)
committerMatthias Clasen <mclasen@redhat.com>
Sat, 23 Jun 2012 21:53:22 +0000 (17:53 -0400)
The current note makes it look like the marshaller code generation has
been deprecated in favour of the libffi-based generic marshaller; this
is not the case, so we should probably clarify the point a bit.

https://bugzilla.gnome.org/show_bug.cgi?id=677235

gobject/gmarshal.list

index 270a9eb..4a5ddf5 100644 (file)
@@ -1,6 +1,9 @@
 # Note: This file used to generate gmarshal.[ch], but it doesn't any
-# longer.  Now that we have g_cclosure_marshal_generic(), there's no
-# reason to use these.  They're kept for ABI compatibility.
+# longer; it is kept mainly for backward compatibility purposes. If
+# you find yourself in the need to add a marshaller in GObject, use
+# g_cclosure_marshal_generic() instead.
+#
+# Warning: The generated symbols are part of the GObject ABI.
 
 # standard VOID return marshallers
 VOID:VOID