home *** CD-ROM | disk | FTP | other *** search
/ Atari FTP / ATARI_FTP_0693.zip / ATARI_FTP_0693 / Mint / mntlib32.zoo / purec / install.bin < prev    next >
Text File  |  1993-05-23  |  5KB  |  104 lines
  1. MiNT Library for Turbo C / Pure C
  2.  
  3. hohmuth 7 Mar 1993
  4.  
  5. This file describes the build and installation procedure of the MiNT 
  6. library for Turbo C and Pure C for the binary distribution.  (If you 
  7. have the source distribution, see the file INSTALL.SRC.  For notes on 
  8. how to use the library, refer to README.PC.)
  9.  
  10. This file is shipped with both the Pure C and the Turbo C binary 
  11. distributions.  If you have the distribution for Pure C, ignore 
  12. everything which refers to Turbo C, and vice versa.)
  13.  
  14. --------------------------------------------------------------------------
  15.  
  16. Building the MiNT library from the binary distribution means linking the 
  17. distributed files with the math libraries from Pure's/Turbo's distribution 
  18. (which are not freely distributable).
  19.  
  20. The binary distribution consists of at least the following files:  
  21. makefile, tosify.mak, mintlib.lib, d_flt.lib, crt0.o and alloca.o.  The 
  22. Pure C distribution additionally contains d_881.lib and falloca.o.
  23.  
  24. You need the following tools to build the library:
  25.  
  26. o   The compiler's tools (of course), in particular `pcc.ttp', `pasm.ttp' 
  27.     and `plink.ttp' (resp. for Turbo C: `tcc.ttp', `mas.ttp' and 
  28.     `tlink.ttp').
  29.  
  30. o   GNU Make, version 3.60 or better.  (The makefile needs GNU Make's 
  31.     functionality, so please don't try another Make.)
  32.  
  33. o   If you want to be able to do `make install' and such, you additionally 
  34.     need `cp'. (I recommend that from the GNU file utilities, linked with 
  35.     the MiNT library PL 25 or above; it will then understand file names 
  36.     like "/dev/a/foo" instead of "A:\foo".)
  37.  
  38. To build the MiNT library, the following steps are nessecary:
  39.  
  40. 1)  Edit the `makefile' to suit your taste.  You should only have to edit 
  41.     the configuration section at the beginning of the file.  Simply 
  42.     follow the instructions given as comments in the makefile.  (Comments 
  43.     are on lines starting with `#'.)
  44.     
  45.     Here is a list of Make variables which have to be configured, and 
  46.     their default:
  47.     
  48.     COMPILERDIR=    /dev/d/pc               # compiler's dir.
  49.     LIBDIR=         $(COMPILERDIR)/lib      # compiler's lib dir
  50.     COMPILERINCDIR= $(COMPILERDIR)/include  # compiler's include dir
  51.     INCLUDEDIR=     /dev/g/gnu/include      # MiNT lib's include dir
  52.     INSTALLDIR=     $(LIBDIR)               # where to install MiNT lib
  53.     TOSIFY_NAMES=   yes         # compiler's tools need old style file names
  54.     TOSIFY_COMMAND=             # undef'd means "shell groks Un*x file names"
  55.     sh_backslash=   \\          # bourne shell needs escaped backslashes
  56.     SHELL=          /bin/sh                 # I use a standard Bourne shell
  57.     RM=             rm                      # remove command
  58.     INSTALL_DATA=   cp                      # install command
  59.  
  60.     The other configurable Make variables should be left as they are; 
  61.     they are only needed when building the library from the source.  The 
  62.     Make variable TURBOC should only be defined if you use Turbo C.
  63.  
  64.     A somewhat difficult decision is which shell to use.  I use a standard 
  65.     bourne shell (from the BSD networking distribution); Bash (the GNU 
  66.     Bourne Again Shell), Mupfel 1.89 or better (which comes with Gemini) 
  67.     and `shell.ttp' (from the Elvis for MiNT distribution) also work.  
  68.     Mupfel 1.21 will _not_ work.  I haven't tried Gulam, but I presume it 
  69.     works too.  You could also try specifying no shell at all and have 
  70.     make executing your commands.
  71.     
  72.     Depending on your shell, you need to configure the Make variables 
  73.     SHELL, TOSIFY_COMMANDS and sh_backslash.  Here are the settings for 
  74.     the shells I tried:
  75.     
  76.     sh, bash        sh_backslash = \\
  77.     shell.ttp       sh_backslash = \$(nothing)
  78.     mupfel.ttp      sh_backslash = \$(nothing), TOSIFY_COMMANDS = yes
  79.  
  80. 2)  Copy the files math.h and float.h from your compiler's distribution 
  81.     to the MiNT library's include directory, renaming them to tcmath.h 
  82.     and tcfloat.h.
  83.  
  84.     The following command does this for you:
  85.     
  86.         make install-includes
  87.     
  88. 3)  You're ready to build the library now.  Hit
  89.  
  90.         make
  91.         
  92.     This builds the following files:  mintlib.lib (if it did not already 
  93.     exist) and mintflt.lib.  In the Pure C distribution, additionally the 
  94.     file mint881.lib will be built.
  95.     
  96. 4)  You are now ready to install the library (which consists of the 
  97.     following files:  mintlib.lib, mintflt.lib, crt0.o, alloca.o, and 
  98.     for Pure C additionally mint881.lib and falloca.o).  Do this by 
  99.     invoking
  100.  
  101.         make install
  102.  
  103.  
  104.