			DOORS Version 1.8
		     for TI 89 or TI 92 Plus
	    compiled for Doors OS 0.85/Plusshell 1.0
		       Copyright (C) 1998
			  Xavier Vassor
			Cdric Couffignal

e-mail: 	xvassor@mail.dotcom.fr <or> deucalion@mail.dotcom.fr
web site: 	http://doorshome.home.ml.org

			All rights reserved

THIS TEXT FILE DESCRIBES ALL THE IMPORTANT FEATURES OF DOORS, SO PLEASE READ CAREFULLY!

******************** Default Password: "doors" ***********************


SUMMARY
-------

1.1  INTRODUCTION AND REQUIREMENTS
1.2  FEATURES
1.3  USING THE SHELL
1.4  USING THE LIBRARIES
2.1  HISTORY
2.2  KNOWN BUGS
2.3  THE AUTHORS
2.4  CONTACT US !


-----------------------------------------------------------------------
1.1 INTRODUCTION
-----------------------------------------------------------------------

Doors is an Explorer that allows you to browse the TI92+ files and folders
and modify or protect them.  You can of course run ASM programs.
You can run the Doors shell by pressing Shift-ON

It is composed of the shell and four libraries : 
	- graphlib -> graphical functions
	- userlib  -> password functions, and others
	- filelib  -> file manipulation functions
	- ziplib  -> compression functions
        
To run Doors, you must have:
	- A TI89 or TI92 Plus with Doors OS 0.85 Beta or Plusshell 1.0 Alpha
	- The four libraries: graphlib, userlib, filelib, ziplib
	- A reasonable amount of memory free.


If you love Doors, hate it or just want to give us your two cents, e-mail us !     
<xvassor@mail.dotcom.fr>
<deucalion@mail.dotcom.fr>

-----------------------------------------------------------------------1.2  FEATURES
-----------------------------------------------------------------------

	- Lots of file operation functions!
        - 3 levels of file protection!
        - Integrated password protection!
	- Compression!
        - Multiselection!
        - Filters!
        - You can view and manipulate protected variables/folders after typing the Doorspass.
	You can unprotect them in that mode only.
        - You can view TEXT variables just by pressing "Enter" when selected if you have 
	XeTal or QV 1.91 on the calculator.
        - You can view PIC variables by pressing "Enter" when selected if you have 
	Doors picture viewer 1.0 on the calculator.
        - You can define hot-keys to programs, text and pics !  If a program is associated with a hot-key, you can even rename, move, lock or hide it. It will always be accesible with the hot-key. The only thing you can't do is to load it from a computer *after* you define it as a hot-key. You will then have to delete the hot-key and to define it again.
        - Displays the comment of a program in the status line when you select it
        - Displays the free memory at the bottom of the screen
        - Optional shell bolt
        - Pressing a [A - Z] char will go to the variable who has that char as its first letter

-----------------------------------------------------------------------1.3  USING THE SHELL
-----------------------------------------------------------------------
When you first get it going, it displays a list of all the folders on your calculator. Then pressing the "Enter" or "Right" keys while a folder will show you the contents of that folder. When the file list is displayed you can press the "Left" key to get back to the folder list, 
or press "Enter" to execute a program.

You can access many functions with Keyboard Keys or access them with menus.

Here are the keys used in the Doors Explorer
	F1 -> Displays the File menu
	F2 -> Displays the Options menu
	F3 -> Displays the Security menu
	F4 -> Displays the Select menu
	F5 -> Displays the About dialog box
In the menus, you can access menu items pressing 1,2,3.. keys.  (It's much faster!)

Keys:     
	2nd UP and 2nd DOWN -> Scrolls up or down 8 items (6 on TI 89)
	2nd R -> Renames a file or a folder
	2nd Y -> Copies a file to another folder
	2nd M -> Moves a file to another folder
	2nd W -> Creates a new folder
	2nd L -> Locks or Unlocks a file or a folder
	2nd H -> Hides or Unhides a file or a folder
	2nd P -> Protects a file or a folder
	2nd T -> Displays the protected variables/folder list after asking the Doorspass
	2nd K -> Defines a new Hot-Key
	2nd D -> Removes a Hot-Key
	2nd Q -> Displays the required library list for a library or prog
	2nd / -> Selects all items
	2nd * -> Deselects all items
	2nd F -> Displays the Filters box
	F6 -> Selects an Item
	F7 -> Protects the TI 92+ with a password
	F8 -> Shuts down the TI 92+
	BackSpace -> Deletes a file or a folder
Pressing an alphabetical char will go to the variable beginning with that char.


Filters:You can define filters pressing F2(View menu) and selecting the Filters item.
	Then you will have to choose the file type you want to be shown.
	Press Left-Right to select, Enter to make your choice effective

Shell bolt: You can choose to bolt the shell. If you do so the Doors password will 
	be asked each time you launch the shell. You can switch ON/OFF this feature pressing
	F3(Security) and selecting the Shell bolt item.

Multiselection: Pressing F6 will select/unselect a variable. When you use the Delete, Protect, Copy, Move, Lock/Unlock, Hide/Unhide, Zip/Unzip functions, it will be used on all the	selected variables.

NOTE: the default password is "doors"
-----------------------------------------------------------------------1.4  USING THE LIBRARIES
-----------------------------------------------------------------------

You should read the .h files contained in the .zip file in order to understand how to use them.  We encourage programmers to use our libraries for their programs.  We think they can be as useful for them as they are for us.


-----------------------------------------------------------------------2.1  HISTORY
-----------------------------------------------------------------------

1998.11.15
        - Doors v1.8 released:
	- Ported the explorer to TI 89 !!
	- Added support of compression !! You can zip/unzip a file from
the menus, or with 2nd-I.
	If you run or view a zipped file (ASM, TEXT, PIC), it will be
automatically unzipped !
	The compression library ziplib has been programmed by Marc Teyssier.
	- Viewers can be in any folder.
	- Doors recognises archived vars now. But still can't Archive/Unarchive them.
	- Now you can add a hot key to a PIC or a TEXT variable too.


1998.10.25
        - Doors v1.71 released:
        - Ported the explorer to TI92+ !

1998.06.04
        - Doors v1.71 released:
        - It always displays 1.7 in the About box because there are only a few changes
        - When you try to delete a folder that contains variables, it now
	displays a error box
        - We fixed a bug in Doors92 which caused the calc to crash. 
        - We optimised a little Doors92 (2650 bytes now)

1998.05.27
        - Doors v1.7 released:
        - Added a Select menu(F4)
        - Now the F6 key selects an item (instead of F5)
        - Added an internal STRING viewer:
        When you highlight a STR variable, its content is displayed in the status line.
        - The Doors.92p program has been improved a little: optimisation,
	and a few small features added: 
        - you can run the shell selecting the 'Explorer' item
        - you can press Left or Right to choose your item in the menu
        - Fixed a small bug when the free memory was displayed
        - Now with graphlib you can choose the adress of the screen: so
	you can if you want use graphlib with grayscales !!


1998.05.08
        - Doors v1.6 released:
        - The memory free is now displayed at the bottom of the screen!
        - Added the getfreemem function in userlib
        - The protect feature has been modified: you can always protect 
	a variable/folder with Protect, but:
	        - you can enter the protected variables/folder list
	with Unprotect (F3 Menu or 2nd+T), after asking for the Doorspass
	        - To unprotect them definitely, first enter the 
		protected variables/folder list and then use Unprotect again on one or more 		variables/folders(it works with multiselection)
        - Changed a key, now it is:
   	2nd T -> Displays the protected variables/folder list after asking the Doorspass
        - fixed a bug in graphlib::put_sprite_mask
        - The shell is a bit smaller now (optimisation)

1998.05.03
        - Doors v1.5 released:
        - You can view and manipulate protected variables/folders
	without unprotecting them !(just enter the Doorspass). Filters even work in this mode !
        - We completely changed the put_sprite function, and we added a 
	put_sprite_mask function. Take a look at graphlib.h to see what has changed
        - Added a pic viewer: Doors picture viewer 1.0 (only 200 bytes !!)
        - When program execution fails, it displays an error message at
	the bottom of the screen
        - A new icon for pictures
        - Changed and added some keys, now it is:
		2nd W   -> Creates a new folder
                2nd /   -> Selects all items
                2nd *   -> Deselects all items
                2nd F   -> Displays the Filters box
        *NEW*   2nd V   -> View protected vars without unprotecting them

1998.04.23
        - Doors v1.4 released:
        - Doors is now compatable with XeTal: you can press Enter on a
	TEXT variable, and the shell will automatically launch XeTal with this variable !
        If you don't have XeTal in the main folder, pressing Enter will have no effect.
        - Lock/Unlock and Hide/Unhide work with multiselection !
        - Pseudo-libraries(tios,kernel) aren't diplayed anymore 
	in the required libraries box
        - changed a little the password protection:
                You must confirm your new password when you change it,
	and now the password is echoed with stars (*).
        - filelib has been reprogrammed: it's a little smaller now but
	manages more errors(memory,duplicate name,invalid name..).
        - fixed two small bugs

1998.04.05
        - Doors v1.3 released:
        - Multiselection!
        - Temporary folders(such as 0001,9999..) are not displayed so that
	you can't manipulate them (that could cause a crash)
        - Pressing 2nd-Q on a FARGO II prog or library displays the list of required
	libraries.
        - Different icons for FARGO progs, libraries, and text variables.
        - When asking the Doorspass,the bad guy can no more press 2nd-Lock-On to
        reset the calc. What's more if you wait more than a few seconds,
        the TI shuts down again.
        - Fixed a bug that sometimes caused a crash.
        - Optimised the speed.
        - If a file is in use, you can't Delete, Copy, or Move it, it
	diplays an error box.
        - If you want to Rename/Create a folder and you enter the name
	of an existing var, it now displays an error box. In the previous versions,
	it just didn't do it
        - If you want to manipulate a locked or hidden file, it doesn't
	flash the variable anymore, it only displays an error box.

1998.03.15
        - Doors v1.2 released:
        - Filter options added !
        - You can define Hot-Keys to FARGO programs ! You will then only have to 
	type the Hot-Key to run the prog !
        - The program comment is displayed in the status line !
        - Optional shell bolt !
        - You can access to menu items pressing the 1,2,3,4,..keys:
  	For example you can press F1 / 5 in the shell to create a new folder
        - added a filelib::gettype function which returns the type of a given file
        - fixed some bugs

1998.03.01
        - Doors v1.01 released:
        - Fixed a few bugs
        - SORRY : we forgot to write the default password in Doors.txt! It is "doors".

1998.02.28
        - Doors v1.0 released

-----------------------------------------------------------------------2.4  KNOWN BUGS
-----------------------------------------------------------------------

        For now there is one known bug. 
	When you use the "Hide" function on a folder, but you don't hide its
	contents, the files contained in this folder sometimes appear in the Var-Link.  
	To correct this error, you should "Hide" the contents of the folder too.

-----------------------------------------------------------------------2.5  THE AUTHORS
-----------------------------------------------------------------------

This program was created by the Doors Team:
	- Cdric Couffignal
	- Xavier Vassor

The distribution of Doors is encouraged, as long as all the files are kept together, unmodified from the form in which they were originally released.


-----------------------------------------------------------------------
2.6  CONTACT
-----------------------------------------------------------------------

Thanks to:
        - Jimmy Monin 
        - Christophe Fondacci 
        - Noah Zoschke
        - Chris Johnert
        - Antoine
        - Jean
        - Henri Fallon
        - Klaus
        - Pierre
        - Cyprien
        - Buggy
        - Marc Teyssier for his ziplib library
	- Aaron King who improved this text file.
        - Sacha Kaercher for XeTal

for their suggestions/bug reports/help/anything else


The Official Doors Homepage:
http://doorshome.home.ml.org

On this site you'll always find the latest info on Doors, beta versions, and more, so check it out!

If you any suggestion, any bug report,any question don't hesitate to mail us at:
Xavier VASSOR           <xvassor@mail.dotcom.fr>
Cedric COUFFIGNAL       <deucalion@mail.dotcom.fr>