home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / misc / icalc.rea < prev    next >
Text File  |  1992-11-11  |  5KB  |  141 lines
  1. short: powerful scientific calculator/language (bug fix)
  2.  
  3. icalc version 2.1a
  4. (C) 1991, 1992 Martin W. Scott. All Rights Reserved.
  5.  
  6. Welcome to icalc version 2.1! If you're new to icalc, first read this
  7. document, then the 'UserGuide'. If you've used version 2.0 before, a
  8. glance at the 'History' and a quick review of the 'Advanced Guide' will
  9. bring you up to date.  Users of the versions 1.x should re-read all
  10. docmentation.
  11.  
  12. Version 2.0 contained a major bug fix to the sqrt function, some minor
  13. (pvr-based) bug fixes to the inverse trig functions, and many major
  14. enhancements since version 1.1.
  15.  
  16. Version 2.1 contains a yet another bug-fix of the sqrt function,
  17. plus a couple of other minor fixes. In version 2.0, sqrt would very
  18. rarely behave incorrectly, due to an obscure rounding error. This has
  19. been fixed, hopefully for the last time.
  20.  
  21. Version 2.1a is identical to version 2.1 except that a number display bug
  22. has been fixed.
  23.  
  24. This version introduces flexible number-base control (so you can do all
  25. your calculations in hexadecimal if you want) plus one or two minor
  26. enhancements. Also included are some powerful scripts to perform
  27. numerical integration and polynomial root-finding.
  28.  
  29.  
  30. Overview
  31. --------
  32. icalc is a (shell-based) calculator/programming language, with a number
  33. of powerful features. Programmers will find the base conversion useful,
  34. complex arithmetic will aid those working in electronics, and a host of
  35. other capabilities should satisfy most people's needs:
  36.  
  37.     - evaluates complicated expressions in same manner as many
  38.       programing languages and advanced pocket calculators;
  39.  
  40.     - many built-in functions and constants;
  41.  
  42.     - arbitrarily named variables;
  43.  
  44.     - user-defined functions with C-like control-structures;
  45.  
  46.     - one-dimensional arrays;
  47.  
  48.     - performs complex-number arithmetic (including trig stuff etc.);
  49.  
  50.     - can work in any number-base from 2 to 36;
  51.  
  52.     - extensible through script files;
  53.  
  54.     - much more...
  55.  
  56.  
  57. You can react in a number of ways to the above list:
  58.  
  59.     Reaction:  Looks too complicated for me!
  60.     My Answer: You don't have to utilise what you don't want/need to;
  61.            you can use icalc at a number of different levels.
  62.  
  63.     Reaction:  It's free, so it's bound to be pretty crap...
  64.     My Answer: Try it out. If you still think that, pass it over. I
  65.            could have made it shareware, but it's against my
  66.            principles (still an idealist at my age...)
  67.  
  68.     Reaction:  Who needs another programming language?
  69.     My Answer: icalc is fast enough for many math tasks, and is quick
  70.            to get into -- no compilation etc., it's interactive,
  71.            and great for prototyping. Plus, if you need complex
  72.            arithmetic, you don't have to write loads of support
  73.            routines, I've already done that.
  74.  
  75.  
  76. Documentation
  77. -------------
  78. Apart from this file and the history, instructions are split into two
  79. parts, a User Guide, and an Advanced Guide. The user guide covers
  80. material explaining the calculator nature of icalc, with simple function
  81. definition; the Advanced Guide covers control-structures, arrays and
  82. more complicated function definitions.
  83.  
  84. You may notice that the User Guide is nicely formatted, whilst the
  85. Advanced Guide is not. This is because I used nro for document processing
  86. in the past, but intend switching it over to TeX (sometime).
  87.  
  88.  
  89. Installation
  90. ------------
  91. icalc uses the standard Commodore mathieeedoub-libraries, which should
  92. be in your LIBS: directory. You may optionally copy the 'icalc.init'
  93. file to your S: directory. It contains various useful extensions to
  94. icalc, and is read on startup. (There is an extensively commented
  95. version for your perusal too.)
  96. That's it.
  97.  
  98.  
  99. Scripts
  100. -------
  101. icalc comes with a few useful scripts. If you write any that you think
  102. may be useful, send them to me and I'll include them in the next release.
  103.  
  104.  
  105. Contact + Moans
  106. ---------------
  107. Source is available on request, for a fee of $25 (US), or equivalent in
  108. your currency. Cash or IMOs/Eurochecques are preferable to Bank cheques.
  109. For the same fee, versions compiled for 680x0 with 6888x can be obtained.
  110. (One fee covers both, though).
  111.  
  112. Of course, if you like icalc and are a kind-hearted soul, I'll gladly
  113. accept any money you may wish to send (poor student and all that).
  114.  
  115. Send all comments, suggestions, bug-reports, scripts, money etc. to me at:
  116.  
  117.     Martin W. Scott,
  118.     23, Drum Brae North,
  119.     Edinburgh  EH4 8AT,
  120.     United Kingdom.
  121.  
  122. I can be contacted by email (until about June 1993) at:
  123.  
  124.     mws@castle.ed.ac.uk
  125.  
  126. I would like to thank the (few) people who have responded to previous
  127. versions of icalc. Although I write software mainly for myself, I go to
  128. considerable effort making it releasable (such as writing documentation,
  129. retaining compatability with previous versions).
  130.  
  131. If I get little or no response from this release, I must assume that
  132. little or no people are using it, and thus will stop issuing updates and
  133. bug fixes. icalc is NOT shareware, and although I'm happy to receive
  134. contributions for my efforts, I don't expect them. I DO expect people to
  135. let me know they're using icalc though, even if it's just a postcard.
  136.  
  137.  
  138. Thank you for reading, and enjoy...
  139.  
  140.     Martin.
  141.