--------------
MUTISTACK 1.07
--------------

MultiStack 1.07 is provided as-is, freely, and without any warranty of 
any kind.  I am not responsible for any kind of damage this product 
might cause.


MultiStack 1.07 copyright 1998 Matias Mutchinick. All rights reserved.


INDEX

1) What is MultiStack?
2) Features
3) What are the stack terminals?
4) Display Status Section.
5) Instructions
6) The [stk] global variable.
7) How does it works?
8) The Stack Display Cache.
9) Installing.
10) Un-installing.
10) Credits
12) A few words from our sponsor.
13) Versions

----------------------------------------------------------------------------------------------

1.-  What is MultiStack?

MultiStack is a stack replacement program.


2.-  Features.

5 / 4 -line stack (see readme.txt).
4 / 5 / 7 / -line interactive stack (see readme.txt)
10 stack terminals.
Customizable CST menu for each one of the 10 stacks
Improved Status Display.
Cache to speed-up the display of algebraics, lists and arrys


3.- What are the stack terminals?

The stack terminals are 10 separate stacks that this program allows 
you to work in. You can switch between them and then go back to them; 
all the items on the stack's will remain untouched.
Also in each of the 10 stack you can have the built-in CST menu
plus a particular CST menu.




4.-   Display Status Section.

Here you will see.

RAD, DEG, GRD                   these are angle measures.
XYZ, R<Z , R<<                  these are coordinate systems
HEX, BIN, DEC, OCT              referring to the BASE you are in.
   , I  ,[I]                    Card I, no, yes, covered
   , II ,[II]                   Card II,no, yes, covered
US1, USR                        NORMAL,1USR, USER modes
ENT                             ENT refers to 63 sysflag. Custom Enter 
ALG                             ALG mode
PRG                             PRG mode.
   

You will also find a little number at the left and bottom of the 
status section; that number goes from 1 to 0 and refers to the stack 
terminal you are in.


5.-  Instructions.

I have defined a macro for all the special functions MultiStack 
provides.

To enter this macro, hit RIGHT SHIFT and then UP-ARROW.  You will see 
a little arrow on the status section pointing right. You 
are in the macro.




5.1 - Activating and Deactivating MultiStack

To activate MultiStack     [MStk]
To deactivate MultiStack   [MStk]

5.2 - Switching stacks.

To switch stacks, press..
RIGHT SHIFT then UP-ARROW and finally a number from 1 to 0.




5.3 - Defining a special CST menu

To define a special CST menu press...
RIGHT-SHIFT then UP-ARROW then LEFT-SHIFT and then CST
You will see the following menu displayed.

[ACST][DCST][RCST]
 

[ACST]   Assigns menu, works with a list, as the built in CST menu
	     (see the HP48 series manual for references).

[DCST]   Deletes the special CST menu. Needs no argument.


[RCST]   Recalls the special CST menu. Needs no argument.


The special CST menus, only work on the stack terminal in which you 
defined it, not in any other stack terminal.  In any of the stack 
terminals, you have access to the Built-in CST menu plus the special 
CST menu.


5.4 -  Activating special CST menus.

To activate a special CST menu press....

RIGHT- SHIFT then UP-ARROW and then the CST key.
The special menu you have previously defined, will be displayed.




6. - The [stk] global variable.

You will see at any time a variable named [stk], this variable keeps 
track of the stack terminal you are in.  You can purge and modify this 
variable, but it will never go away.  The variable holds a BINT 
referring to the stack number, if you change this variable for any 
other thing that is not a bint from 1 to 0, it will be set to 1.  You 
don't have to worry about purging it or changing it by mistake, your 
calc won't crash, and the worst that can happen is to lose the 
contents of a stack.

You might not like having this variable all the time, but believe me, 
it's better than a Temporary Variable, because this way the other 
stacks will survive warm starts and all that stuff.

Why is it not hidden?
Because that way it is more accessible and it looks cute.


7.0 How does it work?

It's actually very simple.
Every time you change from a stack terminal to another this program 
will store the actual stack in the hidden dir, and recall the target 
stack to the stack.

The stacks are saved in with a forbidden name, this way it's more 
difficult to have them deleted by mistake.  Also, the CST menus work 
that way.

When you have big items on the stack like 60000k or many items like 
5000 and you change stacks, there is always the possibility to lose 
information.  I have protected this to happen in any way I could, but 
its hard for a computing device to work well at memory overflow.
This happens very very rarely.

8.0 - The Stack Display Cache

That function of the Stack Display Cache is to speed up the display of
Algebraics, Lists, Arrys. This are the objects that take longer to decomplile
into strings, and when you have one of this objects on the stack it takes a lot to display.
Basicaly what the cache does, is once the object has been decompliled into a string, its kept
in a variable in the hidden dir, and then instead of decompiling the object again, the string
from the cache is used.
The Cache size is 7 objects.
The objects with the string are stored on the var cache[MStk] on the hidden dir.
*DO NOT MODIFY THIS VARIABLE*


To setup the cache press the [CACHE] key on the library and a menu will be displayed.

[ALG] wont use the cache on algebraics        ; user flag 10 clear
[ALG*] will use the cahche on algebraics     ; user flaf 10 set  

[ARRY] wont use the cache on arrys        ; user flag 11 clear
[ARRY*] will use the cahche on arrys      ; user flaf 11 set  

[LIST] wont use the cache on lists        ; user flag 12 clear
[LIST*] will use the cahche on lists      ; user flaf 12 set  

[CLEAR] clears all objects stored on the cache
[PURG] purges cache[MStk] var on the hidden dir.

Remember that the objects as well as the string of the object are stored on the cache, be aware
of the size of the objects, you are using, for example... 
if you are using very large lists this takes a lot of space, so if you are not using the 
same list over and over again, its better to turn of the cache for the lists.

 
9.0 - Installing MultiStack


a) Download the .lib  file you want to install to your hp48
b) Recall the library to the stack (library ID 1742).
c) Put the number 0 on the stack
d) Press  STO
e) Turn off and then on your calculator.
f) You can now purge the variable containing the library
g) Enjoy.



10.0 -  Un-installing MultiStack

When you don't want to use anymore MultiStack and you want to clear it 
from your calculator......

You will have to purge the stack terminals from the hidden dir.

I have added an uninstall to do all this.

This routine will only work if the string "UNINSTALL" is
in the level 1 of the stack.
And then you just have to type UNMStk or press [UNMStk]


To purge the lib.

First deactivate the MultiStack
Type....
1742 DETACH   and then  
:0: 1742 PURGE



11.-  Credits.

I would like to thank:

Victor Achiaga, for helping me and advising me in programming.
Eric Rechlin, for Suggestions, encouraging me to release this one, and 
Testing.
Roberto Perez Franco, General Manager of MultiStack Panama.

12. - A few words from our sponsor.

First of all thank you for using MultiStack.  I hope you like it.
MultiStack is not an incomplete product, but I will still continue 
to improve it and update it, so any comments, suggestions, complains, 
questions, etc. are welcome.  There are no known bugs.


Matias Mutchinick Babinsky.
mmb@quetzal.innsz.mx
http://www.datos.com/hp48/


13. - Versions

*Version 1.06*
-Faster Interactive Stack
-Added REV to Interactive Stack
-Fixed bug on un-installing routine
-Improved the stack switching routine, now it doesn't saves empty stacks

*Version 1.07*
-New Chache to speed up the stack display.
-Fixed minor bug on mstk55106.
-Improved some routines to make it work better.




