Next: , Previous: Search paths, Up: Installation


2.6 Compiling from UNIX source

To compile and install a UNIX executable from a source release x.xx, first execute the commands:

tar -zxf asymptote-x.xx.tar.gz
cd asymptote-x.xx

Then put http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/gc6.8.tar.gz in the current directory and

./configure
make all
make install
If you get errors from a broken pdftex installation, simply put
http://asymptote.sourceforge.net/asymptote.pdf
in the directory doc and repeat the command make all.

For a (default) system-wide installation, the last command should be done as root. To install without root privileges:

./configure --prefix=$HOME/asymptote
The above steps will compile an optimized single-threaded static version of the Boehm garbage collector (http://www.hpl.hp.com/personal/Hans_Boehm/gc/). Alternatively, one can request use of a (presumably multithreaded and therefore slower) system version of the Boehm garbage collector by configuring instead with ./configure --enable-gc=system (provided of course that your system has the libgc and libgccpp libraries). One can disable use of the garbage collector by configuring with ./configure --disable-gc. For a list of other configuration options, say ./configure --help. For example, one can tell configure to look for header files and libraries in nonstandard locations:
./configure CFLAGS=-I/opt/usr/include LDFLAGS=-L/opt/usr/lib

If you are compiling Asymptote with gcc, you will need a relatively recent version (e.g. 3.2 or later). For full interactive functionality, you will need version 4.2 or later of the GNU readline library.

The FFTW library is only required if you want Asymptote to be able to take Fourier transforms of data (say, to compute an audio power spectrum). The GSL library is only required if you require the special functions that it supports.

If you don't want to install Asymptote system wide, just make sure the compiled binary asy and GUI script xasy are in your path and set the configuration variable dir to point to the directory base (in the top level directory of the Asymptote source code).