home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Professional
/
OS2PRO194.ISO
/
os2
/
wps
/
file
/
pmdmatch
/
pmdmatch.hlp
(
.txt
)
< prev
next >
Wrap
OS/2 Help File
|
1994-02-27
|
22KB
|
564 lines
ΓòÉΓòÉΓòÉ 1. About PMDMatch ΓòÉΓòÉΓòÉ
PMDMatch is an OS/2 version of 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, 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). Support is provided in the 'shareware' section
of OS2BVEN on CompuServe.
ΓòÉΓòÉΓòÉ 2. Command line parameters ΓòÉΓòÉΓòÉ
There are several command line switches and parameters which can control the
way PMDMatch starts up.
Any parameters on the command line which are not immediately preceeded by a
dash (-) or forward slash (/) are assumed to be a directory name. The first
such parameter encountered is used as the Left directory name and the second
one is used as the Right directory. Unless the /B option (see below) is
specified, these are saved after the previous execution and used for the next
time if no directories are supplied on the command line.
The following parameters can be supplied on the command line:
/B - This will bypass the usage of the previously specified directory locations
and will bypass saving them when the current execution session is terminated.
/L - This will show all files in both directories, regardless of comparison
to/existence of files in the other directory.
/A - This will only show files which have the same name as in the other
directory, regardless of their relative dates/sizes.
/D - This will only show files which either don't exist in the other directory
or have a different date/size.
/M - This will only show files which have the same name as in the other
directory and have a different date/size.
If no filter option is supplied and there has not been a previous execution
which changed the setting, it will default to show all.
ΓòÉΓòÉΓòÉ 3. PMDMatch.ini file ΓòÉΓòÉΓòÉ
Almost all configurable information is saved in the PMDMatch.ini file. When
the program starts, it checks the current directory first. If a PMDMatch.ini
file is found, it is used. If it is not found, the PMDMatch.ini in the
directory where the PMDMatch.exe file is located is used. If it does not
exist, it will be created. This allows the program to save colors, position
information, directory choices, fonts, etc. so you can configure it to look the
way you want and those settings will be used at the next execution. You can
use the Save Options menu to immediately save all the settings to the current
directory.
ΓòÉΓòÉΓòÉ 4. Color/Font customization ΓòÉΓòÉΓòÉ
In addition to checking/unchecking the items on the Options menu, you can also
customize the appearance of PMDMatch. The directory containers and all of the
buttons can be individually set by drag/drop operations from the Color and Font
palettes. In order to change the color of the text, be sure to hold down the
Ctrl key while drag/dropping the color from the Color palette.
ΓòÉΓòÉΓòÉ 5. File menu ΓòÉΓòÉΓòÉ
The functions on this menu are related to defining the directories and filters
used in comparing the directories, printing comparisons, and exiting the
program.
ΓòÉΓòÉΓòÉ 6. File-Left Directory ΓòÉΓòÉΓòÉ
Choosing this item will present a dialog box which allows you to select a
directory to display in the left directory container.
ΓòÉΓòÉΓòÉ 7. File-Right Directory ΓòÉΓòÉΓòÉ
Choosing this item will present a dialog box which allows you to select a
directory to display in the right directory container.
ΓòÉΓòÉΓòÉ 8. File-Same Directory ΓòÉΓòÉΓòÉ
Choosing this item will present a dialog box which allows you to select drive
letters and a directory to display in both the left and right directory
containers.
ΓòÉΓòÉΓòÉ 8.1. Drive/Directory selection ΓòÉΓòÉΓòÉ
This dialog box allows you to choose the directory to display in the container
window.
ΓòÉΓòÉΓòÉ 8.2. Select drive ΓòÉΓòÉΓòÉ
This drops down a list of drive letters which can be selected to go with the
directory selected.
ΓòÉΓòÉΓòÉ 8.3. Select show sub directories ΓòÉΓòÉΓòÉ
This check box controls whether the directory list box shows all of the
directories below the current level (checked) or just those at the next level
(unchecked).
ΓòÉΓòÉΓòÉ 8.4. Select directory ΓòÉΓòÉΓòÉ
This shows a list of directories for the drive letters which is enabled. In
the case of selecting the same directory, where both drive letters are enabled,
this is the directories on the last drive that was selected.
ΓòÉΓòÉΓòÉ 9. File-Filters ΓòÉΓòÉΓòÉ
This dialog box allows you to select how the data in the two directories is
filtered before being displayed. It can first be filtered for which files to
include, then which of those files to exclude, and finally by one of four
comparison views categories; All, Alike, Different, and Modified.
ΓòÉΓòÉΓòÉ 9.1. Filter include ΓòÉΓòÉΓòÉ
This entry field allows you to enter a list of 'wild-card' specifications,
separated by commas, of the files you want to process. For instance, '*.*'
will get all of the files in the directory and '*.c,*.h*' will get all of the
files ending in .c as well as all of the files containing .h. Files to be
'excluded' are checked after the list of 'included' files is built.
ΓòÉΓòÉΓòÉ 9.2. Filter exclude ΓòÉΓòÉΓòÉ
This entry field allows you to enter a list of 'wild-card' specifications,
separated by commas, of the files which you want excluded from those that
qualified to be included. For instance, '*.obj' will skip all object files in
the directory and '*.obj, *.tmp*' will skip both object and temporary files.
Files to be 'excluded' are checked after the list of 'included' files is built.
ΓòÉΓòÉΓòÉ 9.3. Filter views ΓòÉΓòÉΓòÉ
The views categories are:
o All - This will show all files in both directories, regardless of comparison
to/existence of files in the other directory.
o Alike - This will only show files which have the same name as in the other
directory, regardless of their relative dates/sizes.
o Different - This will only show files which either don't exist in the other
directory or have a different date/size.
o Modified - This will only show files which have the same name as in the other
directory and have a different date/size.
ΓòÉΓòÉΓòÉ 10. File-Exit ΓòÉΓòÉΓòÉ
Choosing this item will exit the program.
ΓòÉΓòÉΓòÉ 11. Edit menu ΓòÉΓòÉΓòÉ
The functions on this menu are related to defining the editor to be used when
viewing files.
ΓòÉΓòÉΓòÉ 12. Edit-Editor ΓòÉΓòÉΓòÉ
This dialog box allows you to select the program you want to use for viewing
files and any options options you want passed to it. A file can be viewed by
either double-clicking on its entry in the directory window or using the cursor
to position to the file entry you want to view and hitting <Enter>.
ΓòÉΓòÉΓòÉ 12.1. Editor program ΓòÉΓòÉΓòÉ
This is the editor program that will be started and passed the name of the
chosen file.
ΓòÉΓòÉΓòÉ 12.2. Editor options ΓòÉΓòÉΓòÉ
This is the editor options that can be supplied to the editor when it is
started to view the chosen file.
ΓòÉΓòÉΓòÉ 13. Options menu ΓòÉΓòÉΓòÉ
The functions on this menu are related to the setup options for the utility.
These options (and many other settings) are kept in the PMDMatch.ini file.
ΓòÉΓòÉΓòÉ 14. Options-Display logo ΓòÉΓòÉΓòÉ
This menu check item option controls whether the program logo is displayed
(checked) or not (unchecked) when the program starts up. However, it adheres
to the system settings for the Logo so if you set the system to not display
Logos, it won't display even if this is checked.
ΓòÉΓòÉΓòÉ 15. Options-Show buttons ΓòÉΓòÉΓòÉ
This menu check item option controls whether the push-buttons at the bottom are
displayed (checked) or not (unchecked). If you prefer using the popup menu,
you can get extra room in the directory containers by turning off the buttons.
And even with the buttons not showing, you can still use the 'F'unction keys...
ΓòÉΓòÉΓòÉ 16. Options-Highlight identical files ΓòÉΓòÉΓòÉ
This menu check item option controls whether identical file are highlighted
(checked) or not (unchecked) when they are displayed in the 'All' and 'Alike'
modes.
ΓòÉΓòÉΓòÉ 17. Options-Move is Copy/Delete ΓòÉΓòÉΓòÉ
This menu check item option controls whether a 'move' is done by first doing a
copy and then deleting the source file (checked) or a standard move
(unchecked). A standard move will fail if the target file exists, so it will
usually work better to have this checked.
ΓòÉΓòÉΓòÉ 18. Options-Ignore Read-Only attributes ΓòÉΓòÉΓòÉ
This menu check item option controls whether any target files for copy and
delete operations have their 'read-only' attribute reset (checked) or not
(unchecked) before the operation. This allows you to overwrite or delete files
that you may not want to, so be very careful with this setting!
ΓòÉΓòÉΓòÉ 19. Options-Mark/Clear modes ΓòÉΓòÉΓòÉ
This dialog box allows you to specify what happens when the Mark and Clear
buttons are used. The Mark button can be set to mark (select) either all the
items on the left or all the items on the right. The Clear button can be set
to clear (deselect) either all the items on the left, all the items on the
right, or all items on both sides.
ΓòÉΓòÉΓòÉ 19.1. Mark mode ΓòÉΓòÉΓòÉ
This determines whether all the items on the left or right are marked
(selected) when the Mark button is used.
ΓòÉΓòÉΓòÉ 19.2. Clear mode ΓòÉΓòÉΓòÉ
This determines whether all the items on the left, right or both are cleared
(deselected) when the Clear button is used.
ΓòÉΓòÉΓòÉ 20. Options-Confirm on Copy ΓòÉΓòÉΓòÉ
This menu check item option controls whether a confirmation dialog logo is
displayed (checked) or not (unchecked) before doing a copy.
ΓòÉΓòÉΓòÉ 21. Options-Confirm on Move ΓòÉΓòÉΓòÉ
This menu check item option controls whether a confirmation dialog logo is
displayed (checked) or not (unchecked) before doing a move.
ΓòÉΓòÉΓòÉ 22. Options-Confirm Delete ΓòÉΓòÉΓòÉ
This menu check item option controls whether a confirmation dialog logo is
displayed (checked) or not (unchecked) before doing a delete.
ΓòÉΓòÉΓòÉ 23. Options-Confirm on Esc cancel/Abort ΓòÉΓòÉΓòÉ
This menu check item option controls whether a confirmation dialog logo is
displayed (checked) or not (unchecked) before doing a cancel (initiated by
using the <Esc> key during an operation) or Abort (in response to an error
message dialog box).
ΓòÉΓòÉΓòÉ 24. Options-Confirm on Exit ΓòÉΓòÉΓòÉ
This menu check item option controls whether a confirmation dialog logo is
displayed (checked) or not (unchecked) before exiting the program.
ΓòÉΓòÉΓòÉ 25. Options-Save options ΓòÉΓòÉΓòÉ
This menu item acts like a pushbutton. When you click on it, all of the
current program settings are saved immediately to a PMDMatch.ini file in the
current directory.
ΓòÉΓòÉΓòÉ 26. Popup menu ΓòÉΓòÉΓòÉ
The functions on this menu are available when Mouse Button 2 (MB2) is clicked
over either of the containers. If it is clicked over an 'open' area or over a
selected file, the copy/move/delete items will apply to all of the selected
files, just as if the buttons had been used. If it is clicked over a file that
is NOT selected, the copy/move/delete items will apply to that individual file.
ΓòÉΓòÉΓòÉ 27. Popup-Copy ΓòÉΓòÉΓòÉ
Choosing this item will copy the file(s). If MB2 was clicked over a file that
is NOT selected, that file will be copied; if not, all selected files will be
copied.
ΓòÉΓòÉΓòÉ 28. Popup-Move ΓòÉΓòÉΓòÉ
Choosing this item will move the file(s). If MB2 was clicked over a file that
is NOT selected, that file will be moved; if not, all selected files will be
moved.
ΓòÉΓòÉΓòÉ 29. Popup-Delete ΓòÉΓòÉΓòÉ
Choosing this item will delete the file(s). If MB2 was clicked over a file
that is NOT selected, that file will be deleted; if not, all selected files
will be deleted.
ΓòÉΓòÉΓòÉ 30. Mark button ΓòÉΓòÉΓòÉ
Choosing this using the button selects ALL of the entries in accordance with
the the Mark/Clear modes settings; choosing it from the popup menu selects ALL
of the entries for the container over which the menu pops up.
ΓòÉΓòÉΓòÉ 31. Clear button ΓòÉΓòÉΓòÉ
Choosing this using the button clears ALL of the directory items in accordance
with the settings of the Mark/Clear modes settings; choosing it from the popup
menu clears ALL of the entries for the container over which the menu pops up.
ΓòÉΓòÉΓòÉ 32. Copy button ΓòÉΓòÉΓòÉ
Choosing this (either by using the button or from the popup menu) starts
copying the selected files from either directory into the other.
ΓòÉΓòÉΓòÉ 33. Move button ΓòÉΓòÉΓòÉ
Choosing this (either by using the button or from the popup menu) starts moving
the selected files from either directory into the other in accordance with the
setting for Move does Copy/Delete.
ΓòÉΓòÉΓòÉ 34. Delete button ΓòÉΓòÉΓòÉ
Choosing this (either by using the button or from the popup menu) starts
deleting the selected files from either directory.
ΓòÉΓòÉΓòÉ 35. Swap button ΓòÉΓòÉΓòÉ
Choosing this (either by using the button or from the popup menu) swaps the
contents of the two directory container windows.
ΓòÉΓòÉΓòÉ 36. Stats button ΓòÉΓòÉΓòÉ
Choosing this (either by using the button or from the popup menu) brings up the
Statistics dialog box. It displays statistics about both of the directories.
ΓòÉΓòÉΓòÉ 36.1. Stats dialog ΓòÉΓòÉΓòÉ
The Statistics dialog is a non-modal, display-only dialog box. What this means
is that is can remain visible and continue being updated while other operations
are performed and no input is accepted from the user.
ΓòÉΓòÉΓòÉ 37. Refresh button ΓòÉΓòÉΓòÉ
Choosing this (either by using the button or from the popup menu) refreshes the
contents of the directories. It will read the contents of both the directories
and update the directory windows accordingly. This means you can leave the
program open, do file operations using other means (such as the command line),
and still be able to perform directory matching.
ΓòÉΓòÉΓòÉ 38. Help Menu ΓòÉΓòÉΓòÉ
The choices on the Help pull-down provide the following:
Help index
Displays the index of the help menu.
General Help
Provides detailed information on using the PMDMatch utility.
Keys Help
Provides information about keys/mouse usage.
Using Help
Displays information about using the PMDMatch utility's help.
ΓòÉΓòÉΓòÉ 39. Help-Using ΓòÉΓòÉΓòÉ
Use this choice to obtain information on how to use the Help facility.
ΓòÉΓòÉΓòÉ 40. Help-General ΓòÉΓòÉΓòÉ
Use this choice to get general help for the program. General help provides
general information about the PMDMatch utility.
ΓòÉΓòÉΓòÉ 41. Help-Keys ΓòÉΓòÉΓòÉ
Use this choice to see a list of keys and a description of the function of the
keys.
ΓòÉΓòÉΓòÉ 41.1. Keyboard ΓòÉΓòÉΓòÉ
FUNCTION KEYS
F2-Mark Selects all of the directory items.
F3-Clear Clears all of the directory items.
F4-Copy Copies the selected files.
F5-Move Moves the selected files.
F6-Delete Deletes the selected files.
F7- Cycles through the filter views.
F8-Swap Swaps the contents of the directory container windows.
F10-Stats Displays the Statistics dialog box.
F11 Displays the Help index.
F12-Refresh Refreshes the contents of the directories.
Alt+F4 Exits the application.
UTILITY KEYS
The keyboard can also be used for some of the utility activities. In general,
you can use the underlined letter when the menus are pulled down to select that
menu item. The 'Alt' key in conjunction with the underlined letter will select
them when the menus are not pulled down. In addition, some accellerator keys
have been defined to perform some of the utility functions directly. These are
listed below:
Ctrl+L Bring up the Left directory selection dialog box.
Ctrl+R Bring up the Right directory selection dialog box.
Ctrl+F Bring up the Filters setting dialog box.
Ctrl+Alt+F Cycles through the filter views.
Esc This can be used to cancel and dismiss any dialog box.
SYSTEM KEYS
These keys can be used to leave the utility (intact) and make use of some other
OS/2 program/feature:
Alt+Esc Switch to the next program, including full-screen programs
Ctrl+Esc Switch to the Task List
ΓòÉΓòÉΓòÉ 41.2. Mouse ΓòÉΓòÉΓòÉ
MOUSE
ΓòÉΓòÉΓòÉ 42. Help-Contents ΓòÉΓòÉΓòÉ
Use this choice to display the help table of contents. The help table of
contents lists the titles of the help information in order by contents.
ΓòÉΓòÉΓòÉ 43. Help-Index ΓòÉΓòÉΓòÉ
Use this choice to display the help index. The help index lists the titles of
the help information in alphabetical order.
ΓòÉΓòÉΓòÉ 44. Help-Product Information ΓòÉΓòÉΓòÉ
This dialog displays information about the application, such as version number
and copyright notice.
ΓòÉΓòÉΓòÉ 45. Help-Registration Information ΓòÉΓòÉΓòÉ
This product is NOT freeware. It is distributed under the ShareWare concept
and depends upon registration fees in order to support its development. This
concept urges you to give the entire set of program files to others to try
before they buy. But if you find the program useful, please send your $25
registration fee to:
Leading the Way
Larry R. Waibel
427 Haverford Road
Ramona, Calif. 92065
Questions and technical support can also be addressed to the author via the
'shareware' section of the CompuServe OS2BVEN forum, ID 71333,2463 or
70441,1274...
NOTE: The OS/2 Ready! mark is a trademark of International Business Machines
Corporation.
ΓòÉΓòÉΓòÉ 46. Dialog Ok ΓòÉΓòÉΓòÉ
This applies all of the changes made in the dialog.
ΓòÉΓòÉΓòÉ 47. Dialog Cancel ΓòÉΓòÉΓòÉ
This dismisses the dialog box and discards all of the changes made in the
dialog.
ΓòÉΓòÉΓòÉ 48. Dialog Help ΓòÉΓòÉΓòÉ
This shows the general help for the dialog box.
ΓòÉΓòÉΓòÉ 49. Error handling ΓòÉΓòÉΓòÉ
When the program starts up, it attempts to create a PMDMATCH.ERR file in the
current directory; if that file exists, it tries to create PMDMBTCH.ERR, and so
on. If the program ends abnormally for some reason, this file will left and
its contents may help the author track down the problem. But if your system
'crashes' or is improperly shutdown while PMDMatch is running, these files will
be left as well; they can be deleted without causing any problems for PMDMatch.
Another type of error that can happen will bring up a message box indicating
that an *Error with a given code has occurred at a certain line number in a
certain program file. If you get this type of error, a MYPMERRS.ERR file will
be written in the current directory which contains that information and may
also be needed by the author; it can also be deleted without problem.
Finally, some 'recoverable' DOS API errors (such as access denied when trying
to write to a read-only file or the floppy drive not being ready) can occur
which will bring up a message box allowing you to Abort, Retry, or Ignore the
operation currently in progress. Just click the appropriate button.
ΓòÉΓòÉΓòÉ 50. UNKNOWN ΓòÉΓòÉΓòÉ
There is no help for this item at this time. Please contact the author so he
can supply the help needed!