From da51e0f2b0091d2ed85e6a56e2945391be9a0d1a Mon Sep 17 00:00:00 2001
From: phille <phille@f7af4fe6-9843-0410-8265-dc069ae4e863>
Date: Thu, 26 Jul 2007 16:38:27 +0000
Subject: [PATCH 1/1] Documentation

---
 HLT/PHOS/AliHLTDDLDecoder.h | 23 +++++++++++++++++------
 1 file changed, 17 insertions(+), 6 deletions(-)

diff --git a/HLT/PHOS/AliHLTDDLDecoder.h b/HLT/PHOS/AliHLTDDLDecoder.h
index 41abc5629af..59a12be7de9 100644
--- a/HLT/PHOS/AliHLTDDLDecoder.h
+++ b/HLT/PHOS/AliHLTDDLDecoder.h
@@ -20,6 +20,7 @@
  * about the suitability of this software for any purpose. It is          *
  * provided "as is" without express or implied warranty.                  *
  **************************************************************************/
+
 #define DDL_32BLOCK_SIZE 5
 
 #include "Rtypes.h"
@@ -59,9 +60,15 @@ class AliHLTDDLDecoder
    */
   bool Decode();
 
-
+  /*
+   *Reads the next altro channels 
+   */
   bool NextChannel(AliHLTAltroData *altroDataPtr);
 
+  /* 
+   * DONT use !
+   * For debugging purphoses only, will be removed in near future
+   */
   template<typename T> 
   void  DumpData(T *array, int N, int nPerLine)
   {
@@ -79,15 +86,13 @@ class AliHLTDDLDecoder
   }
 
 
-
-
-
-
   void SetMemory(UChar_t  *dtaPtr, UInt_t size);
+  
   void PrintInfo(AliHLTAltroData &altrodata, int n = 0, int nPerLine = 4);
 
   /*
-   *
+   * Prints to stdout the percent of altroblocks that
+   * is missing the 2aaa trailer.
    */
   float GetFailureRate();
 
@@ -103,6 +108,12 @@ class AliHLTDDLDecoder
   */
   void DecodeLastDDLBlock();
 
+  /*
+   *Use for simulated data only.
+   *Patch for incorrectly simulated data. Counts the number of 
+   *aaaa word in the trailer of the payload and tries to figure out
+   *the correct number of 40 bit altro words in the RCU pauload
+   */
   int countAAApaddings();
 
   UInt_t  *f32DtaPtr;                     /**<Pointer to dat of the input buffer in entities of 32 bit words (the RCU/DDL block) */
-- 
2.43.0