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 donUt have a backup copy on disk that you can reinstall from.



NOTE:  Version 1.2 of RTibbottUs BookcaseS 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 RNewtCasedS) 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 TO 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 RAll PackagesS



	Version 1.2 of RTibbottUs BookcaseS 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 RExtrasS in the Extras Drawer icon (see Figure 1).

J









	When you launch NewtCase, it displays two lists (see Figure 2).  One list contains installed RactiveS 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.

J













































	To archive a package (put it in your NewtCase), highlight it in the Installed Packages list and tap on the RArchiveS 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).

J







	To reinstall the package (take it out of your NewtCase), highlight it in the Archived Packages list and tap on the RReinstallS 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 packageUs entry in the NewtCase.  If this happens, you will have to reinstall the package with the Connection Kit.

J







	You can remove a package by highlighting it in either list and tapping on the RRemoveS 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 RRunS button.  When you launch an archived package, NewtCase will de-archive it and run it.  You may notice a delay between when the RNewtCase is workingS 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 canUt launch all books.  We recommend using TibbottUs Bookcase (included with this archive) to manage your NewtonBooks.  However, archiving/reinstalling/removing books works fine.



	Click on the R?S 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 RAll PackagesS by tapping on the category selector above the Archived Packages list (see Figure 5).

J





















	You can categorize archived packages in one of seven categories:  Unfiled, Books, Communications, Games, Utilities, Applications and Other.  To change a packageUs 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 RUnfiledS if you have RAll PackagesS selected.

J























< 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 NewtCaseUs 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 RStore New Items on CardS 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 TibbottUs 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.1), 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 RICSS, NewtCase is application #2740.  PLEASE BE HONEST and register this software if you use it - we canUt continue to write cool Newton apps if we donUt get any support.



	Please note that while version 1.2 is still a shareware product, version 2.0 of NewtCase is a commercial product.  If you are interested in purchasing version 2.0, call PelicanWare at 800/655-NEWT or 503/221-1148.



< Bugs, Questions, Comments, Suggestions... >

	If NewtCase crashes, please write down the error code (especially if it is an RUnexpected errorS) 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.



	TibbottUs 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 TibbottUs Bookcase to Michael Tibbott at tibbott@newton.apple.com.



	Send e-mail to the author, Dan Rowley, at ics@amug.org or 73563,2343 on CompuServe.  You can reach Tom at ics@indirect.com or 75460,2121 on CompuServe.  We want to develop Newton applications to fit your needs.  Give us feedback, let us know if weUre doing it right.  WeUre here for you.



< Our Other Newton Applications >

	In addition to NewtCase, weUve 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.indirect.com/ics/newton/> and our ftp directory at <ftp://ftp.indirect.com/pub/ics/>.



< 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 TibbottUs Bookcase now get along fine.  Quick-access extras button is now a little shorter.  The RNewtCase wonUt be able to remove packageS message is gone.  If NewtCase canUt 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 RofflineS, 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 Rsoup changedS 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 73563.2343@compuserve.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.  TibbottUs Bookcase is a trademark of Michael Tibbott.



	You canUt 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 shareware/freeware collection.



	In using this software, you understand and agree that this software is provided Ras isS 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: ics@amug.org / CompuServe: 73563,2343

Tom Collins / Internet: ics@indirect.com / CompuServe: 75460,2121