diff --git a/gtk/gtkiconview.c b/gtk/gtkiconview.c
index a01879afa8..f0082f28df 100644
--- a/gtk/gtkiconview.c
+++ b/gtk/gtkiconview.c
@@ -4993,8 +4993,15 @@ gtk_icon_view_unselect_path (GtkIconView *icon_view,
  * want to convert the returned list into a list of `GtkTreeRowReferences`.
  * To do this, you can use gtk_tree_row_reference_new().
  *
- * To free the return value, use:
+ * To free the return value, use `g_lsit_free_full`:
  * |[<!-- language="C" -->
+ * GtkWidget *icon_view = gtk_icon_view_new ();
+ * // Use icon_view
+ *
+ * GList *list = gtk_icon_view_get_selected_items (GTK_ICON_VIEW (icon_view));
+ *
+ * // use list
+ *
  * g_list_free_full (list, (GDestroyNotify) gtk_tree_path_free);
  * ]|
  *
diff --git a/gtk/gtkmain.c b/gtk/gtkmain.c
index 352e32fdcd..c96bfb3c81 100644
--- a/gtk/gtkmain.c
+++ b/gtk/gtkmain.c
@@ -753,9 +753,15 @@ gtk_is_initialized (void)
  * you can use it to update the default text direction as follows:
  *
  * |[<!-- language="C" -->
- * setlocale (LC_ALL, new_locale);
- * direction = gtk_get_locale_direction ();
- * gtk_widget_set_default_direction (direction);
+ * #include <locale.h>
+ *
+ * static void
+ * update_locale (const char *new_locale)
+ * {
+ *   setlocale (LC_ALL, new_locale);
+ *   GtkTextDirection direction = gtk_get_locale_direction ();
+ *   gtk_widget_set_default_direction (direction);
+ * }
  * ]|
  *
  * Returns: the `GtkTextDirection` of the current locale