Index: trunk/Mars/hawc/plot_cleaned.C
===================================================================
--- trunk/Mars/hawc/plot_cleaned.C	(revision 19841)
+++ trunk/Mars/hawc/plot_cleaned.C	(revision 19842)
@@ -38,15 +38,15 @@
 ///////////////////////////////////////////////////////////////////////////
 
+// ==========================================================================
+// ============ see plot_cleaned function at the end of the file ============
+// ==========================================================================
 Bool_t HandleInput()
 {
-    // This must be there to get accesss to the GUI while the macro
-    // is still running!
-
+    // This is a pure man's command line interface to wait for a key input
+    // and allow exit but at the same time allow interaction with the GUI
     TTimer timer("gSystem->ProcessEvents();", 50, kFALSE);
     while (1)
     {
-        //
         // While reading the input process gui events asynchronously
-        //
         timer.TurnOn();
         const char *gl = Getline("Type 'q' to exit, <return> to go on: ");
@@ -64,9 +64,8 @@
 }
 
-//
-// Setup the data-members of your 'virtual' class
-//
+// Create four camera histograms
 MHCamera display[4];
 
+// All 'data members' that are required globally
 TCanvas   *c;
 MParList  *fParList;
@@ -92,7 +91,12 @@
     for (int i=0; i<4; i++)
     {
+        // Tell all histograms which is the geometry to use
         display[i].SetGeometry(*geomcam);
+
+        // Add the camera object to the pads
         c->cd(i+1);
         display[i].Draw();
+
+        // Add the MHillas object (which pains the ellipse)
         gPad->cd(1);
         plist->FindObject("MHillas")->Draw();
@@ -155,4 +159,20 @@
     delete c;
 }
+
+// ==========================================================================
+//
+// Run the macro with
+//
+//      root hawc/plot_cleaned.C\(\"00000001.003_Y_MonteCarlo003_Events.root\"\)
+//
+// The default file name is a Y-file (either as Monte Carlo-truth from ceres
+// or from the callisto)
+//
+// From within root, the escape characters can be omitted, e.g.
+//
+//      root
+//      [0] .x hawc/plot_cleaned.C("00000001.003_Y_MonteCarlo003_Events.root")
+//
+// ==========================================================================
 
 void plot_cleaned(const char *fname)
