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