home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Workbench / Libs / IXDOC.LHA / ixemul-bin / INSTALL < prev    next >
Encoding:
Text File  |  1995-10-05  |  6.1 KB  |  165 lines
  1.  
  2.             IXEMUL  LIBRARY  INSTALLATION  NOTES
  3.  
  4.                (last updated 10/4/95)
  5.  
  6.  
  7. =====================
  8. DISTRIBUTION CONTENTS
  9. =====================
  10.  
  11. The net ixemul library distribution consists of several archives, where XXYY
  12. are the major and minor version numbers:
  13.  
  14.   ixemulXXYY-bin.lha    utils for gnu/bin, like ixtrace and ixconfig
  15.  
  16.   ixemulXXYY-sdk.lha    files needed to build ixemul.library using apps
  17.  
  18.   ixemulXXYY-doc.lha    various documentation, such as this file
  19.  
  20.   ixemulXXYY-src.lha    Complete source code for ixemul library
  21.  
  22.   ixemulXXYY-CF.lha    Specific flavors of the library, where 'C'
  23.             is one of 0, 2, 3, or 4, for 68000, 68020,
  24.             68030, and 68040 respectively, and 'F' is either
  25.             'f' or 's' for FPU support or soft floating point
  26.             respectively.
  27.  
  28. Note that version 41.0 would be 4100 and 41.10 would be 4110.
  29.  
  30. The ixemulXXYY-doc.lha archive contains various readme and copyright files
  31. that do not need to be installed anywhere.  The ixemulXXYY-src.lha archive
  32. contains the source tree that can be installed anywhere.  The rest of the
  33. archives should simply be extracted relative to the gnu: directory to put
  34. all the files in their standard location.
  35.  
  36. ========================
  37. INSTALLING RUNTIME FILES
  38. ========================
  39.  
  40. For the moment, you must manually install the files.  Eventually there will
  41. be an installer script available that you can use with the standard AmigaDOS
  42. installer program to make installation more WorkBench friendly.
  43.  
  44. First backup any files in gnu: that will get overwritten during the install,
  45. if you wish to preserve them.  These files typically are:
  46.  
  47.     gnu:bin/ixconfig
  48.     gnu:bin/ixtrace
  49.     gnu:lib/bcrt0.o
  50.     gnu:lib/crt0.o
  51.     gnu:lib/rcrt0.o
  52.     gnu:lib/libc.a
  53.     gnu:lib/libb/libc.a
  54.     gnu:include        (lots of files, but probably not all)
  55.     gnu:man            (lots of files, but probably not all)
  56.     gnu:Sys/libs/ixemul*    (all the old versions of the library)
  57.  
  58. Extract the contents of ixemulXXYY-bin.lha, ixemul-XXYY-sdk.lha (if you
  59. expect to be building any ixemul.library using applications), and any
  60. ixemul-XXYY-CF.lha archives that you want, overwriting any existing copies
  61. of the files in your gnu tree.  For example, to install the utils, sdk, and
  62. both the 68000 and 68040+68881 versions of the library, do the following:
  63.  
  64.     lha -mraxe x ixemulXXYY-bin.lha gnu:
  65.     lha -mraxe x ixemulXXYY-sdk.lha gnu:
  66.     lha -mraxe x ixemulXXYY-0.lha gnu:
  67.     lha -mraxe x ixemulXXYY-4f.lha gnu:
  68.  
  69. Now you need to decide which version of the library to use, based on what
  70. sort of machine you have (68000, 68020, 68030, 68040) and whether or not it
  71. has an FPU (68020+68881, 68030 with FPU, or 68040 with FPU).  Do something
  72. like the following:
  73.  
  74.     cd gnu:Sys/libs
  75.     copy ixemul040fpu.library ixemul.library clone
  76.  
  77. Then either reboot or run a program to flush the existing ixemul.library (if
  78. any) from memory.
  79.  
  80. =======================
  81. INSTALLING SOURCE FILES
  82. =======================
  83.  
  84. To extract the source code, simply cd to a directory where you would like
  85. the source code directory to be created, and extract the source archive
  86. there:
  87.  
  88.     cd gnu-src:
  89.     lha -mraxe x ixemulXX.YY-src.lha
  90.  
  91. Note that this will create the directory ixemul-XX.YY and populate it with
  92. all the source files.
  93.  
  94. To rebuild the library, all that is needed is to run the configure script
  95. and then run make.  Note that at the moment, you have to use separate build
  96. and source directories and the path you use to run "configure" has to be
  97. an absolute one, not a relative one (see below).  That is, you leave the
  98. source tree untouched and create a separate build tree in which all the
  99. compiled files will be placed:
  100.  
  101.     cd gnu-build:
  102.     makedir ixemul-XX.YY    (must not be source directory at the moment)
  103.     cd ixemul-XX.YY
  104.     sh /gnu-src/ixemul-XX.YY/configure m68k-cbm-amigados
  105.  
  106. This will create a Makefile and several subdirectories with other Makefiles.
  107. Note the section in the Makefile that looks like:
  108.  
  109.     all:
  110.         $(MAKE) build CPU=68000 FPU=soft-float BASE=no-baserel
  111.         $(MAKE) build CPU=68000 FPU=soft-float BASE=baserel
  112.         $(MAKE) build CPU=68020 FPU=68881      BASE=no-baserel
  113.         $(MAKE) build CPU=68020 FPU=68881      BASE=baserel
  114.         $(MAKE) build CPU=68020 FPU=soft-float BASE=no-baserel
  115.         $(MAKE) build CPU=68020 FPU=soft-float BASE=baserel
  116.         $(MAKE) build CPU=68030 FPU=68881      BASE=no-baserel
  117.         $(MAKE) build CPU=68030 FPU=68881      BASE=baserel
  118.         $(MAKE) build CPU=68030 FPU=soft-float BASE=no-baserel
  119.         $(MAKE) build CPU=68030 FPU=soft-float BASE=baserel
  120.         $(MAKE) build CPU=68040 FPU=68881      BASE=no-baserel
  121.         $(MAKE) build CPU=68040 FPU=68881      BASE=baserel
  122.         @(cd libsrc && $(MAKE) $(FLAGS_TO_PASS))
  123.  
  124. By default, all of the versions of ixemul.library are build by make.  This
  125. can take a very long time (about a day on a 40MHz 040 WarpEngine for
  126. example, probably much longer on other machines).
  127.  
  128. If you only want to build one particular version of the library and runtime
  129. files to test, just comment out the lines you don't want.  I.E.  to build a
  130. 68040+68881 version, the above lines should be changed to:
  131.  
  132.     all:
  133.         $(MAKE) build CPU=68000 FPU=soft-float BASE=no-baserel
  134.         $(MAKE) build CPU=68000 FPU=soft-float BASE=baserel
  135.     #        $(MAKE) build CPU=68020 FPU=68881      BASE=no-baserel
  136.     #        $(MAKE) build CPU=68020 FPU=68881      BASE=baserel
  137.     #        $(MAKE) build CPU=68020 FPU=soft-float BASE=no-baserel
  138.     #        $(MAKE) build CPU=68020 FPU=soft-float BASE=baserel
  139.     #        $(MAKE) build CPU=68030 FPU=68881      BASE=no-baserel
  140.     #        $(MAKE) build CPU=68030 FPU=68881      BASE=baserel
  141.     #        $(MAKE) build CPU=68030 FPU=soft-float BASE=no-baserel
  142.     #        $(MAKE) build CPU=68030 FPU=soft-float BASE=baserel
  143.         $(MAKE) build CPU=68040 FPU=68881      BASE=no-baserel
  144.         $(MAKE) build CPU=68040 FPU=68881      BASE=baserel
  145.         @(cd libsrc && $(MAKE) $(FLAGS_TO_PASS))
  146.  
  147. Note that you have to build the 68000 version in any case, since the
  148. compiler runtime files (*crt*.o, libc.a, libbc.a) are generic 68000 code.
  149.  
  150. Then just run "make" in the build directory:
  151.  
  152.     cd gnu-build:ixemul-XX.YY
  153.     make
  154.  
  155. ==============
  156. REPORTING BUGS
  157. ==============
  158.  
  159. Please report problems or bugs to Fred Fish (fnf@amigalib.com), who is the
  160. current ixemul library coordinator.  Even better than a bug report is a bug
  161. fix, which typically would be a context diff file for one or more ixemul
  162. source files.
  163.  
  164. -Fred Fish (fnf@amigalib.com)
  165.