home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / lib / mntc6846.zoo / patch / readme.c68 < prev    next >
Encoding:
Text File  |  1995-03-29  |  4.2 KB  |  118 lines
  1. MiNT library for c68, patchlevel 46
  2.  
  3. This is a port of Eric Smith's MiNT library to Thorsten Roskowetz's port
  4. of Keith Walker's Minix c68 compiler [confused yet? ;) ].  It replaces
  5. the files crt0.o, libc.a, libc32.a, libiio.a and libiio32.a.
  6.  
  7. You will need some additional files to build the c68 MiNTlibs.  At the
  8. site where you found this archive, look for the following archives:
  9.  
  10.     mntincXX.tgz
  11.         The library header files for version XX (currently 46).  If your
  12.     c68 package came with header files, check the patchlevel in
  13.     PatchLev.h; if it matches the patchlevel of this library, you
  14.     already have the contents of the above archive.
  15.     mit2mot.zoo
  16.     A MIT-to-Motorola assembly code translator.  This will be used
  17.     to convert the .cpp files in the MiNTlibs distribution to .s
  18.     files that c68's assembler can deal with.
  19.     cpp114.zoo
  20.     If the cpp that came with your c68 package is version 1.1.3 or
  21.     earlier (you can check this by typing `cpp -V'), you will also
  22.     need this package to upgrade it.
  23.  
  24. Also, if your c68 distribution uses the JAS assembler, make sure it is
  25. version 2.00x8 or later (you can check this by typing `jas -V').  If
  26. your c68 distribution uses as68, you're fine.
  27.  
  28. WHAT'S HERE:
  29.  
  30.     readme.c68
  31.         This file.
  32.     dfadd.s    dfcmp.s        dfdiv.s
  33.     dfltodf.s    dfmul.s        dfneg.s
  34.     dftol.s    dftosf.s    dftoul.s
  35.     dftst.s    dfutodf.s    frexp.spp
  36.     ldexp.spp    linea.spp    modf.spp
  37.     modff.spp    sfadd.s        sfcmp.s
  38.     sfdiv.s    sfltosf.s    sfmul.s
  39.     sfneg.s    sftodf.s    sftol.s
  40.     sftoul.s    sftst.s        sfutosf.s
  41.     stackche.s    stackerr.c    stmttrac.s
  42.     xdiv.s    xerror.spp    xmul.s
  43.     xnorm4.s    xnorm8.s    osbind.s
  44.     Makefile
  45.         c68-specific source files.
  46.     Makefile.cross
  47.     Makefile for c68 cross-compiler.
  48.  
  49. WHAT TO DO WITH IT:
  50.  
  51. 0)  Obtain all of the files listed above.
  52.  
  53. 1)  Put mit2mot.ttp somewhere where make can find it.  If necessary,
  54.     install the latest versions of cpp and the MiNT headers.
  55.  
  56. 2)  From the main source directory, delete the following files:
  57.  
  58.     - Makefile
  59.     - frexp.cpp
  60.     - ldexp.cpp
  61.     - linea.c
  62.     - modf.cpp
  63.     - osbind.cpp
  64.     - all files beginning with `_'
  65.  
  66.     Copy all the .c, .s and .spp files from this directory into the main
  67.     source directory, as well as either Makefile or Makefile.cross, as
  68.     appropriate.  If you are building on a cross-compiler, rename
  69.     Makefile.cross to Makefile.
  70.  
  71. 3)  In the main source directory, edit the Makefile as follows:
  72.  
  73.     - Set $(LIB) to the directory in which c68's libraries reside.
  74.     - Uncomment (or comment) the definitions of $(RM) and $(CP) if
  75.       necessary for your make program.
  76.     - If you do not have the libsort program, delete or comment out
  77.       the lines which invoke it.  Libsort reorders an object
  78.       library into optimal linking order; this is not necessary for
  79.       the library to be used with c68, but does decrease link
  80.       time.
  81.  
  82. 4)  Run make.  The default target is `lshort', which builds libc.a and
  83.     libiio.a for use in -mshort mode; the `llong' target builds libc32.a
  84.     and libiio32.a, for use in -mlong mode.  Note that you can build
  85.     both libraries at once with the command `make lshort llong', since
  86.     the Makefile cleans up properly between libraries.
  87.  
  88. That's it!  Your libraries are now installed and ready to use.
  89.  
  90. AUTHORS:
  91.  
  92. No, I didn't do this all by myself. ;)  So here are, in no particular
  93. order, the people who have contributed directly or indirectly to this
  94. port.  See the file AUTHORS in the main source directory for a list of
  95. contributors to the library as a whole.  Please send corrections to the
  96. address below.
  97.  
  98. rossi@titan.rz.uni-osnabrueck.de (Thorsten Roskowetz) (compiler maintainer)
  99. dsb@cs.duke.edu (Scott Bigham) (lib port maintainer)
  100. t150315@proffa.cc.tut.fi (Tamminen Eero)
  101. PPOSPIS@MtRoyal.AB.CA (Paul Pospisil)
  102.  
  103. In addition, many of the files in this directory are from Keith Walker's
  104. c68 source release; check that package for further contributors.
  105.  
  106. DISCLAIMER:
  107.  
  108. What, you were expecting an ironclad guarantee of performance? ;)  Okay,
  109. while I have built several large programs with this library with no
  110. problems, I can't guarantee that there aren't still a few bugs lurking
  111. around in the code.  Caveat emptor, use at your own risk, and all that
  112. jazz.  And if you should happen to find a bug, please notify me at the
  113. address below.
  114.  
  115. Have fun!
  116.  
  117. Scott Bigham                dsb@cs.duke.edu
  118.