How to install rlab from source files:
=================================================


N. Required tools packages and shared libraries:
------------------------------------------------
1. Tools for rlab's parser and such:
  bison, gcc, g77 (any) or gfortran (4.1.2 or higher),
  f2c
1. flex is ignored in building rlab. This is done because flex-2.5.35
makes an error when processing the file 'scan.l'. The files provided with rlab
'lex.yy.c' and 'lex.yy_c_dist' are processed with flex-2.5.35 and the error is fixed
by hand (the flex' developers have been notified on 12-5-2010).
In the file 'lex.yy.c' at the beginning there is a comment paragraph describing the details.

Developers only - others can ignore this paragraph:
One can test rlab against the local instalation of flex by modifying
in 'Makefile.in' the line containing

FLEX = @FLEX@

where instead @FLEX@ one should put the name of local flex, and then running the command
> make scanner
If that is executed without errors then probably local flex is fine.

2. For list of mandatory and optional libraries to build rlabplus
see attached file 'libslist.txt'

Following an untar of the src archive downloaded from the sourceforge.net
site, two directories are extracted which contain the rlab installation:
  pgplot/
  rlab-2.x.x-gcc/
  install.txt (this file)

Building rlab goes in two stages:

 I. Compile and build rlab:
---------------------------
> cd rlab-2.x.x-gcc
> make clean
> ./configure
> make
> sudo make install

If one modifies certain files it is not necessary to run the entire make.
Instead, one can use
> make gc               (re-build the garbage collector, do not change its flags)
> make flibs            (re-build fortran libraries, if necessary)
> make clibs            (re-build c-libraries, if necessary)
> make rlab             (re-build the executable from files in root directory and libs)
> sudo make install     (just as it name says)

For testing and template purposes please download test package from sourceforge.net
site and unpack it in your local directory $HOME/rlab. This will create a subdirectory
$HOME/rlab/test, which will have a number of subdirectories containing scripts that
test different features of rlab, e.g., ordinary differential equations, minimization,
numerical integration, gnuplot interface, & c.

Please note: not all features of rlab that are in test directory are available. In
fact three are not: comedi and gpib (test for shared object libraries that allow rlab
to run different laboratory instruments through two common interfaces).

gfortran vs. f77/g77, 32 vs. 64 bit
RLaB's makefile.in has been modified so as to compile without a problem on all
linux platforms. The name of the variable used to comunicate the name of the local
fortan compiler to sub-make's in ./flibs is $F77.
RLaB 32-bit installs in /usr/local/lib while 64-bit in /usr/local/lib64, so that both
versions can coexist on the same system.
The name of the directory in /usr/local/lib carries the version of the gcc RLaB
was built with, so multiple compiled instances can coexist, as well.

II. End matter
------------------------------------------
Please report errors and problems with this document to mkostrun@gmail.com
Marijan Kostrun, V-2009, XII-2010, XII-2011, X-2016