--------------------------------------------------------------
         Go4 Release Package v3.4-1 (build 30401)
                      28-November-2008
-------------------------------------------------------------
    The GSI Online Offline Object Oriented (Go4) Project
    Experiment Data Processing at EE department, GSI
------------------------------------------------------------
Authors: Joern Adamczewski-Musch      (1999-)
         Mohammad Al-Turany           (2000-2004)
         Denis Bertini                (2001-2004)
         Hans Georg Essel             (1999-)
         Marc Hemberger               (1999-2000)
         Sergey Linev                 (2002-)
---------------------------------------------------------------
Copyright (C) 2000- Gesellschaft f. Schwerionenforschung, GSI
                    Planckstr. 1, 64291 Darmstadt, Germany
Contact:            http://go4.gsi.de
---------------------------------------------------------------
This software can be used under the license agreements as stated
in Go4License.txt file which is part of the distribution.
---------------------------------------------------------------
These packages are tested on
    Linux (LK 2.4.20), RedHat 7.3, Scientific Linux 4
    SuSe 8.1, SuSe 9.2,  SuSe 9.3 (x86_64), SuSe 10.0 (x86_64), SuSe 10.3, SuSe 11
    Fedora core 2/ core 3/ core 4 / core 5,
    Debian 3.1 (32 bit and AMD 64bit), Debian 4.0, Ubuntu 6.10
    compilers: gcc 3.2, gcc 3.3.5, gcc 3.4.3, gcc 4.0.2, gcc 4.1.x, gcc 4.3.x
    SunOS 5.2 (Solaris) with CC 5.8

    ROOT: recommended >=4.04; tested for ROOT versions <=5.15-06

    Qt: >=3.3.x 
    NOTE: Go4 v3 does not work with Qt version 4 ! Please use Go4 v4 here.

INSTALLATION:
- Install the ROOT framework Version >3.05
  (download at http://root.cern.ch)
  NOTE: choose installation mode for one generic $ROOTSYS directory,
  DO NOT INSTALL root in "fixed location" as system libraries, i.e.
  DO NOT use e.g. "--prefix=/usr/local" when configuring root install!
  set environment variables
      $(ROOTSYS), $(LD_LIBRARY_PATH), $(PATH)
      e.g. in a startup script rootlogin

- Install the Qt graphics library, X11-free-3.0.x (recommended >=3.0.5)
  (download at http://www.trolltech.com/developer/download/index.html)
   Note: Qt has to be configured with thread support to work with Go4!!
         This is not the default!!
   In the $QTDIR, before building Qt configure it like:
      ./configure -prefix $PWD -shared -qt-gif -thread
   Set environment variables
      $(QTDIR), $(LD_LIBRARY_PATH), $(PATH)
      e.g. in a startup script qtlogin

- Unpack this Go4 distribution in the future Go4 System directory,
  e.g. /usr/local/pub/Go4

- In the Go4 System directory, execute script ". go4.init".
  This will set the environment $GO4SYS to the current directory and
  prepares the build: e.g. GO4SYS=/usr/local/pub/Go4. Settings for the
  qtroot interface and the Go4 libraries version is also done here.

- Be sure that environment variables for ROOT and Qt libraries are set
  correctly to your local installations!!

- "gmake all" will start the build of the Go4.

- To compile under Windows or Solaris, one should modify GO4_OS definition
  in Makefile.config file to Win32 or Solaris respectively.

- The file $GO4SYS/etc/Go4LaunchClientPrefs.txt contains the command format
  strings to be used on remote startup of the analysis from the gui.
  Here the call to the xterm (/usr/local/bin/xterm) is specified with
  absolute path. Please check if xterm is installed on your system at this
  location. You might have to change this string here to run go4 in the
  external xterm (ssh mode).

- The analysis startup script $GO4SYS/etc/Go4ClientStartup.ksh specifies
  in the first line the shell to execute it, i.e "#!/usr/bin/ksh". Please
  check if this is the correct location of the ksh executable on your system
  (type "which ksh" in shell). If not, you should edit this line to indicate
  the absolute path. If ksh should not be installed at all on your linux, you
  can use bash instead. The same is true for the user startup script
  AnalysisStart.sh that is in the user analysis working directory,
  e.g. in $GO4SYS/Go4Example2Step

- Edit your go4login script (see go4login.sh):
  Define ROOTSYS, QTDIR and GO4SYS according to your local
  installation. You might call your local rootlogin and qtlogin scripts
  here instead explicitly defining ROOTSYS and QTDIR again. Be sure that
  LD_LIBRARY_PATH contains $ROOTSYS/lib:$QTDIR/lib:$GO4SYS/lib
  and PATH contains $ROOTSYS/bin, $QTDIR/bin and $GO4SYS/bin.
  Put the script at a location in your global $PATH.

- ". go4login.sh" from any new shell sets the environment. Type "go4" to
  start the Go4 Main GUI with File/Oject Browser and remote analysis control.

- This completes the framework installation. To use Go4 with your analysis,
  install the Go4 User Analysis package (UserAnalysis.tar.gz) at the future
  user working directory. See README.txt of this package for details.

- Read the Go4 Manual Go4introV3.doc for further information on adopting your
  analysis and how to use the GUI!

- Read the ROOT Users guide
  (available at  http://root.cern.ch/root/RootDoc.html) for any questions
  concerning the ROOT system itself!

- Please contact the Go4 developer team for any bug reports and wishes!
________________________________________________________________________