/***************************************************************************/
/* ODFIX - Copyright 2004  R.L. Walsh                                      */
/***************************************************************************/

Overview
========

ODFix corrects problems with two Object Desktop components:

o  Zip Folders - enables Zip Folders to use recent versions of InfoZip's
                 Unzip (>v5.32).  Without this patch, the first letter
                 of each filename in the archive is missing.  This fix
                 supports O.D. v1.52 and v2.01 or later.

o  Control Center - turns on the CPU meter when running Warp v4.5x and
                 prevents WPS lockups when dragging over Control Center.
                 This fix should work with any version of O.D.

This package also includes a utility named OLDNEWBK.EXE which you can
use elsewhere to unlock/replace/backup files.  Unlike similar utils,
it should work with any type of file.  Run "oldnewbk /?" for more info.


/***************************************************************************/

Install / Uninstall
===================

Put the three main files (odfix.cmd, odccfix.dll, and oldnewbk.exe) in
the directory containing your Object Desktop dlls, then run odfix.cmd.
You'll be presented with a menu that lets you install or uninstall
either or both fixes.

After you make a selection, odfix will advise you of the results.  If
you run it from the WPS, its window won't close until you "press any
key to continue", so you won't miss any of its messages.  That's it!


/***************************************************************************/

More Info
=========

Zip Folder fix
--------------
O.D.'s Zip Folders are hard-coded to expect that unzip's output will
have three spaces before a filename.  Versions after v5.32 only put
two spaces there, causing Zip Folders to skip over the first letter
of the filename.  ODFix locates the byte in objdoarc.dll that says
"skip 3" and changes it to "skip 2", solving the problem.

ODFix supports three version of objdoarc.dll:
  v1.52 - v1.5 with FixKits 1 and 2 applied
  v2.01 - v2.0 with FixKit 1 or later applied (Stardock's FixKit 2
          and the 3rd-party FixKits 3 & 4 didn't update this dll)
  v2.01 with revised icons - this is Christian Hennecke's package
          available from hobbes as od20_archview_icons.zip

Even though ODFix will only patch these three versions, it has been
tested with all 1.5 & 2.0 versions of objdoarc.dll to ensure that it
doesn't patch versions it doesn't support.

If you've never updated your copy of Object Desktop, the FixKits are
still available from Stardock:

  http://www.stardock.com/support/os2/files/od15fk1e.zip
  http://www.stardock.com/support/os2/files/od15fk2e.zip

  http://www.stardock.com/support/os2/files/od20fk1e.zip
  http://www.stardock.com/support/os2/files/od20fk2.zip


Control Center fix
------------------
ODFix corrects two separate problems with the Control Center but ties
them together:

The Control Center's CPU meter doesn't work under Warp v4.5x because
it never issues the command required to enable this feature.  Earlier
versions of OS/2 didn't have this requirement.  The ODCCFix WPS class
will issue this command - but only if its other fix is in place.

Dragging over the Control Center from any program other than the WPS
will cause the Desktop to lock up.  ODCCFix prevents this from happening
by subclassing Control Center's windows and filtering drag messages sent
to them.  It blocks messages coming from other processes' drags but lets
WPS drag messages through.

For this fix to work, a Control Center object (which is just a WPS
folder in disguise) must contain an ODCCFix object.  When that Control
Center's window opens, its ODCCFix object will be notified and will
begin protecting that window.  If you have more than one Control Center
(e.g. v2's Object Netscan object), each one must have its own ODCCFix
object - a shadow will not work.

Since ODCCFix objects in other folders aren't notified when a Control
Center window opens, they are useless.  To avoid giving the impression
that this fix is working when it really isn't, the ODCCFix class won't
turn on the CPU meter until at least one of its objects has successfully
installed its d&d message filter.

ODCCFix objects are extremely easy to create because they're just plain
datafiles named "ODCCFIX.RWY".  To create one, use your text editor's
Save As dialog to navigate to the Control Center directory that needs
to be protected.  Enter the name "ODCCFIX.RWY", then press Save.  When
the WPS finds a new file with this exact name, it will assign it to the
ODCCFix class.  Your new "object" will then protect the Control Center
associated with that directory.

Warning!  Dragging over Control Center's *icon* from another program
will also cause the Desktop to lockup.  ODCCFix can not prevent this.


/***************************************************************************/

Files in ODFIX.ZIP
==================

1.  ODFIX.CMD           June 17, 2004       01:00:00
2.  ODFIX.TXT           June 17, 2004       01:00:00
3.  ODCCFIX.DLL         June 17, 2004       01:00:00
4.  OLDNEWBK.EXE        June 17, 2004       01:00:00


/***************************************************************************/
Rich Walsh (rich@e-vertise.com)
Ft Myers, FL
June 17, 2004
/***************************************************************************/
