NAME

    astroroot_init_env -- Initialize the environment variables relevant for
                          AstroROOT data processing

USAGE

    Fist AstroROOT has to be installed.
    	
    for Bourne shell flavours (e.g. sh, ksh, bash):
    	. ${ISDC_ENV}/bin/astroroot_init_env.sh       

    for C-shell flavours (e.g. csh, tcsh)
    	source ${ISDC_ENV}/bin/astroroot_init_env.csh 

DESCRIPTION

    This component can be used to initialize environment variables
    that are relevant to AstroROOT processing software.
    
    The following variables are checked for:

        ISDC_ENV              => must be defined prior to calling the
	                         script

        ROOTSYS               => must be defined prior to calling the
	                         script
				 
                              => PATH, MANPATH and LD_LIBRARY_PATH are
	                         verified as well and corrected if needed
	
    The following variables are modified if existing -- otherwise set:
    
        PATH                  => ISDC_ENV/bin:PATH
	LD_LIBRARY_PATH       => ISDC_ENV/lib:LD_LIBRARY_PATH
                                 Depending on your system's
				 configuration, additional directories
				 may be added (ISDC_ENV/lib/{sys,gcc,f90})
	PFILES                => HOME/pfiles:...;ISDC_ENV/pfiles:...

    
PARAMETERS

    --v, --version            => displays the version number of the
                                 script.
				 
				 NOTE: For Bourne shell flavours the
				 '.' in front of astroroot_init_env.sh
				 should not be given in this case
				 
    --h, --help               => displays this help text				 

				 NOTE: For Bourne shell flavours the
				 '.' in front of astroroot_init_env.sh
				 should not be given in this case 

ERROR CODES

   -35751                     => env. variable $ISDC_ENV is not set
                                 prior to calling the script.
    
   -35753                     => directory $HOME/pfiles cannot be created.

   -35754                     => Help file $ISDC_ENV/help/astroroot_init_env.txt
                                 NOT found

   -35755                     => Internal error: wrong number of arguments.
                                 Only 1 argument is expected by
                                 $ISDC_ENV/bin/astroroot_setup_env.sh
    
   -35756                     => Internal error: unsupported shell flavour.
                                 Only sh  (Bourne shell) and
				      csh (C-shell) are supported.

   -35757                     => Internal error: could not execute
                                 $ISDC_ENV/bin/astroroot_setup_env.sh

   -35792                     => env. variable $ROOTSYS 
                                 is not set prior to calling the script.
			       

EXAMPLES

    see USAGE

BUGS

    No BUGS are currently known.

    
AUTHOR

    Mathias Beck, INTEGRAL Science Data Centre
    Mathias.Beck@obs.unige.ch

    Reiner Rohlfs, Geneva Astronomical Data Centre
    Reiner.Rohlfs@obs.unige.ch
    	
SEE ALSO