[gnome-games/gsoc-seed-games] [lightsoff] Various clarifying comments

[Tim Horton <hortont src gnome org>]

commit f8a7cd6299aab28ee33302d662bb100863490a05
Author: Tim Horton <hortont424 gmail com>
Date:   Sat Jul 11 21:46:18 2009 -0400

    [lightsoff] Various clarifying comments

 lightsoff/src/Game.js |    9 +++++++++
 1 files changed, 9 insertions(+), 0 deletions(-)
---
diff --git a/lightsoff/src/Game.js b/lightsoff/src/Game.js
index 4007db1..7f470f5 100644
--- a/lightsoff/src/Game.js
+++ b/lightsoff/src/Game.js
@@ -85,6 +85,10 @@ GameView = new GType({
 			return false;
 		}
 		
+		// The player asked to swap to a different level without completing
+		// the one in progress; this can occur either by clicking an arrow
+		// or by requesting a new game from the menu. Animate the new board
+		// in, depthwise, in the direction indicated by 'context'.
 		var swap_board = function(arrow, event, context)
 		{
 			if(timeline && timeline.is_playing())
@@ -118,8 +122,12 @@ GameView = new GType({
 			return false;
 		}
 		
+		// The player changed the theme from within the preferences window
 		var theme_changed = function()
 		{
+			if(timeline)
+				return;
+			
 			timeline = new Clutter.Timeline({duration: 1500});
 			
 			create_next_board();
@@ -134,6 +142,7 @@ GameView = new GType({
 			timeline.start();
 		}
 		
+		// The current level changed; update the score in GConf and the LEDView 
 		var score_changed = function(new_score)
 		{
 			current_level = new_score;