From fa1c6a1ea3491423c4feebd52b4c7e50c0618f85 Mon Sep 17 00:00:00 2001
From: Manuel Friedli <manuel@fritteli.ch>
Date: Fri, 27 Jun 2014 12:55:31 +0200
Subject: [PATCH] added comments

---
 uhr-de_CH.js | 29 ++++++++++++++++++++++++++++-
 1 file changed, 28 insertions(+), 1 deletion(-)

diff --git a/uhr-de_CH.js b/uhr-de_CH.js
index 19ee2f1..1bb4be2 100644
--- a/uhr-de_CH.js
+++ b/uhr-de_CH.js
@@ -12,6 +12,7 @@ GNU General Public License for more details.
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
+// hilfsvariablen
 var h = {
 	"_es_isch": {1:[1,2,4,5,6,7]},
 	"_ab": {4:[1,2]},
@@ -23,8 +24,11 @@ var h = {
 	"_20": {3:[1,2,3,4,5,6]}
 };
 var layout = {
+	// version: zur Zeit immer 2 (Pflichtattribut)
 	"version": 2,
+	// Sprechender Name der Sprache
 	"language": 'Bärndütsch',
+	// Buchstabenfeld als Array von Strings.
 	"letters": [
 		'ESKISCHAFÜF',
 		'VIERTUBFZÄÄ',
@@ -37,20 +41,42 @@ var layout = {
 		'ZÄNIERBEUFI',
 		'ZWÖUFINAUHR'
 		],
+	// Permanent aktive Buchstaben. <array-or-object>, vgl. ausführliche Beschreibung bei "minutes".
 	"permanent": h._es_isch,
+	/*
+	 * Minuten: Objekt im folgenden Format:
+	 * {
+	 * 	<minuten>: <array-or-object>,
+	 * 	...
+	 * }
+	 * <minuten>: String von Komma-separierten Minutenwerten, zu welchem die in <array-or-object> angegebenen Buchstaben aktiv sein sollen
+	 * <array-or-object> : [ <object>, ...] | <object>
+	 * <object>: { <zeile> : [ <spalte>, ... ] }
+	 * <zeile>: Die Zeile, in welcher die Buchstaben liegen; von oben gezählt, oben ist 1.
+	 * <spalte>: Die Spalte, in der ein einzelner Buchstabe liegt; von links gezählt, links ist 1.
+	 * Beispiel:
+	 * "minutes": {
+	 * 	"0,1": {1: [6, 7, 9]},
+	 * 	"5": [ {3: [1, 2]}, {4: [10, 11]} ]
+	 * }
+	 * Erklärung:
+	 * Bei Minuten 0 und 1 sind die Buchstaben 6, 7 und 9 der ersten Zeile aktiv.
+	 * Bei Minute 5 sind die Buchstaben 1 und 2 der Zeile 3 sowie die Buchstaben 10 und 11 der Zeile 4 aktiv.
+	 */
 	"minutes": {
 		"5,6,7,8,9": [h._5, h._ab],
 		"10,11,12,13,14": [h._10, h._ab],
 		"15,16,17,18,19": [h._15, h._ab],
 		"20,21,22,23,24": [h._20, h._ab],
 		"25,26,27,28,29": [h._5, h._vor, h._haubi],
-		"30,31,32,33,34": [h._haubi],
+		"30,31,32,33,34": h._haubi,
 		"35,36,37,38,39": [h._5, h._ab, h._haubi],
 		"40,41,42,43,44": [h._20, h._vor],
 		"45,46,47,48,49": [h._15, h._vor],
 		"50,51,52,53,54": [h._10, h._vor],
 		"55,56,57,58,59": [h._5, h._vor]
 	},
+	// Die Stunden; gleiches Format wie bei den Minuten
 	"hours": {
 		"1": {5:[1,2,3]},
 		"2": {5:[4,5,6,7]},
@@ -66,4 +92,5 @@ var layout = {
 		"12": {10:[1,2,3,4,5,6]}
 	}
 };
+// Das Layout bei der Uhr unter dem Code "de_CH" registrieren.
 window._uhr.languages['de_CH'] = layout;