[gtk/wip/baedert/single-node-window: 23/25] update documentation for new style classes and node names

[Timm Bäder <baedert src gnome org>]

commit 8dedf1d2a203b219fa97d8a822b256f2637903ff
Author: Timm Bäder <mail baedert org>
Date:   Wed May 20 09:36:21 2020 +0200

    update documentation for new style classes and node names

 gtk/gtkassistant.c |  3 ++-
 gtk/gtkwindow.c    | 11 ++++++++---
 2 files changed, 10 insertions(+), 4 deletions(-)
---
diff --git a/gtk/gtkassistant.c b/gtk/gtkassistant.c
index 2e560bd339..c5da702416 100644
--- 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 0574ee4673..944a1e5d2b 100644
--- 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.
  */