
*  MaxFile/PM Version 1.22  *

To get started with MaxFile/PM run the REXX command script INSTALL.CMD and
follow the prompts. It will lead you through the steps of getting MaxFile/PM
installed into its own directory. I *DO* recommend a clean install. However, if
you wish to use your old MAXFMPM.INI from a previous version, tell install to
use the directory that you have your current version of MaxFile/PM installed
in. The install is smart enough to find your old MAXFMPM.INI and modify it
accordingly.

    *********************************************************************
   * Go through EACH page of the notebook and make sure the settings are *
   * accurate for your system! I can NOT stress this enough.             *
    *********************************************************************

MaxFile/PM requires MSGAPI32.DLL, this DLL does NOT get copied anywhere for
you, it is your responsibility to put it in your LIBPATH if you need it. This
file is now included with MaxFile/PM for the convenience of those users who are
not running Squish.

As far as documentation is concerned, MAXFMPM.INF will always be current.
MAXFMPM.TXT won't be too far off, but it may not always follow the latest code
changes as closely as the Online Reference.

Have fun!

Craig

===============================================================================

Necessary files

  The only files absolutely needed for MaxFile/PM to operate correctly
  are:

        MAXFMPM.EXE
        MAXFMPM.INI
        EXECDOS.EXE
        MAXFMPM.INF  (Not absolutely needed, but does come in handy.)
        MSGAPI32.DLL

  The rest are just examples and the documentation files.

===============================================================================

What's New (or been fixed)

    I may not always put everything that has changed in this section of
    this file. I get quite wrapped up in the code and sometimes can't
    remember every little thing that I have worked on. But for the most
    part this section should be pretty accurate.

07-01-94

    Removed Origin line from File Announcement messages that are
    generated in a FILES.BBS window. REXX announcements are unaffected
    by this. Also bumped the max message size up to 32k since Squish
    1.10 can handle the larger message size now.

    Changed the way DOS archivers are handled, you can now configure
    them just like OS/2 based archivers.

    Added a few more REXX enhancements.

    Removed most of the directory sensitive code so that directory
    changes won't bring MaxFile/PM down in a nasty fashion.

    Cleaned up the install a little bit, it only copies the needed files
    to the destination directory.

    Increased buffer sizes for reading in FILES.BBS files.

    Added support for ZOO as per popular request.

    Fixed bug in recognizing archivers other than ZIP, ARC, ARJ or LZH.
    They ALL work now.. I have tested them all and added some suggested
    switches for all of them to MAXFMPM.TXT.

    Added a few more status reports to the FILES.BBS windows.

    A successful "touch" on a file now flags the File Database Utility
    so that it will run on the area(s) that files were touched in.

07-02-94

    If no adoptee extensions are set up, MaxFile/PM will no longer do an
    adopt.

    Rearranged the code that opens windows from the main file area
    window so that the queue wouldn't get blocked as long. All the open
    calls are now initiated by a WinPostMsg() call, this should help out
    with the problems that were occurring under 2.11. I wish I could do
    this in another thread, but PM doesn't allow it..

    Squashed a little buglet that occurred when opening a window from the
    Search Results dialog box. Before, if you opened a window from that
    dialog you couldn't bring the main window to the front unless you
    closed the window you opened.

    Added another command file to the distribution archive, SHOWINI.CMD.
    Its sole purpose in life is to report the pertinent INI information
    to standard output.

07-03-94

    Final registration incentives added in preparation for standard
    release. It's put or shut up time. :-(

    Adoptee extensions were being ignored, because the code was missing
    to parse filenames for the Adopt function. Whoops! It's been fixed.

07-05-93

    Increased maximum line lengths to accommodate both the 8.3 filename
    and a description for each entry in a FILES.BBS file. When an
    extended description marker is defined the maximum line length is
    now 1036 characters (8+1+3+1024), otherwise the line length is
    limited to 278 characters (8+1+3+256).

    Fixed a little problem with the case sensitivity of ZIP and UNZIP
    when trying to extract a FILE_ID.DIZ from ZIP archives.

    Overlooked the ^D hotkey for Remove Items, its back in now.

    Fixed the overwrite code for drag and drop, it now works as
    advertised.

07-06-93

    BC++ libraries strike again.. For some odd reason, free() was
    trapping on certain size FILE_ID.DIZ's (241 characters), beats the
    hell out of me why it was doing it, heap corruption could be a
    possible cause. Fixed by using DosAllocMem()/DosFreeMem() instead of
    the library functions.

    Solved the problem with context menus not appearing, PM's heap was
    filling up which in turn stopped the menus from loading. I am now
    explicitly destroying each menu when it is no longer needed. This
    should also clear up a few other PM related problems.

    When unprintable characters are stripped from incoming FILE_ID.DIZ
    files all extra whitespace is now removed. Makes for a cleaner
    import. Any truncations that may occur are done AFTER the garbage is
    stripped out.

    Tweaked the menu handling code to work a little better, this fix is
    mostly cosmetic.

07-07-93

    Added another button to the button bar.. Format Descriptions.
    (Elliott? ;-)

    When a program macro is run against a file in a FILES.BBS window
    MaxFile/PM now checks the file statistics against what is stored in
    the container record and updates the container record if they don't
    match.

07-08-94

    First draft of the Online Reference is included. It doesn't have any
    jumps in it yet, but it is still VERY readable.

07-09-94

    Fixed the settings notebook so the error reporting message boxes
    don't go into an endless loop requiring MaxFile/PM to be killed by
    another process.

    'Format Description' will now always strip whitespace from
    descriptions and remove any present extended description
    characters. This makes for a cleaner description.

07-12-94

    Reinstalled the Performance Beta 1 to evaluate MaxFile/PM's
    performance. It works, no hangs so far.

    Tweaked EXECDOS code, there was a possibility that a return code
    from it could be bogus and meaningless. Not anymore..

    Reinstalled 2.10 and applied the service pack.. (Ick!) So I could do
    some more testing. 2 days, 3 different versions of OS/2..

    Removed presentation parameter calls for setting the fonts for MLE
    controls. This should help with 2.11 and its picky nature.

07-14-94

    Small problem occured if no FILES.BBS was found for a file area, no
    files in the download path were added to the container for that
    area. Fixed..

07-15-94

    Fixed Trap when there was no FILES.BBS for a file area and the
    directory was empty.

07-16-94

    MAJOR change in the way the Insert->File option on the FILES.BBS
    context menu works. It does *NOT* copy the file anymore, instead it
    inserts the file with a *_FULLY QUALIFIED PATH_* into the FILES.BBS.

07-19-94

    Removed case sensitivity in searching with MPM_QueryFileInfo().

07-20-94

    New FILES.BBS context menu item, 'Descriptions->Cleanse'. It strips
    out all high-ASCII, non-visible ASCII and extra whitespace
    characters from all the highlighted descriptions or comments in a
    FILES.BBS window.

07-22-94

    Fixed a problem that ocurred when dropping a fully pathed file onto
    the main File Area window, the wrong file path was written to the
    FILES.BBS and the file couldn't be found.

07-25-94

    Added another Mutex Semaphore to handle the main File Area window
    resource contentions. I found out that I was incorrect in my
    assumption that I could use one semaphore to handle all the possible
    scenarios where contention for resources might come into play.

08-30-94

    Added a ^aMSGID kludge to file announcements so that some of the
    brain-dead mail readers would show the correct address for the
    message (they were -incorrectly- looking for a MSGID to obtain the
    origination address for the message.) Also fixed the incorrect date
    stamps for them in the process.

09-12-94

    Registration incentives (nag dialogs) have been removed so that
    interested parties may fully evaluate the performance of the
    program. The usage timer still ticks away, though.. Through Scott
    Dudley's generousity, I am now including MSGAPI32.DLL in the
    distribution archive for those who don't run Squish.

09-14-94

    Added code to "peek" the termQ before actually doing a read on the
    termQ, this was done to fix a trap that occured under 2.11 in some
    instances when MaxFile/PM has to wait on an executable to finish.

    Make sure that you are using a display driver that is certified as
    compatible with the version of OS/2 that you are running. I found
    out the hard way that using the WD 640x480 256 color driver that
    comes with 2.10 will NOT work reliably with 2.11, it was causing
    MaxFile/PM to lock the WPS up tight after spawning an external
    process and waiting for it.

09-21-94

    Changed 'Extract To...' to only ask for the directory to extract
    files to once. All the archives selected will get expanded into the
    same directory. The earlier behaviour of asking for each file was
    locking up the WPS when a display driver of 640x480/256 colors or
    greater was being used (buggy drivers, not my code!)

09-25-94

    *Finally* cleaned up dupe check results. Duplicate files are now
    only listed once like they should be, in alphabetical order.

    Rearranged the Settings notebook, the Adopt page has been renamed to
    Main - Pg 3 (more for consistency than anything else.) At the same
    time, added two new configuration items. For "Remove Items" you can
    now set a default action, options selectable are; "Prompt",
    "Entries" and "Entries and Files." For "Descriptions->Copy" you can
    now configure whether or not you want the (xx of xx) counter
    appended to the end of the copied description.

    "Copying" files and/or comments can now be accomplished via Drag and
    Drop. Hold the CTRL key down while you are dragging file or comment
    objects, when dropped on either the Main File Area window or on a
    FILES.BBS window, the objects will get copied to the destination and
    the original objects will be left intact.

    Most of the above was suggested by Michael Roedeske.

    Also found a small bug related to FILE_ID.DIZ extraction, some
    archives come with the read only attribute set on the files in the
    archive. This bit is now removed from any _extracted_ FILE_ID.DIZ's
    so that they can be deleted when no longer needed.

09-26-94

    Added a few more options to the File Area window Context Menu; "Edit
    REXX Macro..." this option allows you to create/edit REXX scripts by
    calling on your favorite editor from inside MaxFile/PM. And "Details
    View", this option will allow you to either have a full details
    view or just the area tag of the file areas displayed in the Main
    File Area window. A checkmark is used show which view is in effect
    (you should be able to figure it out by looking at the container...)
    When checked; details view is in effect, otherwise the view is text.

09-27-94

    Added another option to the File Area window Context Menu, "Create
    FREQ List..." This option allows you to create a list of directories
    for mailers that use an OKFILE.* for file requests.

    Added "Files->Remove Missing" to the FILES.BBS window Context Menu.
    It searches through a FILES.BBS window and removes orphaned file
    entries.

    The download counter string is now configurable, it is on Main -
    Page 3 with the rest of the adopt options.

09-28-94

    Added "Files->Purge Dupes" to the FILES.BBS window Context Menu.
    This item scans through a FILES.BBS window and purges duplicate
    entries based on filenames. Useful when a TICK processor adds an
    entry for a file that already exists (during a replace, etc..)

10-01-94

    Modified the behaviour of "Remove Items", when you choose to remove
    only entries, the old behaviour was to remove the entry for a file
    from the FILES.BBS window. This has been changed to show the file,
    which is still present, as an orphaned file (this is the way it
    should have been in the first place.) Comments are still handled in
    the old fashion.

    Added another option to the FILES.BBS window Context Menu, "Select All
    Files". It selects all files in a FILES.BBS window that are not orphans.

10-05-93

    The number of significant characters for a duplicate file search can
    be configured now. Look for it in the Settings Notebook on Main -
    Page 2.

10-14-94

    Removed debug code from ExecAndWait() function. This removes the
    message box that presents the "Bad RC" message. You will still be
    notified of errors with spawning archivers, but only if it is a
    serious error that requires your attention.

    "Remove Items", orphaned file entries (entry in FILES.BBS with no
    file in the download directory) can now be removed when you select
    to "Remove Entries and Files." Purge missing will perform the same
    operation.

    Phillip Perlman brought the above items my attention.

    Tweaked menu handling code.

