clapper-gtk: Various documentation cleanups and fixes

src/lib/clapper-gtk/clapper-gtk-container.c

@@ -86,6 +86,7 @@ clapper_gtk_container_new (void)
 /**
  * clapper_gtk_container_set_child:
  * @container: a #ClapperGtkContainer
+ * @child: a #GtkWidget
  *
  * Set a child #GtkWidget of @container.
  */

src/lib/clapper-gtk/clapper-gtk-simple-controls.c

@@ -166,6 +166,8 @@ clapper_gtk_simple_controls_set_fullscreenable (ClapperGtkSimpleControls *self,
  *
  * Get whether [class@ClapperGtk.ToggleFullscreenButton] button in the @controls
  * is set to be visible.
+ *
+ * Returns: %TRUE when fullscreenable, %FALSE otherwise.
  */
 gboolean
 clapper_gtk_simple_controls_get_fullscreenable (ClapperGtkSimpleControls *self)

src/lib/clapper-gtk/clapper-gtk-title-header.c

@@ -121,6 +121,8 @@ clapper_gtk_title_header_set_fallback_to_uri (ClapperGtkTitleHeader *self, gbool
  *
  * Get whether a [property@Clapper.MediaItem:uri] property is going
  * be displayed as a header text when no other title could be determined.
+ *
+ * Returns: %TRUE when item URI will be used as fallback, %FALSE otherwise.
  */
 gboolean
 clapper_gtk_title_header_get_fallback_to_uri (ClapperGtkTitleHeader *self)

src/lib/clapper-gtk/clapper-gtk-title-label.c

@@ -283,6 +283,8 @@ clapper_gtk_title_label_set_fallback_to_uri (ClapperGtkTitleLabel *self, gboolea
  *
  * Get whether a [property@Clapper.MediaItem:uri] property is going
  * be displayed as a label text when no other title could be determined.
+ *
+ * Returns: %TRUE when item URI will be used as fallback, %FALSE otherwise.
  */
 gboolean
 clapper_gtk_title_label_get_fallback_to_uri (ClapperGtkTitleLabel *self)