13.1.2010 Kamil Sedlak

1) The filling of the root tree was called from musrScintSD.cc, which was
   problematic, because no variables were written out if there was no
   sensitive volume defined (problem for example when one wants to study
   the beam-line properties using just save volumes).
   Therefore the tree filling is now called from musrEventAction.cc.

2) A possibility to gently stop the run by creating a file with the
   name "RUNNUMBER.stop" in the working directory has been introduced.
   ("Gently" means that root output file is closed properly.)

doc/musrSim.tex

@@ -126,6 +126,7 @@ in the macro file:
 
 By default, the output of the simulation is written out in the subdirectory ``data'' with
 the name ``musr\_RUNNUMBER.root''.
+(Note that the execution of the simulation can be terminated gently by creating a file ``RUNNUMBER.stop'' in the working directory.)
 
 \section{Conventions}
 The default units of the musrSim in both the macro file (RUNNUMBER.mac) and in the Root tree 
@@ -766,7 +767,10 @@ Three special volumes ``Target, M0, M1 and M2''.
 	the job will be terminated gently if its physical execution time
 	exceeds \emph{timeMax}.  
 	Note that the units of \emph{timeMax} are seconds,
-	and the default value is set to 85000\,s (23\,hours, 37\,minutes).
+	and the default value is set to 85000\,s (23\,hours, 37\,minutes).\\
+	(Note that the simulation can also be terminated gently by creating a file
+         ``RUNNUMBER.stop'' in the working directory, where RUNNUMBER matches the 
+	run number specified in the name of the macro file.)
 \end{description}
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \section{Output root tree variables}