home *** CD-ROM | disk | FTP | other *** search
/ Amiga Games 1996 January / amigagames-cdrom-1996-01.iso / archive / userbox / publicdomain / taschenrechner.lha / MCalc / MCalc.doc < prev    next >
Text File  |  1995-01-21  |  32KB  |  1,052 lines

  1.    Welcome to MUIProCalc v1.5. 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.  Depending on your MUI Preferences you, will either see a
  112. Cycle gadget, or a set of registers. Using either of those, you may
  113. switch between five function tables. The first set is a more
  114. mathematical set, whilst the second might only be of use to
  115. programmers. There are functions for bit-manipulation etc.pp. The third
  116. contains a set of memories, you may store temporary results in. Thr
  117. fourth and the fifth are for standard deviation and linear regression
  118. calculations respectively.
  119.  
  120.    This Group may be hidden, thus leading to more space. See Layout, to
  121. find out more about that.
  122.  
  123. Input fields
  124. ============
  125.  
  126.    These are buttons probably known from any other calculator. Simply
  127. click on the digit/operator you want to add to your expression. The
  128. characters 'A-F' are used to enter hexadecimal values. The other
  129. characters 'I-Z' are memories. These can be set using an expression of
  130. the form
  131.  
  132.                             x = sqrt (2*3)
  133.  
  134.    This expression will set memory 'X' to the result of 'sqrt (2*3)'.
  135. You may now use this value during other operations. You may even set a
  136. memory relative to another one, like
  137.  
  138.                           x = y + sqrt (2*3)
  139.  
  140.    MUIProCalc supports four different value formats, these are :
  141.  
  142. Decimal
  143.      Decimal values are entered with no additional characters, like
  144.      '2.12322'.  You may even enter doubles using scientific notation,
  145.      like '2.123e-2'
  146.  
  147. Hexadecimal
  148.      These values are preceded by a '$'-sign or by '0x'
  149.  
  150. Octal
  151.      These values are preceded by a '\'-sign
  152.  
  153. Binary
  154.      These values are preceded by a '%'-sign
  155.  
  156.    The '!' operator is used to calculate the factorial of a value. This
  157. one is limited to a value of !170.
  158.  
  159.    The 'Exec' button may be used to 'start' the calculator. This can
  160. also be done, by simply hittin RETURN from within the String gadget
  161.  
  162.    For percentage calculations there are several modes and functions:
  163.  
  164.    * X + Y%
  165.  
  166.      Will add Y% of X to X
  167.  
  168.    * X - Y%
  169.  
  170.      Will subtract Y% of X from X
  171.  
  172.    * X * Y%
  173.  
  174.      Will calculate the Y percentage of X
  175.  
  176.    * X %ch Y
  177.  
  178.      Will return the percentual changes between X and Y
  179.  
  180.    * X %t Y
  181.  
  182.      Y is which percentage of X? Eg. 250 %t 10 will return 4.
  183.  
  184.    Here is a list of functions, you probably can`t make anything out
  185. of, on first sight:
  186.  
  187.    * (n k)
  188.  
  189.      Usage in calucaltor: n_expression '(n k)' k_expression. This will
  190.      calculate the expression 'n over k' (N!/(N-K)!)
  191.  
  192.    * YRoot
  193.  
  194.      Usage in calculator: y_root 'YRoot' x_value. This will calculate
  195.      the yth root of x.
  196.  
  197.    * REZ
  198.  
  199.      Usage in calculator: 'REZ' x_value. This will calculate the
  200.      reciprocal of x.
  201.  
  202.    * EXG
  203.  
  204.      Usage in calculator: mem_1 'EXG' mem_2. This function will swap
  205.      contents of the specifed memories (mem_1 and mem_2)
  206.  
  207.    'CLR' clears the current display.
  208.  
  209.    'ACLR' will clear the display and all memories plus standard
  210. deviation values and linear regression value pairs.
  211.  
  212.    This Group may be hidden, thus leading to more space. See Layout, to
  213. find out more about that.
  214.  
  215. Calculating standard deviation
  216. ==============================
  217.  
  218.    For calculating statistical functions, such a the standard deviation
  219. or the linear regression, MUIProCalc offers a somewhat different
  220. approach for entering the values. I will now explain the actions you
  221. have to take, in order to calculate standard deviation for a set of
  222. values.
  223.  
  224.    First, you have to initialize the list of values, this is accomlished
  225. through the SD command. It expects, enclosed in brackets, a list of
  226. values, each seperated by a comma.
  227.  
  228.                        SD(120, 145, 80, 65, 120)
  229.  
  230.    Would set up five values for standard deviation calculations. You
  231. may enter expressions for each value, like '120*2/X', of course.
  232.  
  233.    Now, according to the values entered, MUIProCalc offers functions for
  234. calculation, which are:
  235.  
  236. SD_AVE
  237.      This function will return the average value of the values entered.
  238.  
  239. SD_PDEV
  240.      Will calculate the standard deviation of the population for the
  241.      values entered.
  242.  
  243. SD_SDEV
  244.      Will calculate the standard deviation of the sample for the list
  245.      of values entered.
  246.  
  247. SD_QSUM
  248.      Will return the sum of all values, each value powered by 2, ie.
  249.      SIGMA X^2
  250.  
  251. SD_SUM
  252.      Will return the sum of all values, ie. SIGMA X
  253.  
  254. SD_NUM
  255.      Will return the number of elements in the list
  256.  
  257. Calculating linear regression
  258. =============================
  259.  
  260.    This set of functions is nearly the same as the one described for
  261. standard deviation. Again you first have to enter some values, this
  262. time pairs of values, for the calculator to work with. As linear
  263. regression works with pairs of values, you somehow have to bring two
  264. values into some sort of relationship. This is accomplished, for
  265. example, by:
  266.  
  267.             LR(10;1003, 15;1005, 20;1010, 25;1011, 30;1014)
  268.  
  269.    This will set up a list of pairs of values. This list of X values
  270. will be set to 10, 15, 20, 25, and 30, while the list of Y values will
  271. be set to 1003, 1005, 1010, 1011, 1014. As you can see, a pair is set
  272. up by the X value, followed by a semicolon and the Y value. Each pair
  273. is, again, seperated through a comma.
  274.  
  275.    Here is a list of functions to work with linear regression:
  276.  
  277. LR_XAVE, LR_YAVE
  278.      Will return the average value for the X or Y values respectively
  279.  
  280. LR_XPDEV, LR_YPDEV
  281.      Will return the standard deviation of the population for either
  282.      the X values, or the Y values
  283.  
  284. LR_XSDEV, LR_YSDEV
  285.      Will calculate the standard deviation of the sample for either the
  286.      X values, or the Y values
  287.  
  288. LR_XNUM, LR_YNUM
  289.      This function either returns the number of X values, or the number
  290.      of Y values. Of course, these numbers will always be the same ;)
  291.  
  292. LR_XQSUM, LR_YQSUM
  293.      Will calculate the sum of X values, or Y values powered by 2, ie.
  294.      SIGMA X^2 or SIGMA Y^2
  295.  
  296. LR_XSUM, LR_YSUM
  297.      Will return the sum of X values, Y values
  298.  
  299. LR_XYSUM
  300.      Will return the sum of the products of each X,Y value pair, ie.
  301.      SIGMA (X*Y)
  302.  
  303. LR_ALPHA
  304.      Will calculate the alpha part of the formula of regression (y =
  305.      alpha + beta * x)
  306.  
  307. LR_BETA
  308.      Will calculate the beta part of the formula of regression (y =
  309.      alpha + beta * x)
  310.  
  311. LR_ASSX <expr>
  312.      Given a fixed value or an expression for the Y value, this
  313.      function will try to assess the value of the X value
  314.  
  315. LR_ASSY <expr>
  316.      Given a fixed value or an expression for the X value, this
  317.      function will try to assess the value of the Y value
  318.  
  319. LR_CORR
  320.      Will return the correlation coefficient for the linear regression
  321.      (r)
  322.  
  323. LR_CCORR
  324.      Will return the critical correlation coefficient for the linear
  325.      regression (r^2)
  326.  
  327. LR_COVAR
  328.      Will return the covariant for the linear regression.
  329.  
  330. Some special notes on usage
  331. ===========================
  332.  
  333.    MUIProCalc doesn`t really act like a real calculator, you probably
  334. own. For example, if you like to calculate the square root of 9^3, you
  335. usally follow these steps to calculate it with your calculator:
  336.  
  337. Enter 9
  338. Press your 'x powered by y' key (x^y)
  339. Enter 3
  340. (Hit your '=' key), which depends on which calculator you use
  341. Hit your square root key
  342.      You get the result (27)
  343.  
  344.    With MUIProCalc you take a different approach. This is almost the
  345. same as when writing the formula down a sheet of paper. Usually you
  346. would write 'sqrt (9^3)' or 'sqrt 9^3'. This is the same with
  347. MUIProCalc: You enter this formula into the Input gadget and simply hit
  348. the Exec gadget or hit the RETURN key.  MUIProCalc will now return the
  349. result (again 27; well, how come?). As you can see, this is somewhat
  350. different to normal or rpn calculators. You enter the formula as if you
  351. wrote it down, and let MUIProCalc parse and evaluate the expression.
  352.  
  353. The menus
  354. =========
  355.  
  356.    MUIProCalc offers a set of menus. These are :
  357.  
  358. Project
  359. -------
  360.  
  361.    The Project menu offers three entries :
  362.  
  363. Preferences...
  364.      Will open the Preferences editor (see Prefs)
  365.  
  366. About...
  367.      Will display about messages
  368.  
  369. Quit
  370.      Will quit MUIProCalc
  371.  
  372. History
  373. -------
  374.  
  375.    If you prefer to use your mouse or the menu shortcuts you may paste
  376. an entry from the history to the current cursor position from within
  377. this menu :
  378.  
  379. Pick left entry
  380.      Will pick the left entry from the list and paste it to the current
  381.      cursor position. If only one column is shown, this will be used
  382.      (see Prefs).
  383.  
  384. Pick right entry
  385.      Will pick the right entry from the list and paste it to the
  386.      current cursor position. If only one column is shown, this will be
  387.      used (see Prefs).
  388.  
  389. Copy left entry
  390.      Selecting this item will copy the left entry from the history to
  391.      the selected clipboard unit. If only one column is show, this one
  392.      will be used (see Prefs).
  393.  
  394. Copy right entry
  395.      Selecting this item will copy the right entry from the history to
  396.      the selected clipboard unit. If only one column is show, this one
  397.      will be used (see Prefs).
  398.  
  399. Delete entry
  400.      This menu item will cause MUIProCalc to delete the selected entry
  401.      from the history.
  402.  
  403. Display Bases
  404. -------------
  405.  
  406.    This menu may be used to set the display mode for output. You may
  407. have 'Decimal', 'Hexadecimal', 'Octal', or 'Binary' output.
  408.  
  409.    In any other mode than 'Decimal' there will be no difference between
  410. 'Signed' and 'Unsigned' modes (see Sign).
  411.  
  412.    The default output type may be set using Output.
  413.  
  414. Size
  415. ----
  416.  
  417.    For the 'Hexadecimal', 'Octal', and 'Binary' modes (see Bases), you
  418. may set an output value size (number of bits).  This will
  419. reduce/increase maximum numbers.
  420.  
  421.    The default output type may be set using Output.
  422.  
  423. Sign
  424. ----
  425.  
  426.    For 'Decimal' output (see Bases), you may have signed or unsigned
  427. results, when you enter 'Hexadecimal', 'Octal', or 'Binary' values.
  428.  
  429.    The default output type may be set using Output.
  430.  
  431. Angle
  432. -----
  433.  
  434.    For trigonometrical functions you may set the type of angle you`ve
  435. entered.  If you set 'RAD', the values will be interpreted as of type
  436. radians, if you set 'DEG' angles will be interpreted as of type
  437. degree. Finally there is type 'GRA' so that angles are interpreted as
  438. of type grads.
  439.  
  440.    The default output type may be set using Output.
  441.  
  442. Windows
  443. -------
  444.  
  445.    Within this menu you will find three entries, each of which will
  446. open a support window:
  447.  
  448. Std.Deviation
  449.      This one will open the support window for standard deviation.
  450.      Within the window you will find a list of all values entered for
  451.      standard deviation.  This is just for validation checks, in order
  452.      to see, whether you`ve entered correct values. Basically it`s of
  453.      no use for calculation.
  454.  
  455. Lin.Regression
  456.      Same as for the Std.Deviation window. Within this window you will
  457.      find the list of pairs of values entered for linear regression.
  458.      Again, this is just for validation.
  459.  
  460. Constants
  461.      This is a more useful window. It will list 31 constants, useful for
  462.      Physicians, or anyone else who is calculating with one of the well
  463.      known constants. If you never ever had the nerve to learn all
  464.      those constants by heart, here they are (well, I guess not all).
  465.      Simply double click on an entry within the list, and the value
  466.      will be copied to the Input gadget.
  467.  
  468. The ARexx Port
  469. ==============
  470.  
  471.    In addition to the default ARexx commands every MUI application
  472. knows about, MUIProCalc offers some more, these are :
  473.  
  474.    As with every MUI Application the name of the ARexx Port is
  475. constructed from the base name of the Application. For MUIProCalc this
  476. will be 'MCALC'.
  477.  
  478.    BTW: If you read something about TeX compatible output, this means
  479. you may use these strings directly within a mathematical environment.
  480. The current conversion routine isn`t quite intelligent I have to admit.
  481. Maybe I`ll add a smarter one for the next release...
  482.  
  483.    There are two scripts included for use with CygnusED which
  484. demonstrate how to use the ARexx Port.
  485.  
  486. CALC - Command
  487. --------------
  488.  
  489. Format:
  490.      CALC EXPRESSION
  491.  
  492. Template:
  493.      EXPRESSION/A
  494.  
  495. Parameter:
  496.      Any valid expression as accepted by MUIProCalc
  497.  
  498. Result:
  499.      Will be a string containing the calculated expression
  500.  
  501. Example:
  502.      CALC '1 + 2 + 3'
  503.  
  504.      6.000000
  505.  
  506. CALCTEX - Command
  507. -----------------
  508.  
  509. Format:
  510.      CALCTEX EXPRESSION
  511.  
  512. Template:
  513.      EXPRESSION/A
  514.  
  515. Parameter:
  516.      Any valid expression as accepted by MUIProCalc
  517.  
  518. Result:
  519.      Will be a string containing the calculated expression converted to
  520.      TeX compatible format.
  521.  
  522. Example:
  523.      CALCTEX '1 / 100000'
  524.  
  525.      1\\cdot 10^{-5}
  526.  
  527. GETOUTPUT - Command
  528. -------------------
  529.  
  530. Format:
  531.      GETOUTPUT [ENTRY]
  532.  
  533. Template:
  534.      ENTRY/N
  535.  
  536. Parameter:
  537.      Supply an entry number you want to get from the history`s output
  538.      list.  ENTRY may either be
  539.  
  540.         * n Any valid entry ranging from 0-n, where n is the last entry
  541.           in the list. If an illegal value is supplied, MUIProCalc will
  542.           return the last entry from the list.
  543.  
  544.         * -1 For the active entry
  545.  
  546.         * -2 For the topmost entry
  547.  
  548.         * -3 For the bottommost entry
  549.  
  550. Result:
  551.      Will be a string containing the expression at the specified entry.
  552.  
  553. Example:
  554.      GETOUTPUT 2
  555.  
  556.      12.000001
  557.  
  558. GETTEXOUTPUT - Command
  559. ----------------------
  560.  
  561. Format:
  562.      GETTEXOUTPUT [ENTRY]
  563.  
  564. Template:
  565.      ENTRY/N
  566.  
  567. Parameter:
  568.      Supply an entry number you want to get from the history`s output
  569.      list.  ENTRY may either be
  570.  
  571.         * n Any valid entry ranging from 0-n, where n is the last entry
  572.           in the list. If an illegal value is supplied, MUIProCalc will
  573.           return the last entry from the list.
  574.  
  575.         * -1 For the active entry
  576.  
  577.         * -2 For the topmost entry
  578.  
  579.         * -3 For the bottommost entry
  580.  
  581. Result:
  582.      Will be a string containing the expression at the specified entry,
  583.      formatted to TeX compatible output.
  584.  
  585. Example:
  586.      GETTEXOUTPUT 3
  587.  
  588.      1\\cdot 10^{-5}
  589.  
  590. GETINPUT - Command
  591. ------------------
  592.  
  593. Format:
  594.      GETINPUT [ENTRY]
  595.  
  596. Template:
  597.      ENTRY/N
  598.  
  599. Parameter:
  600.      Supply an entry number you want to get from the history`s input
  601.      list.  ENTRY may either be
  602.  
  603.         * n Any valid entry ranging from 0-n, where n is the last entry
  604.           in the list. If an illegal value is supplied, MUIProCalc will
  605.           return the last entry from the list.
  606.  
  607.         * -1 For the active entry
  608.  
  609.         * -2 For the topmost entry
  610.  
  611.         * -3 For the bottommost entry
  612.  
  613. Result:
  614.      Will be a string containing the expression at the specified entry.
  615.  
  616. Example:
  617.      GETINPUT 2
  618.  
  619.      2 + 2 + 3 + 4
  620.  
  621. GETTEXINPUT - Command
  622. ---------------------
  623.  
  624. Format:
  625.      GETTEXINPUT [ENTRY]
  626.  
  627. Template:
  628.      ENTRY/N
  629.  
  630. Parameter:
  631.      Supply an entry number you want to get from the history`s input
  632.      list.  ENTRY may either be
  633.  
  634.         * n Any valid entry ranging from 0-n, where n is the last entry
  635.           in the list. If an illegal value is supplied, MUIProCalc will
  636.           return the last entry from the list.
  637.  
  638.         * -1 For the active entry
  639.  
  640.         * -2 For the topmost entry
  641.  
  642.         * -3 For the bottommost entry
  643.  
  644. Result:
  645.      Will be a string containing the expression at the specified entry,
  646.      formatted to TeX compatible output.
  647.  
  648. Example:
  649.      GETTEXINPUT 3
  650.  
  651.      1\\cdot 32
  652.  
  653. FORMATTEX - Command
  654. -------------------
  655.  
  656. Format:
  657.      FORMATTEX EXPRESSION
  658.  
  659. Template:
  660.      EXPRESSION/A
  661.  
  662. Parameter:
  663.      Supply an expression you would like to have converted to TeX
  664.      compatible format.
  665.  
  666. Result:
  667.      Will be a string containing the converted expression, formatted to
  668.      TeX compatible output.
  669.  
  670. Example:
  671.      FORMATTEX '1 * 10^-5'
  672.  
  673.      1\\cdot 10^{-5}
  674.  
  675. SETMODE - Command
  676. -----------------
  677.  
  678. Format:
  679.      SETMODE [BASE=DEC|HEX|OCT|BIN] [SIZE=8|16|32]
  680.      [SIGN=SIGNED|UNSIGNED] [ANGLE=RAD|DEG|GRA]
  681.  
  682. Template:
  683.      BASE/K,SIZE/K,SIGN/K,ANGLE/K
  684.  
  685. Parameter:
  686.     BASE
  687.           Specify a new conversion/output base for ARexx calculations.
  688.           You may supply either one of the following :
  689.  
  690.              * DEC Decimal output
  691.  
  692.              * HEX Hexadecimal output
  693.  
  694.              * OCT Octal output
  695.  
  696.              * BIN Binary output
  697.  
  698.     SIZE
  699.           Specify the default conversion size for
  700.           hexadecimal/octal/binary values. You may supply either one of
  701.           the following :
  702.  
  703.              * 8   8 Bits
  704.  
  705.              * 16  16 Bits
  706.  
  707.              * 32  32 Bits
  708.  
  709.     SIGN
  710.           Specify signed or unsigned output. Supply either one of :
  711.  
  712.              * SIGNED   Signed output
  713.  
  714.              * UNSIGNED Unsigned output
  715.  
  716.     ANGLE
  717.           Spcify the default type of supplied angles. This may either
  718.           be :
  719.  
  720.              * RAD Angles of type radians
  721.  
  722.              * DEG Angles of type degree
  723.  
  724.              * GRA Angles of type grads
  725.  
  726. Result:
  727.      This will always be FALSE (0)
  728.  
  729. Example:
  730.      SETMODE 'BASE=HEX' 'SIZE=8' 'SIGN=SIGNED' 'ANGLE=DEG'
  731.  
  732. DELETEHISTORY - Command
  733. -----------------------
  734.  
  735. Format:
  736.      DELETEHISTORY [ENTRY]
  737.  
  738. Template:
  739.      ENTRY/N
  740.  
  741. Parameter:
  742.      Supply an entry number you want to delete from the history`s input
  743.      list.  ENTRY may either be
  744.  
  745.         * n Any valid entry ranging from 0-n, where n is the last entry
  746.           in the list. If an illegal value is supplied, MUIProCalc will
  747.           not delete anything.
  748.  
  749.         * -1 For the active entry
  750.  
  751.         * -2 For the topmost entry
  752.  
  753.         * -3 For the bottommost entry
  754.  
  755. Result:
  756.      This will always be FALSE (0)
  757.  
  758. Example:
  759.      GETTEXINPUT 3
  760.  
  761.      This will delete the fourth entry from the list
  762.  
  763. Preferences
  764. ***********
  765.  
  766.    Within the Preferences window you may configure some of MUIProCalc`s
  767. default values. These are :
  768.  
  769.    Furthermore the active function table, set with the 'Functions'
  770. cycle gadget within the main window, will be taken into account.
  771.  
  772. Use
  773.      will use the current settings and store them temporarily, so if you
  774.      restart MUIProCalc, these settings will be used again.
  775.  
  776. Save
  777.      will save/store the settings on disk.
  778.  
  779. Cancel
  780.      will restore the previously used values.
  781.  
  782. Window layout
  783. =============
  784.  
  785.    Within this group there are two CheckBox gadgets. if the 'No
  786. Functions' CheckBox is set, the main window will not contain the
  787. function tables. If not the function tables will be displayed. If you
  788. set 'No Input' the input fields will not be displayed. If you clear
  789. this CheckBox, the lower gadget group will be displayed.
  790.  
  791.    Using the 'In/Out Order' gadget you may control the ordering of the
  792. input String gadget and the output ListView gadget. When 'Input then
  793. Output' is selected, the String gadget will appear 'on top' of the
  794. ListView. Otherwise ('Output then Input') it will appear underneath the
  795. ListView.
  796.  
  797. Output settings
  798. ===============
  799.  
  800.    You may set the default values for 'Display Bases', 'Size', 'Sign'
  801. and 'Angle' here.
  802.  
  803.    See Bases Size Sign Angle
  804.  
  805. History settings
  806. ================
  807.  
  808.    Using the 'Lines' Slider gadget you may adjust the maximum number of
  809. lines to capture during a session.
  810.  
  811.    With the 'Entries' Cycle gadget you may set the output format for
  812. the history.  You may choose from the following formats :
  813.  
  814. Input & Ouput
  815.      Within the left column you`ll see the expression entered. In the
  816.      right column there`ll be the result for that expression.
  817.  
  818. Output & Input
  819.      Is the opposite to the above
  820.  
  821. Input
  822.      Will only show your input expression
  823.  
  824. Output
  825.      Will only show the result
  826.  
  827.    Using the 'ClipUnit' Slider gadget you may set the default
  828. clipboard unit for History clipping. Simply select a unit you want to
  829. use.
  830.  
  831. Misc
  832. ====
  833.  
  834.    Set the 'Clear input on exit' CheckBox gadget if you prefer to have
  835. the input gadget cleared every time you`ve entered an expression.
  836. Otherwise simply clear it.
  837.  
  838.    The 'Flush memory' CheckBox gadget may be used to tell MUIProCalc to
  839. flush all unused libraries (including unused MUI-Classes) from memory
  840. on exit, thus freeing all that precious memory used up by MUIProCalc.
  841.  
  842.    The 'Deviation window', 'Regression window' and 'Constants
  843. window' tell MUIProCalc whether to open the corresponding windows, or
  844. not ('Std.Deviation', 'Lin.Regression' and 'Constants' windows). Set a
  845. CheckBox gadget in order to make MUIProCalc open that window on startup.
  846.  
  847. Whom I must say 'thank you'
  848. ***************************
  849.  
  850.    I would like to thank the following people
  851.  
  852. Dirk Federlein
  853.      For betatesting and suggestions
  854.  
  855. Stefan Stuntz
  856.      Especially for MUI and for answering all my questions...
  857.  
  858. Volker Güth
  859.      For being the first (and only one so far) contacting me just
  860.      because of MUIProCalc...
  861.  
  862.      ...and all the others I forgot
  863.  
  864. How to obtain updates
  865. *********************
  866.  
  867.    MUIProCalc will be available on ADS, FRAS, FTP, and Fred Fish disks
  868. as soon as there`s a new release available.
  869.  
  870. How to contact the author
  871. *************************
  872.  
  873.    If you have any questions, suggestions, bug reports or anything else
  874. you want to tell me, you may contact me under one of these addresses.
  875.  
  876.    Either use normal snail mail:
  877.  
  878.      Kai Iske
  879.      Brucknerstrasse 18
  880.      63452 Hanau
  881.      Germany
  882.      Tel.: +49-(0)6181-850181
  883.  
  884.    or reach me using electronical mail
  885.  
  886.      INTERNET:   iske@informatik.uni-frankfurt.de
  887.      COMPUSERVE: Kai Iske, 100524,1201
  888.      FIDO:       Kai Iske, 2:244/6302.11
  889.      ZNET:       KAI@SWEET.RHEIN-MAIN.DE
  890.  
  891. Program history
  892. ***************
  893.  
  894.      -----------------------------------------------------------
  895.      Version 1.5                             (21.01.95 17:43:49)
  896.      -----------------------------------------------------------
  897.      
  898.           - Added new function to menu/ARexx. DELETEHISTORY will delete
  899.             an entry from the history list.
  900.             (Requested by : Sorry, I lost you name, but thanks for the
  901.             suggestions and the translation of the manual)
  902.      
  903.           - Added support for GRADS
  904.             (Requested by : Sorry, I lost you name, but thanks for the
  905.             suggestions and the translation of the manual)
  906.      
  907.           - Introduced exg operator, which exchanges the contents
  908.             of two memories
  909.             (Requested by : Sorry, I lost you name, but thanks for the
  910.             suggestions and the translation of the manual)
  911.      
  912.           - Added great support for physical constants. 31 listed
  913.             (Requested by : Sorry, I lost you name, but thanks for the
  914.             suggestions and the translation of the manual)
  915.      
  916.           - Added full features linear regression support
  917.             (Requested by : Volker Güth)
  918.      
  919.           - Added standard deviation support
  920.             (Requested by : Volker Güth)
  921.      
  922.           - Added (n k) n-over-k function, 1/x, and the y-th root of x
  923.             function.
  924.             (Requested by : Sorry, I lost you name, but thanks for the
  925.             suggestions and the translation of the manual)
  926.      
  927.           - Increased number of internal memories from 3 to 18 (I-Z)
  928.      
  929.           - Changed function group to use Registers/Cycle Gadget,
  930.             according to your MUI settings.
  931.      
  932.           - MCalc requested any muimaster.library, even though version
  933.             7 (MUI 2.x) was required
  934.      
  935.           - Some of the input gadgets didn`t react on key nor mouse
  936.             activations.
  937.             (Reported by : Andreas Kirchwitz, and several others)
  938.      
  939.           - Recompiled scanner using Flex 2.4.7
  940.      
  941.           - The format identifier for binary values has been changed;
  942.             I forgot to change the output format identifier as well.
  943.      
  944.      
  945.      -----------------------------------------------------------
  946.      Version 1.4                             (18.08.94 17:35:24)
  947.      -----------------------------------------------------------
  948.      
  949.           - MCalc didn`t even care about Percent calculations
  950.      
  951.           - atan() wasn`t definied for some ranges (somehow)
  952.      
  953.           - The InputString will be default object now
  954.      
  955.           - Recompiled with Scanner generated by flex 2.4.6
  956.      
  957.      
  958.      -----------------------------------------------------------
  959.      Version 1.3                             (11.02.94 23:35:32)
  960.      -----------------------------------------------------------
  961.      
  962.           - One couldn`t use 1e3 for scientific notation of 1000. You
  963.             had to write 1.0e3. Changed
  964.             (Reported by : Henry Norman)
  965.      
  966.           - No more error lines will be copied from History
  967.             (Requested by : Stefan Stuntz)
  968.      
  969.           - "Radiant" was wrong. Changed. Why didn`t anybody tell me.
  970.             (Reported by : Henry Norman)
  971.      
  972.           - Chose wrong case for mathematical "e".
  973.             (Reported by : Henry Norman)
  974.      
  975.      
  976.      -----------------------------------------------------------
  977.      Version 1.2                             (08.12.93 23:48:31)
  978.      -----------------------------------------------------------
  979.      
  980.           - Default number of history lines increased
  981.             (Requested by : Stefan Stuntz)
  982.      
  983.           - No checks were made on the ENTRY argument to an ARexx
  984.             function
  985.      
  986.           - For calculations via ARexx one can set the type, size, sign
  987.             and angle flags seperately, now
  988.      
  989.           - Improved error handling from within ARexx commands a bit
  990.      
  991.           - MUIProCalc may output TeX style mathematical expressions
  992.             when using the ARexx commands. Additionally there is another
  993.             option to convert expressions to TeX format.
  994.             (Requested by : Volker Güth)
  995.      
  996.           - Added more ARexx functions to the default ones
  997.             (CALC, GETINPUT, GETOUTPUT)
  998.             (Requested by : Volker Güth)
  999.      
  1000.           - MUIProCalc didn`t handle extremly small values
  1001.             (Reported by : Volker Güth)
  1002.      
  1003.           - Default values weren`t set up
  1004.      
  1005.           - ACLR and CLR gadget have got menu entries too, now
  1006.             (Requested by : Volker Güth)
  1007.      
  1008.           - History entries may be copied to clipboard now
  1009.             (Requested by : Volker Güth)
  1010.      
  1011.           - Recompiled using SAS 6.50
  1012.      
  1013.           - Bug in ListView display fixed
  1014.      
  1015.           - You may now tell MCalc to clear the input string after
  1016.             hitting RETURN or EXEC.
  1017.      
  1018.      
  1019.      -----------------------------------------------------------
  1020.      Version 1.1                             (17.10.93 15:03:10)
  1021.      -----------------------------------------------------------
  1022.      
  1023.           - Save and Use gadgets weren`t arranged as proposed
  1024.             by the AUISG. (Reported by: Stefan Stuntz)
  1025.      
  1026.           - Changed layout of Prefs window a bit
  1027.             (Suggested by: Stefan Stuntz)
  1028.      
  1029.           - NOT operator didn`t behave as expected ;) It was a simple
  1030.             negate... (Reported by : Top on IRC)
  1031.      
  1032.           - Hex-Values may be entered using 'C'-Style now (e.g. 0xff)
  1033.      
  1034.           - One can use the faktorian '!' behind numbers now, too.
  1035.             (Suggested by : Top on IRC)
  1036.      
  1037.           - One could accidentially change the ordering of the
  1038.             functions and input-gadgets groups by using
  1039.             'No Functions' and 'No Input' (reported by: Top on IRC)
  1040.      
  1041.           - Order of Input and Ouput gadgets (String + ListView) may be
  1042.             set now, ie. the input string may show up underneith the
  1043.             ListView and vice versa (Requested by Dirk Federlein)
  1044.      
  1045.      
  1046.      -----------------------------------------------------------
  1047.      Version 1.0                             (02.10.93 02:16:34)
  1048.      -----------------------------------------------------------
  1049.      
  1050.             --- Initial release ---
  1051.  
  1052.