**********************************************************
* DABC plugin for hadaq 
* (originally HADES collaboration DAQ and data format)
*        Joern Adamczewski-Musch, j.adamczewski@gsi.de
*        Sergey Linev, s.linev@gsi.de
* Version 2.3.5 - 02-Oct-2013
   : Move documentation to Readme.dox, see http://dabc.gsi.de site 

   
* Components:
   * HldFile - (OK) input and output of hld file format
   * HldInput - (OK) data input, reading data from hld files 
   * HldOutput- (OK) data output, writing data to hld file 
   * DataSocketAddon - (Exp) receive hadtu packets from trb frontend (single stream)
   * MbsTransmitterModule - (OK) wrap hadtu format into mbs event container
                            output is mbs server or lmd file.
                            this format is used in mbs subevent combiner and go4 monitoring unpacker 
   * CombinerModule - (OK) do eventbuilding of hadtu format from several data streams.
                      output is full event in hadtu format. 
                      Should provide functionality of old daq_evtbuild in the end.
   * Observer  - (OK) Control system interface to hades shared memory. 
                      We use original hadaq code (worker and psxshm) and wrap it into dabc parameter scheme.
                      
* Applications:
   * HldConverter.xml - (OK)
         configuration to read hld file and write the hadtu events wrapped in mbs events to lmd file

   * EventBuilder.xml -(OK)
         configuration to receive hadtu data at n udp sockets, and do a full eventbuilding.
         Output events can be served via mbs transmitter at transport/stream server
         In parallel, output events can be written to hld and/or lmd files.
         May enable export of variables via shared mem to hades EPICS-based eventbuilder control system
   
   * EventBuilderDim.xml -(OK)
         as EventBuilder.xml, but shows how to activate additionally DIM control system export.
         
* How to use:
  See Readout.dox  
 
* Changes:     
   * Version 0.01 - 06-Jun-2012
      : design of classes and first successful compilation.
   * Version 0.02 - 13-Jun-2012
      : First working with HldConverter and HldServer applications. 
   * Version 0.03 - 15-Jun-2012
      : First version with working UdpTransport. Tested with hadaq trb simulator + Go4 client
   * Version 0.04 - 19-Jun-2012
      : Implemented valid simple eventbuilding in udp transport. 
        Will insert hades eventheader before each subevent of hadtu input stream.
        First version that is _really_ working with hadaq trb simulator + Go4 client
   * Version 0.05 - 22-Jun-2012
      : First full eventbuilding in CombinerModule. 
        Tested with hadaq trb simulator + Go4 client  
   * Version 0.06 - 26-Jun-2012
      :  Implemented hld file output. 
         Improvements in Combiner module
   * Version 0.07 - 05-Jul-2012
      :  Implemented interface to hades shared memory control (hadaq "worker").
         Tested with original hades ebctrl ioc + medm
   * Version 0.08 - 08-Jul-2012
      :  Added control of distributed runid from hades epics master
   * Version 2.3.5 - 02-Oct-2013
      :  Move documentation to Readme.dox, see http://dabc.gsi.de site 
   
* DISCLAIMER:
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details (http://www.gnu.org).
---------------------------------------------------------------