////////////////////////////////////////////////////
            /                                                   /
            / A C A L C    v 1 . 1    D O C U M E N T A T I O N /
            /                                                   /
            ////////////////////////////////////////////////////
                                                               

                              by  David Schweikert or CYBORG
 


 		1. COPYRIGHT
 		2. INTRODUCTION TO RPN
 		3. THE PROGRAM
 		4. COMMANDS
		5. THE IMPROVEMENTS IN THIS VERSION
 		6. FUTURE IMPROVEMENTS




1.  COPYRIGHT

There's no Copyright ! --->>> Spread-it ! But not for money, or you are
really a thief: a thiny Public Domain program is not payable !
ACALC (1.x versions) is Public Domain.

2. INTRODUCTION TO RPN

This is a pre-version ! Report bugs to:

      David Schweikert
      Villa Elvezia
      6914 Carona CH
      TEL: 091 686647

The RPN logic is:
 	   _________________________________________
 	  /                                        /
 	 /  WORK WITH 2 NUMBERS AND AN OPERATION  / 
 	/________________________________________/  

OK, now the examples:

 - You want to calculate (5+2)*2
   You write : '5 2+2*

 - You want to calculate 5+(2*2)
   You write : '2 2*5+
      or     : '5 2 2*+

 - You want to calculate (3.2+4.8)*(-15+23)
  (the negativ sign (-) is typed in Acalc with (_) !
   You write : '3.2 4.8+_15 23+*'

     THAT'S : ([E] for ENTER)
       
    3.2    [ ] or [E]    4.8    +    _15    [ ] or [E]    23    +    *
     |                    |     |     |                   |     |    |
     |                    |<----+     |                   |<----+    |
     +--------------------+           +-------------------+          |
               8                                8                    |
               |                                |<-------------------+
               +--------------------------------+
                                64


 I think now is OK ! Or not ? If not write me a message in AUGL or ACCU or
 TIME WARP to David Shweikert or in Pirates CH BBS to CYBORG !

 
3. THE PROGRAM

First : ACALC is :  A D V A N C E D    C A L C U L A T O R   1 . 1  .

ACALC work with full RPN logic: a small window appear and You write the RPN
expession...
Only 2 things : The negativ sign with (_) and remember that the program
work interactive and you can't write words (ex sinus with sin,...)
For the 2nd thing see the Commands help...

4. THE COMMANDS

OK: Here's the list (I've write it two times: only commands in file
com.doc, for example to write them to printer...):


   [ESC] QUIT 
    [_] For negativ sign (ex: _4.52 is -4.52)
  [d] LAST NUMBER    [<-] DELETE 
  [P] Program  [X] Execute a Program
  [Y] Execute the program in memory.
  [v] View X and Y  [V] View only X
  [p] POWER	ex: '3 4p  it's 3*3*3*3 
  [r] RADICAL ex: '3 4r' it's the 4th radical of 3 
  [q] 2nd RADICAL ex: '4q' its' the 2nd radical of 4 
  [s] SINE     [S] ARCSINE     [h] HYPERBOLIC SINE 
  [c] COSINE   [C] ARCCOSINE   [j] HYPERBOLIC COSINE 
  [t] TANGENT  [T] ARCTANGENT  [k] HYPERBOLIC TANGENT 
  [z] ARCTANGENT of x/y        [Z] COTANGENT 
    ALL is expressed in radians... 
  [f] Removes integer part of x. (fractional part)
  [i] Removes fractional part of x. (integer part)

5. PROGRAMMATION

Here's the most powerful thing, U can enter complicated programs, but it's
parhaps difficult to begin...
The technique is the same of interactive calculation.
A lot of other functions R improved. f.e. 'I' is Input + charcater
Ex: Ia3* is Input a * 3 or simple  a*3. Only a character after I !
The list of programming functions is at end of this chapter.
Another example: A program that calculate the circle area with the
formula  pi * r ² :
Ir2p3.14* 
112233334

Ok, that's:
1)   Input r
2)   2 power function
4-3) *3.14

Have U understand ? No ? Impossible...

To Write a program: Run ACALC, type 'P' and write the program's name.
Then U have PRG>>>. Write Ur program and press RETURN or ENTER.
To Run a program: Type 'X' and write the program's name.

Because U R so good to learn, yet a complicate program:
To calculate IIdegree equations.
IaIbIcRb2pRa4*Rc*-MdK0<GnqRb-Ra2*/MyRd_Rb-Ra2*/MxWResult:)vQLnWNOT A REAL EQ)Q
|----||------------||---||---------||-----------||---------||----------------|
  1         2         3       4           5           6              7


Do not desesperate ! It's not very hard and I think U can do most complicate
progs, the explication:
1) Easy: The inputs of a,b,c.
2) Calculates delta (b²-4ac). R is simply to "recall" variables.
   M memorise the current result on a variable (d=delta).
3) K0= Is a test. The test R expressed in : K + 0 or y + =,<,>,!.
   K0 do a test with current_result(x) ? 0. and ? is replaced by =,<,>,!:
   the tests to execute. Ex:
   K0< tests if x<0.
   K0> tests if x>0.
   K0! tests if x is not 0.
   Ky< tests if x<y. (x is the current_result and y the last...)
   Ky! tests if x is different of y. 
    ... and so on...

   So if the contition is not valable, Acalc jumps 2 characters.
   And if it is valable, Acalc do nothing...
   In this program The Gn function is executed only if x < 0 (if the
   current value is negativ).
   G is GO! The Gn function jumps to label n, marked with
   Ln (n can be a,b,c,d,e,g,h,...). In this program if K = 0 the program
   jumps to sequence 7.
4) Calculates (-b + square-root of d)/2a. d is not called with
   Rd because it is the current_value, the result of 2).
5) Calculates (-b - square-root of d)/2a. d is now recalled.
6) W writes a string (see 7).
   v shows x and y.
   Q ends the program.
7) Ln : Label n. Executed if x<0 on 3).
   W writes a string, end of the string with ).
   for example WHello Acalc fans !) print Hello Acalc fans!.
   Q ends the program

In this version U should end Ur program with Q ! This one simply Writes
 ">>>" and ends the program.

So to end a program : (Hints)
1) Write a thing
2) show X & Y or only Y
3) end with Q
Each point is a line.

If U don't understand, write a message to CYBORG in most popular Swiss-
Pirates BBS. Or Write me a letter !

Now the list of PROGRAMMING FUNCTIONS:

c is a character.

 Ic - Inputs c         Rc - Recall c
 Mc - Memorise c       Xc)- Execute c program to end ')'. The current is lost.
 K0c- Test if xc0 (c can be =,<,>,!) \ If not jumps 2 characters. 
 Kyc- Test if xcy (c can be =,<,>,!) /
 Gc - Goto label c     Lc - Label c
 Ac - Turns flag c on  Dc - Turns flag c off
 Fc - Tests if flag c is on. Same as K
 Wc)- Prints c (a string) to end the string ')'

5. IMPROVEMENTS IN THIS VERSION

Oh, A lot of things, but not bugs (only thiny ones), so report them...
1) I implementes a most beautiful aspect, three lines R now visible, but
   I've not only resized it, All is adeguated and the interactive operations
   R now visible...
2) When a program is running the display is disabled, so it's very important
   to write in Ur program 'v' or 'V' at the end, to show the result.
3) A new command : 'Y', it's simply a execute command, but of the
   program in memory, so if U want to run a program more times, U type
   first 'X' and the name, then only 'Y'.
4) U can execute programs from a program, the current will be lost and the
   new runned. U should type Xc), where c is a string (the name), to end
   the string type ')'.
5) Some internal operations semplified.

         I know they R not very big improvements, but they R comfortable... 

6. FUTURE IMPROVEMENTS

 I think a lot of things:
FIRST£ THE BUGS ! I do improvements improvements, but really important R
the bugs, and I think there is big bugs... ZZZZZZ.... pic.. 
for example radians to degree converter,
base converter and much much other.
All that in Official release 1.x (!) !

                              If You have any suggestions...
 
                                                      David Schweikert