home *** CD-ROM | disk | FTP | other *** search
/ The Best of Mecomp Multimedia 2 / MECOMP-CD-II.iso / system / libs / rexxmathlib.doc < prev    next >
Text File  |  1989-05-24  |  5KB  |  103 lines
  1.  
  2.     rexxmathlib.library version 1.2 and 1.3
  3.     =======================================
  4.  
  5.     This version is identical to the previous release. The only change is
  6. that the version for the 1.3 math libraries now shows version 1.3, when you use
  7. the AmigaDOS version command. Included in this archive is also version 1.2,
  8. compiled and linked for AmigaDOS 1.2. It is called rexxmath1.2.library, and if
  9. you want to use it, you must copy it to libs: as rexxmathlib.library.
  10.  
  11.     Willy Langeveld, 20 May 1989.
  12.  
  13.     With the previous release:
  14.     ==========================
  15.  
  16.     This version is recompiled and relinked for use with the AmigaDOS
  17. 1.3 IEEE math libraries. How do you keep the various versions apart?
  18. The size of the one for 1.3 is 7012 bytes. The previous release was some
  19. 13900 bytes, whereas the special release for the StarBoard II's 68881 was
  20. 8152 bytes. Which one to use? If you have AmigaDOS 1.3, use the one that's
  21. 7012 bytes long. If you have 1.2 or (heaven forbid) 1.1, use the 13900 byte
  22. one. If you have 1.2 and a StarBoard II, AND a 68881 in its multifunction
  23. module, use the special one after renaming it to rexxmathlib.library.
  24.     This archive *only* includes the 7012 byte one. It can only be used
  25. with the 1.3 IEEE math libraries.
  26.  
  27.     Willy Langeveld, 31 January, 5 April 1989.
  28.  
  29.     Documentation for the AmigaREXX math library, version 1.0.
  30.     ==========================================================
  31.  
  32.     In version 1 of the AmigaREXX math library the following functions
  33. have been implemented. In column 1 you will find the function, in column 2
  34. the calling sequence, and in column 3 some aliases. Column 4 has the allowed
  35. ranges of the arguments that will not cause an error.
  36.     The regular library is called rexxmathlib.library: it should work on
  37. all Amigas. However, if you own a StarBoard II memory expansion with a 
  38. Multi-Function Module plus 68881 math coprocessor, you can speed up your
  39. REXX math by using the library rexxmathsbii.library instead. You will then 
  40. also need the MicroBotics supplied IEEE libraries.
  41.  
  42.     Willy Langeveld.
  43.  
  44.  
  45.  
  46. Function        Call. Seq.    Alias(es)    Requires
  47. ----------------------------------------------------------------------------
  48. Absolute value        abs(x)        fabs
  49. Inverse cosine        acos(x)                -1.0 <= x <= 1.0
  50. Inverse hyperbolic cos    acosh(x)            x >= 1.0
  51. Inverse sine        asin(x)                -1.0 <= x <= 1.0
  52. Inverse hyperbolic sin    asinh(x)
  53. Inverse tangent        atan(x)
  54. Inverse hyp. tangent    atanh(x)            -1.0 < x < 1.0
  55. Inv. tangent y/x    atan(y,x)            y != 0.0, x != 0.0
  56. Lowest integer above x    ceil(x)
  57. Cosine            cos(x)
  58. Hyperbolic cosine    cosh(x)
  59. Cotangent        cot(x)        cotan
  60. Cotangent        cotan(x)    cot
  61. Cosecans        csc(x)
  62. e to the power x    exp(x)
  63. Absolute value        fabs(x)        abs
  64. Factorial        fact(x)                x >= 0, x < 171
  65. Highest integer below x    floor(x)    int
  66. Highest integer below x    int(x)        floor
  67. Log base e        ln(x)        log        x > 0.0
  68. Log base e        log(x)        ln        x > 0.0
  69. Log base 10        log10(x)            x > 0.0
  70. Nearest integer to x    nint(x)
  71. x to the power y    pow(x,y)    power, xtoy    x >= 0.0
  72. x to the power y    power(x,y)    pow, xtoy    x >= 0.0
  73. Secans            sec(x)
  74. Sine            sin(x)
  75. Hyperbolic sine        sinh(x)
  76. Square root        sqrt(x)                x >= 0.0
  77. Tangent            tan(x)
  78. Hyperbolic tangent    tanh(x)
  79. x to the power y    xtoy(x,y)    pow, power    x >= 0.0
  80.  
  81.  
  82.  
  83.  
  84. +----------------------------------------------------------------------+
  85. |                                                                      |
  86. |                  D I S C L A I M E R   N O T I C E                   |
  87. |                                                                      |
  88. |  This document and/or  portions of the material and  data furnished  |
  89. |  herewith,  was developed under sponsorship of the U.S. Government.  |
  90. |  Neither the U.S.  nor  the U.S.D.O.E.,  nor  the  Leland  Stanford  |
  91. |  Junior University, nor their employees,  nor their respective con-  |
  92. |  tractors, subcontractors, or their employees, makes  any warranty,  |
  93. |  express or implied, or assumes any liability or responsibility for  |
  94. |  accuracy,  completeness or  usefulness of any information, appara-  |
  95. |  tus, product or process disclosed, or represents that its use will  |
  96. |  not infringe privately-owned rights.  Mention of any product,  its  |
  97. |  manufacturer, or suppliers shall not, nor is it intended to, imply  |
  98. |  approval, disapproval, or fitness for any particular use. The U.S.  |
  99. |  and  the University at all times  retain the right to use and dis-  |
  100. |  seminate same for any purpose whatsoever.                           |
  101. |                                                                      |
  102. +----------------------------------------------------------------------+
  103.