Launch Em
Version 3.1
Copyright (c) 2001 Synergy Solutions, Inc. All rights reserved.
Synergy Solutions, Inc. is a BarPoint.com company.
by Alan Pinstein & Dan Hewins

SYSTEM REQUIREMENTS:
PalmOS 3.x or greater.  
Launch 'Em requires 148k of memory for a minimal install (no plugins).

INSTALLATION:
Installation instruction are included in this distribution. 
See the LaunchEm.html for more information.

UPDATING NOTES:
- When updating from Launch 'Em 2, Launch 'Em's PREFERENCES will be saved.
- If you use Launch 'Em App Hack, you MUST disable Launch 'Em App Hack in 
HackMaster before upgrading.
- Before upgrading, please be sure to uncheck the "Always Use Launch 'Em" 
feature (in the General Preferences of Launch 'Em) to ensure that all of your 
plugins are updated to the newest version. Once you've installed the update, you 
can re-enable this feature.

SUPPORT:
For support or more information, please visit our web site at
  http://www.synsolutions.com/
The Launch 'Em pages are located at
  http://www.synsolutions.com/software/launchem/

If you want to develop plugins for Launch 'Em, the Plugin SDK is available at:
  http://www.synsolutions.com/software/launchem/

Please send comments, questions, bug reports, etc. to launchem@synsolutions.com.

ACKNOWLEDGEMENTS:
Some icons from the iconice.pdb file were created and donated for use 
by Daeyeon Han ("parang"). Thanks to him for his generosity.

HackMaster is included for use with Launch 'Em only. If you use other HackMaster 
extensions with HackMaster, be sure that you register HackMaster at 
http://www.daggerware.com. Thanks, Ed!

VERSION HISTORY:
----------------

Launch 'Em 3.1 / LaunchEmAppHack 3.0 8/8/2001
---------------------------
* Enhancements.
  - Speed. Launch 'Em now caches information about your applications, 
    allowing it to start faster. Launch 'Em may take longer to start when:
    > You are running Launch 'Em for the first time.
    > You have added or deleted programs/databases since the last time 
      that you ran Launch 'Em.
    In these cases, Launch 'Em is rebuilding its internal cache. 
    This is consistent with the behavior of the built-in applications program.
  - A help screen for Launch 'Em App Hack, accessed from the main 
    Launch 'Em menu, explains how to activate and use App Hack.
  - The "Please Register" screen in the demo version now has a "Beam Me"
    button to facilitate sharing Launch 'Em.
  - Launch 'Em now supports AutoCF to run applications directly from CF cards.
    Support for SD/MMC and Memory Stick cards is in development.
  - A German edition of Launch 'Em is now shipped.
    Use the "Custom" installation object to select German files.
* Bug fixes:
  - Column headers in list view will now expand properly to full screen width.
  - The "Locked records in open unprotected DB" message no longer appears.
  - Icon names (not database names) appear in the main display.
  - Database names (not tAIN names) appear in database lists (GetInfo, 
    BeamMe, and Trashcan gadgets).  Under PalmOS 4.0, all built in apps 
    also have overlay resource databases with the same tAIN name.  
    This was causing multiple databases listed with the same name.  
    In the future, we expect that more applications will include overlays.
  - Corrected string in the About dialog.
  - Palm m505 no longer crashes when the user creates a "Default DB 
    Placement" entry with no type or creator information.
    Such entries are now disregarded.
  - Read/display PQA icons are colored correctly.
  - The DefaultDB Dialog no longer appears superimposed over the main view.
  - Fixed display errors on the HandEra 330.
  - Category import now works correctly on Handspring devices 
    running PalmOS 3.52H.
  - Scroll bars now have the correct colors.
* Maintenance.
  - Removed last remnants of theme support.
  - Launch 'Em 3.1 automatically deletes LaunchEm2 databases 
    created by earlier releases. 
---------------------------
---------------------------
Launch 'Em 3.0.2 / LaunchEmAppHack 3.0 6/5/2001
---------------------------
-  Added optimized release targets.
-  Changed SpawnHelp string's resource ID to 3100 (Reminder Bug).
-  Renamed Labels in About Box to 3.0.2.
-  Renamed Version String in Constructor to 3.0.2.
-  Changed the Rom Incompatible Alert to reflect OS 3.0.
-  Changed ourMinVersion to sysMakeROMVersion(3,0,0,0,0).
-  Hid MoreGeneralPrefsScreenDepthPopTrigger and Label in LEForms in 
DoMoreGenPrefs(), if OS version < 2.0 (crash on 2.x devices).
-  Put the semi-colon on a new line in those pesky for loops (This just generated a 
compiler warning each time for possible unwanted ';').
-  In DefaultFormHandleEvent in LEForms changed FrmGotoForms to  
FrmReturnToForm to avoid crash in 4.0 debug ROMs.
-  In MainFormDoCommand changed FrmGotoForm(DefaultSettingsForm) to 
FrmPopupForm(DefaultSettingsForm) - see 10.
-  Added Import Category Settings Alert and switched text and buttons.
-  LEImport, line 526. Options are now Yes or No and text is: Do you want to import the 
category settings from Palm's default Launcher?
-  To avoid incessant looping of the NoTabsAvailableAlert the Boolean 
shownNoTabsAvailableAlert was addded to LETabsGlobalDataType (LETabs.h) and is 
initialized to false in AppStart in LEMain. This Boolean is set and tested in 
LETabDrawTabs().
-  In LEWindow.c LEWinLoadTab was changed to avoid infinite loop when noTab (recH = Ox000000) in the second part of the funtion.
-  All targets are build with Palm OS 4.0 Support libs.
-  Because of 14 (s.a) #include <PalmUtils.h> has been added to PalmOS.pch. That is 
where the min and max macros are now. Palm suggests there might be a problem in the 
future with using these together with the C++ compiler and that for future sys versersions 
one might want to declare those macros oneself.
-  Added 4.0 support for LEImport. Previously versions 4.0 of the OS would default to 
LauncherNone and not import any Settings. Also changed String resource to reflect that 
we always import all categories. 
-  NOTE: with optimization at Level 4 this release will produce an address error 
(application accessed a 2- or 4- byte value at an odd (i.e. not even) memory address. This 
issue 
   disappears w/ optimization level 3.
---------------------------
---------------------------
Launch 'Em 3.0 / LaunchEmAppHack 3.0 3/6/2001
---------------------------
- All of Launch 'Em's prefs are now stored as NAME/VALUE pairs in a UNIX-style 
.conf file.
- Added the 'directives' feature
- Fixed a bug causing 'read from NULL / low memory' when tapping while an EMPTY 
tab is displayed.
- The Security dialog now dismisses after choosing the desired mode...
- The beta expiration warning now tells the user where to go to download the newest version.
- Fixed UI bug where the Apps List feature would have an ellipsized (...) Most Common header.
---------------------------
---------------------------
Launch 'Em 3.0b10 / LaunchEmAppHack 3.0b10 1/14/2001 
---------------------------
- Added SoundOff and IconTransparency plugins to the distribution.
- Fixed a bug in LEAppHack which would cause a crash on removal of the SB module 
while an SB app is running on NEWER visors. I think that the problem still 
remains on older models, and it can't be fixed w/o patching the OS...
- Fixed a UI bug in which the date/levels display would draw on top of the command bar 
during the time-based update.
- All LE databases now have their backup bits set.
- Fixed a bug in LEAppHack which would cause the 'last app' feature of LEAppHack 
to cause crashes when switching apps on Palm OS 2.0. This bug was accidentally 
introduced in LEAppHack 2.15.
- Added support in the Private Records Toggle to support MASKED records on OS 3.5.
- Set up project to use precompiled headers for the PalmOS system headers. Makes for much faster builds.
- In list view, databases with less than 1024 bytes used to show as '0k'. Now they show as '<1k'. Also fixed same bug in GetInfo plugin.
- When sorting by creator codes in list view, the items are now sorted case-insensitively.
- Fixed a bug in which the 'drag handles' in the Default Settings would not redraw after being dragged around. Essentially, the OS widens the TAB popup and that covered the handles. The easiest fix is to move the handles so that they don't get obscured by the lists.
---------------------------
---------------------------
Launch 'Em 3.0b9 11/22/2000 [ release tag: v3_0b9 build time: Wednesday, November 
22, 2000 3:47:51 PM ]
---------------------------
- Commerce system wasn't ready; needed to release a new beta with longer expiration.
- Adjusted codebase to use the registration module; it did not check out cleanly from CVS.
- changed RemoveIcon gadget help text
- fixed bug in default DB filing code that caused a crash
- scroll position now resets to top when toggling tab views (large icon, small icon, list)
- fixed initialization bug in which LE would set Visor Prisms to 16 bit color mode.  (now only 8, 4, 2, 1 bit modes supported)
---------------------------
---------------------------

Launch 'Em 3.0b8 10/24/2000
---------------------------

- speed enhancement (!) in first time icon display 

- LE now allows user to change the screen depth in the More Prefs screen

- LE and the screen depth plugin now only support 256 colors because the Palm OS color 
picker will crash in 16 bit mode

- changed color pickers to also use RGB sliders

- fixed truncated date in compact toolbar to correctly display date formats that begin with 
the year

- changed Brightness plugin to Brightness/Contrast plugin.



Launch 'Em 3.0b7 10/19/2000

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

- fixed bug where some gadget buttons would still be usable when the toolbar is hidden



Launch 'Em 3.0b6 10/18/2000

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

- added "Beam Launch 'Em" menu choice to beam Launch 'Em

- removed "Delete Active Theme" menu choice

- added support for TRG AutoCF

- updated screen depth option in "More General Prefs" to handle up to 24 bit color

- updated screen depth gadget plugin to handle up to 24 bit color

- small icons are now centered in the small icon and list views



Launch 'Em 3.0b5 10/17/2000

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

- fixed update procedure so that the text color of the tab is black when updating from 
earlier versions

- added another button to toolbar that allows toggling between any toolbar position

- fixed demo code so that other buggy programs won't cause LE to crash when displaying 
nag screen

- updated ScreenDepth plugin to have accurate list choices and added 65k colors to list

- changed icon sort routine from insertion sort to quick sort



Launch 'Em 3.0b4 10/16/2000

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

- legacy icons now draw in same color as text in each tab

- changed database name back to "LaunchEm2"

	- beta 3 users: delete Launch 'Em and install beta 4

- screen depth list in MoreGeneral Prefs screen has current depth selected

- changed "Power off and lock" and "Graffiti Reference" gadget icons

- made spawn gadget list wider



Launch 'Em 3.0b3 10/12/2000

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

- Launch 'Em loads faster!

	- issues: the first time an icon is displayed it will be slightly slower than ususal but 
it will happen faster every time after that.  This is on a per-use basis.  If LE is quit and 
relaunched, the slow then fast behavior is repeated.

- added preferences for non-color handhelds to set the screen depth

- legacy icons now draw black

- changed color picker dialogs

- allow for user to choose text color for tabs



Launch 'Em 3.0b2 10/11/2000

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

- fixed bug where tapping on list view header launches first application in list



Launch 'Em 3.0b1 10/10/2000

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

- BEAMING SUPPORT!

	- If a registered version of LE is beamed to another Palm handheld, it will become 
a demo on the receiving handheld.

	  So beam LE to everyone you see with a Palm!

	- Demo is beamable.

- Color support for Palm IIIc

	- Color tabs

	- Color gadget icons

	- color tab background

	- color toolbar background

	- color battery/memory level meter

- 3 position toolbar (expanded, compact, none)

- added gadget prefs gadget

- added list view for tabs:

	- 1 to 3 columns

	- tap on header to sort on that column (tap again to sort descending)

	- choose popup trigger to choose what to show in that column

	- drag-resizing of column widths

	- users can toggle to list view by tapping on the active tab.

- added support for 3.5 security (show, mask, hide) if masked, treat as hidden

- fixed private records gadget to work with Palm OS 3.5 security

- added support for many other sort modes (size, version, type, creator; ascending and 
descending)

- removed automatic refresh on power on.  Will only refresh if provate records state is 
changed.

- added support for Sony Clie JogDial

	- main screen (scroll or switch tabs)

	- gadget prefs screen (scroll gadget description field)

- supports transparent removable media (e.g. Handspring 8MB Flash Module)

	- saves locations of applications removed from Launch 'Em (which tab)

	- this applies to removable media as well as deleted applications.

	- if a database is removed from a tab its location is saved for if it is installed 
again.

	- saves 100 removed database locations (can be changed in resource 'RQSZ' ID 
1000 in LaunchEm2 database)

- updates tab records to new format

- saves preferences from version 2.15 (and any version that had the same prefs structure 
as 2.15)

- fixed bug introduced in ver 2.15 that had the memory chip bitmap showing in the 
default settings form

- fixed memory leak in plugin mgr, wasn't freeing the chunk created in 
SysCreateDataBaseList





Updating Notes

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

- When updating from version 2.15 of Launch 'Em, the PREFERENCES will be saved.  
For any other previous version, the preferences will be restored to factory settings.



