--------------------------------------------
INSTALLATION PROCESS (& BRIEF INTRODUCTION):
--------------------------------------------
(A few minutes only are necessary for reading and installing!)

00-Remember, when you will install a Software Package associated with the
   CAOS PSE, to subscribe to its mailing-list (and for each Software Package
   you will use.
   [As a first step of the installation process of any Software Package.]

01-Click on "CAOS PSE 7.0 archive file" and unpack then the downloaded file
   caos_pse.tgz (with, e.g., "tar xvfz"). A directory called "caos_pse" will
   be created.
   Note that no Software Package is included, but the template one. The
   Software Packages (Soft.Pack.CAOS, Soft.Pack.AIRY) are obtainable from:
       http://lagrange.oca.eu/caos/

2a-UNIX/LINUX/MACOSX cases:
   Change directory to .../caos_pse/work_caos and:
   2a.1- Fix the paths in caos_env.sh (or .csh, depending on your shell).
   2a.2- Idem in caos_startup.pro.

2b-WINDOWS 10 case:
   2b.1- Unlike in the previous case, you can eliminate the files 
         caos_env.csh and caos_env.sh and, instead, define the two
         environment variables CAOS_WORK (complete address of working
         directory .../work_caos/), and CAOS_ROOT (complete address of
         source code directory .../caos_pse/) from the windows "Start"
         menu, in "Control Panel->System->Advanced System Settings->
         Environment variables for Windows 10".
   2b.2- Comment within the file "caos_startup.pro" the lines defining
         the various necessary paths (caos/, astrolib/, etc.)
         and, instead, define them within the IDL preferences (from the IDL 
         "File" menu, in "Preferences->Path").
   2b.3- Set the IDL startup file to be caos_startup.pro
         ("Window->Preferences->IDL->startup file:-> Browse...").
   2b.4- Exit from IDL.

03-UNIX/LINUX/MACOSX cases:
   Type "source caos_env.csh" (or .sh).
   [Note that this is to be done for each opened shell where you will use
   IDL together with CAOS. Alternatively you can move the content of the
   file caos_env.csh into your .cshrc or .bashrc and .profile files. See
   the "trick" (point 04 of the "Final Remarks") given at the end of
   this file to avoid this step and step 08 here below.]

04-Launch IDL.
   [See the "trick" (point 04 of the "Final Remarks") given at the end
   of this file to avoid this step and step 07 here above in the
   UNIX/LINUX/MACOSX cases.]

05-Type "worksheet" at the CAOS prompt in order to use the CAOS
   Application Builder.

06-Install some Software Package !

NB: steps 01, 2a/2b, 06 are necessary just once, during installation.


------------------------
SOME ADDITIONAL REMARKS:
------------------------

00-Refer to the template module xxx for a guide for writing a new module
   and so include your IDL code within the CAOS PSE (and submit it to us
   for inclusion in future distributions).

01-Refer to
      http://lagrange.oca.eu/caos
   for further informations on the CAOS Problem-Solving Environment and
   its packages (or for submission of bug fixes, new modules, etc.).

02-Please never redistribute any CAOS part by yourself, rather refer to
   http://lagrange.oca.eu/caos -- or at least recommend subscription to
   the mailing-list.

03-Refer to the CAOS tutorials given on the CAOS web-page
      http://lagrange.oca.eu/caos/tutorial/tutorial.html
   for an example of use together with the Software Package CAOS,
   or to
      http://www.airyproject.eu/Tutorials/AIRY/
   for an example of the use together with the Software Package AIRY.

04-UNIX/LINUX/MACOSX cases:
   If you will use different Software Packages but would like to have
   the simulation projects made with different installed packages in
   different locations (not all the simulation projects in the same
   "work_caos/Projects" directory), there is a solution which still permits
   to use modules from the various Software Packages together anyway.
   A-Make one working directory per Software Package (e.g. work_caos and  
     work_airy)
   B-Add one alias for each installed Software Package in your .cshrc
     or .bashrc (and .profile) file, for example for the Software Package
     CAOS:
     alias caos='cd YOUR_PATH/work_caos ; source caos_env.sh ; idl'
     and for the Software Package AIRY:
     alias airy='cd YOUR_PATH/work_airy ; source caos_env.sh ; idl'
   C-Then simply type "caos" (or "airy") to launch IDL+the CAOS PSE+move
     in the CAOS (or AIRY) working directory, all together.


-------------------------------------
Completed June 2016 - Marcel Carbillet