symbols/ctrl: Improving the comments and reducing the spacing.

Signed-off-by: Benno Schulenberg <bensberg@justemail.net>

diff --git a/symbols/ctrl b/symbols/ctrl
index 09d76b5..ca019ec 100644 (file)
--- a/symbols/ctrl
+++ b/symbols/ctrl
@@ -1,57 +1,57 @@
-// eliminate the caps lock key completely (replace with control)
+// Eliminate CapsLock, making it another Ctrl.
 partial modifier_keys 
 xkb_symbols "nocaps" {
-    replace key <CAPS> {  [ Control_L, Control_L ] };
+    replace key <CAPS> { [ Control_L, Control_L ] };
     modifier_map  Control { <CAPS>, <LCTL> };
 };
 
-// replace left control with Meta
+// Make the left Ctrl key a left Meta.
 xkb_symbols "lctrl_meta" {
-    replace key <LCTL> {  [ Meta_L ] };
+    replace key <LCTL> { [ Meta_L ] };
 };
 
-// swap the caps lock key with the left control key
+// Swap the functions of the CapsLock key and the left Ctrl key.
 partial modifier_keys 
 xkb_symbols "swapcaps" {
-    replace key <CAPS> {  [ Control_L ] };
-    replace key <LCTL> {  [ Caps_Lock ] };
+    replace key <CAPS> { [ Control_L ] };
+    replace key <LCTL> { [ Caps_Lock ] };
 };
 
-// moves the control key to the middle row and the caps lock
-// to the bottom row.  Only works if the geometry or keycodes
+// Move Ctrl to the leftmost key on the middle row and CapsLock to the
+// leftmost key on the bottom row.  Only works if the geometry or keycodes
 // file has defined appropriate aliases for the keys in question.
 partial modifier_keys 
 xkb_symbols "ac_ctrl" {
-    replace key <AC00> {  [ Control_L ] };
-    replace key <AA00> {  [ Caps_Lock ] };
+    replace key <AC00> { [ Control_L ] };
+    replace key <AA00> { [ Caps_Lock ] };
 };
 
-// Moves the control key to the bottom row and the caps lock
-// to the middle row.  Only works if the geometry or keycodes
+// Move Ctrl to the leftmost key on the bottom row and CapsLock to the
+// leftmost key on the middle row.  Only works if the geometry or keycodes
 // file has defined appropriate aliases for the keys in question.
 partial modifier_keys 
 xkb_symbols "aa_ctrl" {
-    replace key <AA00> {  [ Control_L ] };
-    replace key <AC00> {  [ Caps_Lock ] };
+    replace key <AA00> { [ Control_L ] };
+    replace key <AC00> { [ Caps_Lock ] };
 };
 
-// Right Ctrl works as Right Alt
+// Right Ctrl key functions as another right Alt.
 partial modifier_keys 
 xkb_symbols "rctrl_ralt" {
-    key <RCTL> {  symbols[Group1]= [ Alt_R ] };
+    key <RCTL> { symbols[Group1]= [ Alt_R ] };
 };
 
-// Menu works as Right Ctrl
+// Menu key functions as another right Ctrl.
 partial modifier_keys
 xkb_symbols "menu_rctrl" {
-  replace key <MENU> { [ Control_R, Control_R ] };
-  modifier_map Control { Control_L, <MENU> };
+    replace key <MENU> { [ Control_R, Control_R ] };
+    modifier_map Control { Control_L, <MENU> };
 };
 
-// right alt functions as another ctrl key
+// Right Alt key functions as another right Ctrl.
 partial modifier_keys 
 xkb_symbols "ralt_rctrl" {
-    replace key <RALT> { type[Group1]    = "TWO_LEVEL",
+    replace key <RALT> { type[Group1] = "TWO_LEVEL",
                          symbols[Group1] = [ Control_R, Control_R ] };
     modifier_map Control { <RALT> }; 
 };