--- DarthVader/TriggerLevel2/inc/TrigLevel2.h	2006/11/09 17:05:49	1.7
+++ DarthVader/TriggerLevel2/inc/TrigLevel2.h	2007/03/01 10:27:36	1.8
@@ -1,3 +1,9 @@
+/**
+ * \file TrigLevel2.h
+ * \author Gianfranca DeRosa / Wolfgang Menn
+ */
+
+
 #ifndef TrigLevel2_h
 #define TrigLevel2_h
 //
@@ -6,21 +12,27 @@
 
 #include <TrigStruct.h>
 
+/**
+ * \brief  Class which contains the Trigger data
+ *
+ */
+
 class TrigLevel2 : public TObject {
  private:
 
  public:
-  UInt_t         evcount;
-  UInt_t         pmtpl[3];
-  UInt_t         trigrate[6];
-  UInt_t         dltime[2];
-  UInt_t         s4calcount[2];
-  UInt_t         pmtcount1[24];
-  UInt_t         pmtcount2[24];
-  UInt_t         patternbusy[3];
-  UInt_t         patterntrig[6];
-  UInt_t         trigconf;
-  Int_t          unpackError;
+
+  UInt_t         evcount; ///<event number starts from 0 at each new run
+  UInt_t         pmtpl[3]; ///<Rate counters top / middle /bottom
+  UInt_t         trigrate[6]; ///<Rate counters of trigger configurations TOF 1/2/.../6 (time base 4 seconds)
+  UInt_t         dltime[2];  ///<livetime  or deadtime live=0.16*dltime[0]; dead=0.01*dltime[1]
+  UInt_t         s4calcount[2]; ///<Rate counters of s4 and calorimeter (time base 4 seconds)
+  UInt_t         pmtcount1[24]; ///<Rate counters of the first 24 pmt's (S111a,...,S118a,S111b,...,S118b etc. look at the QL sequence)
+  UInt_t         pmtcount2[24]; ///<Rate counters of the last 24 pmt's
+  UInt_t         patternbusy[3]; ///<Too complex to describe, basically there are 3 registers which store the status of the busy lines of all the detector in the 3 phases of acq. (after the trigger, when IDAQ set the busy and when iDAQ remove it)
+  UInt_t         patterntrig[6]; ///<What is used in the trigger. One has to do some bit shifting to check the values
+  UInt_t         trigconf; ///<Gives the trigger configuration by bit shifting. For example: "trigconf & (1<<0)" => TOF1
+  Int_t          unpackError; ///<is a flag set in case of CRC errors during the unpacking of data
   //
   // here you can define methods to make life simplier during the analysis
   //