========================================
                                 
                                    
                                         
                                                 
                                     
                                      
                                       
                             

                  =============- Version 1.2 -============


                      THE "EDCALC" CALCULATOR UTILITY


                             MARTIN REDDY, 1997



INTRODUCTION
~~~~~~~~~~~~

As  of  version  5.0,  the calculator feature of EdWord Professional  is  an
external  program which is run in the background every time you  select  the
"Calculator" menu option. This offers a number of advantages:

     1) The EdWord executable becomes slightly smaller (by about 17K)
     2) You can enter text into the editor while still having the
        calculator displayed
     3) You can use the calculator with other programs or as a stand-
        alone utility

By  default,  the EdCalc program must always be stored in the same directory
as  your EdWord executable because this is where EdWord will always look  in
order to find it. However, if you would prefer to keep EdCalc in a different
place,   then  you can use the -CDIR command line option of EdWord  (or  the
CALCDIR  WorkBench Tool Type)  to specify the directory which EdWord  should
search instead).


FEATURES OF EDCALC
~~~~~~~~~~~~~~~~~~
EdCalc  offers a new feature since the previous incarnation when  it  was  a
part  of  the EdWord program.  This is the "INS" gadget at the  top  of  the
button  bank.   Selecting this gadget (by clicking on it or  pressing  "I"),
will  insert  the  currently displayed value into the  current  document  of
EdWord.

This is done by use of the ARexx port of EdWord.  EdCalc sends a command  to
EdWord's  ARexx port to insert the current value into the current  document.
However,  this facility is not hard-wired into EdCalc and is quite  flexible
so  you  could quite easily customise EdCalc to work,  for example,  with  a
spreadsheet which offers an ARexx port so that whenever you clicked on "INS"
it inserts the current value into the current cell.

EdCalc  will  run  under all versions of Workbench (i.e.  1.2,   1.3,   2.0,
3.0...).   However,  under Workbench 2.0 and above,  the EdCalc window  will
sport  a "zoom" gadget which can be clicked on to iconify the calculator  to
a  title  bar  and back again to a full window (you can also use  the  Right
Mouse Button to the same effect).
           

EDCALC KEYS
~~~~~~~~~~~
All  of  the  gadgets  of the EdCalc window have keyboard equivalents.   The
numeric buttons can all be selected by pressing the corresponding  digit  on
the keyboard. The other gadgets can be selected as follows:

               DEL : CA
              HELP : CE
                 I : INS
               ESC : OFF
                 T : @DEC
                 S : STO
                 R : RCL
         Backspace : <-
                 ^ : ^
                 + : +   
                 - : -
                 * : ×
                 / : ÷
               TAB : +/-
        = or ENTER : =



COMMAND LINE OPTIONS
~~~~~~~~~~~~~~~~~~~~
The  following  is an explanation of all of the currently supported  command
line  options of EdCalc and how they are used.  N.B.  You can also call  the
program as "EdCalc ?" for a brief summary of the supported options.

 (Command line options are case independent, i.e. -Pub == -PUB == -pub)


 -port <ARexxPortName>
    
     This specifies the name of the ARexx port which will be used to send
     information to when the user clicks on the "INS" gadget. (e.g. The
     EdWord ARexx port is usually called "EDWORD" - refer to the About
     menu option to find out for sure.)

 -cmd <ARexxInsertCmd>

     Once we know the actually ARexx port to send the information to, we
     also need to know the name of an ARexx command which is supported
     by that ARexx port. This is the command which is passed the actual
     information when "INS" is selected. (e.g. The "InsertText" command
     is offered by the EdWord ARexx interface and will insert a piece
     of text into the current document. Therefore, if we specify this 
     as the desired command, then whenever we click on the "INS" gadget,
     EdCalc will send an InsertText command to the EDWORD ARexx port 
     with instructions to insert the current value into the editor).
    
 -pub <PublicScrName>

     By default, EdCalc will open on the top-most screen. If you wish to
     specify a Public screen for it to open on, then you can use this
     command line option. (e.g. The EdWord custom screen is a Public
     Screen and is usually called "EdWordScreen"). Workbench 2.0 only!

 -screen <ScrAddr>

     This is another option which will let you open EdCalc on another
     screen. This time you have to know the actual address of the 
     desired "Screen" structure, i.e. the value returned by OpenScreen().
     This is a much more powerful command as it will let you open EdCalc
     on ANY screen, but you have to have access to that screens address
     first of all. (This is probably on possible if you have written 
     the program which opens the custom screen).

 -s1 <shadow1col>

     Specifies the colour to be used as the Bottom/Right edges of the
     3D look gagdets (usually black). <shadow1col>=0..noofcolours

 -s2 <shadow2col>

     Specifies the colour to be used as the Top/Left edges of the 3D
     look gagdets (usually white). <shadow2col>=0..noofcolours

 -back <background>

     Specifies the colour to be used for the background of the window.
     <background>=0..noofcolours

 -pen <pencol>

     Specifies the colour to be used as the Pen colour (i.e. the
     colour which all text is displayed in). <pencol>=0..noofcolours

 -gad <gadgetcol>

     Specifies the colour used to fill the gadget buttons of the
     calculator. <gadgetcol>=0..noofcolours

 -title <windowtitle>

     Specifies the name of the program which is displayed in the title
     bar of the calculator. The default title is "EdCalc V1.2".