-------------------------------------------------------------------------
Note, this help is for
            
            RASS-OSX v3.6.1

To get started follow these steps in a window of the OS X Terminal:

 1) Go to your RMSP1 folder E.g. type

            cd 

    (note the blank after 'cd ') and drag the folder RMSP1 to the terminal
    window. Then press key RETURN.

 2) Consult the READ ME using this command or double-click it in the Finder


            open 'READ_ME.pdf'   Should I open it for you (y/n)? 

 3) Go to the work directory and create a new project directory. E.g. type

            cd Work
            mkdir myfirst
            cd myfirst
            open .

 4) Transfer all files of your RASS project to this directory e.g. by drag
    and drop. Note: All files means sources, i.e. all Modula-2 files of your
    Model Definition Program (MDP) plus possibly needed input files. For your
    convenience the release offers sample MDP Logistic.MOD ready for your use.

 5) Make and execute the program by the command

            mk

    Note, this utility does compile, link, and execute the first main program
    module upon sucessful making.  It does not require any preparation as long
    as all sources are within your directory 'myfirst' or a sub directory of
    'myfirst'.  Note also, 'mk' does generate a Makefile, which you can use
    once created by 'mk'.  The Makefile offers several targets.  Use 'make
    help' to learn about those.  HINT: If make fails, try 'make clean' before
    the next 'make'.

 6) To execute the program type its name and RETURN. To inspect the results
    open e.g. ModelWorks.DAT as created by Logistic.MOD by Apple's TextEdit.


 RASS-OSX comes with following utilities:

  - RASSHelp        (this command, synonym = RMSP1Help)
  - mk              makes and executes your RASS project from files contained
                    in current working directory (generates a Makefile)
  - mk1             makes and executes a single program module (in any dir)
  - autoedit        Adjusts sources containing compiler flags to RASS-OSX code
  - make            the Unix utility to remake the program (see 'make help')
  - make help       use 'make help' to learn more on the mk generated Makefile
  - job             execute RASS program in foreground (job -o lists output)
  - setRASSmailto   sets, shows E-mail address(es)
  - setprojdescr    sets, shows, clears a project descriptor (alias: 'prj')
  - getjob          creates a new file 'job' in current directory
  - getm2config     creates a new file 'config.M2PATH' in current dir (to be
                    used only with 'job'. With 'mk' or 'mk1' use option -P)
  - cleanup         cleans current directory, asks for deletion of job results
  - fis             find in sources
  - def2DEF, mod2MOD, mac2unix, unix2mac conversion utils
  - switch2using    switches '.profile' to use either RMSP1 or RASS-OSX
  - switchp1        switches Xcode and P1 compiler

  Most utilities give help or respond to arguments such as show. Ex.:
  'setRASSmailto help', 'prj show', 'make show', or 'job tutorial'.

  To check the installation and learn about current env var settings 
  use 'switch2using -v' and 'switchp1 -v'.

  For developers are also utilities 'mknewlib' and 'doBatchExecute' available.
  Utility 'doBatchExecute' executes a program, but does not hang if the
  debugger is called.

  Use 'mk' or 'mk1' with option -P and edit 'config.M2PATH.sh' or use 'job'
  and edit 'config.M2PATH' for a User.Profile mechanism as in MacMETH. 

  Visit https://sysecol.ethz.ch/ramses/ramses-software-layers/rass.html
  and https://www.sysecol2.ethz.ch/intranet/Unix_Hints.html#RASS for
  further info, e.g. on how to use the debugger or for literature.

 Enjoy!
-------------------------------------------------------------------------
 This is RASS-OSX utility RASSHelp v1.9 using RASS-OSX v3.6.1
-------------------------------------------------------------------------