[gtk: 1/2] docs: Fix links in selection models




commit ad5e72728f73c4d6216f269d77956e36f6faead3
Author: Maximiliano Sandoval R <msandova gnome org>
Date:   Fri Apr 1 13:04:14 2022 +0200

    docs: Fix links in selection models

 gtk/gtkselectionmodel.c  | 14 ++++++++------
 gtk/gtksingleselection.c |  6 +++---
 2 files changed, 11 insertions(+), 9 deletions(-)
---
diff --git a/gtk/gtkselectionmodel.c b/gtk/gtkselectionmodel.c
index 3f78141e58..e9c9dcef3c 100644
--- a/gtk/gtkselectionmodel.c
+++ b/gtk/gtkselectionmodel.c
@@ -43,12 +43,14 @@
  * [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
diff --git a/gtk/gtksingleselection.c b/gtk/gtksingleselection.c
index 7b01cb6f19..d0d50c7304 100644
--- a/gtk/gtksingleselection.c
+++ b/gtk/gtksingleselection.c
@@ -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
 {


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]