--- yoda/README	2004/07/06 12:20:23	1.1.1.1
+++ yoda/README	2006/04/05 08:06:52	6.1
@@ -1,13 +1,16 @@
-Install procedure 1.1 - Nagni 11 May 2004
+Install procedure 3.0 - Nagni 04 April 2006
 
-To install YODA:
+To install YODA you can either use traditional Makefile (deprecated) or ANT tool (suggested).
+
+/**************/
+ USING Makefile
+/**************/
 
 1) check that you have installed ROOT and your enviroment have defined
    
 #-----YODA's Environment-----------------------
 # this variable define where YODA will write the managed files
 export YODA_DATA= YourPathToStoreUnpackedFiles
-export YODA_LOGS= YourPathToLogs
 #-----YODA's Environment-----------------------
  
 #-----Cern's ROOT Environment-----------------------
@@ -17,50 +20,101 @@
 #-----Cern's ROOT Environment-----------------------
 
 2) check that you have installed
-   ---->log4cpp (logger for c++ programs)
+   ---->log4cxx (jakarta logger for c++ programs)
    ---->g77	(GNU FORTRAN Compiler)
    ---->LIBTOOL	(compiler utility)
 
 3) create a directory (say YOUR_YODA) and copy the source into it
 
-4) from LIBTOOL directory copy into YOUR_YODA the following files
-   
-    config.guess
-    config.sub
-    ltmain.sh
- 
-5) execute the following commands
+4) execute the following commands (please customize the ./configure line according to your system)
 
 $ cd $YODA_ROOT
+$ autoheader
+$ libtoolize       (eventually "libtoolize --force")
+$ export CFLAGS="-g -O4"
+$ export FFLAGS="-g -O0 -keepC"
+$ export CXXFLAGS="-g -O4"
 $ aclocal
 $ automake -a
 $ autoconf
-$ export CXXFLAGS="-g"
+$ ./configure --prefix=/path/where/you/want/to/install --with-log4cxx=/opt/log4cxx --enable-gprof=no
+$ make
 
 that a look at the configure options
 $ ./configure --help
 
-if you want to install executable in the same directory of source code
 $ ./configure
 
+$ make
 
-else  
-$ ./configure --libexecdir=yourDirectory
+then became ROOT user to install YODA
 
-and finally 
-$ make
+$ make install
+
+if everthing has been correct typing
+
+$ yoda
+
+the program should reply something like below
+
+You have forgotten the file name.
+Try '-help' for more information.
+
+
+/**************/
+   USING ANT
+/**************/
+
+For this you should have installed moreover the ANT tool also the ant-contrib package. Once you have edited and configured the "value"s of the following parameters in the build.xml file
+
+<!--Here is where all the stuff will be installed-->
+<property name="pamSoftware" value="${env.HOME}/pamela"/>
+	
+<!-- CERN's ROOT base directory -->
+<property name="root"    value="/opt/root"/>
+	
+<!-- LOG4CXX base directory -->
+<property name="log4cxx" value="/opt/log4cxx"/>
+	
+<!-- ant-contrib base directory -->
+<property name="ant-contrib.lib"  value="/opt/ant-contrib/lib"/>
+	
+you can run (in the same folder of build.xml)
+
+ant compileYoda
+
+once you verified that everithing is ok run
+
+ant deployYoda
+
+At the end you will have into the "pamSoftware" folder a structure like
+./bin/yoda
+./lib/libyoda.so
+./include/several ".h" files
+
+Check the funzionality typing 
+
+/"pamSoftware"/bin/yoda
+
+
+-----> Troubleshoting <----
+If you get a kind of "libxxxx.so" not found check that 
+
+log4cxx/lib, root/lib, /"pamSoftware"/lib/
 
+are in your LD_LIBRARY_PATH environment.
 
------->NOTE<------
-This procedure will generate the code in the same directory YODA
-sources has been copied.
-The executable file name is techmodelreader and it's located in
-TECHMODEL directory.
-To make yoda available using just the command "yoda" from every location 
-just making a softlink to techmodel/.libs/techmodelreader in /usr/bin
-directory (root privileges are needed!)
 
-   ln -s techmodel/.libs/techmodelreader /usr/bin/yoda
 
+------>NOTE 1<------
+On the source code is supplied also a tipical configuratin file for the Log4cxx tool.
+The file is named log4cxx.conf and is designed to be put into the YODA_DATA directory.
+Notice that to set the output detail level you have to modify the log4cxx.conf
+according to your needs.
 
+------>NOTE 2<------
+Because of major changes in ROOT, Trees produced with a version of ROOT greater than 4.01/02 
+cannot be read by older ROOT versions.
 
+------>NOTE 3<------
+If you are doing an upgrading and you are installing it in a different location be careful to not use in the LD_LIBRARY_PATH both new and old yodalib.so.