diff --git a/gtk/gtkactionmuxer.c b/gtk/gtkactionmuxer.c
index c0876bfc85..4618564ae4 100644
--- a/gtk/gtkactionmuxer.c
+++ b/gtk/gtkactionmuxer.c
@@ -26,7 +26,7 @@
 
 #include <string.h>
 
-/*
+/**
  * SECTION:gtkactionmuxer
  * @short_description: Aggregate and monitor several action groups
  *
@@ -602,7 +602,7 @@ gtk_action_muxer_class_init (GObjectClass *class)
   g_object_class_install_properties (class, NUM_PROPERTIES, properties);
 }
 
-/*
+/**
  * gtk_action_muxer_insert:
  * @muxer: a #GtkActionMuxer
  * @prefix: the prefix string for the action group
@@ -656,7 +656,7 @@ gtk_action_muxer_insert (GtkActionMuxer *muxer,
                                             G_CALLBACK (gtk_action_muxer_group_action_state_changed), group);
 }
 
-/*
+/**
  * gtk_action_muxer_remove:
  * @muxer: a #GtkActionMuxer
  * @prefix: the prefix of the action group to remove
@@ -690,7 +690,7 @@ gtk_action_muxer_remove (GtkActionMuxer *muxer,
     }
 }
 
-/*
+/**
  * gtk_action_muxer_new:
  *
  * Creates a new #GtkActionMuxer.
@@ -701,10 +701,11 @@ gtk_action_muxer_new (void)
   return g_object_new (GTK_TYPE_ACTION_MUXER, NULL);
 }
 
-/* gtk_action_muxer_get_parent:
+/**
+ * gtk_action_muxer_get_parent:
  * @muxer: a #GtkActionMuxer
  *
- * Returns: (transfer-none): the parent of @muxer, or NULL.
+ * Returns: (transfer none): the parent of @muxer, or NULL.
  */
 GtkActionMuxer *
 gtk_action_muxer_get_parent (GtkActionMuxer *muxer)
@@ -714,7 +715,8 @@ gtk_action_muxer_get_parent (GtkActionMuxer *muxer)
   return muxer->parent;
 }
 
-/* gtk_action_muxer_set_parent:
+/**
+ * gtk_action_muxer_set_parent:
  * @muxer: a #GtkActionMuxer
  * @parent: (allow-none): the new parent #GtkActionMuxer
  *
diff --git a/gtk/gtkactionmuxer.h b/gtk/gtkactionmuxer.h
index 07f88ad2d2..401483072c 100644
--- a/gtk/gtkactionmuxer.h
+++ b/gtk/gtkactionmuxer.h
@@ -37,7 +37,7 @@ GtkActionMuxer *        gtk_action_muxer_new                            (void);
 
 void                    gtk_action_muxer_insert                         (GtkActionMuxer *muxer,
                                                                          const gchar    *prefix,
-                                                                         GActionGroup   *group);
+                                                                         GActionGroup   *action_group);
 
 void                    gtk_action_muxer_remove                         (GtkActionMuxer *muxer,
                                                                          const gchar    *prefix);
diff --git a/gtk/gtkactionobservable.c b/gtk/gtkactionobservable.c
index c6e469f15e..ab90df2e59 100644
--- a/gtk/gtkactionobservable.c
+++ b/gtk/gtkactionobservable.c
@@ -34,7 +34,7 @@ gtk_action_observable_default_init (GtkActionObservableInterface *iface)
 {
 }
 
-/*
+/**
  * gtk_action_observable_register_observer:
  * @observable: a #GtkActionObservable
  * @action_name: the name of the action
@@ -54,7 +54,7 @@ gtk_action_observable_register_observer (GtkActionObservable *observable,
     ->register_observer (observable, action_name, observer);
 }
 
-/*
+/**
  * gtk_action_observable_unregister_observer:
  * @observable: a #GtkActionObservable
  * @action_name: the name of the action
diff --git a/gtk/gtkactionobserver.c b/gtk/gtkactionobserver.c
index a1dc1d1034..cf70b20a3e 100644
--- a/gtk/gtkactionobserver.c
+++ b/gtk/gtkactionobserver.c
@@ -54,7 +54,7 @@ gtk_action_observer_default_init (GtkActionObserverInterface *class)
 {
 }
 
-/*
+/**
  * gtk_action_observer_action_added:
  * @observer: a #GtkActionObserver
  * @observable: the source of the event
@@ -85,7 +85,7 @@ gtk_action_observer_action_added (GtkActionObserver   *observer,
     ->action_added (observer, observable, action_name, parameter_type, enabled, state);
 }
 
-/*
+/**
  * gtk_action_observer_action_enabled_changed:
  * @observer: a #GtkActionObserver
  * @observable: the source of the event
@@ -110,7 +110,7 @@ gtk_action_observer_action_enabled_changed (GtkActionObserver   *observer,
     ->action_enabled_changed (observer, observable, action_name, enabled);
 }
 
-/*
+/**
  * gtk_action_observer_action_state_changed:
  * @observer: a #GtkActionObserver
  * @observable: the source of the event
@@ -135,7 +135,7 @@ gtk_action_observer_action_state_changed (GtkActionObserver   *observer,
     ->action_state_changed (observer, observable, action_name, state);
 }
 
-/*
+/**
  * gtk_action_observer_action_removed:
  * @observer: a #GtkActionObserver
  * @observable: the source of the event