home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 6 / FreshFish_September1994.bin / new / util / misc / mcalc / mcalc.doc < prev    next >
Text File  |  1994-08-18  |  23KB  |  758 lines
  1.    Welcome to MUIProCalc v1.4. 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 release
  25. new versions of MUIProCalc. Public Domain vendors are not allowed to
  26. sell MUIProCalc for more than the price of a regular disk, which should
  27. 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. Installing MUIProCalc
  62. *********************
  63.  
  64.    Installing MUIProCalc isn`t that hard. First of all you should get
  65. hold of MUI (MagicUserInteface) and install it. MUIProCalc relies on
  66. MUI, since the complete User Interface was written using this great
  67. system.
  68.  
  69.    Having installed MUI (if you haven`t done so already), you may copy
  70. the program MCalc and it`s icon MCalc.info to a place you like.
  71.  
  72.    If you want to use the online help, you have to have AmigaGuide(C)
  73. installed. If so, move the supplied MCalc.guide file to the same
  74. directory you moved the main program to.
  75.  
  76.    That`s it. In order to get online help, simply position the mouse
  77. over the object you want to get help for and MUIProCalc will pop up a
  78. window containing the help text.
  79.  
  80.    One word to the menu shortcuts : They might not be Style Guide
  81. compliant, but I think it`ll work just fine, anyway ;)
  82.  
  83.        NOTE that you better set the stack size to at least 8192 bytes
  84.  
  85. Using MUIProCalc
  86. ****************
  87.  
  88.    Well, it isn`t that hard to use MUIProCalc. The main input window is
  89. devided into three areas, which are
  90.  
  91. The input/output area
  92. =====================
  93.  
  94.    Within this area (the upper) you see a String gadget and a ListView
  95. gadget.  The String gadget is used to enter the expressions you want to
  96. calculate.
  97.  
  98.    Within the ListView you see a history of all entered expressions and
  99. results. Per default the left column of the ListView is used to display
  100. the expression, whilst the right one reflects the result. You may set
  101. the number of lines bufferd using the Preferences. Furthermore you may
  102. tell MUIProCalc how to format the entry, i.e. you may have four
  103. different output types.  See History, to find out more about history
  104. settings.
  105.  
  106. Function tables
  107. ===============
  108.  
  109.    Within this area you`ll find all the functions supported by
  110. MUIProCalc.  Simply click on the function you want to be added to the
  111. expression. You will also notice a Cycle gadget. This one may be used
  112. to switch between two function tables. The first set is a more
  113. mathematical set, whilst the second might only be of use to
  114. programmers. There are functions for bit-manipulation etc.pp.
  115.  
  116.    This Group may be hidden, thus leading to more space. See Layout, to
  117. find out more about that.
  118.  
  119. Input fields
  120. ============
  121.  
  122.    These are buttons probably known from any other calculator. Simply
  123. click on the digit/operator you want to add to your expression. The
  124. characters 'A-F' are used to enter hexadecimal values. The other
  125. characters 'X-Z' are memories. These can be set using an expression of
  126. the form
  127.  
  128.                             x = sqrt (2*3)
  129.  
  130.    This expression will set memory 'X' to the result of 'sqrt (2*3)'.
  131. You may now use this value during other operations. You may even set a
  132. memory relative to another one, like
  133.  
  134.                           x = y + sqrt (2*3)
  135.  
  136.    MUIProCalc supports four different value formats, these are :
  137.  
  138. Decimal
  139.      Decimal values are entered with no additional characters, like
  140.      '2.12322'.  You may even enter doubles using scientific notation,
  141.      like '2.123e-2'
  142.  
  143. Hexadecimal
  144.      These values are preceded by a '$'-sign or by '0x'
  145.  
  146. Octal
  147.      These values are preceded by a '\'-sign
  148.  
  149. Binary
  150.      These values are preceded by a '%'-sign
  151.  
  152.    The '!' operator is used to calculate the factorial of a value. This
  153. one is limited to a value of !170.
  154.  
  155.    The 'Exec' button may be used to 'start' the calculator. This can
  156. also be done, by simply hittin RETURN from within the String gadget
  157.  
  158.    For percentage calculations there are several modes and functions:
  159.  
  160.    * X + Y%
  161.  
  162.      Will add Y% of X to X
  163.  
  164.    * X - Y%
  165.  
  166.      Will subtract Y% of X from X
  167.  
  168.    * X * Y%
  169.  
  170.      Will calculate the Y percentage of X
  171.  
  172.    * X %ch Y
  173.  
  174.      Will return the percentual changes between X and Y
  175.  
  176.    * X %t Y
  177.  
  178.      Y is which percentage of X? Eg. 250 %t 10 will return 4.
  179.  
  180.    'CLR' clears the current display.
  181.  
  182.    'ACLR' will clear the display and all memories
  183.  
  184.    This Group may be hidden, thus leading to more space. See Layout, to
  185. find out more about that.
  186.  
  187. The menus
  188. =========
  189.  
  190.    MUIProCalc offers a set of menus. These are :
  191.  
  192. Project
  193. -------
  194.  
  195.    The Project menu offers three entries :
  196.  
  197. Preferences...
  198.      Will open the Preferences editor (see Prefs)
  199.  
  200. About...
  201.      Will display about messages
  202.  
  203. Quit
  204.      Will quit MUIProCalc
  205.  
  206. History
  207. -------
  208.  
  209.    If you prefer to use your mouse or the menu shortcuts you may paste
  210. an entry from the history to the current cursor position from within
  211. this menu :
  212.  
  213. Pick left entry
  214.      Will pick the left entry from the list and paste it to the current
  215.      cursor position. If only one column is shown, this will be used
  216.      (see Prefs).
  217.  
  218. Pick right entry
  219.      Will pick the right entry from the list and paste it to the
  220.      current cursor position. If only one column is shown, this will be
  221.      used (see Prefs).
  222.  
  223. Copy left entry
  224.      Selecting this item will copy the left entry from the history to
  225.      the selected clipboard unit. If only one column is show, this one
  226.      will be used (see Prefs).
  227.  
  228. Copy right entry
  229.      Selecting this item will copy the right entry from the history to
  230.      the selected clipboard unit. If only one column is show, this one
  231.      will be used (see Prefs).
  232.  
  233. Display Bases
  234. -------------
  235.  
  236.    This menu may be used to set the display mode for output. You may
  237. have 'Decimal', 'Hexadecimal', 'Octal', or 'Binary' output.
  238.  
  239.    In any other mode than 'Decimal' there will be no difference between
  240. 'Signed' and 'Unsigned' modes (see Sign).
  241.  
  242.    The default output type may be set using Outp