3 files changed, 48 insertions, 20 deletions
diff --git a/windows/neo-vars/neo20-vars.ahk b/windows/neo-vars/neo20-vars.ahk
index 34d2dce..7601925 100644
--- a/windows/neo-vars/neo20-vars.ahk
+++ b/windows/neo-vars/neo20-vars.ahk
@@ -1,24 +1,22 @@
 #MaxThreadsPerHotKey 4
 
-/*
-CM* == 1: Await more compose chars after this sequence? 
-CD*     : Replace compose sequence by this character
-CPx*    : Key press for * in Ebene x
-CPNx*   : Key press for numpad * in Ebene x
-CS*     : shortcut to output instead of *
-PP*     : repeat code for key *
-PR*     : release code for key *
-*/
-
-; ein wenig COMPOSE
+; die Compose-Definitionen
 #Include %a_scriptdir%\en_us.ahk
 #Include %a_scriptdir%\neocomp.ahk
 #Include %a_scriptdir%\neovarscomp.ahk
 
+Comp := ""
+
+; Hier liegt die Tastaturbelegung
 #Include %a_scriptdir%\keydefinitions.ahk
+
+; Shortcuts, um die Zeichen wieder sauber zur Applikation bringen zu können
 #Include %a_scriptdir%\shortcuts.ahk
+
+; Good-old AHK-Skripts
 #Include %a_scriptdir%\recycle.ahk
 
+
 AllStar(This_HotKey) {
   global
   PhysKey := This_HotKey
@@ -30,11 +28,10 @@ AllStar(This_HotKey) {
     IsDown := 0
   } else
     IsDown := 1
-;  ActKey := Transform(PhysKey)
-  ActKey := PhysKey
-  if Ebene7 and (CP7%ActKey% != "")
+  ActKey := PhysKey ; das könnte später für eine Transformation benutzt werden
+  if (Ebene7 and (CP7%ActKey% != ""))
     Char := CP7%ActKey%
-  else if Ebene8 and (CP8%ActKey% != "")
+  else if (Ebene8 and (CP8%ActKey% != ""))
     Char := CP8%ActKey%
   else
     Char := CP%Ebene%%ActKey%
diff --git a/windows/neo-vars/neovarscomp.ahk b/windows/neo-vars/neovarscomp.ahk
index 4ea7526..9ae608c 100644
--- a/windows/neo-vars/neovarscomp.ahk
+++ b/windows/neo-vars/neovarscomp.ahk
@@ -1,3 +1,14 @@
+/*
+CM* == 1: Await more compose chars after this sequence? 
+CD*     : Replace compose sequence by this character
+CPx*    : Key press for * in Ebene x
+CPNx*   : Key press for numpad * in Ebene x
+CS*     : shortcut to output instead of *
+PP*     : repeat code for key *
+PR*     : release code for key *
+*/
+
+; ein wenig COMPOSE
 CMSCompU002D := 1
 CDSCompU002DSLeft := "U2190"
 CDSCompU002DS__Up := "U2191"
diff --git a/windows/neo-vars/shortcuts.ahk b/windows/neo-vars/shortcuts.ahk
index 6aeeacc..9296f75 100644
--- a/windows/neo-vars/shortcuts.ahk
+++ b/windows/neo-vars/shortcuts.ahk
@@ -1,3 +1,14 @@
+/* SHORTCUTS
+   Da in diesem AHK-Skript sämtliche Tastendrücke zur weiteren Verarbeitung
+   in Unicode- und Spezialzeichen umgewandelt werden, müssen sie für eine
+   effiziente Tasten-Ausgabe, wo möglich, zurück gewandelt werden. Dazu
+   dienen Shortcuts: Soll beispielsweise das Unicode-Zeichen U0061 (kleines
+   a) ausgegeben werden, muss dieses durch "send {a}" ersetzt werden. Die
+   dafür notwendigen Rückwandlungskonstanten werden hier, teilweise
+   automatisiert, definiert und im entsprechenden Unterprogramm zur Anwendung
+   gebracht.
+*/
+
 ; ###### Shortcuts für alle ASCII-Zeichen (0x21 bis 0x7E)
 SetFormat, integer, hex
 char := 0x21
@@ -11,13 +22,27 @@ loop {
 SetFormat, integer, d
 
 ; #### weitere Shortcuts
+CSU0008 := "Backspace"
 CSU0009 := "tab"
+CSU000D := "Enter"
 CSU001B := "esc"
 CSU0020 := "space"
+
+/**** die folgenden Shortcuts ersetzen die automatische Wahl entsprechender
+ **** down- und up-Sendezeichen, da die Zeichenerzeugung entweder aufwändiger
+ **** ist (wie bei den diversen toten Zeichen) oder schlicht mit AHK nicht
+ **** geht (wie das Key-Repeat der schließenden Klammer).
+*/
 DNCSU005E := "{^}{space}"
 DNCSU0060 := "{``}{space}"
 DNCSU007D := "{}}"                 ; "{} down}" geht nicht, warum auch immer
 DNCSU00B4 := "{´}{space}"
+
+/**** die meisten der folgenden Shortcuts werden von AHK zwar verarbeitet,
+ **** von dort aber nur als ALT+Numpad verschickt und daher nicht für alle
+ **** Programme nutzbar, also auskommentiert und als Unicode-Zeichen
+ **** geschickt.
+*/
 CSU20AC := chr(128)   ; €
 ; CSU201A := chr(130) ; ‚
 ; CSU0192 := chr(131) ; ƒ
@@ -60,9 +85,6 @@ CSU00F6 := chr(246)   ; ö
 CSU00FC := chr(252)   ; ü
 CSU00FF := chr(255)   ; ÿ
 
-CSU000D := "Enter"
-CSS_Esc := "Esc"
-CSU0008 := "Backspace"
 CSS_Del := "Delete"
 CSS_Ins := "Insert"
 CSS__Up := "Up"
@@ -107,5 +129,3 @@ CSSNPDn := "NumpadPgDn"
 CSSNHom := "NumpadHome"
 CSSNEnd := "NumpadEnd"
 CSSNClr := "NumpadClear"
-
-Comp := ""