documenting actions
GTK4 is using actions (as in GAction) more prominently. Among other things, it has gained the ability to define actions in class_init. We want to document these using gtk-doc comments, and I have chosen the following syntax:
/**
* GtkText|edit.move-cursor:
* @granularity: a #GtkMovementStep defining the granularity of movement
* @count: the number of steps to move the cursor
* @extend: %TRUE to extend the selection
*
* The edit.move-cursor action changes the position of the
* text caret in the text, and may extend the selection while
* doing so.
*
* The default bindings for this action include
* the Left and Right arrow keys, Home and End.
*
* All bindings can be used with the Shift modifier
* to extend the selection.
*/
I've written patches to make gtk-doc pick this up and provide reasonable documentation from it (see gtk-doc!30 (closed)). It would be nice if gobject-introspection could learn to ignore these comments without complaining about symbols like GtkText|edit.move-cursor