summaryrefslogtreecommitdiffstats
path: root/windows/autohotkey
diff options
context:
space:
mode:
authordennis <dennis@b9310e46-f624-0410-8ea1-cfbb3a30dc96>2008-11-01 13:18:17 +0000
committerdennis <dennis@b9310e46-f624-0410-8ea1-cfbb3a30dc96>2008-11-01 13:18:17 +0000
commit920e1c3bfa06851fb06623da32c2502891f8f172 (patch)
tree150481026a22424dfb867715f64fe5e509b8ffba /windows/autohotkey
parent6fb47d5d1ac78edd3554bd9ae7f2eb0eea63bb99 (diff)
AHK-Entwickler-Readme um Mœsis Vorschlag eines einheitlichen Coding-Style ergänzt.
git-svn-id: https://svn.neo-layout.org@1084 b9310e46-f624-0410-8ea1-cfbb3a30dc96
Diffstat (limited to 'windows/autohotkey')
-rw-r--r--windows/autohotkey/Source/README.txt20
1 files changed, 19 insertions, 1 deletions
diff --git a/windows/autohotkey/Source/README.txt b/windows/autohotkey/Source/README.txt
index 3b0ecff..26867ac 100644
--- a/windows/autohotkey/Source/README.txt
+++ b/windows/autohotkey/Source/README.txt
@@ -31,4 +31,22 @@ Eine kurze Einführung (Installation und Beispielskript) findet man etwa auf
http://www.kikizas.net/en/usbapps.ahk.html
Eine alphabetische Liste aller erlaubten Kommandos findet man online unter
-http://www.autohotkey.com/docs/commands.htm \ No newline at end of file
+http://www.autohotkey.com/docs/commands.htm
+
+=== Coding-Style ===
+Der Programmcode sollte möglichst einheitlich formatiert werden, um mögliche Fehlerquellen auszuschließen und um optimale Lesbarkeit zu erreichen:
+
+== Zuweisungen mit ":=" ==
+AHK erlaubt mehrere Arten der Zuweisung. Um Missverständnissen vorzubeugen, möge ausschließlich die Zuweisung mittels ":=" Verwendung finden. Die Zuweisung mit einem "=" funktioniert zwar auch und erspart bei Zuweisung konstanter Zeichenfolgen auch die Anführungszeichen, sorgt aber spätestens bei Berechnungen für Verwirrung.
+
+== Funktionale If-Abfrage ==
+Abfragen mittels "if" können in AHK auf zwei unterschiedliche Arten erfolgen, die sich durch die Klammerung des Ausdrucks unterscheiden. Um auch hier Missverständnissen vorzubeugen, mögen sämtliche Abfragen in eine gemeinsame Klammer gefasst werden.
+
+== Möglichst auf %-Variablen verzichten ==
+Gibt es von einer Funktion oder Methode zwei Varianten, so ist die Variante vorzuziehen, bei der Variablen nicht mit %varname% escaped werden müssen (analog zur Zuweisung mit ":="), um Missverständnissen vorzubeugen.
+
+== Einrückung ==
+Einrückung einheitlich 2 Zeichen vor dem Beginn der Zeile, dazwischen einheitlich 1 Zeichen. Dient es der Lesbarkeit, z.B. die Abfragen einer "if"-Abfrage mit der darunter liegenden "else if"-Abfrage auszurichten, darf dies stattfinden.
+
+== Geschwungene Klammern ==
+Geschwungene Klammern zum Zusammenhalten eines Funktionsblocks oder If-Zweiges mögen dem Funktionsnamen bzw. if-Zweig folgen. Bei If-Abfragen möge "else" mit einem Leerzeichen Abstand an die schließende Klammer angehängt werden, woran dann gegebenenfalls die nächste öffnende Klammer mit einem Leerzeichen angehängt wird. \ No newline at end of file