**************************************************************************

			 boolsoft presents
	     ________        ________        ________ 
 	    |   ___  |      |  ______|      |   ___  |
 	    |  |   |  |    |  |             |  |   |  | 
 	    |  |___|  |   |  |              |  |___|  | 
            |   _____|   |  |               |   _____|
	    |  |          |  |              |  |
	    |  |           |  |______       |  |
	    |__| O W E R    |________| O M  |__| R E S S

 	             -  PowerComPress  v0.9 -

		        for 68k-calculators
			    
			    14.10.2005
			    by  saubue

**************************************************************************

PowerComPress is a fast and powerful file compression tool, based on the
BriefLZ-algorithm of Joergen Ibsen and featuring a graphical browser based
on Advanced Dialogs. You can compress files to nearly unlimited-sized GroupFiles
(if they are too large, they will be splitted), view them inside the
GroupFiles and decompress them. PowerComPress additionally supports TIOS
file actions ((un)archive, delete) and two themes for the browser.



Contents
********

I.    Requirements
II.   Installation
III.  Usage & Keys
IV.   Credits
V.    Contact
VI.   Known Bugs
VII.  ToDo-list
VIII. History



I.   Requirements
*****************

> 68k Texas Instruments calculator with HW 2 or HW 3
  (TI89, TI89Titanium, TI92+ or Voyage200 PLT)
> Operating System: AMS (min. 2.00)



II.  Installation
*****************

 You have to send two files to your calculator - "pcpress" (the launcher) and
"pcppack" (the ExePacked program). On your PC, these files are both named
"PowerComPress" ("PowerComPress.XXz" and "PowerComPress.XXy"). These files
can be found in the directory "bin" of the "PowerComPress.zip"-file.

 All you have to do is to send the files of the correct directory to your calc
(e.g. if you have a TI89 you send the files in the directory "TI89") using
a linking program like TIConnect or TiLP. It's recommend to archive both
files on your calculator because of the limited RAM.

 To launch PowerComPress on your calculator, type "pcpress()" into the status
line at your HomeScreen. PowerComPress is a nostub program, so you do not need
a patch or a kernel.



III. Usage & Keys
*****************

Key(s)         |  Function
---------------|--------------------------------------
[UP]/[DOWN]    |  Browse files
[F1]           |  Open menu "File"
[F2]           |  Open menu "Options"
[F3]           |  Show credits
[F4]           |  Exit PowerComPress
               | 
[UP]/[DOWN]    |  Navigate through the files and Dialogs  
[LEFT]/[RIGHT] |  Check/Uncheck CheckBoxes in Dialogs
[ENTER]        |  Select / Confirm
               |  Enter child view:
               |    Folders     -> Files of the selected folder
               |    Files       -> Entries of the selected GroupFile
[ESC]          |  Cancel / Decline
               |  Enter parent view:
               |    Files       -> Folders
               |    GroupFiles  -> Files
               |
[+]            | Add variable to GroupFile
[-]            | Extract GroupFile or single variable
[ALPHA]/[HAND] | (Un)Archive variable
[<-]           | Delete variable


GroupFiles (.PCP-files):

  Compressing of whole folders at once is supported; simply select the
folder to compress and input the name for the GroupFile

  If a GroupFile will be larger than 64kB (the max. filesize on TI68k calcs),
you will be asked to split the GroupFile (if you did not set the option
"Always split GroupFiles"). The name for a splitted GroupFile will be 'name0.part',
'name1.part' and so on. If your GroupFile-name is longer than 8 characters, the
last character of the name will be used for the number.

  Some files might produce a larger output when they are being compressed (e.g.
.ppg-files). If this happens, PowerComPress will automatically add the uncompressed
block to the GroupFile. Such entries won't need to be decompressed when extracting
a GroupFiles, so the extracting of those files will be a lot faster.
  


IV.  Credits
************

PowerComPress
v0.9, 14.10.2005

> written by Jonas Gehring (aka saubue)
> released under boolsoft

> based on BriefLZ v1.04 by Joergen Ibsen (http://www.ibsensoftware.com)
  that was slightly changed when adapting to the calculator and added with
  error dialogs and GroupFile support. However, the compression itself is
  still the original one.

> powered by Advanced Dialogs v0.91
> powered by ExtGraph v2.00beta5 by TI-Chess Team (http://tict.ticalc.org)

> compiled with TIGCC v0.96 Beta 6 (http://tigcc.ticalc.org)

> uses font data and drawing routines by David Randall
  (see 'FontUtils.c')

> thanks to:
  + The TIGCC Team
  + The TI-Chess Team
  + Joergen Ibsen
  + David Randall
  + technoplaza.net
  + betatesters: Martin Huber (aka mhubi)
                 Sciencefreak
                 UnKNown Cyberfreak
  + MobiFiles.de and its message board
  + Camelot (http://www.tigen.org/camelot)
  + and everyone else in the community!



V.   Contact
************

e-mail:		saubue@mobifiles.de
boolsoft hp:	http://boolsoft.mobifiles.de
MobiFiles hp:	http://www.mobifiles.de



VI. Known Bugs
**************

You should not add more than 255 files to a GroupFile, else the calculator
will probably crash when viewing the contents of the GroupFile!

There my be unknown bugs, so please don't hesitate in reporting the ones
you may have found!



VIII. ToDo-list
***************

> Add more TIOS options (copy etc.)

Any other suggestions are welcome!
Please e-mail to saubue@mobifiles.de



VIII. History
*************

Usually, every new version contains some bugfixes and / or optimizations that
aren't aleays mentioned explicitly.


14.10.2005	v0.9		Extracting single files from GroupFiles is
				  supported now


11.10.2005	v0.84		Added request to overwrite files when unextracting
				  GroupFile
				When you select a file and press [ENTER], you aren't
				  taken to the first file of the directory anymore


06.10.2005	v0.83		Adding files to GroupFiles that are splitted in
				  more than two parts is working now
				Added deleting of whole folders
				Folders can't be (un)archived now (i.e. these options
				  are no longer valid at the folder view)


05.10.2005	v0.82		Decompressing GroupFiles is more stable now
				  and a silly bug that was messing up uncompressed
				  blocks was removed
				Viewing GroupFiles is more stable now			


03.10.2005	v0.81		Shortcut for extracting GroupFiles (-) is
				  working now				
				Extended Options menu with the possibility to
				  change the current theme (white or black)
				Modified GUI a bit so the black theme is looking
				  fine
				The configuration file can't be accessed now
				  via PowerComPress


30.09.2005	v0.8		Only GroupFiles are supported now (like .zip- or
				  .rar-archives)
				GroupFiles can be splitted now, so there is no
				  limitation of their size
				Rewritten entirely new GUI with much faster
				  scrolling (thanks to David Randall!)
				Viewing of GroupFiles is now supported
				Removed memory check
				Most routines were rewritten
				NOTE: Due to the new GroupFile-format, old
				  .PCP- and .PCG-files aren'r supported now


19.09.2005	v0.7		Optimized GroupFile support (GroupFiles are a
				  bit smaller now)
				A lot of bugfixes


16.09.2005	v0.62		If you add a variable to GroupFile and the
				  the output will be larger than the input,
				  you can choose whether to skip or to add
				  the original one.


09.09.2005	v0.61		Fixed folder detection (the first folder will
				  be found now, too)


08.09.2005	v0.6		Added RestoreGroup() so that groups won't get
				  corrupted when adding a variable fails while
				  writing to a GroupFile
				Extracting from a GroupFile is faster now
				When you add a variable to a GroupFile and the
				  compressed variable will be larger than the
				  original, you can choose whether to skip or
				  to cancel.


07.09.2005	v0.56		Compressing whole folders works now and has a
				  few new features (custom folders etc.)
				Now using Advanced Dialogs v0.91


05.09.2005	v0.55		Added compressing of whole folders into
				  one single group in main\
				Variables are now compressed / added into
				  their original directory


03.09.2005	v0.5beta	Added group file support (.PCG-files)
				Now using Advanced Dialogs v0.9


13.08.2005	v0.35beta	Added possibility to delete original files
				Fixed bug with larger output file (see v0.3)				


11.08.2005	v0.3		Added memory check
				Added warning if output is larger than input


09.08.2005	v0.2		Added grayscale GUI & file browser
				Now using ExtGraph and Advanved Dialogs


20.06.2005	v0.1		First beta version
