home *** CD-ROM | disk | FTP | other *** search
/ Atari FTP / ATARI_FTP_0693.zip / ATARI_FTP_0693 / Mint / mnthlb30.zoo / 00readme next >
Text File  |  1993-06-05  |  4KB  |  110 lines
  1. MiNT library for Heat-n-Serve/Sozobon C, patchlevel 30.
  2.  
  3. This is a port of Eric Smith's MiNT library to Heat-n-Serve C, based on
  4. Dave Gymer's original port.  It replaces the files dlibs.a, dstart.o,
  5. and libm.a from the original Heat-n-Serve distribution, and includes a
  6. simple termcap library.
  7.  
  8. A reminder, you _will_ need the pl30 include files to use this library.
  9. These can be found where you found this archive, in the file
  10. mntinc30.zoo or similar.
  11.  
  12. WHAT'S HERE:
  13.  
  14.     00readme
  15.     This file.
  16.     dlibs.a
  17.     dstart.o
  18.     MiNT-aware replacements for the Heat-n-Serve distribution files
  19.     of the same name.
  20.     libm.a
  21.     Floating point support.  Actually, this is identical to the
  22.     libm.a from the original Heat-n-Serve distribution, except that
  23.     critical portions have been recompiled with the MiNT headers
  24.     (since dLibs and the MiNTlibs disagree on the shape of a FILE).
  25.     libtermcap.a
  26.     A simple termcap library.
  27.     dlibs_8.a
  28.     dstart_8.o
  29.     libm_8.a
  30.     libterm8.a
  31.     As above, but compiled with short external identifiers and hence
  32.     compatible with HSC v1.40 and earlier.  The unnumbered versions
  33.     use the new 22-character identifiers available under v2.00 and up.
  34.     compiler.h
  35.     osbind.h
  36.     utime.h
  37.     Include files that have been modified since the original pl30
  38.     release.
  39.     patch/
  40.     Stuff you'll need if you want to start playing around with the
  41.     library source.
  42.  
  43. IF YOU JUST WANT TO USE IT:
  44.  
  45. To get yourself up and running with the MiNTlibs, do the following:
  46.  
  47. 0)  Obtain and install the MiNT include files for this version.
  48.  
  49. 1)  Copy the files dlibs.a, dstart.o, libm.a and libtermcap.a (or
  50.     for v1.40 and earlier, dlibs_8.a, dstart_8.o libm_8.a and
  51.     libterm8.a) to the directory where your MiNT library will live.
  52.     Also copy the files vdifast.a and aesfast.a from the Heat-n-Serve
  53.     distribution to this directory.
  54.  
  55. 2)  Replace the files compiler.h, osbind.h and utime.h from the MiNT
  56.     include distribution with the ones from this package.  Also, replace
  57.     the gemfast.h from the MiNT include distribution with the one from
  58.     the Heat-n-Serve distribution.
  59.  
  60. 3)  Set the environment variables LIB and INCLUDE to point to your MiNT
  61.     library directory and MiNT include files directory, respectively.
  62.  
  63. And you're ready to roll!  The MiNT library is a complete replacement
  64. for dLibs, but if you should need to switch back temporarily, you can
  65. simply change LIB and INCLUDE appropriately.
  66.  
  67. IF YOU WANT TO PLAY WITH IT:
  68.  
  69. Ah, the hacker type, eh?  Okay, here's how to update the pl30 source
  70. release to HSC pl30:
  71.  
  72. 0)  Obtain and install the MiNT library source distribution for this
  73.     version.  Also obtain the following programs from atari.archive:
  74.  
  75.     patch    To install the enclosed diffs
  76.     cpp        \
  77.     mit2mot    / To build the .cpp files
  78.  
  79. 1)  Apply the patches in patch/code30.diffs from this archive using patch
  80.     (alternatively, you could apply the patches by hand; the format of
  81.     the context diffs is pretty easy to understand).  Also, replace the
  82.     file sozobon/makefile from the source distribution with
  83.     patch/makefile from this archive.
  84.  
  85. 2)  Place the programs cpp.ttp and mit2mot.ttp somewhere that make can
  86.     find them.
  87.  
  88. 3)  In the main source directory, delete all files beginning with `_',
  89.     as well as linea.c and inistack.c.  Copy all the .s files from
  90.     sozobon/, as well as termcap.c and makefile, to the main source
  91.     directory.
  92.  
  93. 4)  Type `make'.  Go watch a movie. ;)
  94.  
  95. You should now have files dlibs.a, dstart.o and libtermcap.a, which
  96. should be identical to the ones in this package.
  97.  
  98. DISCLAIMER:
  99.  
  100. What, you were expecting an ironclad guarantee of performance? ;)  Okay,
  101. while I have built several large programs with this library with no
  102. problems, I can't guarantee that there aren't still a few bugs lurking
  103. around in the code.  Caveat emptor, use at your own risk, and all that
  104. jazz.  And if you should happen to find a bug, please notify me at the
  105. address below.
  106.  
  107. Have fun!
  108.  
  109. Scott Bigham                dsb@cs.duke.edu
  110.