  ***TLIB-keywords*** "%n: Version %v at %f"
  "readme.doc: Version 20 at 20-May-95,12:39:12"

  ***TLIB-revision-history***
* 1 readme.doc 17-Dec-93,22:29:52 PMDMatch 'readme' file
* 2 readme.doc 31-Dec-93,20:33:52 Changes for v1.04
* 3 readme.doc 4-Jan-94,20:47:02 Changes for v1.05
* 4 readme.doc 7-Jan-94,8:02:36 Changes for v1.06
* 5 readme.doc 14-Jan-94,12:15:32 Changes for v1.07
* 6 readme.doc 26-Jan-94,20:23:16 Changes for v1.08
* 7 readme.doc 27-Feb-94,10:52:32 Changes for v1.09
* 8 readme.doc 19-Mar-94,12:30:38 Changes for v1.09b
* 9 readme.doc 21-Apr-94,20:34:20 Changes for v1.09c
* 10 readme.doc 21-May-94,16:23:30 Changes for v1.09d
* 11 readme.doc 18-Jul-94,19:24:58 Changes for v1.09e
* 12 readme.doc 19-Aug-94,18:47:46 Changes for v1.09f
* 13 readme.doc 24-Sep-94,09:41:06 Changes for v1.09g
* 14 readme.doc 21-Oct-94,21:20:02 Changes for v1.09h
* 15 readme.doc 23-Dec-94,14:40:26 Changes for v1.09i
* 16 readme.doc 27-Jan-95,19:43:26 Changes for v1.09j
* 17 readme.doc 11-Mar-95,13:36:02 Changes for v1.09.11
* 18 readme.doc 31-Mar-95,07:16:22 Changes for v1.09.12
* 19 readme.doc 15-Apr-95,15:54:46 Changes for v1.09.13
* 20 readme.doc 20-May-95,12:39:12 Changes for v1.09.14
  ***TLIB-revision-history***

PMDMatch is an OS/2 utility inspired by the DirMatch utility
originally published years ago in PC Magazine.  I use it to
maintain floppy backups of the projects I'm working on by
matching the project directory with the same directory on
the floppy and only having to copy files that are newer.  It
can also be used when merging a software update (by taking
a 'snapshot' before the installation and then comparing
that to the resulting directories afterward), as a file
viewer, and for limited directory management (it is a specific
purpose utility, so don't expect a full-fledged directory
management package, although I have tried to provide as many
features and make it as flexible/configurable as I could).
Just unzip or copy the files to a directory of your choice and
run it from there.

NOTE:  If you obtained PMDMatch as a single .zip file, it is
packaged using Info-ZIP's compression utility.  Info-ZIP's
software (Zip, UnZip and related utilities) is free and can
be obtained as source code or executables from various
bulletin board services and anonymous-ftp sites, including
CompuServe's IBMPRO forum and ftp.uu.net:/pub/archiving/zip/*.

One way to run the first time is:

  PMDMatch dirpath1 dirpath2

This will bring up PMDMatch and compare the two directories.
It will also create an initial 'PMDMatch.ini' file in the
directory from which it was run to hold your personalized
settings such as color, font, options, etc.  The 'dirpath's
can be full or relative specifications with or without drive
letter.  Then take a look through the help contents or index
and learn about the other options and usage.

Or, if you have the .zip file you can use the PMDSetup.cmd;
just tell it where you put the PMDMatch.exe when it asks and
it will create an object on the desktop for you.  If you have
the disk installation, after running the install program a
folder will have been created for you.

After installing, I suggest you go through the 'help' contents and
find all of the things it can do.  You can get context sensitive
help on any item by pressing F1 when it has the focus.

Here's the stuff I still intend to (someday <s>) add, not in
any particular order and based upon how much demand (and time)
there is for them:

1) Add the ability to move/copy to a different target than the
   other container by a selection choice when confirmation is
   enabled

2) Implement full 'drag and drop' to copy/move files

3) Change selection directory control to a container and
   allow tree or single level display of directories (low
   priority)

4) Implement printing (The 'snapshot' file is a comma-
   delimited ASCII text file so you may be able to use
   that in the meantime.)

5) Add the ability to choose to have the directory containers
   one on top of the other or side by side as they are now
   (depends upon how many want this)

I try to keep my registered users at least a version
ahead of the one I upload to OS2BVEN, so if you want to be
sure to get the latest, please be sure and register!  The only
difference between this shareware and commercial software is
that you get the chance to try it before you spend your hard-
earned money.  But if you continue to use it, you are obligated
to pay the author for the MANY hundreds of hours that are still
going into its development!

Credits:
I'd like to thank my wife Liz for, as she puts it, "getting
to know the back of my head very well" while I've been working
on this program.  I'm also very indebted to Bill Speights for
his help in testing and proof-reading and his wife Sarah for
putting up with us!  And without the answers to those 'undocumented'
container questions by Rick Fishman, none of this would have
been possible!  I also want to acknowledge the unsolicited help
that Mark Kimes (FM/2 author) has given me on more than one
occasion such that I ended up adding some features even sooner
than I had planned.

Known Problems:
(I'm working on these, but if I keep waiting until I get them
all fixed, I'll never get the new functions available <g>.)
1) Some users are getting an error after deleting a number of
   files on a network drive.  The error indicates there's a
   problem starting more threads.  I'm still trying to find
   out the common cause; I can't get it to fail for me.
2) Some users report that the 'Load to/Save from' text on the
   snapshot dialogs is cut off but I can't find what I'm doing
   wrong and, of course, it looks fine on my systems.  So far
   I've only had a report of this on a German version of OS/2.
   I'd be interested to know if it's happening anywhere else.
3) The function keys entries for copy/move/etc. and some other
   menu items should be disabled when a 'snapshot' is loaded.

Version History:
1.09.14
	1) Corrected a bug in setting the state of the Show Progress
	   check box.
	2) Changed metering to charge on a per functional operation
	   (such as copying selected files) rather than per startup.
	3) Added a settings checkbox to control whether or not there
	   is progress animation in the containers when actions are
	   being performed.
	4) Added a settings checkbox to control whether or not the
	   containers are automatically refreshed after an action.
	5) Corrected a bug which didn't allow cancelling a direct
	   edit of a file name.
	6) Corrected a bug where files with different attributes
	   didn't show in the modified filter mode when they should
	   have.

1.09.13
	1) Added the ability specify which of the fields are used when
	   determining if the files are different or not.
	2) Added IdeaFarm(tm) 'meterware' support.

1.09.12
	1) Added the ability to use Alt-MB1 click (or the popup menu)
	   to edit the name of a file.
	2) Added the ability to use Alt-MB1 click to edit and change
	   either of the directories directly without having to use
	   the directory selection dialog.
	3) Added a setting in the options notebook to set whether or
	   not to include subdirectories at startup

1.09.11
	1) Added handling of 'hard errors'.
	2) Changed version numbering style to work with Software
	   Installer/2.
	3) Corrected a problem where rapid clicking on check boxes
	   would miss some of the clicks.
	4) Corrected a problem where the 'progress' dialog didn't
	   continue to display when the 'cancel' was canceled.

1.09j
	1) Added the ability to mark just the newer files.
	2) Moved many of the check-menu options to a settings
	   notebook.
	3) Now adds a snapshot comment as a '.COMMENTS' EA as well
	   as putting it in the file.
	4) Corrected so compare will be on the popup whenever the
	   pointer is over a file which has a corresponding file in
	   the other container, no matter what other items (if any)
	   are selected.
	5) Added additional accelerator keys: Ctrl-I to toggle the
	   Include Subdirectories state, Ctrl-Alt-ADLMU for setting
	   the Filter views.

1.09i
	1) Added the ability to create the destination directory if
       it doesn't exist.
	2) Added the ability to open a directory as a folder on the
	   desktop.
	3) Added the /O ('O'perating system attributes) command-line
	   switch to show operating system/hidden files.
	4) Added the 'U'nique mode to only check for files that exist
	   in one directory but not in the other.
	5) Changed so that command-line filter modes are not written
	   to the .ini file.
	6) Added support for entering a comment line which is placed
	   in the snapshot file.
	7) Added 'partial' drag/drop support in that files can be dragged
	   from either of the PMDMatch containers to a WorkPlace Shell
	   folder.
	8) Corrected so you can change the directory in one container
	   without losing the snapshot in the other.
	9) Added the ability to generate a .cmd file containing all
	   of the actions to take so it can be run later or on another
	   system.
	10) Corrected handling when the editor or comparitor don't exist.

1.09h
	1) Added the ability to turn off showing the progress dialog.
	2) Added the ability to invoke a compare program of the user's
	   choice to compare the two files' contents.
	3) Corrected a bug where the 'swap' function wouldn't dismiss
	   the progress dialog.
	4) Corrected a bug where the command-line snapshot didn't
	   close when finished.
	5) Added the total number of files in each container to the
	   statistics dialog box.

1.09g
	1) Added a check to see if the snapshot file exists.
	2) Added the /1 option for displaying just a single
	   directory.
	3) Added the ability to capture a snapshot from the
	   command line.
	4) Added the ability for the user to put comments in a
	   snapshot file.
	5) Better handling of 'same' directory; if the directory
	   in the box is also on the drive which gets chosen, leaves
	   it there rather than going to root.
	6) Added a conditional cascade menu to the 'mark all' on the
	   popup menu so you can specify to 'mark all and copy', etc.
	   You can set the default item to be used in the 'mark/clear
	   modes' dialog.
	7) Added another column to display the Extended Attributes sizes.

1.09f
	1) Added a dialog box to indicate 'busy/in progress' rather than
	   just using the 'alarm clock' pointer.
	2) Added {ahrs} indications of 'archived', 'hidden', 'read-only',
	   and/or 'system' files at the end of the file name.
	3) Added an option to control whether the {a}rchived attribute
	   is to be indicated or not.
	4) Added an checkbox to the 'filters' dialog to control whether
	   or not 'system/hidden' files are included.
	5) Changed so that several threads can be active at a time
	   when copying/etc. files to improve performance.
	   
1.09e
	1) Added the ability to specify the name of a file containing
	   a list of file names which are the only ones to be shown,
	   either with a command line option or the filter dialog box.
	2) Added the ability to include the files in all of the
	   subdirectories below the current ones.  Building the lists
	   for an entire drive can be time-consuming so use with care.
	   It can be turned on from the command line with the /R switch
	   or checked on the option menu.  The setting is NOT saved in
	   the pmdmatch.ini file.

	   Because of having added this feature, I found that I needed
	   to change the contents of 'snapshot' files so those taken
	   with 1.09d will not work.  However, you can manually change
	   them to be compatible if you really need to by adding a line
	   at the top of the file.  It needs to be the complete drive/
	   path specification of the directory that was current when
	   the snapshot was taken.  It must be enclosed in double-quotes
	   and end with a backslash as in the following example (it does
	   not have to be in any particular case-all lower, upper, or
	   mixed is fine):
	   
	   "C:\CUR\DIR\AT\SNAPSHOT\"

	3) More minor 'cosmetic' corrections and bug fixes

1.09d
	1) Added the ability to save and load a 'snapshot' list of
	   the files selected in a container for use in a comparison-
	   only mode
	2) Reduced the button spacing so the buttons can be as large
	   as possible so larger text will fit on them
	3) Several other minor 'cosmetic' corrections and bug fixes

1.09c
	1) Corrected a bug which gave a fatal error when trying
	   to copy a non-8.3 format filename to a floppy
	2) Moved the 'both', 'same', and 'filters' menu items from
	   the 'file' menu to the 'view' menu to be more CUA
	   compliant
	3) Corrected a bug where the 'alike' filter mode showed more
	   than just 'alike' files
	4) Corrected a bug that prevented the 'ignore read-only'
	   from resetting the read-only attribute on the target

1.09b
	1) Added the ability to double-click in the containers
	   title areas to bring up the directory selection dialog
	   box
	2) Put a directory selection list box into the dialog so
	   either or both directories can be chosen at the same
	   time
	3) Added the /S option to display the directory selection
	   dialog box when first starting up

1.09a
	1) Corrected so 'help' can be found in the directory
	   from which the .exe was run, if it's not in the
	   'set HELP=' path
	2) Corrected so directory selection list doesn't return
	   file names from a Novell network drive

1.09
	1) Made the directory selection dialog box larger (and
	   added a horizontal scroll bar) so it would show more
	   drives/directories at once
	2) Corrected so the directory selection list box shows
	   FAT directories in sorted order
	3) Implemented 'move' option
	4) Added a pop-up menu for the containers
	5) Added an option to show or not show the buttons since
	   the popup menu can do all they do
	6) Added a check box to the directory selection dialog box
	   to allow showing the entire tree of subdirectories below
	   the current level or just the next level (this may be
	   replaced with a container tree view control someday)

1.08
	1) Added a /L command line option for specifying 'filter All'
	2) Implemented 'Ignore Read-Only attributes' option
	3) Corrected bugs with using tab/arrow keys to move among
	   controls (buttons and containers)
	4) Implemented 'Highlight identical files' option
	5) Changed filter toggle cycling key from F8 to F7
	6) Added a Swap-F8 button.  Note that this will cause the
	   customized colors/fonts of the buttons to be lost the first
	   time this new version is run and they will have to be setup
	   again <sorry>

1.07
	1) Corrected a directories display problem which occurred when
	   there was no .ini file and PMDMatch was first run without
	   any command line directories
	2) Changed colorization so that the default system colors are
	   used until drag/drop has been done to customize them so the
	   user doesn't feel they're locked into my arbitrary choice of
	   colors
	3) Corrected problems with the directory choices dialog box

1.06
	1) Added 'exclude' filter handling

1.05
	1) Corrected some error message handling problems when one of
	   the directories being specified didn't exist
	2) Reworked 'include' filter handling
	3) Enhanced error handling during 'dir'/'drive' selections
	
1.04
	1) Corrected a problem where closing while still filling the
	   containers would report an error by disabling 'close' on
	   the system menu
	2) Added 'Abort/Retry/Ignore' to error message/handling
	3) Changed 'About to' messages to be informational instead
	   of questions (eliminates beep as well)
	4) Corrected an access violation bug
	5) Added simple animation to the About box
	6) Added 'include' filter handling
	7) Corrected a problem where files which were only different
	   in size didn't show up in the different/modified views.
	   They now show but neither is high-lighted since it's
	   impossible to tell which is 'newer'

1.03
	1) Corrected directory selection so selecting drive letters
	   refreshes the directory list
	2) Corrected a bug where double-clicking on an empty container
	   window caused an access violation

1.02
	1) Corrected multiple instances problem
	2) Changed directory selection dialog to be common
	3) Corrected 'delete' file 'in-use' emphasis
	4) Corrected a problem when trying to specify just a drive
	   on the command-line so it uses that drive's current
	   directory
1.01
	1) Main funtionality complete

1.00
	1) Initial release
