From: Matthias Clasen <mclasen@redhat.com>
Date: Sat, 10 Dec 2022 21:02:07 +0000 (-0500)
Subject: builderscope: Add a note for implementors
X-Git-Tag: archive/raspbian/4.12.3+ds-1+rpi1~1^2^2^2~22^2~9^2~45^2
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=5c70f2ae9bedd5ee44d87f0626cd896c698dd74c;p=gtk4.git

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 6d472dc6a8..8d18c44c96 100644
--- 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.
  */
 
 /**