home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Developer / hardware / m68k / libFPSP.README < prev    next >
Encoding:
Text File  |  1993-09-30  |  2.5 KB  |  69 lines
  1. Motorola M68040FPSP library routines for NeXT 68040 machines.
  2. Patch level 2.
  3.     Fix up sincos entry point.
  4.  
  5. Patch level 1.
  6.     Add a bunch more C entry points.
  7.     Add declarations to fend off NeXT library routines.
  8.  
  9. Installation
  10. ============
  11. 1. Create a new directory, `cd' to it.
  12. 2. Uncompress and `un-tar' the source files.
  13.    You should than have:
  14.    In the current directory:
  15.     a Makefile, a README, and a bunch of assembler source files.
  16.    In the arch subdirectory:
  17.     The original source from the Motorola BBS.
  18.    In the test subdirectory:
  19.     A program to test the library routines.
  20. 3. Type `make install' to assemble the routines, create the library, and
  21.    install the library in /usr/local/lib/libFPSP.a.
  22.  
  23. The FPSP library is now ready to use.
  24. To use the routines with your programs, just add a `-lFPSP' to the
  25. appropriate spots in your makefiles.
  26.  
  27.  
  28. Comments
  29. ========
  30. A number of people who have tried these routines have sent me mail
  31. about the libjv package also available on the archives.  Yes, that
  32. package *is* faster than the M68040FPSP routines, but the speed comes
  33. at the cost of reduced accuracy.
  34.  
  35.  
  36. Caveats
  37. =======
  38. These are the Motorola FPSP library routines translated to `gas' syntax.
  39. I had to work around a bunch of assembler bugs, the worst being that
  40. instructions like
  41.     fcmps    #0x3FF80000,fp0
  42. would not assemble properly.  You can find all the places I had to do
  43. this by doing a
  44.     grep '|||' *.s
  45. The original instruction is included as a comment on each of these lines
  46. so you can see what should be there.
  47.  
  48. I *hope* I got all the translations correct.  Use this software at your
  49. own risk!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  50.  
  51. I was unable to figure out how to make the assembler generate a
  52. floating-point-condition-branch instruction with a word offset.  The
  53. assembler insists on emitting a long offset even when the target is
  54. only a few instructions away.  This makes the routines run slower, and
  55. take up more space, than they otherwise would.
  56.  
  57. The file NeXTglue.s contains the `glue' routines which provide C entry
  58. points to the functions.  I threw these glue routines together pretty
  59. quickly.  If someone else takes the time to redo them correctly please
  60. send the improved routinse back to me.  I had to put in some `magic'
  61. declarations to keep the loader from trying to pull in the floating
  62. point support routines from /lib/libsys_s.a -- again I hope I got 
  63. this right.
  64.  
  65. Eric Norum                             eric@skatter.usask.ca
  66. Saskatchewan Accelerator Laboratory
  67. University of Saskatchewan
  68. Saskatoon, Canada.                     NeXTMail accepted.
  69.