////////////////////////////////////////////////////
            /                                                   /
            / 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


          WORLD SPREADING BY LABYRINTH BBS OF CHRONOS ++4191574138 
                  CALL US FOR THE LASTEST ELITE NEWS!!!!!


 		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