[libdazzle] shortcuts: leave some crumbs for later

[Christian Hergert <chergert src gnome org>]

commit 1c2050d61b733ced9c25f89c84f841a502d83dc8
Author: Christian Hergert <chergert redhat com>
Date:   Mon Jun 12 18:45:42 2017 -0700

    shortcuts: leave some crumbs for later

 src/shortcuts/dzl-shortcut-chord.c |    4 ++++
 1 files changed, 4 insertions(+), 0 deletions(-)
---
diff --git a/src/shortcuts/dzl-shortcut-chord.c b/src/shortcuts/dzl-shortcut-chord.c
index 94eeaa8..d823167 100644
--- a/src/shortcuts/dzl-shortcut-chord.c
+++ b/src/shortcuts/dzl-shortcut-chord.c
@@ -592,6 +592,10 @@ dzl_shortcut_chord_table_set_free_func (DzlShortcutChordTable *self,
 guint
 dzl_shortcut_chord_table_size (const DzlShortcutChordTable *self)
 {
+  /* I know this is confusing, but len is the number of items in the
+   * table (which consumers think of as size), and @size is the allocated
+   * size of the ^2 growing array.
+   */
   return self ? self->len : 0;
 }