Clie ScreenLock Fix
----------------------------------------------------------------------------
README.txt                                              version 1.00, 3/3/01

Written 2001 Douglas I. Anderson

Released under GNU Public License.  See http://www.gnu.org


Description
===========
This hack just fixes a bug in the current shipping versions of the
Sony Clie that prevents FlipHack from working.  It will probably also
make drawing by some applications appear smoother.


Details
=======
An optional PalmOS function, WinScreenLock(), does not work on the Sony
Clie.  This function is typically used by applications to make drawing
appear smoother to the user.  This does not cause any real compatibility
problems for the Clie because WinScreenLock() is optional for hardware 
makers to support.  That's because it may require a large amount of memory
in some cases.  PalmOS guidelines say that applications must be able to 
function even if this routine is not implemented.

FlipHack actually _requires_ that WinScreenLock() be implemented.  Any
systems that don't implement WinScreenLock() will not work with FlipHack.
On version 1.0, FlipHack failed silently (though it did no harm).  On 
version 1.1 it gives an error message.


As I said, on the Sony Clie, WinScreenLock() does not work properly.
However, it turns out that there is no good reason that WinScreenLock() 
doesn't work on the Clie.  The reason it doesn't work is that the Clie 
software is reporting the wrong value in some cases for another function: 
HwrDisplayAttributes().

This hack fixes HwrDisplayAttributes() so that it returns the right
value.  For more technical details, see the source code.


Requirements
============
* A Sony handheld with an OS less than 4.0 (it is assumed that Sony will
  have fixed the bug by 4.0, so this hack disables itself if it detects
  a newer OS).
* Approximately 1K available memory.
* The HackMaster application from DaggerWare or an appropriate competitor.  
    - To get a copy of Hackmaster, go to:
      <http://www.daggerware.com/hackmstr.htm>.  Note that HackMaster is
      shareware.  Please pay for it if you use it.
    - To get a copy of X-Master, a free version of Hackmaster, go to:
      <http://www.linkesoft.com>


Installation / Usage
====================
Back up your data.  Always a good idea when installing a hack.

If you haven't already installed HackMaster (or an equivalent), do that 
first.

Now, simply install the "Clie ScreenLock Fix.prc" file as you would any
other ".prc" file.  If you have any previous version installed, uninstall
it first (_very_ important).

Go into HackMaster and install Clie ScreenLock Fix (click on the checkbox 
next to it).  

That's it!


Legal Junk & Distribution
=========================
This program and code are Copyright 2001 Douglas Anderson.  It may 
also be Copyright by Handspring, as they were/are my employer.  
I would like to thank them for letting me distribute this program under GPL.

This code is released under GPL and is subject to the terms of the GPL.  
For details, see <http://www.gnu.org>.  

I request (but do not require) copies of any disk/CD-ROM/etc that contains
Clie ScreenLock Fix.

Sony and Clie are likely trademarks of Sony Corporation.  


Thanks
======
Thanks for Clie ScreenLock Fix go to Erik Rauch and Wallace White from
Think Outside, who provided me with supplies to help track down the
problem.


Contact Info
============
Probably the easiest way to contact me is via e-mail.  However, I always
appreciate getting real mail...  I will definitely think you're cooler if
you send me real mail.  

      e-mail:  da AT byteswapped.com
      web:     http://www.byteswapped.com/palm/
      address: Doug Anderson
               2235 California St. #205
               Mountain View, CA 94040
...hope to hear from you.


Known bugs
==========
* If Sony still has the problem in devices running OS 4.0, this hack
  will not fix the problem (for safety, it only runs on OS 3.5-based
  Sony devices).


Version History
===============
1.0,   03/03/01 - Initial revision.