[gtk+/rendering-cleanup: 64/65] label: Clarify docs for gtk_label_get_layout()



commit ecfc3dce4d263fa7b6c00e42f905e6a44b1c6b1b
Author: Benjamin Otte <otte redhat com>
Date:   Thu Dec 2 11:34:41 2010 +0100

    label: Clarify docs for gtk_label_get_layout()

 gtk/gtklabel.c |    5 +++--
 1 files changed, 3 insertions(+), 2 deletions(-)
---
diff --git a/gtk/gtklabel.c b/gtk/gtklabel.c
index 39655b8..63b9cd0 100644
--- a/gtk/gtklabel.c
+++ b/gtk/gtklabel.c
@@ -5509,8 +5509,9 @@ gtk_label_get_selection_bounds (GtkLabel  *label,
  * Gets the #PangoLayout used to display the label.
  * The layout is useful to e.g. convert text positions to
  * pixel positions, in combination with gtk_label_get_layout_offsets().
- * The returned layout is owned by the label so need not be
- * freed by the caller.
+ * The returned layout is owned by the @label so need not be
+ * freed by the caller. The @label is free to recreate its layout at
+ * any time, so it should be considered read-only.
  *
  * Return value: (transfer none): the #PangoLayout for this label
  **/



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