home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / utilsr / rpn101 / RPNCALC.DOC < prev    next >
Text File  |  1992-12-10  |  6KB  |  211 lines
  1.  
  2.         RPN Calculator for the Psion Series 3
  3.               Version 1.01 9 Dec 1992
  4.  
  5.         Copyright (c) 1992 Jaime Pereira
  6.  
  7.         Email: jep@world.std.com
  8.                Compuserve 70441,456
  9.  
  10.         Address: 312 Southwind Dr. #206
  11.                  North Palm Beach, FL 33408
  12.              USA
  13.  
  14.    ======================================================================
  15.     This program is free software; you can redistribute it and/or modify
  16.     it under the terms of the GNU General Public License as published by
  17.     the Free Software Foundation; either version 1, or (at your option)
  18.     any later version.
  19.  
  20.     This program is distributed in the hope that it will be useful,
  21.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  22.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  23.     GNU General Public License for more details.
  24.  
  25.     You should have received a copy of the GNU General Public License
  26.     along with this program; if not, write to the Free Software
  27.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  28.    ======================================================================
  29.  
  30.  
  31. Introduction
  32. ------------
  33.  
  34. RPN Calc is a Reverse Polish Notation calculator intended tto
  35. replace the Psion Series 3 built in calculator. It is fashioned
  36. after the HP-28 style inteface.
  37.  
  38. This initialal release contains the following features:
  39.     
  40.     + RPN interface
  41.     + Basic stack manupulators
  42.     + 20 number stack, of which top 6 items are visible
  43.     + 10 memories
  44.     + Integrates most math functions
  45.  
  46. Change Log
  47. ----------
  48.  
  49. Version 1.0    
  50.     Initial release
  51.  
  52. Version 1.01
  53.     + Correct bug in "change sign" which did not permit specification 
  54.       of negative exponents in scientific notation.
  55.     + Correct bug that pushed the edit box operand into the stack
  56.           after a flawed math operation happend. The correct behaivor
  57.           is to restore the stack and edit box to the state before
  58.           the operation occurred.
  59.  
  60.  
  61. Distrubution
  62. ------------
  63.  
  64.     RPNCALC.OPA    RPN pplication program
  65.     RPNCALC.PIC    Icon file
  66.     RPNCALC.OPL    Sources for RPN
  67.     RPNCALC.DOC    This document
  68.     COPYING        GNU General Public License
  69.  
  70. Installation
  71. ------------
  72.  
  73. All program files should be in a directory named "\Rpncalc".
  74. To create a directory, press PSION-+ whilst on the system
  75. screen.   The  program needs  2  files in  order  to run.
  76. These are as follows:
  77.  
  78.       RPNCALC.OPA    
  79.       RPNCALC.PIC   
  80.  
  81. Install the application in  the system screen by pressing
  82. PSION-I.  When the  "Install Application" dialog pops up,
  83. press TAB  on  the "File:  name" item.    Go to  the root
  84. directory, and into  the "Rpncalc" directory.   There, select
  85. the file RPNCALC.OPA and press enter.  This will return you
  86. to the dialog  - press enter again.   RPNCalc should now be
  87. installed, and can be run in the usual manner.
  88.  
  89. In addition, you can assign the "Calc" button to run RPN calc
  90. using the "Assign button" option of the Apps section of the 
  91. system menu.
  92.  
  93.  
  94. Operation
  95. ---------
  96.  
  97. After entering RPN calc, a windows with two sections appears.
  98. The top section is called the edit box, and here is were one
  99. enters the numbers. The bottom section is the stack display.
  100.  
  101. To place a number in the stack, punch the number in the edit
  102. box and press Enter. The Enter key also duplicates the value
  103. on top of the stack when the edit box is empty.
  104.  
  105. An example on how to add two numbers follows:
  106.  
  107.         1028 <Enter> 50 +
  108.     
  109. This should display the numner 1078 in the top of the stack.
  110. The spaces between the tokens are only shown for clarity
  111. and need not be entered.
  112.  
  113. If there is a number in the edit box, all operations consider
  114. it the top of the stack. Otherwise, it is the number in the
  115. top of the stack display.
  116.  
  117.  
  118. Editing Numbers
  119. ---------------
  120.  
  121. To edit a number, the left and right arrow keys and the
  122. delete key are usefull. 
  123.  
  124. If the edit box is blank, the up and down arrows bring the 
  125. values in the stack to the edit box.
  126.  
  127. Memories
  128. --------
  129.  
  130. RPNCalc has 10 memories available, identified by the numbers
  131. 1 to 10. They are used in a similar way as the Sto and Rcl 
  132. buttons in an HP calculator. For example, to store the top 
  133. of the stack in memory 4, press 4 followed by the 'I' key.
  134.  
  135. Similarly to recall a value stored in a memory press the
  136. memory number followed by the 'O' key. The number should appear
  137. in the top of the stack.
  138.  
  139. All memories have an initial value of 0.
  140.  
  141.  
  142. Table of Basic Operations
  143. -------------------------
  144.  
  145. operation    key        before        after
  146. ---------------------------------------------------------
  147. dup        Enter        n          n  n
  148. drop        Delete        n             
  149. swap        S        n1 n2          n2 n1
  150. rot        R        n1 n2 n3      n2 n3 n1
  151.  
  152. mem store    I        mem n      
  153. mem recall    O        mem           n 
  154.  
  155. addition    +        n1 n2        n2+n1
  156. substraction    -        n1 n2        n2-n1
  157. multiplication    *        n1 n2        n2*n1
  158. division    /        n1 n2        n2/n1
  159. power        x        n1 n2        n2^n1
  160.  
  161. Pi constant    P                Pi
  162. ---------------------------------------------------------
  163.  
  164. Additional math operations are avalable using the 'PSION' key.
  165.  
  166. Non trivial math functions are implemented using the same keystrokes
  167. as Psion Calc (i.e. using the 'PSION' key. For a list of such 
  168. operations see the built in help.
  169.  
  170. Tools
  171. -----
  172.  
  173. This program was developed in a couple of days using the Series 3 
  174. emulator EHWIM.EXE, available free of charge in Compu$erve and other 
  175. fine stores neer you. In addition the icon was made using the
  176. BITMEISTER utility written by W. Raymond Alderman.
  177.  
  178.  
  179. Change Log
  180. ----------
  181.  
  182. Version 1.0    
  183.     Initial release
  184.  
  185. Version 1.01
  186.     Corrects bug in change sign which did not permit specification 
  187.     of negative exponents in scientific notation.
  188.  
  189.  
  190. Further Work
  191. ------------
  192.  
  193.     + A "real" manual
  194.     + Clean and unintrusive interface to OPL
  195.     + Graphing module
  196.     + Hex and binary display modes
  197.     + Enginnering display format
  198.  
  199. Other Matters
  200. -------------
  201.  
  202. If you find this application usefull, find problems, dislike some
  203. feature, add something neet feature to it, or fell lonely, drop me 
  204. a note at the address provided at top of this document. I will try 
  205. to get back to you as time permits.
  206.  
  207. That's all for now, 
  208.  
  209. Jaime Pereira
  210.  
  211.