10. INSTALL

Start data section to INSTALL[1 /1 ]
     1: 
     2: FULL BUILD.
     3: -----------
     4: 
     5: 1. Download, build, and install Ocaml (3.08.1 or greater)
     6:    if you don't have it already
     7: 
     8:    http://caml.inria.fr
     9: 
    10: 2. Download, build, and install Python (1.5.2 or later)
    11:    if you don't have it already
    12: 
    13:     http://www.python.org
    14:     http://python.sourceforge.net
    15: 
    16: 3. Download the Felix tarball (this package)
    17:    and unpack it in your workspace
    18: 
    19:    tar -zxvf flx_1.1.3_rc4_src.tgz
    20:    cd felix_1.1.3_rc4
    21: 
    22: 4. Bootstrap the system.
    23: 
    24:   ./configure
    25: 
    26: OR type
    27: 
    28:    make config
    29:    make boot
    30:    make extract
    31: 
    32: EDIT THE FILES
    33: 
    34:   config/*.py
    35: 
    36: TO SUIT YOUR TASTES. THIS FILE IS NOT CLOBBERED.
    37: YOU MAY NEED TO DELETE IT AND RUN 'make boot'
    38: again to reset to the defaults.
    39: 
    40: 5. Build the compiler
    41: 
    42:    make
    43: 
    44: 6. Build the documentation and tutorial
    45: 
    46:    make doc
    47: 
    48: 7. Install the compiler
    49: 
    50:    Become super user if necessary, then:
    51: 
    52:    make install -- installs felix
    53: 
    54: REBUILD
    55: -------
    56: 
    57:   make virgin        -- this deletes EVERYTHING generated
    58:                         except the Makefile
    59: 
    60:   make boot          -- use this to reextract after a make virgin
    61: 
    62:   make clean         -- use this to delete all output from
    63:                         test runs
    64: 
    65: PERFORMANCE TEST
    66: ----------------
    67: 
    68:   make performance    -- takes a few minutes to run
    69: 
    70: This test flogs the cooperative mult-tasking system
    71: by generating 1 million threads and sending each
    72: of them two messages: its a rough guide to how much
    73: overhead there would be handling, say, 1 million
    74: concurrent phone calls, web connections, or sprites
    75: in a game.
    76: 
    77: LOST THE MAKEFILE?
    78: ------------------
    79: 
    80:   env PYTHONPATH=. python interscript/bin/iscr.py lpsrc/flx.pak
    81: 
    82:                      -- re-extract sources
    83: 
    84: HOW TO USE IT
    85: -------------
    86: 
    87: make a sample program mytest.flx:
    88: 
    89:   #import <flx.flxh>
    90:   include "std";
    91:   print "It works!"; endl;
    92: 
    93: and then run it:
    94: 
    95:   flx -Ilib mytest
    96: 
End data section to INSTALL[1]