Commented on loop() before refactoring.

svn-id: r45604

1 files changed, 5 insertions, 2 deletions

diff --git a/engines/draci/animation.h b/engines/draci/animation.h
index 11cdc3d414..e7ffc9d761 100644
--- a/engines/draci/animation.h
+++ b/engines/draci/animation.h
@@ -104,8 +104,11 @@ public:
 
 	void markDirtyRect(Surface *surface) const;
 
-	// Animation callbacks
-
+	// Animation callbacks.  They can only do simple things, such as
+	// setting the value of some variable or stopping an animation.  In
+	// particular, they cannot run sub-loops or anything like that, because
+	// the callback is called at an arbitrary time without much control
+	// over what the state of the rest of the program is.
 	void registerCallback(AnimationCallback callback) { _callback = callback; }
 
 	void doNothing() {}