Index: trunk/src/atmsdriver/TrafficEventsAnimator.java
===================================================================
--- trunk/src/atmsdriver/TrafficEventsAnimator.java	(revision 226)
+++ trunk/src/atmsdriver/TrafficEventsAnimator.java	(revision 227)
@@ -20,5 +20,10 @@
 
 /**
- *
+ * Read and process all Traffic Events in a file and show
+ * resulting highway network. 
+ * A snapshot of the highway model after each event is saved in a buffer
+ * and a graphical display allows the user to scroll through the history. 
+ * This application is used by Traffic Event authors to assist
+ * in verifying the correctness of their data file.
  * @author jdalbey
  */
@@ -28,5 +33,5 @@
      * Error logger.
      */
-    private static Logger logger = Logger.getLogger("trafficmodeleventdriver");
+    private final static Logger logger = Logger.getLogger("trafficmodeleventdriver");
 
     /**
@@ -38,5 +43,5 @@
      * LinkedList of batch events
      */
-    private LinkedList<TrafficEvent> eventQueue;
+    private final LinkedList<TrafficEvent> eventQueue;
     /**
      * Map of incidents to events
@@ -48,19 +53,6 @@
     private List<String> history;
     /**
-     * Creates new form HighwayDisplayPanel
-     * 
- *
- * Read and process all Traffic Events in a file and show
- * resulting highway network. 
- * A console display of the highway network is output
- * for each event.
- * This application is used by Traffic Event authors to assist
- * in verifying the correctness of their data file.
- * Because the output is sent immediately to the console the
- * author doesn't have to sit through simulation time to
- * observe dots changing on ATMS client.
- * @author jdalbey
- */
-
+     * Creates the JPanel and builds the highways and events. 
+     */
     public TrafficEventsAnimator() throws RemoteException, SimulationException
     {
@@ -92,5 +84,6 @@
         eventQueue = TrafficModelManager.readBatchFile(fileScanner);
     }
-    public void run()
+    /** Load the traffic events into a history buffer */
+    public void load()
     {
         txtDisplay.setText("Loading ...");
@@ -101,5 +94,5 @@
             // Get next event
             TrafficEvent nextEvent = eventQueue.peek();
-            //System.out.println("LAUNCHING EVENT: " + nextEvent.toString());
+            System.out.println(nextEvent.eventTime);
             // apply colorization to highways
             highways.applyColorToHighwayStretch(nextEvent.routeNumber, nextEvent.dir,
@@ -110,4 +103,5 @@
         }
         scrollBar.setMaximum(history.size());
+        // display the first item from the history
         txtDisplay.setText(history.get(0));
     }
@@ -157,9 +151,15 @@
     private void scrollbarValueChanged(java.awt.event.AdjustmentEvent evt)//GEN-FIRST:event_scrollbarValueChanged
     {//GEN-HEADEREND:event_scrollbarValueChanged
-        
+        // when the scroll bar is moved show the corresponding snapshot from history
         txtDisplay.setText(history.get(evt.getValue()) );
         repaint();
     }//GEN-LAST:event_scrollbarValueChanged
 
+    /** Entry point for the application.  Builds a surrounding JFrame and 
+     * runs the application.
+     * @param args
+     * @throws RemoteException
+     * @throws SimulationException 
+     */
     public static void main(String[] args) throws RemoteException, SimulationException
     {
@@ -170,5 +170,5 @@
         frame.add(display);
         frame.setVisible(true);
-        display.run();
+        display.load();
     }