[gtk+] [docs] improve docs for gtk_accelerator_parse().



commit d4a159d488344e4087eaa1dae5c4a0aa4b633173
Author: Stefan Kost <ensonic users sf net>
Date:   Fri Apr 16 21:26:25 2010 +0300

    [docs] improve docs for gtk_accelerator_parse().
    
    Link to gdk_keyval_from_name() and give example for non obvious accelerator
    strings.

 gtk/gtkaccelgroup.c |    3 +++
 1 files changed, 3 insertions(+), 0 deletions(-)
---
diff --git a/gtk/gtkaccelgroup.c b/gtk/gtkaccelgroup.c
index d5d9b53..9dbab6f 100644
--- a/gtk/gtkaccelgroup.c
+++ b/gtk/gtkaccelgroup.c
@@ -1131,6 +1131,9 @@ is_hyper (const gchar *string)
  * "&lt;Release&gt;z" (the last one is for key release).
  * The parser is fairly liberal and allows lower or upper case,
  * and also abbreviations such as "&lt;Ctl&gt;" and "&lt;Ctrl&gt;".
+ * Key names are parsed using gdk_keyval_from_name(). For character keys the
+ * name is not the symbol, but the lowercase name, e.g. one would use
+ * "&lt;Ctrl&gt;minus" instead of "&lt;Ctrl&gt;-".
  *
  * If the parse fails, @accelerator_key and @accelerator_mods will
  * be set to 0 (zero).



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