From e801a68f0df3767c5c321737975ba0c4cfe0731f Mon Sep 17 00:00:00 2001
From: David Boddie <david.boddie@puri.sm>
Date: Tue, 30 Jul 2019 16:50:23 +0200
Subject: [PATCH] Add comments to explain what empty labels do

---
 data/keyboards/symbols/nb.xml | 2 ++
 data/keyboards/symbols/us.xml | 2 ++
 eek/eek-section.c             | 3 ++-
 3 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/data/keyboards/symbols/nb.xml b/data/keyboards/symbols/nb.xml
index 0dc2807a..c8faf6b8 100644
--- a/data/keyboards/symbols/nb.xml
+++ b/data/keyboards/symbols/nb.xml
@@ -65,6 +65,8 @@
     <symbol keyval="197" label="&#197;">Aring</symbol>
     <symbol label=""></symbol>
     <symbol label=""></symbol>
+    <!-- Empty labels cause keys to be hidden when the level they are defined
+         for is shown. -->
   </key>
   <key name="AC01">
     <symbol label="a">a</symbol>
diff --git a/data/keyboards/symbols/us.xml b/data/keyboards/symbols/us.xml
index dd01d459..43e9e5f5 100644
--- a/data/keyboards/symbols/us.xml
+++ b/data/keyboards/symbols/us.xml
@@ -115,6 +115,8 @@
     <symbol label="{">braceleft</symbol>
   </key>
   <key name="AC10">
+    <!-- Empty labels cause keys to be hidden when the level they are defined
+         for is shown. -->
     <symbol label=""></symbol>
     <symbol label=""></symbol>
     <symbol label=")">parenright</symbol>
diff --git a/eek/eek-section.c b/eek/eek-section.c
index e2763b9f..1168eea3 100644
--- a/eek/eek-section.c
+++ b/eek/eek-section.c
@@ -535,7 +535,8 @@ keycounter (EekElement *element, gpointer user_data)
 {
     EekKey *key = EEK_KEY(element);
 
-    /* Skip keys without labels for the current level. */
+    /* Skip keys without labels for the current level. This causes those
+       keys to be hidden in the visible layout. */
     if (!eek_key_has_label(key))
         return;