From 920e1c3bfa06851fb06623da32c2502891f8f172 Mon Sep 17 00:00:00 2001 From: dennis Date: Sat, 1 Nov 2008 13:18:17 +0000 Subject: =?UTF-8?q?AHK-Entwickler-Readme=20um=20M=C5=93sis=20Vorschlag=20e?= =?UTF-8?q?ines=20einheitlichen=20Coding-Style=20erg=C3=A4nzt.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit git-svn-id: https://svn.neo-layout.org@1084 b9310e46-f624-0410-8ea1-cfbb3a30dc96 --- windows/autohotkey/Source/README.txt | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) 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 -- cgit v1.2.3