home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 63 / af063sub.adf / ACalc / ACalc.doc < prev    next >
Text File  |  1993-09-12  |  8KB  |  199 lines
  1.  
  2.  
  3.                              ACalc - User's Manual
  4.  
  5.  
  6.  
  7.  
  8.  
  9. AboutThisDoc
  10.    
  11.           This manual describes  release  1.21  of  the  utility  ACalc.  This
  12.   program is (c)1993 by  Denis  GOUNELLE,  any  commercial  usage  or  selling
  13.   without author's written authorization is strictly forbidden. You  can  copy
  14.   and spread this program under the following conditions:
  15.  
  16.         - all the files are provided
  17.         - the files are not modified in any way
  18.         - you don't charge more than $6 for copy fee
  19.    
  20.           In spite of several tests, no warranty is made  that  there  are  no
  21.   errors in ACalc. YOU USE THIS PROGRAM AT YOUR OWN RISK. In no event  will  I
  22.   be liable for any damage, direct or indirect, resulting of the use of ACalc.
  23.    
  24. Introduction
  25.    
  26.           ACalc is a calculator that may be used both in floating  point  mode
  27.   (double precision IEEE) and in based mode (decimal or hexadecimal).  It  may
  28.   appear on any screen, and can be installed as  a  commodity  with  Kickstart
  29.   2.04 or greater.
  30.  
  31.           Criticisms and suggestions will always be welcomed. Write to:
  32.  
  33.                                M. GOUNELLE Denis
  34.                                     Boite 71
  35.                               6, rue des cailloux
  36.                              92110 CLICHY - FRANCE
  37.    
  38.           You can also send a message to  the  following  Internet  address  :
  39.   "gounelle@alphanet.ch". Note that this mailbox is not mine, so  please  send
  40.   only short messages. As I don't have direct access to  the  messages,  don't
  41.   expect an answer before a dozen of days.
  42.    
  43. Installation
  44.    
  45.           ACalc needs the  "mathieeedoubbas.library"  library,  which  may  be
  46.   found on system disks provided with your Amiga. Under  Kickstart  1.3,  just
  47.   copy the program in a directory included in your  path  (e.g.  "C:").  Under
  48.   Kickstart 2.04 or greater, you may want to install ACalc as a commodity, and
  49.   copy it in the "SYS:WBStartup" directory.
  50.  
  51. Running_from_CLI
  52.    
  53.   ACalc detach itself from CLI. Command line arguments may be:
  54.  
  55.       CX_PRIORITY n (ignored under Kickstart 1.3) 
  56.           Set the commodity priority.
  57.  
  58.       CX_HOTKEY key (ignored under Kickstart 1.3) 
  59.           Set the commodity hotkey. Default key is "ctrl esc".
  60.  
  61.       NOCOMM (ignored under Kickstart 1.3) 
  62.           Prevent ACalc to install itself as a commodity. The program will
  63.           terminate as soon as you click on the close gadget.
  64.  
  65.       SAVEVAR 
  66.           Ask  ACalc  to  save  expression  results  in  an  environnement
  67.           variable,  instead  of  the  clipboard.  The  variable  name  is
  68.           "ACalcResult". 
  69.    
  70. Running_from_Workbench
  71.    
  72.   The following arguments may be specified in the "TOOL TYPES" of ACalc  icon:
  73.    
  74.       CX_PRIORITY=n (ignored under Kickstart 1.3) 
  75.           Set the commodity priority.
  76.  
  77.       CX_HOTKEY=key (ignored under Kickstart 1.3) 
  78.           Set the commodity hotkey. Default key is "ctrl esc".
  79.  
  80.       NOCOMM (ignored under Kickstart 1.3) 
  81.           Prevent ACalc to install itself as a commodity. The program will
  82.           terminate as soon as you click on the close gadget.
  83.  
  84.       SAVEVAR 
  85.           Ask  ACalc  to  save  expression  results  in  an  environnement
  86.           variable,  instead  of  the  clipboard.  The  variable  name  is
  87.           "ACalcResult". 
  88.    
  89. Using_ACalc
  90.    
  91.           When called, ACalc opens a window  on  the  frontmost  screen.  This
  92.   window has a display area, and a 36 keys keyboard. Most of  these  keys  are
  93.   self-explanatory, so this section only describe some of them.
  94.  
  95.       Mode key (FLT,DEC,HEX) 
  96.           ACalc has three working modes: floating point mode (FLT),  based
  97.           decimal mode (DEC) and based hexadecimal mode (HEX). In the  two
  98.           based modes, ACalc use 32 bits unsigned integers.  Depending  on
  99.           the current mode, some keys may be disabled.
  100.  
  101.       d 
  102.           In HEX mode, allow to  specify  that  the  immediatly  following
  103.           number is a decimal number.
  104.  
  105.       h 
  106.           In DEC mode, allow to  specify  that  the  immediatly  following
  107.           number is a hexdecimal number.
  108.  
  109.       STO 
  110.           This key allow to store the currently displayed result in one of
  111.           the 10 available memories. After having selected this key, click
  112.           on one of the digits (0 - 9) to select the memory number. 
  113.           The memories are set to zero when the program start. If ACalc is
  114.           installed as a commodity, memory contents is  preserved  between
  115.           two invocations of the program.
  116.  
  117.       RCL 
  118.           Recall the content of a memory. After having selected this  key,
  119.           click on one of the digits (0 - 9) to select the memory  number.
  120.            
  121.       BS 
  122.           Delete the last character of the displayed expression or result.
  123.            
  124.       = 
  125.           Start the evaluation of the  current  expression,  and  displays
  126.           either the result or an error message. In both  cases,  you  may
  127.           recall the expression by pressing the right mouse button. 
  128.           The result may be immediatly used: if you click on  an  operator
  129.           (e.g. "+") ACalc will suppose  that  the  result  is  the  first
  130.           operand. Otherwise, the result will  be  deleted  because  ACalc
  131.           will suppose you want to compute a new expression. 
  132.    
  133.           Each time an expression is evaluated, it's result  is  automatically
  134.   saved in the clipboard. This allow you to use this  result  in  any  program
  135.   that also use the clipboard (like your word processor  or,  under  Kickstart
  136.   2.04 or greater, the Shell window if the "conclip" program is running). 
  137.           If you want to have the result saved in an  environnement  variable,
  138.   rather than the clipboard, you must call ACalc with the  "SAVEVAR"  argument
  139.   (see "Running_from_CLI" and "Running_from_Workbench" sections).
  140.  
  141. Using_the_keybord
  142.    
  143.           You can use ACalc not only with  your  mouse,  but  also  with  your
  144.   keyboard. If you want to use the keyboard,  you  can  either  click  on  the
  145.   display area and edit the expression as in any string gadget, or just  press
  146.   the key of your keyboard corresponding to the window's key  label.  In  this
  147.   case, you may also close ACalc window by pressing the "ESC" key. 
  148.           Some operators are to be entered and displayed in a different manner
  149.   (not as the key label): for example, the "NOT" operator is displayed as  '~'
  150.   (tilde). If you use ACalc with the keyboard, you must press the '~' key, and
  151.   not the 'N',
  152.  
  153.           mode            TAB key
  154.           NOT             ~
  155.           AND             &
  156.           OR              |
  157.           SHL             <
  158.           SHR             >
  159.           RCL             M (followed by memory number)
  160.           BS              BACKSPACE key
  161.    
  162.   The STO and CLR keys cannot be selected with the keybord.
  163.  
  164. History
  165.    
  166.           ACalc is written almost fully in C language, and was  developped  on
  167.   an Amiga 3000 UNIX-1 (10 Mb RAM, internal HD disk drive, internal hard  disk
  168.   of 100 Mb, external SyQuest drive of 88 Mb, external floppy disk drive, 1960
  169.   monitor and Star LC24-10 printer) connected by a null-modem cable to an A500
  170.   with 1 Mb RAM.
  171.    
  172.   v1.00   15-Avr-93, 19904 bytes 
  173.           o First released version.
  174.  
  175.   v1.01   26-May-93, 20140 bytes 
  176.           o  Bug  fixed:  display  wasn't  good  if  the   screen   font   was
  177.             proportionnal
  178.  
  179.   v1.02   29-May-93, 20148 bytes 
  180.           o Supports the "Show" command of the "Exchange" program
  181.  
  182.   v1.10   07-Jun-93, 21012 bytes 
  183.           o Tries to open the window under the mouse pointer 
  184.           o Better support of fonts: use the default text font for the window,
  185.             and the screen font for string gadget and window's title. 
  186.           o If ACalc is installed as a commodity, running  it  twice  make  it
  187.             appeared instead of terminate.
  188.  
  189.   v1.20   29-Jun-93, 20924 bytes 
  190.           o Modified gadget handling, in order  that  enabling/disabling  them
  191.             when changing working mode is faster  (was  terribly  slow  on  an
  192.             A500/A2000)
  193.  
  194.   v1.21   12-Sep-93, 20864 bytes 
  195.           o Uses new version of the GetDefaultTextFont() function
  196.  
  197.              
  198.  
  199.