update documentation for new style classes and node names

diff --git a/gtk/gtkassistant.c b/gtk/gtkassistant.c
index 2e560bd3391052fac246b35809f9d2279df3f4b8..c5da70241666cafc87f6f317b82c9d37d3cda807 100644 (file)
--- a/gtk/gtkassistant.c
+++ b/gtk/gtkassistant.c
@@ -58,7 +58,8 @@
  *
  * # CSS nodes
  *
- * GtkAssistant has a single CSS node with the name assistant.
+ * GtkAssistant has a single CSS node with the name window and style
+ * class .assistant.
  */
 
 #include "config.h"

diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c
index 0574ee4673a7c75abcc02bbaca7b695c9671245d..944a1e5d2b0013e850eb704c4f6a1464709acd0f 100644 (file)
--- a/gtk/gtkwindow.c
+++ b/gtk/gtkwindow.c
@@ -133,13 +133,11 @@
  *
  * |[<!-- language="plain" -->
  * window.background
- * ├── decoration
  * ├── <titlebar child>.titlebar [.default-decoration]
  * ╰── <child>
  * ]|
  *
- * GtkWindow has a main CSS node with name window and style class .background,
- * and a subnode with name decoration.
+ * GtkWindow has a main CSS node with name window and style class .background.
  *
  * Style classes that are typically used with the main CSS node are .csd (when
  * client-side decorations are in use), .solid-csd (for client-side decorations
@@ -149,6 +147,13 @@
  * types of window often add their own discriminating style classes, such as
  * .popup or .tooltip.
  *
+ * Generally, some CSS properties don't make sense on the toplevel window node,
+ * such as margins or padding. When client-side decorations without invisible
+ * borders are in use (i.e. the .solid-csd style class is added to the
+ * main window node), the CSS border of the toplevel window is used for
+ * resize drags. In the .csd case, the shadow area outside of the window
+ * can be used to resize it.
+ *
  * GtkWindow adds the .titlebar and .default-decoration style classes to the
  * widget that is added as a titlebar child.
  */