I. Compiling FT Jam:
--------------------

  1. With a previous version of Jam:
  ----------------------------------
  
  The easiest way to compile Jam is to use a previous version of the
  program. If you already have one installed on your system, simply
  type "jam" in this directory.
  
  This will create a new executable named "jam" or "jam.exe", located
  in a new system-dependent directory, whose name can be:
  
     bin.ntx86\jam.exe
     bin.linux86\jam
     etc..
     

  1. On Unix and Cygwin:
  ----------------------
  
  FTJam supports the traditionnal Unix build & installation sequences,
  you can simply type:
  
     ./configure --prefix=<yourprefix>
     make
     make install
     
  note that only the jam executable will be installed. No documentation
  is provided for now...
  
  
  2. With toolset-specific makefiles:
  -----------------------------------
  
  You can also use one of the Makefiles located in the "builds"
  directory. Here's what you need to type on the command line,
  depending on your system and compiler:
  
  
  a. Windows + Visual C++:
  
       set VISUALC=/install/path/to/visual/compiler
       set JAM_TOOLSET=VISUALC
       nmake -f builds\win32-visualc.mk
                           
                           
  b. Windows + Borland C++: (be sure to use the Borland "make" tool)

        set BORLANDC=/install/path/to/borland/compiler
        set JAM_TOOLSET=BORLANDC
        make -fbuilds\win32-visualc.mk   


  c. Windows + Mingw (gcc):

        set BORLANDC=/install/path/to/borland/compiler
        set JAM_TOOLSET=BORLANDC
        make -f builds\win32-visualc.mk   


  WE DO NOT PROVIDE PROJECT FILES FOR ANY SPECIFIC COMPILER/TOOLSET
 
      



  3. Without jam:
  ---------------
  
  If you don't have a jam binary installed, you can still compile the
  program using the following method:
  
    - copy the file "Makefile0" to "Makefile"
    
    - edit the new "Makefile"  and adapt it to your OS. Simply uncomment the
      lines specific to your system
      
    - invoke your make tool
  

  Note that the Makefile is used to build a boot-strap version of jam,
  called "jam0". Once it is built, the "jam0" executable is called to
  re-build itself.
  
  If this second pass doesn't work, this is probably because you didn't
  set some environment variable that indicates which compiler to use to
  Jam. Read the Jam documentation for more information on this.. 


  

II. Installation:
-----------------

  Except for Unix, we do not provide any sophisticated
  installation pass. Simply copy the new jam executable
  to any directory in your current path.. and start
  using it !!


III. Default files:
-------------------

  All default files for Jam are compiled within the
  executable itself.
  
  There are no special configuration directory to
  place global or user preferences. Until further
  notice, all defaults can only be changed by using
  command line switches and setting environment
  variables..


IV. Windows and OS/2 Binary packages:
-------------------------------------

  It's possible to create zip files of the binaries
  on Windows and OS/2 system by following these simple
  steps (you need to have the "zip" utility in your
  path !!):
  
    1. build jam
    2. strip the jam.exe executable in bin.ntx86 when
       possible
    3. call "jam package"
    
  you should see a file named "ftjam-xxxxx-win32.zip"
  or "ftjam-xxxxx-os2.zip" in the current directory,
  as well as "ftjam-xxxxx.zip" (containing the sources)


Good luck,


- David Turner,  28 Jul 2001
