OS/2 Professional

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 | 21.2 KB | 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!