--- PamelaDigitizer/Pamelagp2Digits.cxx	2007/09/28 10:46:27	1.2
+++ PamelaDigitizer/Pamelagp2Digits.cxx	2007/10/31 18:17:59	1.6
@@ -4,15 +4,17 @@
 //      The conversion is done using a slightly patched version of
 //      Rene Brun's h2root.
 //
-//      Created : Jan Conrad (conrad@particle.kth.se)
-//      Modified: Silvio Orsi (silvio.orsi@roma2.infn.it)
+//      Created : 2006 Jan Conrad  (conrad@particle.kth.se)
+//      Modified: 2007 Silvio Orsi (silvio.orsi@roma2.infn.it)
 //
 //
 //  HOWTO (RECOMMENDED):
 //  ./ Pamelagp2Digits filename.his
 //  It generates filename.pam (PAMELA raw data) and filename.gp.root (sim info)
 //  
-//  HOWTO (EXPERT, only for testing purposes)
+//  NB: more details are present in the file HOW-TO-DIGIT.TXT
+//
+//  HOWTO (only for testing purposes)
 //  Pamelagp2Digits hbook_filename root_filename  raw_filename compress tolower
 //  - If the 2nd and 3rd parameters are missing the names are generated from the hbook file name. 
 //  - The following flags are from h2root and default values are used: 
@@ -25,21 +27,50 @@
 //
 //  MODIFICATIONS:
 //
-//  v. 1.01 (S.Orsi, Roma2, 28 September 2007)
+//  v. 1.6 (S.Orsi, Roma2, 31 October 2007)
+//  - TOF: (Campana, Menn, Orsi)
+//         + bugs fixed
+//         + crc included
+//         + introduction of 3 control bits in the ADC and TDC words before writing fDataTof
+//         + channel map corrected (correspondence between PMT# and TDC channel)
+//         + new conversion pC to ADC
+//         + scaling factors to tune MC data to real ones
+//  - HOW-TO-DIGIT.TXT file updated (E.Vannuccini)
+//
+//  v. 1.5 (S.Orsi, Roma2, 11 October 2007)
+//  - file HOW-TO-DIGIT.TXT written (mainly by S.Bottai): contains information on how to run the chain from the DB creation to DarthVader through Digitizer, yoda and YodaProfiler
+//
+//  v. 1.4 (S.Orsi, Roma2, 11 October 2007)
+//  - similar to v. 1.3
+//
+//  v. 1.3 (S.Orsi, Roma2, 11 October 2007)
+//  - TOF: + changes and major corrections in ADC and TDC (W.Menn, D.Campana, S.Orsi)
+//         + flag DEBUG added (default: DEBUG=false; if true, print on screem some messages to debug)
+//  - AC: + shift register filled; 
+//        + minor bugs fixed
+//        + counters increment by 1 at each event (they were constant before)
+//  - S4: + minor bugs fixed (S.Borisov)
+//        + the routine DigitizeS4() is now inserted in the code. For DV versions earlier than October 2007, the option "-S4" is still needed because S4 calibration is not present
+//  - corrected severe bug that caused yoda to process only part of large data files (file.pam). S4 data were written to file even if the DigitizeS4() routine was not called. Previous versions of the digitizer should have crashed always, but unexpectedly worked on small files.
+//  - file HOW-TO-DIGIT.TXT written (mainly by S.Bottai): contains information on how to run the chain from the DB creation to DarthVader through Digitizer, yoda and YodaProfiler. The file is included only from release 1.5
+//  - digitizer version numbers modified according to CVS repository (v1.00->v1.1, v1.01->v1.2)
+//  - some flags (LDFLAGS) in the Makefile have been changed; they are needed on some machines (e.g. pamelatov.roma2.infn.it), but give errors on others (e.g. pamelaws02.na.infn.it). See Makefile for details if the compilation fails due to library errors)
+//
+//  v. 1.2 (S.Orsi, Roma2, 28 September 2007)
 //  - TOF TDC inserted (to be tuned)
 //  - improved tracker dEdx, tracker saturation inserted (S.Bottai)
 //  - S4 routine inserted in code (not in read-out)
 //  - bugs with packet length corrected
 //  - small bugs fixed
-//  - NB: Run DarthVader with the options: "DarthVader -zerofill -idRun 1 -ALL +RUN +CAL [ --no-crosstalk ] +TRK +TOF +AC +TRG +ND", i.e. without S4
+//  - NB: Run DarthVader with the options: "DarthVader -zerofill -idRun 1 -ALL +RUN +CAL [ --no-crosstalk ] +TRK +TOF +AC +TRG +ND" or  "DarthVader -zerofill -idRun 1 +CAL [ --no-crosstalk ] -S4", i.e. without S4
 // 
-//  v. 1.00 (S.Orsi, Roma2, 13 September 2007)
+//  v. 1.1 (S.Orsi, Roma2, 13 September 2007)
 //  - trigger (dummy), tof (preliminary, adc only), ND (preliminary) inserted
 //  - various changes and bug fixes
 //  - padding increased (fPADbuffer=64, fPadding = padbytes+64) 
 //
 //  v. beta (J.Conrad, KTH, 2006)
-//  - compiles; includes pscu, calo, trk, ac
+//  - compiles; includes pscu, calo, trk, ac; not present on cvs
 //
 /////////////////////////////////////////////////////////////////////////