diff --git a/docs/reference/gtk/drawing-model.xml b/docs/reference/gtk/drawing-model.xml index 5a4dd781df..27cf247aef 100644 --- a/docs/reference/gtk/drawing-model.xml +++ b/docs/reference/gtk/drawing-model.xml @@ -203,12 +203,12 @@ Hierarchical drawing - During the Paint phase GTK receives a single ::render signal on the toplevel - window. The signal handler will create a snapshot object (which is a - helper for creating a scene graph) and emit a GtkWidget::snapshot() signal, - which will propagate down the widget hierarchy. This lets each widget - snapshot its content at the right place and time, correctly handling things - like partial transparencies and overlapping widgets. + During the Paint phase GTK receives a single #GdkSurface::render signal on + the toplevel surface. The signal handler will create a snapshot object + (which is a helper for creating a scene graph) and call the + #GtkWidget::snapshot() vfunc, which will propagate down the widget hierarchy. + This lets each widget snapshot its content at the right place and time, + correctly handling things like partial transparencies and overlapping widgets. @@ -217,7 +217,7 @@ the render nodes of children, and grandchildren, and so on), and will reuse that node during the Paint phase. Invalidating a widget (by calling gtk_widget_queue_draw()) discards the cached render node, forcing the widget - to regenerate it the next time it needs to handle a ::snapshot. + to regenerate it the next time it needs to produce a snapshot. diff --git a/docs/reference/gtk/gtk4-docs.xml b/docs/reference/gtk/gtk4-docs.xml index cca756c355..a01508c54d 100644 --- a/docs/reference/gtk/gtk4-docs.xml +++ b/docs/reference/gtk/gtk4-docs.xml @@ -19,11 +19,15 @@ - GTK Overview + Introduction + + + + GTK Concepts