[gtk+/gtk-3-8] Doc: various small fixes

[Matthias Clasen <matthiasc src gnome org>]

commit 8368b12b61cc58d0db3cc030978a6f1eaabed34a
Author: Sébastien Wilmet <swilmet gnome org>
Date:   Wed Apr 17 12:38:44 2013 +0200

    Doc: various small fixes
    
    https://bugzilla.gnome.org/show_bug.cgi?id=700007

 gtk/gtkentry.c              |    7 ++++---
 gtk/gtkliststore.c          |    5 +++--
 gtk/gtktextbuffer.c         |    6 +++---
 gtk/gtktextbufferrichtext.c |    2 +-
 gtk/gtktextbufferrichtext.h |    2 +-
 gtk/gtktextview.c           |    7 ++++---
 gtk/gtktreestore.c          |    5 +++--
 gtk/gtktreeview.c           |    3 ++-
 8 files changed, 21 insertions(+), 16 deletions(-)
---
diff --git a/gtk/gtkentry.c b/gtk/gtkentry.c
index e3553cc..1c247fc 100644
--- a/gtk/gtkentry.c
+++ b/gtk/gtkentry.c
@@ -1425,9 +1425,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
@@ -1507,7 +1508,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 467bac0..8e0e82b 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 a877e34..97ddd6d 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 2c5d228..2bad3ca 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 44034df..b0084a1 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 2de8a1e..2d02add 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 21e7a20..ccf2409 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 cb43c7f..ce46b74 100644
--- a/gtk/gtktreeview.c
+++ b/gtk/gtktreeview.c
@@ -60,7 +60,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