Various documentation fixes

Always have Since: annotations at the very bottom, use the correct
ClassName::signal-name/ClassName:property-name syntax, fix a few typos
in type names, wrong function names, non-existing type names, etc.

13 files changed, 16 insertions, 16 deletions

diff --git a/gtk/gtkfontchooserwidget.c b/gtk/gtkfontchooserwidget.c
index 0f6208285e..b7fbef1f90 100644
--- a/gtk/gtkfontchooserwidget.c
+++ b/gtk/gtkfontchooserwidget.c
@@ -69,11 +69,11 @@
  * To change the text which is shown in the preview area, use
  * gtk_font_chooser_set_preview_text().
  *
- * Since: 3.2
- *
  * # CSS nodes
  *
  * GtkFontChooserWidget has a single CSS node with name fontchooser.
+ *
+ * Since: 3.2
  */
 
 
diff --git a/gtk/gtkgesture.c b/gtk/gtkgesture.c
index 9fa1cf3a26..47fa3c56ce 100644
--- a/gtk/gtkgesture.c
+++ b/gtk/gtkgesture.c
@@ -54,8 +54,8 @@
  * target widget, and gestures that are attached to containers above the widget
  * get a chance to interact with the event before it reaches the target.
  *
- * After the capture phase, GTK+ emits the traditional #GtkWidget::button-press,
- * #GtkWidget::button-release, #GtkWidget::touch-event, etc signals. Gestures 
+ * After the capture phase, GTK+ emits the traditional #GtkWidget::button-press-event,
+ * #GtkWidget::button-release-event, #GtkWidget::touch-event, etc signals. Gestures
  * with the %GTK_PHASE_TARGET phase are fed events from the default #GtkWidget::event
  * handlers.
  *
diff --git a/gtk/gtkgesturedrag.c b/gtk/gtkgesturedrag.c
index 0c5a7859e8..59fdc2aa62 100644
--- a/gtk/gtkgesturedrag.c
+++ b/gtk/gtkgesturedrag.c
@@ -25,8 +25,8 @@
  *
  * #GtkGestureDrag is a #GtkGesture implementation that recognizes drag
  * operations. The drag operation itself can be tracked throught the
- * #GtkGestureDrag:drag-begin, #GtkGestureDrag:drag-update and
- * #GtkGestureDrag:drag-end signals, or the relevant coordinates be
+ * #GtkGestureDrag::drag-begin, #GtkGestureDrag::drag-update and
+ * #GtkGestureDrag::drag-end signals, or the relevant coordinates be
  * extracted through gtk_gesture_drag_get_offset() and
  * gtk_gesture_drag_get_start_point().
  */
diff --git a/gtk/gtkgesturelongpress.c b/gtk/gtkgesturelongpress.c
index 405068db53..8cbcce76e7 100644
--- a/gtk/gtkgesturelongpress.c
+++ b/gtk/gtkgesturelongpress.c
@@ -309,7 +309,7 @@ gtk_gesture_long_press_class_init (GtkGestureLongPressClass *klass)
    * @gesture: the object which received the signal
    *
    * This signal is emitted whenever a press moved too far, or was released
-   * before #GtkGestureLongPress:pressed happened.
+   * before #GtkGestureLongPress::pressed happened.
    *
    * Since: 3.14
    */
diff --git a/gtk/gtklabel.c b/gtk/gtklabel.c
index e1f55f6ec7..c0b37772ab 100644
--- a/gtk/gtklabel.c
+++ b/gtk/gtklabel.c
@@ -208,7 +208,7 @@
  *
  * gtk_label_set_justify() sets how the lines in a label align
  * with one another. If you want to set how the label as a whole
- * aligns in its available space, see the #GtkWidget::halign and
+ * aligns in its available space, see the #GtkWidget:halign and
  * #GtkWidget:valign properties.
  *
  * The #GtkLabel:width-chars and #GtkLabel:max-width-chars properties
diff --git a/gtk/gtklistbox.c b/gtk/gtklistbox.c
index f2a35b850e..59a46b88cd 100644
--- a/gtk/gtklistbox.c
+++ b/gtk/gtklistbox.c
@@ -3592,7 +3592,7 @@ gtk_list_box_row_get_activatable (GtkListBoxRow *row)
 
 /**
  * gtk_list_box_row_set_selectable:
- * @row: a #GTkListBoxrow
+ * @row: a #GtkListBoxRow
  * @selectable: %TRUE to mark the row as selectable
  *
  * Set the #GtkListBoxRow:selectable property for this row.
diff --git a/gtk/gtkmodelbutton.c b/gtk/gtkmodelbutton.c
index cbeab65783..0e941c2808 100644
--- a/gtk/gtkmodelbutton.c
+++ b/gtk/gtkmodelbutton.c
@@ -142,7 +142,7 @@
  * ╰── check
  * ]|
  *
- * Iconic model buttons (see #GtkModelButton::iconic) change the name of
+ * Iconic model buttons (see #GtkModelButton:iconic) change the name of
  * their main node to button and add a .model style class to it. The indicator
  * subnode is invisible in this case.
  */
diff --git a/gtk/gtknotebook.c b/gtk/gtknotebook.c
index a4d97ed1ec..26de2bc86a 100644
--- a/gtk/gtknotebook.c
+++ b/gtk/gtknotebook.c
@@ -130,7 +130,7 @@
  * name arrow are placed as first and last child of the tabs node.
  *
  * The main node gets the .frame style class when the notebook
- * has a border (see gtk_notebook_set_has_border()).
+ * has a border (see gtk_notebook_set_show_border()).
  *
  * The header node gets one of the style class .top, .bottom,
  * .left or .right, depending on where the tabs are placed. For
diff --git a/gtk/gtkshortcutsshortcut.c b/gtk/gtkshortcutsshortcut.c
index cd446740c3..018322c827 100644
--- a/gtk/gtkshortcutsshortcut.c
+++ b/gtk/gtkshortcutsshortcut.c
@@ -464,7 +464,7 @@ gtk_shortcuts_shortcut_class_init (GtkShortcutsShortcutClass *klass)
    * GtkShortcutsShortcut:accelerator:
    *
    * The accelerator(s) represented by this object. This property is used
-   * if #GtkShorcutsShortcut:shortcut-type is set to #GTK_SHORTCUT_ACCELERATOR.
+   * if #GtkShortcutsShortcut:shortcut-type is set to #GTK_SHORTCUT_ACCELERATOR.
    *
    * The syntax of this property is (an extension of) the syntax understood by
    * gtk_accelerator_parse(). Multiple accelerators can be specified by separating
diff --git a/gtk/gtkshortcutswindow.c b/gtk/gtkshortcutswindow.c
index 6edb4ee756..109c17fc2f 100644
--- a/gtk/gtkshortcutswindow.c
+++ b/gtk/gtkshortcutswindow.c
@@ -45,7 +45,7 @@
  * The recommended way to construct a GtkShortcutsWindow is with GtkBuilder,
  * by populating a #GtkShortcutsWindow with one or more #GtkShortcutsSection
  * objects, which contain #GtkShortcutsGroups that in turn contain objects of
- * class #GtkShortcutsShortcut or #GtkShortcutsGesture.
+ * class #GtkShortcutsShortcut.
  *
  * # A simple example:
  *
diff --git a/gtk/gtkspinbutton.c b/gtk/gtkspinbutton.c
index 7961dc9fca..e76a1e737f 100644
--- a/gtk/gtkspinbutton.c
+++ b/gtk/gtkspinbutton.c
@@ -84,7 +84,7 @@
  * properties. Note that GtkSpinButton will by default make its entry
  * large enough to accomodate the lower and upper bounds of the adjustment,
  * which can lead to surprising results. Best practice is to set both
- * the #GtkEntry::width-chars and #GtkEntry::max-width-chars poperties
+ * the #GtkEntry:width-chars and #GtkEntry:max-width-chars poperties
  * to the desired number of characters to display in the entry.
  *
  * # CSS nodes
diff --git a/gtk/gtkstack.c b/gtk/gtkstack.c
index 998f08f575..94389333ad 100644
--- a/gtk/gtkstack.c
+++ b/gtk/gtkstack.c
@@ -1690,7 +1690,7 @@ gtk_stack_get_transition_running (GtkStack *stack)
  * @interpolate_size: the new value
  *
  * Sets whether or not @stack will interpolate its size when
- * changing the visible child. If the #GtkStack::interpolate-size
+ * changing the visible child. If the #GtkStack:interpolate-size
  * property is set to %TRUE, @stack will interpolate its size between
  * the current one and the one it'll take after changing the
  * visible child, according to the set transition duration.
diff --git a/gtk/gtkstylecontext.c b/gtk/gtkstylecontext.c
index 7d5664af80..bfb094838b 100644
--- a/gtk/gtkstylecontext.c
+++ b/gtk/gtkstylecontext.c
@@ -2568,7 +2568,7 @@ gtk_style_context_get_background_color (GtkStyleContext *context,
  *
  * Since: 3.0
  *
- * Deprecated: 3.16: Use gtk_render_border() instead.
+ * Deprecated: 3.16: Use gtk_render_frame() instead.
  **/
 void
 gtk_style_context_get_border_color (GtkStyleContext *context,