home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / bbs / mar94 / os20 / util / mcalc.lha / MCalc / MCalc.doc < prev    next >
Text File  |  1993-12-31  |  21KB  |  709 lines
  1.    Welcome to MUIProCalc v1.2. This is a short description on how to use
  2. MUIProCalc and what possibilities it offers. Anyway, it is a quite
  3. powerful calculator, also suited for programmers who have to deal with
  4. different computer specific calculations and values.
  5.  
  6.    MUIProCalc doesn`t stand for MUI'Professional'Calc. It is meant to
  7. stand for MUI'Programmer'Calc...
  8.  
  9. MUIProCalc (MCalc) is (C) 1993 Kai Iske, GiftWare
  10.  
  11.    The icon for MUIProCalc was taken from the ToolManager 2.0
  12. distribution and was designed by Michael 'Mick' Hohmann.
  13.  
  14. MUI is Copyright (C) Stefan Stuntz
  15.  
  16.    *NOTE* that you better set the stack size to at least 8192 bytes
  17.  
  18. Copyright
  19. *********
  20.  
  21.    You are allowed to copy and spread this program but only if you do
  22. not make any commercial profit out of the program itself and all
  23. supported files. The source of MUIProCalc is considered teachware and
  24. the author claims the right to be the only one to produce and
  25. distribute new versions of MUIProCalc. Public Domain vendors are not
  26. allowed to sell MUIProCalc for more than the price of a regular disk,
  27. which should not be higher than 5 Dollars.
  28.  
  29.    MUIProCalc is GiftWare, so if you like it and you you want to express
  30. your feelings, feel free to send me anything you think of being suited.
  31. Postcards, cookies, money, simply anything ;)
  32.  
  33. Guarantee
  34. *********
  35.  
  36.    The author does not give any guarantee that the program MUIProCalc
  37. works perfectly.  The program was tested and it is used every day,
  38. anyway nobody is perfect and that is why I can not take the
  39. responsibilty for any damages occured during the usage of MUIProCalc.
  40.  
  41. Evolution
  42. *********
  43.  
  44.    Due to the fact that I was still using Calc 3.0, written by Jimmy
  45. Yang, which wasn`t that compatible to newer Kickstarts, I thought about
  46. writing a new one, since I couldn`t find any calculator suited my
  47. needs. Not that Calc 3.0 was/is buggy, but it`s just the fact that it
  48. isn`t font adaptive. Furthermore I wanted to know how powerful MUI
  49. really was, so I thought it`d be a good idea to write it using MUI.
  50.  
  51.    Taking Calc 3.0, I tried to implement the functionality of this
  52. calculator, putting it into a MUI-GUI. What is still missing is the
  53. plotter. This may change in a later release.
  54.  
  55.    One word to the parser: The grammar might not be perfect. There`s
  56. only a small amout of syntax checking, in order to minimize parser
  57. size. Float value error handling isn`t perfect either, yet. I just
  58. wanted to have a calculator as soon as possible. All this will change
  59. in future releases, if there are enough of replies.
  60.  
  61. Whom I must say 'thank you'
  62. ***************************
  63.  
  64.    I would like to thank the following people
  65.  
  66. `Dirk Federlein'
  67.      For betatesting and suggestions
  68.  
  69. `Stefan Stuntz'
  70.      Especially for MUI and for answering all my questions...
  71.  
  72. `Volker Güth'
  73.      For being the first (and only one so far) contacting me just
  74.      because of MUIProCalc...
  75.  
  76. `My girlfriend'
  77.      Who accepts what I`m doing
  78.  
  79.      ...and all the others I forgot
  80.  
  81. How to obtain updates
  82. *********************
  83.  
  84.    MUIProCalc will be available on ADS, FRAS, FTP, and Fred Fish disks
  85. as soon as there`s a new release available.
  86.  
  87. How to contact the author
  88. *************************
  89.  
  90.    If you have any questions, suggestions, bug reports or anything else
  91. you want to tell me, you may contact me under one of these addresses.
  92.  
  93.    Either use normal snail mail:
  94.  
  95.      Kai Iske
  96.      Brucknerstrasse 18
  97.      63452 Hanau
  98.      Germany
  99.      Tel.: +49-(0)6181-850181
  100.  
  101.    or reach me using electronical mail
  102.  
  103.      USENET:   kai@iske.adsp.sub.org
  104.      FIDO:     Kai Iske, 2:244/6302.11
  105.      ZNET:     KAI@SWEET.ZER
  106.  
  107. Installing MUIProCalc
  108. *********************
  109.  
  110.    Installing MUIProCalc isn`t that hard. First of all you should get
  111. hold of MUI (MagicUserInteface) and install it. MUIProCalc relies on
  112. MUI, since the complete User Interface was written using this great
  113. system.
  114.  
  115.    Having installed MUI (if you haven`t done so already), you may copy
  116. the program `MCalc' and it`s icon `MCalc.info' to a place you like.
  117.  
  118.    If you want to use the online help, you have to have AmigaGuide(C)
  119. installed. If so, move the supplied `MCalc.guide' file to the same
  120. directory you moved the main program to.
  121.  
  122.    That`s it. In order to get online help, simply position the mouse
  123. over the object you want to get help for and MUIProCalc will pop up a
  124. window containing the help text.
  125.  
  126.    One word to the menu shortcuts : They might not be Style Guide
  127. compliant, but I think it`ll work just fine, anyway ;)
  128.  
  129.    *NOTE* that you better set the stack size to at least 8192 bytes
  130.  
  131. Using MUIProCalc
  132. ****************
  133.  
  134.    Well, it isn`t that hard to use MUIProCalc. The main input window is
  135. devided into three areas, which are
  136.  
  137. The input/output area
  138. =====================
  139.  
  140.    Within this area (the upper) you see a String gadget and a ListView
  141. gadget.  The String gadget is used to enter the expressions you want to
  142. calculate.
  143.  
  144.    Within the ListView you see a history of all entered expressions and
  145. results. Per default the left column of the ListView is used to display
  146. the expression, whilst the right one reflects the result. You may set
  147. the number of lines bufferd using the Preferences. Furthermore you may
  148. tell MUIProCalc how to format the entry, i.e. you may have four
  149. different output types.  See History, to find out more about history
  150. settings.
  151.  
  152. Function tables
  153. ===============
  154.  
  155.    Within this area you`ll find all the functions supported by
  156. MUIProCalc.  Simply click on the function you want to be added to the
  157. expression. You will also notice a Cycle gadget. This one may be used
  158. to switch between two function tables. The first set is a more
  159. mathematical set, whilst the second might only be of use to
  160. programmers. There are functions for bit-manipulation etc.pp.
  161.  
  162.    This Group may be hidden, thus leading to more space. See Layout, to
  163. find out more about that.
  164.  
  165. Input fields
  166. ============
  167.  
  168.    These are buttons probably known from any other calculator. Simply
  169. click on the digit/operator you want to add to your expression. The
  170. characters 'A-F' are used to enter hexadecimal values. The other
  171. characters 'X-Z' are memories. These can be set using an expression of
  172. the form
  173.  
  174.                             x = sqrt (2*3)
  175.  
  176.    This expression will set memory 'X' to the result of 'sqrt (2*3)'.
  177. You may now use this value during other operations. You may even set a
  178. memory relative to another one, like
  179.  
  180.                           x = y + sqrt (2*3)
  181.  
  182.    MUIProCalc supports four different value formats, these are :
  183.  
  184. `Decimal'
  185.      Decimal values are entered with no additional characters, like
  186.      '2.12322'.  You may even enter doubles using scientific notation,
  187.      like '2.123e-2'
  188.  
  189. `Hexadecimal'
  190.      These values are preceded by a '$'-sign or by '0x'
  191.  
  192. `Octal'
  193.      These values are preceded by a '\'-sign
  194.  
  195. `Binary'
  196.      These values are preceded by a '%'-sign
  197.  
  198.    The '!' operator is used to calculate the factorial of a value. This
  199. one is limited to a value of !170.
  200.  
  201.    The 'Exec' button may be used to 'start' the calculator. This can
  202. also be done, by simply hittin RETURN from within the String gadget
  203.  
  204.    'CLR' clears the current display.
  205.  
  206.    'ACLR' will clear the display and all memories
  207.  
  208.    This Group may be hidden, thus leading to more space. See Layout, to
  209. find out more about that.
  210.  
  211. The menus
  212. =========
  213.  
  214.    MUIProCalc offers a set of menus. These are :
  215.  
  216. Project
  217. -------
  218.  
  219.    The Project menu offers three entries :
  220.  
  221. `Preferences...'
  222.      Will open the Preferences editor (see Prefs)
  223.  
  224. `About...'
  225.      Will display about messages
  226.  
  227. `Quit'
  228.      Will quit MUIProCalc
  229.  
  230. History
  231. -------
  232.  
  233.    If you prefer to use your mouse or the menu shortcuts you may paste
  234. an entry from the history to the current cursor position from within
  235. this menu :
  236.  
  237. `Pick left entry'
  238.      Will pick the left entry from the list and paste it to the current
  239.      cursor position. If only one column is shown, this will be used
  240.      (see Prefs).
  241.  
  242. `Pick right entry'
  243.      Will pick the right entry from the list and paste it to the
  244.      current cursor position. If only one column is shown, this will be
  245.      used (see Prefs).
  246.  
  247. `Copy left entry'
  248.      Selecting this item will copy the left entry from the history to
  249.      the selected c