home *** CD-ROM | disk | FTP | other *** search
/ PSION CD 2 / PsionCDVol2.iso / Programs / 824 / readme.txt < prev    next >
Encoding:
Text File  |  2001-09-01  |  6.8 KB  |  226 lines
  1. ---------------------------------------------------------
  2. FlCalc - A programmer's calculator
  3. (C) 1997, 2001 David Rushall
  4. All rights reserved
  5.  
  6. ---------------------------------------------------------
  7. INTRODUCTION
  8.  
  9. FlCalc is a programmer's calculator with a difference.
  10.  
  11. Originally written to compliment the Calc application on
  12. my Series 3a as I couldn't find anything I liked that did
  13. what I needed and ported to the Series 5 for the same
  14. reason.
  15.  
  16. Features include
  17.  
  18.   o  32-bit integer expression evaluation.
  19.   
  20.   o  Multiple simultaneous output formats including 
  21.      decimal, hex and binary.
  22.   
  23.   o  ASCII and EBCDIC character tables.
  24.   
  25.   o  Multiple memories.
  26.   
  27.   o  Repeatable statements.
  28.   
  29.   o  Pen-enabled on-screen keypad.
  30.   
  31.   o  Copy and paste.
  32.  
  33. ---------------------------------------------------------
  34. INSTALLATION
  35.  
  36. To install this software on your machine:
  37.  
  38.   1) Close ALL applications on your EPOC device.
  39.  
  40.      If you do not close all applications before
  41.      installing the SIS package in the next step
  42.      you may have version problems later.
  43.      
  44.   2) Install the main application SIS file:
  45.      
  46.        FlCalc.sis
  47.                
  48.   3) After the Clipboard OPM is installed, a
  49.      directory called "Clipboard" will have been
  50.      created in the root directory of your machine.
  51.      If you do not wish to develop you own
  52.      applications using the OPM you can delete this
  53.      directory and its contents without affecting the
  54.      operation of FlCalc.
  55.  
  56.   4) Finally, look in the "Extras" draw on the machine
  57.      for the new "FlCalc5" icon, in the normal manner.
  58.  
  59. NOTES:
  60.  
  61.   *  Please consult the manuals for your device for
  62.      details of installing applications packaged in SIS
  63.      files. You will require a PC or Mac running your
  64.      EPOC connect software (i.e. PsiWin 2 or equivalent)
  65.      or the "Add/Remove" icon on the control panel of
  66.      your EPOC device. Double-clicking on the SIS file
  67.      either on the EPOC device or on the PC/Mac connected
  68.      to the EPOC device should do the trick.
  69.      
  70.   *  OPMs are special resources that may be shared by
  71.      many different applications on the EPOC device. If
  72.      these applications do not deliver the OPMs correctly
  73.      in the standard SIS files, they may cause problems
  74.      with other applications when they are installed, or
  75.      even uninstalled. If you find that this application
  76.      fails to start after installing or uninstalling
  77.      another application, perhaps reporting a missing or
  78.      invalid OPM file, please try reinstalling this
  79.      application using the instructions above. This
  80.      should correct the problem.
  81.  
  82. ---------------------------------------------------------
  83. UNINSTALLING
  84.  
  85. If you have finished with this software you can remove
  86. the application as follows:
  87.  
  88.   1) Make sure the FlCalc application is not running.
  89.  
  90.   2) Using the "Add/Remove" icon on the EPOC control
  91.      panel, remove the "FlCalc5" application.
  92.  
  93. After you have completed these steps, FlCalc will have
  94. been removed from your machine's memory and "Extras" bar.
  95.  
  96. ---------------------------------------------------------
  97. BASIC USE
  98.  
  99. In its basic form, FlCalc is simple to use. Simply choose
  100. the application from the Extras bar, enter your
  101. calculation and press Enter.
  102.  
  103. For example, try...
  104.  
  105.     5+(7-2)
  106.  
  107. By default, you can enter numbers in decimal or
  108. hexadecimal (other formats are available using special
  109. notation), as indicated by the second button in the
  110. status area (under the input line). To switch between
  111. them, simply tap the button, or choose the appropriate
  112. item from the main menu.
  113.  
  114. The results of you calculations are displayed in the
  115. large window, with each value being displayed in
  116. multiple formats, e.g. both hexadecimal and binary.
  117. The selection of output format is made using the third
  118. button in the status area, or appropriate menu items.
  119.  
  120. See the online help file (accessible from the "Tools"
  121. menu within the application) for detailed instructions
  122. for use, including details of operators and advanced
  123. expression syntax.
  124.  
  125. A summary of operators follows...
  126.  
  127.     BINARY OPERATORS
  128.     +   :ADD    - add
  129.     -   :SUB    - subtract
  130.     *   :MUL    - multiply
  131.     /   :DIV    - integer divide
  132.     %   :MOD    - modulus (remainder)
  133.     &   :AND    - logical and
  134.     |   :OR     - logical or
  135.     ?   :OR     - logical or
  136.     ^   :XOR    - logical xor
  137.     <<  :LEFT   - shift bits left
  138.     >>  :RIGHT  - shift bits right
  139.  
  140.     UNARY OPERATORS
  141.     -   :NEG    - negative (2's compliment)
  142.     ~   :NOT    - logical not (1's compliment)
  143.     #   :MIRROR - mirror image of bits
  144.  
  145. ---------------------------------------------------------
  146. CHANGES
  147.  
  148. Version 1.72
  149.  
  150.   *  ASCII and EBCDIC string literal input.
  151.   *  History list dialog implementation completed.
  152.   *  Bug fix: "Show keypad tool tips" toggle now works.
  153.  
  154. Version 1.71
  155.  
  156.   *  Repackaged to use the shared FlLib OPM.
  157.  
  158. Version 1.7
  159.  
  160.   *  Osaris compatibility.
  161.   *  Enhanced input buffer scrolling.
  162.   *  Colour application icon.
  163.  
  164. Version 1.6
  165.  
  166.   *  Improved Revo support.
  167.   *  Easier to read display font.
  168.   *  Installable on drive E:
  169.   *  Minor enhancements.
  170.  
  171. ---------------------------------------------------------
  172. DISCLAIMER AND COPYRIGHT
  173.  
  174.   1) FlCalc is Freeware and copyright; it is not public
  175.      domain. The rights to this package remain the
  176.      property of the author.
  177.      
  178.   2) You may use this software, free of charge, for an
  179.      indefinite period and at no obligation to the
  180.      author.
  181.      
  182.   3) Permission is given to publicly distribute this
  183.      software provided the distribution contains all, and
  184.      only, the unaltered files of the original
  185.      distribution, the ownership of the rights to this
  186.      software is clearly stated and any fee charged is
  187.      extremely nominal.
  188.      
  189.   4) Use of this software is entirely at the user's own
  190.      risk. The user must accept responsibility for any 
  191.      direct or indirect loss or damage arising from the 
  192.      use (or misuse) of the package. This software is 
  193.      supplied "as-is".
  194.  
  195.   5) Note: The OPM file employed by this software (and
  196.      included in this distribution) is the copyright of
  197.      Mark O'Neill. Please see his WWW site,
  198.  
  199.      http://www.i27.com/
  200.  
  201.      for more details.
  202.  
  203. ---------------------------------------------------------
  204. CONTACTS
  205.  
  206. If you have any problems, comments or suggestions about
  207. this software, you can contact me at the following email
  208. addresses:
  209.  
  210.      dave@freepoc.org
  211.  
  212.      dave@piecafe.demon.co.uk
  213.  
  214. This application is distributed in association with
  215. FreEPOC:
  216.  
  217.      http://www.freepoc.org/
  218.  
  219. For the latest news of this an my other software, also
  220. visit:
  221.  
  222.      http://www.piecafe.demon.co.uk/
  223.  
  224. ---------------------------------------------------------
  225. Dave Rushall, 2001
  226.