home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 6 File
/
06-File.zip
/
pmdmatch.zip
/
readme.doc
< prev
Wrap
Text File
|
1995-05-20
|
17KB
|
387 lines
***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