[gtksourceview/wip/gutter: 1/3] Gutter: better TODO comment for get_renderer_at_pos()



commit 3e9cb61edc1a17ab03fc6054f19cb1f8a37c8526
Author: Sébastien Wilmet <swilmet gnome org>
Date:   Thu Oct 20 18:28:02 2016 +0200

    Gutter: better TODO comment for get_renderer_at_pos()

 gtksourceview/gtksourcegutter.c |    8 ++++++--
 1 files changed, 6 insertions(+), 2 deletions(-)
---
diff --git a/gtksourceview/gtksourcegutter.c b/gtksourceview/gtksourcegutter.c
index 5eb09e9..281def0 100644
--- a/gtksourceview/gtksourcegutter.c
+++ b/gtksourceview/gtksourcegutter.c
@@ -1716,8 +1716,12 @@ gtk_source_gutter_get_padding (GtkSourceGutter *gutter,
  *
  * Returns: (nullable) (transfer none): the renderer at (x, y) or %NULL.
  */
-/* FIXME: to insert a renderer in a gutter, only one position is needed. Here to
- * retrieve a renderer, two positions are needed? Document why.
+/* TODO: better document this function. The (x,y) position is different from
+ * the position passed to gtk_source_gutter_insert() and
+ * gtk_source_gutter_reorder(). The (x,y) coordinate can come from a click
+ * event, for example? Is the (x,y) a coordinate of the Gutter's GdkWindow?
+ * Where is the (0,0)? And so on.
+ * Also, this function doesn't seem to be used.
  */
 GtkSourceGutterRenderer *
 gtk_source_gutter_get_renderer_at_pos (GtkSourceGutter *gutter,


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