home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-dist / ixemul-45.0-src.tgz / tar.out / contrib / ixemul / INSTALL < prev    next >
Text File  |  1996-10-04  |  7KB  |  181 lines
  1.  
  2.             IXEMUL  LIBRARY  INSTALLATION  NOTES
  3.  
  4.                (last updated 1-October-96)
  5.  
  6.  
  7. =====================
  8. DISTRIBUTION CONTENTS
  9. =====================
  10.  
  11. The net ixemul library distribution consists of several archives:
  12.  
  13.   ixemul-bin.lha    Utils for ade/bin, like ixtrace and ixprefs
  14.  
  15.   ixemul-sdk.lha    Files needed to build applications that use
  16.             ixemul.library.
  17.  
  18.   ixemul-doc.lha    Various documentation, such as this file
  19.  
  20.   ixemul-src.tgz    Complete source code for ixemul library as
  21.             a gzip compressed tar archive.
  22.  
  23.   ixemul-tz.lha        Pieces for doing TZ (timezone) management
  24.  
  25.   ixemul-CCCF.lha    Specific flavors of the library, where 'CCC'
  26.             is one of 000, 020, or 040, for 68000, 68020,
  27.             and 68040 respectively, and 'F' is either
  28.             'f', 's', or 't' for FPU support or soft floating
  29.             point or a "trace" version (also soft float)
  30.             respectively.
  31.  
  32. The ixemul-doc.lha archive contains various readme and copyright files that
  33. do not need to be installed anywhere.  The ixemul-src.tgz archive contains
  34. the source tree that can be installed anywhere.  The rest of the archives
  35. should simply be extracted relative to the ade: directory to put all the
  36. files in their standard location.
  37.  
  38. ========================
  39. INSTALLING RUNTIME FILES
  40. ========================
  41.  
  42. For the moment, you must manually install the files.  Eventually there will
  43. be an installer script available that you can use with the standard AmigaOS
  44. installer program to make installation more WorkBench friendly.
  45.  
  46. First backup any files in ade: that will get overwritten during the install,
  47. if you wish to preserve them.  These files typically are:
  48.  
  49.     ade:bin/ixprefs
  50.     ade:bin/ixtrace
  51.     ade:lib/bcrt0.o
  52.     ade:lib/crt0.o
  53.     ade:lib/rcrt0.o
  54.     ade:lib/libc.a
  55.     ade:lib/libb/libc.a
  56.     ade:include        (lots of files, but probably not all)
  57.     ade:man            (lots of files, but probably not all)
  58.     ade:etc            (lots of files, but probably not all)
  59.     ade:Sys/libs/ixemul*    (all the old versions of the library)
  60.  
  61. Change directory to ade: and extract the contents of ixemul-bin.lha,
  62. ixemul-sdk.lha (if you expect to be building any ixemul.library using
  63. applications), ixemul-tz.lha (optional) and any ixemul-XXXX.lha archives
  64. that you want, overwriting any existing copies of the files in your ade
  65. tree.  For example, to install the utils, sdk, and both the 68000 and
  66. 68040+68881 versions of the library, do the following:
  67.  
  68.     lha -mraxe x ixemul-bin.lha ade:
  69.     lha -mraxe x ixemul-sdk.lha ade:
  70.     lha -mraxe x ixemul-000.lha ade:
  71.     lha -mraxe x ixemul-040f.lha ade:
  72.  
  73. Now you need to decide which version of the library to use, based on what
  74. sort of machine you have (68000, 68020 or 68030, 68040) and whether or not it
  75. has an FPU (68020+68881, 68030 with FPU, or 68040 with FPU).  Do something
  76. like the following:
  77.  
  78.     cd ade:Sys/libs
  79.     copy ixemul040fpu.library ixemul.library clone
  80.  
  81. Then either reboot or run a program to flush the existing ixemul.library (if
  82. any) from memory.  You should also review the NEWS file from the docs
  83. archive for changes made since the version from which you have upgraded.
  84. If you installed the ixemul-tz.lha archive you should read ixtimezone.doc
  85. from the docs archive and set your TZ environment variable appropriately.
  86.  
  87. =======================
  88. INSTALLING SOURCE FILES
  89. =======================
  90.  
  91. To extract the source code, simply cd to a directory where you would like
  92. the source code directory to be created, and extract the source archive
  93. there:
  94.  
  95.     cd ade-src:
  96.     gzip -d ixemul-src.tgz
  97.     tar -xvf ixemul-src.tar
  98.     rm ixemul-src.tar
  99.  
  100. Note that this will create the directory ixemul and populate it with all the
  101. source files.
  102.  
  103. To rebuild the library, all that is needed is to run the configure script
  104. and then run make.  It is recommended that you use separate source and build
  105. directories so you can leave the source tree untouched:
  106.  
  107.     cd ade-build:
  108.     makedir ixemul
  109.     cd ixemul
  110.     sh /ade-src/ixemul/configure --prefix=/ade
  111.  
  112. This will create a Makefile and several subdirectories with other Makefiles.
  113. Note the section in the Makefile that looks like:
  114.  
  115. ###  CPU-FPU types.
  116. ###
  117. ###  The default thing to do is to make all reasonable combinations of the
  118. ###  library.
  119. ###
  120. ###  Note that libsrc, which builds the runtime startup files and all
  121. ###  versions of libc.a, and utils completely ignore the base/cpu/fpu variables,
  122. ###  so these are handled in the all: target.
  123. ###
  124. ###  You can remove specific CPU/FPU combinations that you are not interested in.
  125.  
  126. CPU-FPU-TYPES =    68000.soft-float \
  127.         68020.soft-float 68020.68881 \
  128.         68040.soft-float 68040.68881
  129.  
  130. By default, all of the versions of ixemul.library are built by make.  This
  131. can take a relatively long time.  If you only want to build one particular
  132. version of the library and runtime files to test, just remove the lines
  133. you don't want.  I.E.  to build a 68040+68881 version, the above lines
  134. should be changed to:
  135.  
  136. CPU-FPU-TYPES =    68040.68881
  137.  
  138. Then just run "make" in the build directory:
  139.  
  140.     cd ade-build:ixemul
  141.     make
  142.  
  143. Note that you must have a version of GNU make that is newer than the ones
  144. distributed on the FreshFish CDs and on aminet.  Those makes had a patch for
  145. AmigaOS that nobody used but disabled an important feature that the current
  146. ixemul Makefiles use.  If you have problem compiling the ixemul library get
  147. the lastest ADE make from ftp.ninemoons.com:pub/ade or a mirror.
  148.  
  149. You need at least version 2.6.0 of gas, the GNU assembler. Earlier
  150. versions didn't fully support the Motorola assembly syntax, but this one
  151. does. Again, you can get this from ADE.
  152.  
  153. You also need a gcc that accepts the -mrestore-a4 option (first released in
  154. October 1996), otherwise ixemul will not compile correctly due to a change
  155. in the way C structures are returned.
  156.  
  157. Finally, if you have an older version of ixemul.library installed while you
  158. are compiling this new version, then you may run into trouble building the
  159. timezone files using the 'zic' utility. This utility requires the latest
  160. ixemul.library (which you have just compiled), but since you haven't
  161. installed it yet, zic complains that the ixemul.library is too old. The
  162. solution is to install the new ixemul.library first, and then continue
  163. compiling. You may have to use 'avail flush' or reboot after installing the
  164. new library to insure that the old library is really flushed from memory.
  165.  
  166. =======
  167. IXPREFS
  168. =======
  169.  
  170. Note that effective with ixemul.library 42.0, ixconfig can no longer be
  171. used.  Use ixprefs instead.
  172.  
  173. ==============
  174. REPORTING BUGS
  175. ==============
  176.  
  177. Please report problems or bugs to Hans Verkuil (hans@wyst.hobby.nl), who is
  178. the current ixemul library coordinator.  Even better than a bug report is a
  179. bug fix, which typically would be a context diff file for one or more ixemul
  180. source files.
  181.