home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / dirs / mortcalc_385.lzh / MortCalc / MortCalc.doc < prev    next >
Text File  |  1990-10-22  |  6KB  |  137 lines
  1.                            MortCalc.doc
  2.                            ~~~~~~~~~~~~                    
  3.             MortCalc is freeware. Enjoy and pass it around with all
  4.             the    included files.
  5.  
  6. OPERATION
  7. ~~~~~~~~~
  8. -from the CLI:   MortCalc  <-c -f -s>
  9.  
  10.     where  -c change the default calculation mode from USA to Canada 
  11.            -f change the default language from English to French
  12.            -s displays raw data (6 decimals, not rounded) to the
  13.               standard output (CLI). Can be redirected to the printer 
  14.               with the command line: MortCalc >PRT: -s.
  15.  
  16.     "MortCalc ?" displays a help screen on the CLI.
  17.  
  18. -from the Workbench: just double click on the icon. See PRESELECTION.
  19.  
  20. BUTTONS AND BOXES 
  21. ~~~~~~~~~~~~~~~~~
  22. If you are fluent with Amigese, run MortCalc right away and read
  23. this doc later for the fine points.
  24.  
  25. Select the operation you want to do by clicking in one of the
  26. buttons at the left (PRINCIPAL, RATE, PERIOD, BALANCE or PAYMENT).
  27. The amortization PERIOD is the length of the loan. The selected
  28. button stays highlighted and the STATUS line confirms your selection.
  29. At startup, MortCalc will compute the monthly payments for the figures
  30. displayed in the value boxes (PAYMENT selected). 
  31.  
  32. To change a value, select a box by clicking in it and edit the digits
  33. with the keyboard or the keypad (DEL, Backspace and the left and right
  34. cursor keys work the usual way). You may click CALCULATE anytime. If 
  35. you hit <RETURN> instead, the cursor jumps to the next box. 
  36.  
  37. To clear a box, you may use the Right Amiga-X combination (press X
  38. while holding down the right fancy A key). Clearing a box just makes
  39. room to enter a new value; to really change a value, you have to click
  40. CALCULATE. This button enters all the displayed figures and the result
  41. is highlighted by the cursor in the selected value box.
  42.  
  43. Clicking on the CALCULATE button updates the display and formats the
  44. output with $, %, etc. The value boxes accept any character but will 
  45. read in only digits and decimal points. Naturally, any non-numerical
  46. entry will generate an error message.
  47.  
  48. When the RATE is computed, an error message will be displayed if
  49. total INTEREST equals or exceeds total payments.
  50.  
  51. The INTEREST box shows the cumulative interest amount paid. This is
  52. the only box that doesn't accept a direct input; this value is updated
  53. each time a new payment is calculated.
  54.  
  55. The CANADA button changes the default mode from USA (monthly 
  56. compounded) to Canada (semiannually compounded). With the startup
  57. values, PAYMENT is $132.15 (USA) and $131.04 (Canada). MortCalc values
  58. have been verified with annuity tables and are very reliable.
  59.  
  60. You can enter any multiple of 12 (1, 2, 3, 4, 6 or 12) in the
  61. "Compounded over ...  months" box. For instance, enter 3 to get
  62. "quarterly compounded".
  63.  
  64. The PRINT button gets you a hard copy of all the values. 
  65. CAUTION: MortCalc may hang if this option is selected while the    
  66. printer is not on-line.
  67.  
  68. To QUIT, hit the Close button in the upper left corner of the
  69. MortCalc window.
  70.  
  71. SHORT CUTS
  72. ~~~~~~~~~~
  73. All the value boxes (exept PERIOD) accept digits only, so you don't
  74. need to enter any comma, $ or % ; CALCULATE does that for you. 
  75.  
  76. As for the PERIOD box, it uses any non-digit character(s) to separate 2
  77. integer fields (years and months). So, the following entries are
  78. equivalent:
  79.  
  80.             10 yrs 2 mo.
  81.             10 ans 2 mois
  82.             10/2
  83.             0y122        (122 months is 10 years and 2 months)
  84.  
  85. Please note that the PERIOD box accepts integers only. All the other
  86. boxes take both integer and decimal values. 
  87.  
  88. You may operate MortCalc without the mouse if you use the arrow keys 
  89. within a box and the <RETURN> key to move from box to box. Place the
  90. mouse pointer on CALCULATE  and simultaneously press left Alt-left Amiga
  91. to simulate a mouse click...
  92.  
  93. ROAD TEST
  94. ~~~~~~~~~
  95. MortCalc can do a lot of things besides calculating your monthly
  96. instalments. For instance, using the startup values, you may want to
  97. know how long it would take to pay the principal if the payments
  98. were set at $150. To find out, select the PERIOD box, then edit
  99. the PAYMENT value box to $150.00 and click CALCULATE. 
  100.     
  101. You may wish to know the balance on a loan after, say, one year.
  102. Just select BALANCE, and enter 1 in the PERIOD box. 
  103.  
  104. Watch out for asymptotic values, else you may have to pay your
  105. mortgage for the whole eternity. For instance, click PERIOD and try
  106. to increment the PRINCIPAL until you get an error message (which
  107. will show up when the PERIOD exceeds 9999 months). You will find out
  108. that at some point just before the error message, a difference of
  109. one miserable dollar in the principal adds *years* of payments. 
  110.  
  111. If you add fractions of cent (say $0.003) to the PAYMENT, you may
  112. notice an increment of a few dollars in PRINCIPAL. The rounding down
  113. of figures also explains why you may have in few cents left in BALANCE
  114. when the amortization PERIOD is over. Use the CLI -s option (raw data)
  115. if you need a precision of more than two decimals. 
  116.   
  117. MortCalc gives you all the figures you need to shop for a mortgage.
  118. You no longer have to take for granted everything your loan agent
  119. tells you, and you may even teach him a trick or two.
  120.  
  121. PRESELECTION OF DEFAULT VALUES
  122. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  123. You may change some startup values by editing the Tool Types
  124. box of the icon (Workbench ICON menu item). ARG1=CAN and ARG2=FR
  125. will change the defaults options to Canada and French, respectively.
  126. Delete these entries to get the default values (USA and English).
  127. Invisible language selection is a welcome feature in a small world
  128. like ours.
  129.  
  130. AGITPROP
  131. ~~~~~~~~
  132. The next version of MortCalc will incorporate weekly and biweekly 
  133. (each other week) compounding if enough users ask for it.
  134.  
  135.                                       
  136.                                                Michel Laliberté
  137.