NewtCase 1.2
(C)1994 Innovative Computer Solutions, All Rights Reserved
Written by Dan Rowley, Documentation/Graphics by Tom Collins

ATTENTION:  Please read this file entirely, especially the Warnings and Disclaimers section.  If you do not understand how NewtCase works, you may run into some surprises.  Archived packages ARE NOT BACKED UP through the Connection Kit.  DO NOT archive packages with NewtCase if you donÕt have a backup copy on disk that you can reinstall from.

NOTE:  Version 1.2 of ÒTibbottÕs BookcaseÓ is included with this archive.  If you have been using Bookcase, please replace it with this version.  It fixes a conflict with NewtCase.

< Overview >
	NewtCase lets any MessagePad (Classic, MP100, MP110) user archive his/her Newton applications to reduce heap memory requirements, alleviate conflicts between applications, and clean up his/her Extras drawer.  Archived (or ÒNewtCasedÓ) packages do not show up in the Extras drawer, but can be reinstalled at any time using NewtCase.  With NewtCase, you can temporarily deinstall applications without having to remove them from your MessagePad.  NewtCase can launch an archived package and, when you quit from that package, automatically re-archive it.  Using NewtCase, you could keep a hundred applications on your 4 meg card without overflowing your heap space or Extras drawer.

< Installation Notes >
	Install NewtCase as you would any other package (with the Connection Kit or some other utility).  NewtCase will work if installed on a PCMCIA card (no Grip ÔO Death).  If NewtCase is installed on a card, do not remove the card if you are running archived packages.  When you quit the archived packages, wait until they disappear from the Extras Drawer before removing the card.

	If you are upgrading from a previous version of NewtCase, you can just remove the old version and replace it with this one.  Your archived packages will be unaffected.  Please remove the QuickRun package that came with v0.9B2.  It is incompatible with NewtCase 1.2.  If you feel there is still a need for a separate QuickRun package, let us know.

	If you are downgrading from version 2.0 of NewtCase, please reinstall all NCK Archives and refile packages stored in the last three sets (originally called User 1, User 2 and User 3).  Version 1.2 cannot access the NCK archives, and will only diplay items filed in the last three sets when viewing ÒAll PackagesÓ

	Version 1.2 of ÒTibbottÕs BookcaseÓ is included with this archive.  If you have been using Bookcase, please replace it with this version.  It fixes a conflict with NewtCase.

< Usage >
	You can launch NewtCase from the Extras Drawer, or you can just tap on the word ÒExtrasÓ in the Extras Drawer icon (see Figure 1).
Ê




	When you launch NewtCase, it displays two lists (see Figure 2).  One list contains installed ÒactiveÓ packages.  The other list contains packages in your NewtCase.  Packages on a locked card will appear with a bullet in front of their names.  You cannot modify these files unless you unlock the card.  The numbers following package names in the Installed Packages list indicate the size of each package.  The numbers in the Archived Packages list indicate the size and estimated heap usage of each package.  NewtCase can tell if you remove or insert a memory card, and will update its lists accordingly.
Ê






















	To archive a package (put it in your NewtCase), highlight it in the Installed Packages list and tap on the ÒArchiveÓ button (see Figure 3).  Archived packages stay where they are and continue to use storage space, but not heap space.  They are invisible to all other applications, including ones that backup packages (to a card, or through the Connection Kit).
Ê



	To reinstall the package (take it out of your NewtCase), highlight it in the Archived Packages list and tap on the ÒReinstallÓ button (see Figure 4).  If the archived package has been damaged or erased in some way, NewtCase will tell you about it, and give you the option to remove that packageÕs entry in the NewtCase.  If this happens, you will have to reinstall the package with the Connection Kit.
Ê



	You can remove a package by highlighting it in either list and tapping on the ÒRemoveÓ button.  You cannot remove an archived package if you have an installed package with the same name.  You can also launch a package from either list by highlighting it and tapping on the ÒRunÓ button.  When you launch an archived package, NewtCase will de-archive it and run it.  You may notice a delay between when the ÒNewtCase is workingÓ message disappears and the program launches.  When you exit the package, NewtCase will re-archive it automatically within 15 seconds.

	Due to inconsistencies in naming conventions, NewtCase canÕt launch all books.  We recommend using TibbottÕs Bookcase (included with this archive) to manage your NewtonBooks.  However, archiving/reinstalling/removing books works fine.

	Click on the Ò?Ó button for registration and contact information.

	The available heap is displayed in a button in the upper-left hand corner.  Clicking on the button performs a garbage collection (gc()).

< Categories >
	You can limit the archived packages list to one of the categories or ÒAll PackagesÓ by tapping on the category selector above the Archived Packages list (see Figure 5).
Ê










	You can categorize archived packages in one of seven categories:  Unfiled, Books, Communications, Games, Utilities, Applications and Other.  To change a packageÕs category, select it in the Archived Packages list and tap on the folder button (see Figure 6).  When you archive a package, it is placed in the current category, or ÒUnfiledÓ if you have ÒAll PackagesÓ selected.
Ê











< Warnings and Disclaimers >
	WARNING, NewtCased packages are invisible to ALL OTHER APPLICATIONS.  Once you archive a package, you can only get it back with NewtCase.  The MessagePad CANNOT backup archived packages - make sure you have a (non-archived) backup copy before archiving a package.

	DO NOT delete NewtCaseÕs soups (with a utility such as StewPot or RemoveIt) unless you have unarchived ALL NewtCased packages on that device.  If you delete the soup on a card that has packages NewtCased on it, you will lose access to those packages, and will not be able to recover the memory they use.

	WARNING, you must remove your storage card before locking or unlocking it (as documented on page 196 of the original MessagePad Handbook).  NewtCase (and other applications) will get confused if you lock or unlock the card while it is still in the MessagePad.

	WARNING, NewtCase will not work if the card is locked AND you have ÒStore New Items on CardÓ selected on the card slip.

	WARNING, BookCase v1.0 by Michael Tibbott will fail if you run an archived package on your Newton.  Please use TibbottÕs Bookcase v1.2.

	WARNING, Time Accountant v2.0 fails when using NewtCase, upgrading to v2.01 solves the problem.

	USE CAUTION, when running NewtCase while other package management utilities are running (e.g., RemoveIt, ExtraExtras, ScrollEx).  Performing an operation in one might confuse the others.

< Registration Information >
	This application is SHAREWARE.  If you decide to keep it, please register it by sending $20.00 to Innovative Computer Solutions; ATTN: Tom Collins; 1075 North Miller Road, #142; Scottsdale, Arizona 85257-4612.  Please include your name, the name of this utility (NewtCase 1.2), type(s) of MessagePad(s) owned, address (postal) and preferred e-mail address so we can contact you about updates and our other products.  You can also register NewtCase on CompuServe.  GO SWREG and search for apps with the keyword ÒICSÓ, NewtCase is application #2740.  PLEASE BE HONEST and register this software if you use it - we canÕt continue to write cool Newton apps if we donÕt get any support.

	Please note that while version 1.2 is still a shareware product, version 2.2 of NewtCase is a commercial product.  If you are interested in purchasing version 2.2, call PelicanWare at 800/655-NEWT or 503/221-1148 or e-mail them at pelican@newts.com.

< Bugs, Questions, Comments, Suggestions... >
	If NewtCase crashes, please write down the error code (especially if it is an ÒUnexpected errorÓ) and e-mail a bug report to us.  We also gladly accept suggestions for future versions.  Please be sure to write down the entire error message, all of the information is important.

	TibbottÕs Bookcase is included as a service to the many users of both NewtCase and Bookcase.  It is NOT an ICS product.  Direct all inquiries regarding TibbottÕs Bookcase to Michael Tibbott at tibbott@newton.apple.com.

	Send e-mail to the author, Dan Rowley, at dan@newts.com or 73563,2343 on CompuServe.  You can reach Tom at tom@newts.com or 75460,2121 on CompuServe.  We want to develop Newton applications to fit your needs.  Give us feedback, let us know if weÕre doing it right.  WeÕre here for you.

< Our Other Newton Applications >
	In addition to NewtCase, weÕve released NewtInfo, SleepAid, HeapIt, GraffitiPatch, inLine and PrefsPatch.  For more information on our programs, check the Newton forums on CompuServe, America Online, eWorld and AppleLink.

	Internet users can check our home page at <http://www.newts.com/> and our ftp directory at <ftp://ftp.newts.com/pub/>.

< Revision History > 
 1.2 - Changes made to support new soup format of v2.0
	1.1 - Refuses (properly) to launch autoparts and other non-launchable packages.  NewtCase and a new version (1.2) of TibbottÕs Bookcase now get along fine.  Quick-access extras button is now a little shorter.  The ÒNewtCase wonÕt be able to remove packageÓ message is gone.  If NewtCase canÕt run a package, it will rearchive it for you.  Running books is a little more reliable, but a lot of books still will not run.  Archive list now updates properly when you switch sets.
	1.0 - First non-beta release.  Added Extras drawer button, integrated NewtCase and QuickRun, fixed bug when launching archived packages with the extras drawer full, fixed scrolling bug when deleting last item in a list, added categories for archived packages, can launch installed packages and remove installed packages, and lists display 8 packages instead of 6.
	0.9b2 - Second beta release, fixed bugs found in v0.9b.
	0.9b - Initial public release.

< Technical Info >
	NewtCase does not store packages in its soup.  It takes them ÒofflineÓ, but stores a reference to them in its soup.

	If you have an entry in your archive listing a -0.9k heap, it indicates that there was a problem archiving that package.  The affected package may or may not have been archived successfully.

	NewtCase cannot open a book unless its ISBN matches its package name.

	Sometimes the screen will blank out when performing an action.  This is because some other  application has forced the root view to redraw and is perfectly normal.

	NewtCase responds to broadcasts of system soup changes by updating its lists accordingly.  NewtCase also broadcasts Òsoup changedÓ messages when making changes to the installed packages.  If you would like more info about supporting these broadcasts in your applications, contact Dan Rowley at dan@newts.com.

< Legal Mumbo Jumbo >
	Newton, MessagePad, Connection Kit and Apple are registered trademarks of Apple Computer, Inc.  NewtCase and QuickRun are trademarks of Innovative Computer Solutions.  TibbottÕs Bookcase is a trademark of Michael Tibbott.

	You canÕt sell NewtCase, but you can charge a nominal fee for connect time or media (not to exceed $5).  Contact the authors if you plan to include it in some sort of commercial/shareware/freeware collection.

	In using this software, you understand and agree that this software is provided Òas isÓ without warranty of any kind.  The authors do not make any warranties, either expressed or implied, including but not limited to implied warranties of merchantability and fitness for a particular purpose, with respect to this software.

	In no event shall the author be liable for any consequential, incidental, or special damages whatsoever (including without limitation, damages for loss of critical data, loss of profits, interruption of business and the like) arising out of the use or inability to use this software.

	Have a nice day.  ;-)

Innovative Computer Solutions / 1075 N. Miller #142 / Scottsdale, AZ 85257
Dan Rowley / Internet: dan@newts.com / CompuServe: 73563,2343
Tom Collins / Internet: tom@newts.com / CompuServe: 75460,2121
