Doc: various small fixes

https://bugzilla.gnome.org/show_bug.cgi?id=700007

8 files changed, 21 insertions, 16 deletions

diff --git a/gtk/gtkentry.c b/gtk/gtkentry.c
index 7b220c6876..3fefc249ae 100644
--- a/gtk/gtkentry.c
+++ b/gtk/gtkentry.c
@@ -1432,9 +1432,10 @@ gtk_entry_class_init (GtkEntryClass *class)
                                                        PANGO_TYPE_ATTR_LIST,
                                                        GTK_PARAM_READWRITE));
 
-  /** GtkEntry:populate-all:
+  /**
+   * GtkEntry:populate-all:
    *
-   * If ::populate-all is %TRUE, the #GtkEntry::populate-popup
+   * If :populate-all is %TRUE, the #GtkEntry::populate-popup
    * signal is also emitted for touch popups.
    *
    * Since: 3.8
@@ -1514,7 +1515,7 @@ gtk_entry_class_init (GtkEntryClass *class)
    * to this signal and append your items to the @widget, which
    * will be a #GtkMenu in this case.
    *
-   * If #GtkEntry::populate-all is %TRUE, this signal will
+   * If #GtkEntry:populate-all is %TRUE, this signal will
    * also be emitted to populate touch popups. In this case,
    * @widget will be a different container, e.g. a #GtkToolbar.
    * The signal handler should not make assumptions about the
diff --git a/gtk/gtkliststore.c b/gtk/gtkliststore.c
index 11dae3f923..b64876bdd5 100644
--- a/gtk/gtkliststore.c
+++ b/gtk/gtkliststore.c
@@ -39,8 +39,9 @@
  * widget.  It implements the #GtkTreeModel interface, and consequentialy,
  * can use all of the methods available there.  It also implements the
  * #GtkTreeSortable interface so it can be sorted by the view.
- * Finally, it also implements the tree <link linkend="gtktreednd">drag and
- * drop</link> interfaces.
+ * Finally, it also implements the tree
+ * <link linkend="gtk3-GtkTreeView-drag-and-drop">drag and drop</link>
+ * interfaces.
  *
  * The #GtkListStore can accept most GObject types as a column type, though
  * it can't accept all custom types.  Internally, it will keep a copy of
diff --git a/gtk/gtktextbuffer.c b/gtk/gtktextbuffer.c
index bebeb56dd6..73d49e5f32 100644
--- a/gtk/gtktextbuffer.c
+++ b/gtk/gtktextbuffer.c
@@ -3046,7 +3046,7 @@ gtk_text_buffer_get_modified (GtkTextBuffer *buffer)
  * last time it was saved. Whenever the buffer is saved to disk, call
  * gtk_text_buffer_set_modified (@buffer, FALSE). When the buffer is modified,
  * it will automatically toggled on the modified bit again. When the modified
- * bit flips, the buffer emits a "modified-changed" signal.
+ * bit flips, the buffer emits the #GtkTextBuffer::modified-changed signal.
  **/
 void
 gtk_text_buffer_set_modified (GtkTextBuffer *buffer,
@@ -4210,7 +4210,7 @@ gtk_text_buffer_get_target_list (GtkTextBuffer   *buffer,
  *
  * This function returns the list of targets this text buffer can
  * provide for copying and as DND source. The targets in the list are
- * added with %info values from the #GtkTextBufferTargetInfo enum,
+ * added with @info values from the #GtkTextBufferTargetInfo enum,
  * using gtk_target_list_add_rich_text_targets() and
  * gtk_target_list_add_text_targets().
  *
@@ -4242,7 +4242,7 @@ gtk_text_buffer_get_copy_target_list (GtkTextBuffer *buffer)
  *
  * This function returns the list of targets this text buffer supports
  * for pasting and as DND destination. The targets in the list are
- * added with %info values from the #GtkTextBufferTargetInfo enum,
+ * added with @info values from the #GtkTextBufferTargetInfo enum,
  * using gtk_target_list_add_rich_text_targets() and
  * gtk_target_list_add_text_targets().
  *
diff --git a/gtk/gtktextbufferrichtext.c b/gtk/gtktextbufferrichtext.c
index 2c5d228dae..2bad3ca5fc 100644
--- a/gtk/gtktextbufferrichtext.c
+++ b/gtk/gtktextbufferrichtext.c
@@ -58,7 +58,7 @@ static GQuark    deserialize_quark (void);
  * @buffer: a #GtkTextBuffer
  * @mime_type: the format's mime-type
  * @function: the serialize function to register
- * @user_data: %function's user_data
+ * @user_data: @function's user_data
  * @user_data_destroy: a function to call when @user_data is no longer needed
  *
  * This function registers a rich text serialization @function along with
diff --git a/gtk/gtktextbufferrichtext.h b/gtk/gtktextbufferrichtext.h
index 3ab920de1e..6bd66ccc8c 100644
--- a/gtk/gtktextbufferrichtext.h
+++ b/gtk/gtktextbufferrichtext.h
@@ -56,7 +56,7 @@ typedef guint8 * (* GtkTextBufferSerializeFunc)   (GtkTextBuffer     *register_b
  * @content_buffer: the #GtkTextBuffer to deserialize into
  * @iter: insertion point for the deserialized text
  * @data: data to deserialize
- * @length: length of %data
+ * @length: length of @data
  * @create_tags: %TRUE if deserializing may create tags
  * @user_data: user data that was specified when registering the format
  * @error: return location for a #GError
diff --git a/gtk/gtktextview.c b/gtk/gtktextview.c
index 2de8a1e623..2d02add081 100644
--- a/gtk/gtktextview.c
+++ b/gtk/gtktextview.c
@@ -863,9 +863,10 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
                                                        GTK_INPUT_HINT_NONE,
                                                        G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 
-  /** GtkTextView:populate-all:
+  /**
+   * GtkTextView:populate-all:
    *
-   * If ::populate-all is %TRUE, the #GtkTextView::populate-popup
+   * If :populate-all is %TRUE, the #GtkTextView::populate-popup
    * signal is also emitted for touch popups.
    *
    * Since: 3.8
@@ -1150,7 +1151,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
    * to this signal and append your items to the @popup, which
    * will be a #GtkMenu in this case.
    *
-   * If #GtkEntry::populate-toolbar is %TRUE, this signal will
+   * If #GtkTextView:populate-all is %TRUE, this signal will
    * also be emitted to populate touch popups. In this case,
    * @popup will be a different container, e.g. a #GtkToolbar.
    *
diff --git a/gtk/gtktreestore.c b/gtk/gtktreestore.c
index 21e7a205d9..ccf240911f 100644
--- a/gtk/gtktreestore.c
+++ b/gtk/gtktreestore.c
@@ -37,8 +37,9 @@
  * widget.  It implements the #GtkTreeModel interface, and consequentialy,
  * can use all of the methods available there.  It also implements the
  * #GtkTreeSortable interface so it can be sorted by the view.  Finally,
- * it also implements the tree <link linkend="gtktreednd">drag and
- * drop</link> interfaces.
+ * it also implements the tree
+ * <link linkend="gtk3-GtkTreeView-drag-and-drop">drag and drop</link>
+ * interfaces.
  *
  * <refsect2 id="GtkTreeStore-BUILDER-UI">
  * <title>GtkTreeStore as GtkBuildable</title>
diff --git a/gtk/gtktreeview.c b/gtk/gtktreeview.c
index 5a26f5cff9..385cabb43c 100644
--- a/gtk/gtktreeview.c
+++ b/gtk/gtktreeview.c
@@ -61,7 +61,8 @@
  * SECTION:gtktreeview
  * @Short_description: A widget for displaying both trees and lists
  * @Title: GtkTreeView
- * @See_also: #GtkTreeViewColumn, #GtkTreeSelection, #GtkTreeDnd, #GtkTreeMode,
+ * @See_also: #GtkTreeViewColumn, #GtkTreeSelection, #GtkTreeModel,
+ *   <link linkend="gtk3-GtkTreeView-drag-and-drop">GtkTreeView drag-and-drop</link>,
  *   #GtkTreeSortable, #GtkTreeModelSort, #GtkListStore, #GtkTreeStore,
  *   #GtkCellRenderer, #GtkCellEditable, #GtkCellRendererPixbuf,
  *   #GtkCellRendererText, #GtkCellRendererToggle