[gtk/column-sorting: 4/4] columnview: Clarify docs

[Matthias Clasen <matthiasc src gnome org>]

commit 5a0f56a189cb0cb45db9693def1888d86ca4afee
Author: Matthias Clasen <mclasen redhat com>
Date:   Wed Oct 19 22:31:23 2022 -0400

    columnview: Clarify docs
    
    Mention that gtk_column_view_sort_by_column
    can be called multiple times to ste up
    complex sorting.

 gtk/gtkcolumnview.c | 7 +++++++
 1 file changed, 7 insertions(+)
---
diff --git a/gtk/gtkcolumnview.c b/gtk/gtkcolumnview.c
index 9ba7db6c2b..2828682436 100644
--- a/gtk/gtkcolumnview.c
+++ b/gtk/gtkcolumnview.c
@@ -1689,6 +1689,13 @@ gtk_column_view_get_sorter (GtkColumnView *self)
  * on @column to associate a sorter with the column.
  *
  * If @column is %NULL, the view will be unsorted.
+ *
+ * This function can be called multiple times to set up
+ * sorting with multiple columns:
+ *
+ *     gtk_column_view_sort_by_column (view, NULL, 0);
+ *     gtk_column_view_sort_by_column (view, col1, GTK_SORT_DESCENDING);
+ *     gtk_column_view_sort_by_column (view, col0, GTK_SORT_ASCENDING);
  */
 void
 gtk_column_view_sort_by_column (GtkColumnView       *self,