home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / pmdmatch.zip / readme.doc < prev   
Text File  |  1995-05-20  |  17KB  |  387 lines
  1.   ***TLIB-keywords*** "%n: Version %v at %f"
  2.   "readme.doc: Version 20 at 20-May-95,12:39:12"
  3.  
  4.   ***TLIB-revision-history***
  5. * 1 readme.doc 17-Dec-93,22:29:52 PMDMatch 'readme' file
  6. * 2 readme.doc 31-Dec-93,20:33:52 Changes for v1.04
  7. * 3 readme.doc 4-Jan-94,20:47:02 Changes for v1.05
  8. * 4 readme.doc 7-Jan-94,8:02:36 Changes for v1.06
  9. * 5 readme.doc 14-Jan-94,12:15:32 Changes for v1.07
  10. * 6 readme.doc 26-Jan-94,20:23:16 Changes for v1.08
  11. * 7 readme.doc 27-Feb-94,10:52:32 Changes for v1.09
  12. * 8 readme.doc 19-Mar-94,12:30:38 Changes for v1.09b
  13. * 9 readme.doc 21-Apr-94,20:34:20 Changes for v1.09c
  14. * 10 readme.doc 21-May-94,16:23:30 Changes for v1.09d
  15. * 11 readme.doc 18-Jul-94,19:24:58 Changes for v1.09e
  16. * 12 readme.doc 19-Aug-94,18:47:46 Changes for v1.09f
  17. * 13 readme.doc 24-Sep-94,09:41:06 Changes for v1.09g
  18. * 14 readme.doc 21-Oct-94,21:20:02 Changes for v1.09h
  19. * 15 readme.doc 23-Dec-94,14:40:26 Changes for v1.09i
  20. * 16 readme.doc 27-Jan-95,19:43:26 Changes for v1.09j
  21. * 17 readme.doc 11-Mar-95,13:36:02 Changes for v1.09.11
  22. * 18 readme.doc 31-Mar-95,07:16:22 Changes for v1.09.12
  23. * 19 readme.doc 15-Apr-95,15:54:46 Changes for v1.09.13
  24. * 20 readme.doc 20-May-95,12:39:12 Changes for v1.09.14
  25.   ***TLIB-revision-history***
  26.  
  27. PMDMatch is an OS/2 utility inspired by the DirMatch utility
  28. originally published years ago in PC Magazine.  I use it to
  29. maintain floppy backups of the projects I'm working on by
  30. matching the project directory with the same directory on
  31. the floppy and only having to copy files that are newer.  It
  32. can also be used when merging a software update (by taking
  33. a 'snapshot' before the installation and then comparing
  34. that to the resulting directories afterward), as a file
  35. viewer, and for limited directory management (it is a specific
  36. purpose utility, so don't expect a full-fledged directory
  37. management package, although I have tried to provide as many
  38. features and make it as flexible/configurable as I could).
  39. Just unzip or copy the files to a directory of your choice and
  40. run it from there.
  41.  
  42. NOTE:  If you obtained PMDMatch as a single .zip file, it is
  43. packaged using Info-ZIP's compression utility.  Info-ZIP's
  44. software (Zip, UnZip and related utilities) is free and can
  45. be obtained as source code or executables from various
  46. bulletin board services and anonymous-ftp sites, including
  47. CompuServe's IBMPRO forum and ftp.uu.net:/pub/archiving/zip/*.
  48.  
  49. One way to run the first time is:
  50.  
  51.   PMDMatch dirpath1 dirpath2
  52.  
  53. This will bring up PMDMatch and compare the two directories.
  54. It will also create an initial 'PMDMatch.ini' file in the
  55. directory from which it was run to hold your personalized
  56. settings such as color, font, options, etc.  The 'dirpath's
  57. can be full or relative specifications with or without drive
  58. letter.  Then take a look through the help contents or index
  59. and learn about the other options and usage.
  60.  
  61. Or, if you have the .zip file you can use the PMDSetup.cmd;
  62. just tell it where you put the PMDMatch.exe when it asks and
  63. it will create an object on the desktop for you.  If you have
  64. the disk installation, after running the install program a
  65. folder will have been created for you.
  66.  
  67. After installing, I suggest you go through the 'help' contents and
  68. find all of the things it can do.  You can get context sensitive
  69. help on any item by pressing F1 when it has the focus.
  70.  
  71. Here's the stuff I still intend to (someday <s>) add, not in
  72. any particular order and based upon how much demand (and time)
  73. there is for them:
  74.  
  75. 1) Add the ability to move/copy to a different target than the
  76.    other container by a selection choice when confirmation is
  77.    enabled
  78.  
  79. 2) Implement full 'drag and drop' to copy/move files
  80.  
  81. 3) Change selection directory control to a container and
  82.    allow tree or single level display of directories (low
  83.    priority)
  84.  
  85. 4) Implement printing (The 'snapshot' file is a comma-
  86.    delimited ASCII text file so you may be able to use
  87.    that in the meantime.)
  88.  
  89. 5) Add the ability to choose to have the directory containers
  90.    one on top of the other or side by side as they are now
  91.    (depends upon how many want this)
  92.  
  93. I try to keep my registered users at least a version
  94. ahead of the one I upload to OS2BVEN, so if you want to be
  95. sure to get the latest, please be sure and register!  The only
  96. difference between this shareware and commercial software is
  97. that you get the chance to try it before you spend your hard-
  98. earned money.  But if you continue to use it, you are obligated
  99. to pay the author for the MANY hundreds of hours that are still
  100. going into its development!
  101.  
  102. Credits:
  103. I'd like to thank my wife Liz for, as she puts it, "getting
  104. to know the back of my head very well" while I've been working
  105. on this program.  I'm also very indebted to Bill Speights for
  106. his help in testing and proof-reading and his wife Sarah for
  107. putting up with us!  And without the answers to those 'undocumented'
  108. container questions by Rick Fishman, none of this would have
  109. been possible!  I also want to acknowledge the unsolicited help
  110. that Mark Kimes (FM/2 author) has given me on more than one
  111. occasion such that I ended up adding some features even sooner
  112. than I had planned.
  113.  
  114. Known Problems:
  115. (I'm working on these, but if I keep waiting until I get them
  116. all fixed, I'll never get the new functions available <g>.)
  117. 1) Some users are getting an error after deleting a number of
  118.    files on a network drive.  The error indicates there's a
  119.    problem starting more threads.  I'm still trying to find
  120.    out the common cause; I can't get it to fail for me.
  121. 2) Some users report that the 'Load to/Save from' text on the
  122.    snapshot dialogs is cut off but I can't find what I'm doing
  123.    wrong and, of course, it looks fine on my systems.  So far
  124.    I've only had a report of this on a German version of OS/2.
  125.    I'd be interested to know if it's happening anywhere else.
  126. 3) The function keys entries for copy/move/etc. and some other
  127.    menu items should be disabled when a 'snapshot' is loaded.
  128.  
  129. Version History:
  130. 1.09.14
  131.     1) Corrected a bug in setting the state of the Show Progress
  132.        check box.
  133.     2) Changed metering to charge on a per functional operation
  134.        (such as copying selected files) rather than per startup.
  135.     3) Added a settings checkbox to control whether or not there
  136.        is progress animation in the containers when actions are
  137.        being performed.
  138.     4) Added a settings checkbox to control whether or not the
  139.        containers are automatically refreshed after an action.
  140.     5) Corrected a bug which didn't allow cancelling a direct
  141.        edit of a file name.
  142.     6) Corrected a bug where files with different attributes
  143.        didn't show in the modified filter mode when they should
  144.        have.
  145.  
  146. 1.09.13
  147.     1) Added the ability specify which of the fields are used when
  148.        determining if the files are different or not.
  149.     2) Added IdeaFarm(tm) 'meterware' support.
  150.  
  151. 1.09.12
  152.     1) Added the ability to use Alt-MB1 click (or the popup menu)
  153.        to edit the name of a file.
  154.     2) Added the ability to use Alt-MB1 click to edit and change
  155.        either of the directories directly without having to use
  156.        the directory selection dialog.
  157.     3) Added a setting in the options notebook to set whether or
  158.        not to include subdirectories at startup
  159.  
  160. 1.09.11
  161.     1) Added handling of 'hard errors'.
  162.     2) Changed version numbering style to work with Software
  163.        Installer/2.
  164.     3) Corrected a problem where rapid clicking on check boxes
  165.        would miss some of the clicks.
  166.     4) Corrected a problem where the 'progress' dialog didn't
  167.        continue to display when the 'cancel' was canceled.
  168.  
  169. 1.09j
  170.     1) Added the ability to mark just the newer files.
  171.     2) Moved many of the check-menu options to a settings
  172.        notebook.
  173.     3) Now adds a snapshot comment as a '.COMMENTS' EA as well
  174.        as putting it in the file.
  175.     4) Corrected so compare will be on the popup whenever the
  176.        pointer is over a file which has a corresponding file in
  177.        the other container, no matter what other items (if any)
  178.        are selected.
  179.     5) Added additional accelerator keys: Ctrl-I to toggle the
  180.        Include Subdirectories state, Ctrl-Alt-ADLMU for setting
  181.        the Filter views.
  182.  
  183. 1.09i
  184.     1) Added the ability to create the destination directory if
  185.        it doesn't exist.
  186.     2) Added the ability to open a directory as a folder on the
  187.        desktop.
  188.     3) Added the /O ('O'perating system attributes) command-line
  189.        switch to show operating system/hidden files.
  190.     4) Added the 'U'nique mode to only check for files that exist
  191.        in one directory but not in the other.
  192.     5) Changed so that command-line filter modes are not written
  193.        to the .ini file.
  194.     6) Added support for entering a comment line which is placed
  195.        in the snapshot file.
  196.     7) Added 'partial' drag/drop support in that files can be dragged
  197.        from either of the PMDMatch containers to a WorkPlace Shell
  198.        folder.
  199.     8) Corrected so you can change the directory in one container
  200.        without losing the snapshot in the other.
  201.     9) Added the ability to generate a .cmd file containing all
  202.        of the actions to take so it can be run later or on another
  203.        system.
  204.     10) Corrected handling when the editor or comparitor don't exist.
  205.  
  206. 1.09h
  207.     1) Added the ability to turn off showing the progress dialog.
  208.     2) Added the ability to invoke a compare program of the user's
  209.        choice to compare the two files' contents.
  210.     3) Corrected a bug where the 'swap' function wouldn't dismiss
  211.        the progress dialog.
  212.     4) Corrected a bug where the command-line snapshot didn't
  213.        close when finished.
  214.     5) Added the total number of files in each container to the
  215.        statistics dialog box.
  216.  
  217. 1.09g
  218.     1) Added a check to see if the snapshot file exists.
  219.     2) Added the /1 option for displaying just a single
  220.        directory.
  221.     3) Added the ability to capture a snapshot from the
  222.        command line.
  223.     4) Added the ability for the user to put comments in a
  224.        snapshot file.
  225.     5) Better handling of 'same' directory; if the directory
  226.        in the box is also on the drive which gets chosen, leaves
  227.        it there rather than going to root.
  228.     6) Added a conditional cascade menu to the 'mark all' on the
  229.        popup menu so you can specify to 'mark all and copy', etc.
  230.        You can set the default item to be used in the 'mark/clear
  231.        modes' dialog.
  232.     7) Added another column to display the Extended Attributes sizes.
  233.  
  234. 1.09f
  235.     1) Added a dialog box to indicate 'busy/in progress' rather than
  236.        just using the 'alarm clock' pointer.
  237.     2) Added {ahrs} indications of 'archived', 'hidden', 'read-only',
  238.        and/or 'system' files at the end of the file name.
  239.     3) Added an option to control whether the {a}rchived attribute
  240.        is to be indicated or not.
  241.     4) Added an checkbox to the 'filters' dialog to control whether
  242.        or not 'system/hidden' files are included.
  243.     5) Changed so that several threads can be active at a time
  244.        when copying/etc. files to improve performance.
  245.        
  246. 1.09e
  247.     1) Added the ability to specify the name of a file containing
  248.        a list of file names which are the only ones to be shown,
  249.        either with a command line option or the filter dialog box.
  250.     2) Added the ability to include the files in all of the
  251.        subdirectories below the current ones.  Building the lists
  252.        for an entire drive can be time-consuming so use with care.
  253.        It can be turned on from the command line with the /R switch
  254.        or checked on the option menu.  The setting is NOT saved in
  255.        the pmdmatch.ini file.
  256.  
  257.        Because of having added this feature, I found that I needed
  258.        to change the contents of 'snapshot' files so those taken
  259.        with 1.09d will not work.  However, you can manually change
  260.        them to be compatible if you really need to by adding a line
  261.        at the top of the file.  It needs to be the complete drive/
  262.        path specification of the directory that was current when
  263.        the snapshot was taken.  It must be enclosed in double-quotes
  264.        and end with a backslash as in the following example (it does
  265.        not have to be in any particular case-all lower, upper, or
  266.        mixed is fine):
  267.        
  268.        "C:\CUR\DIR\AT\SNAPSHOT\"
  269.  
  270.     3) More minor 'cosmetic' corrections and bug fixes
  271.  
  272. 1.09d
  273.     1) Added the ability to save and load a 'snapshot' list of
  274.        the files selected in a container for use in a comparison-
  275.        only mode
  276.     2) Reduced the button spacing so the buttons can be as large
  277.        as possible so larger text will fit on them
  278.     3) Several other minor 'cosmetic' corrections and bug fixes
  279.  
  280. 1.09c
  281.     1) Corrected a bug which gave a fatal error when trying
  282.        to copy a non-8.3 format filename to a floppy
  283.     2) Moved the 'both', 'same', and 'filters' menu items from
  284.        the 'file' menu to the 'view' menu to be more CUA
  285.        compliant
  286.     3) Corrected a bug where the 'alike' filter mode showed more
  287.        than just 'alike' files
  288.     4) Corrected a bug that prevented the 'ignore read-only'
  289.        from resetting the read-only attribute on the target
  290.  
  291. 1.09b
  292.     1) Added the ability to double-click in the containers
  293.        title areas to bring up the directory selection dialog
  294.        box
  295.     2) Put a directory selection list box into the dialog so
  296.        either or both directories can be chosen at the same
  297.        time
  298.     3) Added the /S option to display the directory selection
  299.        dialog box when first starting up
  300.  
  301. 1.09a
  302.     1) Corrected so 'help' can be found in the directory
  303.        from which the .exe was run, if it's not in the
  304.        'set HELP=' path
  305.     2) Corrected so directory selection list doesn't return
  306.        file names from a Novell network drive
  307.  
  308. 1.09
  309.     1) Made the directory selection dialog box larger (and
  310.        added a horizontal scroll bar) so it would show more
  311.        drives/directories at once
  312.     2) Corrected so the directory selection list box shows
  313.        FAT directories in sorted order
  314.     3) Implemented 'move' option
  315.     4) Added a pop-up menu for the containers
  316.     5) Added an option to show or not show the buttons since
  317.        the popup menu can do all they do
  318.     6) Added a check box to the directory selection dialog box
  319.        to allow showing the entire tree of subdirectories below
  320.        the current level or just the next level (this may be
  321.        replaced with a container tree view control someday)
  322.  
  323. 1.08
  324.     1) Added a /L command line option for specifying 'filter All'
  325.     2) Implemented 'Ignore Read-Only attributes' option
  326.     3) Corrected bugs with using tab/arrow keys to move among
  327.        controls (buttons and containers)
  328.     4) Implemented 'Highlight identical files' option
  329.     5) Changed filter toggle cycling key from F8 to F7
  330.     6) Added a Swap-F8 button.  Note that this will cause the
  331.        customized colors/fonts of the buttons to be lost the first
  332.        time this new version is run and they will have to be setup
  333.        again <sorry>
  334.  
  335. 1.07
  336.     1) Corrected a directories display problem which occurred when
  337.        there was no .ini file and PMDMatch was first run without
  338.        any command line directories
  339.     2) Changed colorization so that the default system colors are
  340.        used until drag/drop has been done to customize them so the
  341.        user doesn't feel they're locked into my arbitrary choice of
  342.        colors
  343.     3) Corrected problems with the directory choices dialog box
  344.  
  345. 1.06
  346.     1) Added 'exclude' filter handling
  347.  
  348. 1.05
  349.     1) Corrected some error message handling problems when one of
  350.        the directories being specified didn't exist
  351.     2) Reworked 'include' filter handling
  352.     3) Enhanced error handling during 'dir'/'drive' selections
  353.     
  354. 1.04
  355.     1) Corrected a problem where closing while still filling the
  356.        containers would report an error by disabling 'close' on
  357.        the system menu
  358.     2) Added 'Abort/Retry/Ignore' to error message/handling
  359.     3) Changed 'About to' messages to be informational instead
  360.        of questions (eliminates beep as well)
  361.     4) Corrected an access violation bug
  362.     5) Added simple animation to the About box
  363.     6) Added 'include' filter handling
  364.     7) Corrected a problem where files which were only different
  365.        in size didn't show up in the different/modified views.
  366.        They now show but neither is high-lighted since it's
  367.        impossible to tell which is 'newer'
  368.  
  369. 1.03
  370.     1) Corrected directory selection so selecting drive letters
  371.        refreshes the directory list
  372.     2) Corrected a bug where double-clicking on an empty container
  373.        window caused an access violation
  374.  
  375. 1.02
  376.     1) Corrected multiple instances problem
  377.     2) Changed directory selection dialog to be common
  378.     3) Corrected 'delete' file 'in-use' emphasis
  379.     4) Corrected a problem when trying to specify just a drive
  380.        on the command-line so it uses that drive's current
  381.        directory
  382. 1.01
  383.     1) Main funtionality complete
  384.  
  385. 1.00
  386.     1) Initial release
  387.