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

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

commit 7687d4936134722a2c3983b6a9268d962d8b3790
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    | 10 +++++++---
 2 files changed, 9 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 0a97fa6255..5635f8239e 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,12 @@
  * types of window often add their own discriminating style classes, such as
  * .popup or .tooltip.
  *
+ * Generally, somce CSS property don't make sense on the toplevel window node,
+ * such as margins or padding. When client-side 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.
  */