123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115 |
- avram - applicative virtual machine code interpreter
- Copyright (C) 2006,2007,2012 Dennis Furey
- This package includes a virtual machine code interpreter and a
- development library. It enables you to run programs that have been
- compiled into the virtual code format that it uses. A compiler to
- generate code in this format is available separately at
- http://gueststar.github.com/ursala.
- The quick install guide (assuming you have root):
- -----------------------
- Change to the directory with this README file in it, and do the
- following.
- configure
- make
- su
- make install
- If this doesn't work, try reading INSTALL, and please let me know what
- you had to do to get it to work so I can include it in this file or
- improve the configuration script.
- Installation for non-root users (whose admins are busy):
- -------------------------------
- Change to the directory with this README file in it and type
- configure --prefix=$HOME
- make
- make install
- The avram binary will be installed under $HOME/bin, which you need to
- put in your path. You might also want to modify your $MANPATH and your
- $INFOPATH environment variables to include $HOME/man and $HOME/info.
- You may substitute any directory you own for $HOME.
- See below if you want to link avram with external math libraries,
- which will need to be installed first.
- Installation for non-root users with small disk quotas (aka students):
- ------------------------------------------------------
- Unpack the tarball in /tmp, which is world writable on most systems,
- cd to /tmp/avram-0.3.0 (or current version) and type
- configure --prefix=/tmp
- make
- strip src/avram
- The third line is optional but recommended. When it's finished
- building, copy src/avram to your home directory wherever you keep your
- executables (probably ~/bin). You won't have any on-line documentation
- with this kind of installation, but you can always read it on the home
- page. Nor will you be able to link your own code against the avram
- library, but you'll use only a few hundred kbytes for the executable
- and will be able to execute unmodified virtual code scripts if they're
- done right.
- A combination of the above installations is to follow the building in
- /tmp with make install, and then copy /tmp/lib to your home directory
- as well as /tmp/bin/avram. That will give you the executable and the
- library but no documentation.
- Installation of Expect
- ----------------------
- Avram has cooler features when built on a machine with the expect
- library, available at http://expect.sourceforge.net. If your system
- doesn't have any files named /usr/lib/*expect* or
- /usr/local/lib/*expect*, you might want to install the expect library
- in order to get the full benefit before installing avram. Version
- numbers shown below may vary.
- 1) download tcl8.5.12-src.tar.gz and expect5.45.tar.gz
- 2) tar -zxvf tcl8.5.12-src.tar.gz
- 3) tar -zxvf expect5.45.tar.gz
- 4) cd tcl8.5.12/unix
- 5) su
- 6) configure; make; make install
- 7) cd ../../expect-5.45
- 8) configure; make; make install
- It is possible to install these libraries non-root by using configure
- --prefix=$HOME. As a show of my solidarity with non-root users, I've
- made the avram configure script look under $HOME for shared libraries
- and header files. You will then have to put your $HOME/lib directory
- in your LD_LIBRARY_PATH environment variable.
- Installation of other libraries
- -------------------------------
- Some other libraries with which avram is able to interface may be of
- interest. These should be installed prior to compiling avram, if you
- want, but avram will also work without them.
- * gsl integration, differentiation, and series acceleration
- * mpfr arbitrary precision arithmetic
- * minpack non-linear optimization
- * lapack linear algebra
- * fftw fast fourier transforms
- * Rmath statistical and transcendental functions
- * ufsparse sparse matrices
- * glpk linear programming by the simplex method
- Keep an eye on the output messages from the configuration script to
- ensure the libraries you want have been detected if you're compiling
- avram yourself, and then as a check execute "avram -e" with the newly
- built binary.
- Comments are welcome.
- - Dennis Furey <[email protected]>
|