home *** CD-ROM | disk | FTP | other *** search
/ Il CD di internet / CD.iso / SOURCE / D / CLISP / CLISPSRC.TAR / clisp-1995-01-01 / unix / INSTALL < prev    next >
Encoding:
Text File  |  1994-12-30  |  4.3 KB  |  140 lines

  1. Installation on Unix:
  2. ---------------------
  3.  
  4. This file describes the standard installation procedure. Special hints for
  5. some platforms can be found in file unix/PLATFORMS.
  6.  
  7. 1. (Optional)
  8.    Convert the sources to your local character set.
  9.    They are distributed in ISO Latin-1 character set.
  10.    See file unix/CONVERT for more information.
  11.  
  12. 2. (Optional)
  13.    Choose which C compiler to use for building CLISP.
  14.    This is normally not necessary; if GNU C is available under the
  15.    name "gcc", it will be used.
  16.  
  17.    For example, if you were wanting to use gcc in traditional mode, then
  18.    type, if you are using csh:
  19.  
  20.          setenv CC "gcc -traditional"
  21.  
  22.    or if you are using bash or ksh:
  23.  
  24.          export CC="gcc -traditional"
  25.  
  26.    or if you are using sh:
  27.  
  28.          CC="gcc -traditional"
  29.          export CC
  30.  
  31. 3. Choose the name of a directory in which to build CLISP.
  32.    (This allows you to build CLISP with different compilers on the same
  33.    machine or for different architectures in the same filesystem, sharing
  34.    the same source.)
  35.    For example, depending on the chosen compiler, let's use with-gcc-trad.
  36.    Then execute
  37.  
  38.          ./configure with-gcc-trad
  39.  
  40.    This will prepare a directory with-gcc-trad/ and figure out many
  41.    system and compiler dependent parameters needed by CLISP.
  42.  
  43.    (Note: Some `make's - for example the HP-UX make - have problems
  44.    with symbolic links. You may avoid these by calling
  45.  
  46.          ./configure
  47.  
  48.    without argument. Then CLISP will be built in the src/ directory
  49.    itself.)
  50.  
  51. 4. Go to this directory
  52.  
  53.          cd with-gcc-trad
  54.  
  55.    and build the makefile that controls compilation:
  56.  
  57.          ./makemake > makefile
  58.  
  59.    If you wish to compile the sources such that you may debug them,
  60.    then type instead:
  61.  
  62.          ./makemake debug > makefile
  63.  
  64. 5. Type
  65.  
  66.          make config.lsp
  67.  
  68.    and edit the contents of config.lsp appropriately for your site,
  69.    especially the definitions of short-site-name and long-site-name.
  70.  
  71.    On Linux (0.99.11 or newer) or SunOS 4, you may also choose to enable
  72.    support for immutable objects (checking that program text and quoted
  73.    constants loaded from files are never destructively modified) by
  74.    adding -DIMMUTABLE to the line defining CFLAGS in the makefile.
  75.  
  76.    For platform specific adjustment of the makefile, take a look at the
  77.    PLATFORMS file.
  78.  
  79. 6. Type
  80.  
  81.          make
  82.  
  83.    to build CLISP.
  84.    You may alternatively do this in seven steps:
  85.          make init                prepares all symbolic links and utilities
  86.          make allc                makes all *.c files
  87.          make libreadline.a       makes the readline library
  88.          make lisp.run            makes the executable
  89.          make interpreted.mem     a memory image with everything uncompiled
  90.          make compiled.mem        makes all *.fas files and
  91.                                   a memory image with everything compiled
  92.          make manual              makes the documentation
  93.    The sixth step is the most time consuming: it takes an hour on a Sun4 and
  94.    may take several hours on a slower machine.
  95.  
  96.    If something goes wrong, check and optionally modify the contents of
  97.    the file unixconf.h and retry this step. Yes, there are many warnings,
  98.    I know. Most of them are harmless.
  99.  
  100.    If you need to switch to a different compiler, execute a
  101.          make distclean
  102.          cd ..
  103.    and go back to step 2.
  104.  
  105. 7. (Optionally)
  106.    Two more tests for CLISP. Let the compiler (now compiled!) recompile itself:
  107.  
  108.          make test
  109.  
  110.    Check whether CLISP passes the test suite:
  111.  
  112.          make testsuite
  113.  
  114. 8. Edit the `prefix' variable in the makefile (you could also have specified
  115.    it as command line option --prefix=... to `configure' in step 3), then type
  116.  
  117.          make install
  118.  
  119.    If `prefix' is /usr/local, then this will install the CLISP binaries
  120.    into /usr/local/bin and /usr/local/lib (creating a directory
  121.    /usr/local/lib/lisp) and the manual page into /usr/local/man/man1.
  122.    You may need superuser privileges for this step when installing into
  123.    public directories.
  124.  
  125. 9. The last thing to do:
  126.  
  127.          cd ..
  128.  
  129.  
  130. Authors:
  131. --------
  132.  
  133.         Bruno Haible                    Michael Stoll
  134.         Augartenstraâ–€e 40               Gallierweg 39
  135.     D - 76137 Karlsruhe             D - 53117 Bonn
  136.         Germany                         Germany
  137.  
  138. Email: haible@ma2s2.mathematik.uni-karlsruhe.de
  139.  
  140.