Document CSS nodes and style classes

So app devs know they can use them.

src/hdy-carousel.c

@@ -39,6 +39,10 @@
  * The #HdyCarousel widget can be used to display a set of pages with
  * swipe-based navigation between them and optional indicators.
  *
+ * # CSS nodes
+ *
+ * #HdyCarousel has a single CSS node with name carousel.
+ *
  * Since: 1.0
  */
 

src/hdy-column.c

@@ -23,6 +23,13 @@
  *
  * If the child requires more than the requested maximum width, it will be
  * allocated the minimum width it can fit in instead.
+ *
+ * # CSS nodes
+ *
+ * #HdyColumn has a single CSS node with name hdycolumn. The node will get the
+ * style classes .wide when its child reached its maximum width, .narrow when
+ * the column allocates its full width to its child, .medium in-between, or none
+ * if it didn't compute its size yet.
  */
 
 #define HDY_EASE_OUT_TAN_CUBIC 3

src/hdy-header-bar.c

@@ -46,6 +46,10 @@
  * When used in a #HdyDialog, HdyHeaderBar will replace its window decorations
  * by a back button allowing to close it. It doesn't have to be its direct child
  * and you can use any complex contraption you like as the dialog's titlebar.
+ *
+ * # CSS nodes
+ *
+ * #HdyHeaderBar has a single CSS node with name headerbar.
  */
 
 /**

src/hdy-keypad.c

@@ -20,6 +20,10 @@
  *
  * This widget should not be altered using the #GtkGrid and #GtkContainer APIs,
  * they are considered internal to this widget, using them externally will lead to unexpected results.
+ *
+ * # CSS nodes
+ *
+ * #HdyKeypad has a single CSS node with name keypad.
  */
 
 typedef struct

src/hdy-leaflet.c

@@ -27,6 +27,12 @@
  * When there is enough space the children are displayed side by side, otherwise
  * only one is displayed. The threshold is dictated by the preferred minimum
  * sizes of the children.
+ *
+ * # CSS nodes
+ *
+ * #HdyLeaflet has a single CSS node with name leaflet. The node will get the
+ * style classes .folded when it is folded, .unfolded when it's not, or none if
+ * it didn't compute its fold yet.
  */
 
 /**

src/hdy-preferences-group.c

@@ -24,6 +24,10 @@
  * title and a description. The title will be used by #HdyPreferencesWindow to
  * let the user look for a preference.
  *
+ * # CSS nodes
+ *
+ * #HdyPreferencesGroup has a single CSS node with name preferencesgroup.
+ *
  * Since: 0.0.10
  */
 

src/hdy-preferences-page.c

@@ -19,6 +19,10 @@
  * The #HdyPreferencesPage widget gathers preferences groups into a single page
  * of a preferences window.
  *
+ * # CSS nodes
+ *
+ * #HdyPreferencesPage has a single CSS node with name preferencespage.
+ *
  * Since: 0.0.10
  */
 

src/hdy-search-bar.c

@@ -73,7 +73,7 @@
  *
  * # CSS nodes
  *
- * HdySearchBar has a single CSS node with name searchbar.
+ * #HdySearchBar has a single CSS node with name searchbar.
  *
  * Since: 0.0.6
  */

src/hdy-squeezer.c

@@ -34,6 +34,10 @@
  *
  * Transitions between children can be animated as fades. This can be controlled
  * with hdy_squeezer_set_transition_type().
+ *
+ * # CSS nodes
+ *
+ * #HdySqueezer has a single CSS node with name squeezer.
  */
 
 /**

src/hdy-title-bar.c

@@ -21,6 +21,10 @@
  *
  * HdyTitleBar becomes really useful when you want to animate header bars, like
  * an adaptive application using #HdyLeaflet would do.
+ *
+ * # CSS nodes
+ *
+ * #HdyTitleBar has a single CSS node with name headerbar.
  */
 
 enum {

src/hdy-view-switcher-bar.c

@@ -21,6 +21,10 @@
  * a window and to be revealed only on really narrow windows e.g. on mobile
  * phones.
  *
+ * # CSS nodes
+ *
+ * #HdyViewSwitcherBar has a single CSS node with name viewswitcherbar.
+ *
  * Since: 0.0.10
  */
 

src/hdy-view-switcher.c

@@ -32,6 +32,10 @@
  * height. Contrary to #GtkHeaderBar, #HdyHeaderBar doesn't force a vertical
  * alignment on its title widget, so we recommend it over #GtkHeaderBar.
  *
+ * # CSS nodes
+ *
+ * #HdyViewSwitcher has a single CSS node with name viewswitcher.
+ *
  * Since: 0.0.10
  */