docs: Fix links in selection models
authorMaximiliano Sandoval R <msandova@gnome.org>
Fri, 1 Apr 2022 11:04:14 +0000 (13:04 +0200)
committerMatthias Clasen <mclasen@redhat.com>
Thu, 21 Apr 2022 23:18:25 +0000 (19:18 -0400)
gtk/gtkselectionmodel.c
gtk/gtksingleselection.c

index 3f78141e5826f8f0dda81695013a56f97fc7bd74..e9c9dcef3c250bc420d8ed08d8f1b0b7291b7fd0 100644 (file)
  * [signal@Gtk.SelectionModel::selection-changed] signal by calling the
  * [method@Gtk.SelectionModel.selection_changed] function. The positions given
  * in that signal may have their selection state changed, though that is not a
- * requirement. If new items added to the model via the ::items-changed signal
- * are selected or not is up to the implementation.
- *
- * Note that items added via ::items-changed may already be selected and no
- * [Gtk.SelectionModel::selection-changed] will be emitted for them. So to
- * track which items are selected, it is necessary to listen to both signals.
+ * requirement. If new items added to the model via the
+ * [signal@Gio.ListModel::items-changed] signal are selected or not is up to the
+ * implementation.
+ *
+ * Note that items added via [signal@Gio.ListModel::items-changed] may already
+ * be selected and no [signal@Gtk.SelectionModel::selection-changed] will be
+ * emitted for them. So to track which items are selected, it is necessary to
+ * listen to both signals.
  *
  * Additionally, the interface can expose functionality to select and unselect
  * items. If these functions are implemented, GTK's list widgets will allow users
index 7b01cb6f194e05a9130bb6ddcd6f9b6d0a722659..d0d50c7304f445927b2d2bac284f8d9e1bbd050f 100644 (file)
@@ -32,9 +32,9 @@
  * item.
  *
  * Note that the selection is *persistent* -- if the selected item is removed
- * and re-added in the same ::items-changed emission, it stays selected.
- * In particular, this means that changing the sort order of an underlying sort
- * model will preserve the selection.
+ * and re-added in the same [signal@Gio.ListModel::items-changed] emission, it
+ * stays selected. In particular, this means that changing the sort order of an
+ * underlying sort model will preserve the selection.
  */
 struct _GtkSingleSelection
 {