builderscope: Add a note for implementors

Recommend that scope implementations should fall
back to or derive from GtkBuilderCScope in order
to not lose GTK's type-guessing machinery.

Related: #5398

diff --git a/gtk/gtkbuilderscope.c b/gtk/gtkbuilderscope.c
index 6d472dc6a8e8cda860dbb6b94bccd5e075fb8a75..8d18c44c960d3b99b2f8e7af75e518d4a00a1687 100644 (file)
--- a/gtk/gtkbuilderscope.c
+++ b/gtk/gtkbuilderscope.c
@@ -41,6 +41,10 @@
  *
  * By default, GTK will use its own implementation of `GtkBuilderScope`
  * for the C language which can be created via [ctor@Gtk.BuilderCScope.new].
+ *
+ * If you implement `GtkBuilderScope` for a language binding, you
+ * may want to (partially) derive from or fall back to a [class@Gtk.BuilderCScope],
+ * as that class implements support for automatic lookups from C symbols.
  */
 
 /**