15.9.2011 Kamil Sedlak

1) Bug removed from the simulation of optical photons with
    the option "APDcellsEffectRequested" -- namely, when any
    simulated photon hit a given APD cell, the cell became "blind"
    to any other photon, irrespective of the arrival time of the
    next photon. However, we need that if the "second" photon
    (simulated at later phase) enters the APD cell before the
    "first" one, that the time of photon arrival changes to the
    earlierst photon.
 2) A new keyword "sampleID ..." (defining which volume is the
    sample volume) was added to the musrSimAna.  The manual
    was updated accordingly.

doc/musrSimAna.tex

@@ -435,6 +435,11 @@ All events should/have to be (?) saved in the Root tree
      This defines a group of detectors, where \emph{group} stands for ``B'' (backward), 
      ``F'' (forward), ``U'' (up), ``D'' (down), ``L'' (left) and ``R'' (right) detectors.
      This grouping is used in the definition of some conditions.
+   \item{\bf sampleID \emph{ID$_1$ ID$_2$ \ldots ID$_n$} } \\
+     Defines which volume (or volumes, if there are more) is the sample.  Typically, the
+     sample is just one volume, but sometimes there is a smaller volume inside of the sample,
+     to which a field is applied, so the small volume also has to be considered as the sample.
+     This information is needed for the condition ``muonDecayedInSample\_gen''.
    \item{\bf  setSpecialAnticoincidenceTimeWindow  \emph{detectorID}  \emph{timeMin}  \emph{timeMax} \emph{unit}} \\
      This command sets a special anti-coincidence time window for a detector \emph{detectorID}.
      Normally, the anti-coincidence time window is defined by {\tt VCOINCIDENCEW}, and is the same for all anti-coincidence