home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / mpm1_28.zip / readme.txt < prev    next >
Text File  |  1995-10-05  |  18KB  |  455 lines
  1. ******************************************************************************
  2. *  !!!!!!!!!!!!!!!!!!!!!  Attention Info-ZIP Users  !!!!!!!!!!!!!!!!!!!!!!!  *
  3. ******************************************************************************
  4. *                                                                            *
  5. *      If you are using the Info-ZIP ZIP tools and you have not done so      *
  6. *      already, PLEASE upgrade to UnZip version 5.12 and look up the -C      *
  7. *      switch. It removes the case sensitive nature of UnZip and is          *
  8. *      REQUIRED for MaxFile/PM to extract file description files from        *
  9. *      ZIP archives.                                                         *
  10. *                                                                            *
  11. ******************************************************************************
  12.  
  13.                            ! PLEASE READ THIS !
  14.  
  15.         THIS VERSION OF MAXFILE/PM WILL *_NOT_* RUN UNDER ANY VERSION
  16.         OF OS/2 EXCEPT WARP OR ITS DESCENDENTS.
  17.  
  18.       MAXIMUS 3.0 USERS, READ THE FIRST SECTION OF WHAT'S NEW BELOW FOR
  19.       INFORMATION ON HAVING MAXFILE/PM READ MAXIMUS 3.0 CONFIGURATION
  20.       INFORMATION.
  21.  
  22. *  MaxFile/PM Version 1.28  *
  23.  
  24. To install MaxFile/PM or update your existing MaxFile/PM configuration, you
  25. should unpack the distribution archive to either a floppy diskette or to a
  26. temporary directory. Move to that drive and/or directory and then run the
  27. supplied INSTALL.EXE to begin. Should the install program fail, all you need to
  28. do is copy the files listed in the file INSTALL.LST to a directory of your
  29. choice and then run MAXFMPM.EXE.
  30.  
  31. I've tried to make the whole installation process as painless as possible. I
  32. hope you like it.
  33.  
  34.     *********************************************************************
  35.    * Go through EACH page of the notebook and make sure the settings are *
  36.    * accurate for your system! I can NOT stress this enough.             *
  37.     *********************************************************************
  38.  
  39. If you are upgrading from a previous version of MaxFile/PM: YOU MUST ENTER THE
  40. SETTINGS NOTEBOOK AND SAVE YOUR CONFIGURATION BEFORE WORKING IN YOUR FILE
  41. AREAS! This needs to be done to correct some of the old settings and to
  42. configure the new settings added with this version.
  43.  
  44. MaxFile/PM requires MSGAPI32.DLL, this DLL does NOT get copied anywhere for
  45. you, it is your responsibility to put it in your LIBPATH if you need it. This
  46. file is now included with MaxFile/PM for the convenience of those users who are
  47. not running Squish.
  48.  
  49. Have fun!
  50.  
  51. Craig
  52.  
  53. ===============================================================================
  54.  
  55. Necessary files
  56.  
  57.   The only files absolutely needed for MaxFile/PM to operate correctly
  58.   are:
  59.  
  60.         MAXFMPM.EXE     MaxFile/PM itself
  61.         MAXFMPM.INI     Initialization file (holds settings)
  62.         MAXFMPM.HLP     Online help
  63.         EXECDOS.EXE     DOS application executor
  64.         MSGAPI32.DLL    DLL for accessing Squish and *.MSG message bases
  65.         *.BMP           If you want to use button bars
  66.  
  67.   These aren't necessary, but they do come in handy:
  68.  
  69.         MAXFMPM.TXT     Documentation
  70.         MPMREXX.INF     REXX documentation
  71.  
  72. ===============================================================================
  73.  
  74. What's New (or been fixed)
  75.  
  76.     I may not always put everything that has changed in this section of
  77.     this file. I get quite wrapped up in the code and sometimes can't
  78.     remember every little thing that I have worked on. But for the most
  79.     part this section should be pretty accurate.
  80.  
  81. 10-03-95
  82.  
  83.     It's been a long time coming! :-)
  84.  
  85.     ------              MAXIMUS 3.0 USERS READ THIS              ------
  86.  
  87.     Updated to directly read Max 3.0's FAREA.DAT file. Make sure you
  88.     change your BBS Package to "Maximus 3.0" and change your File Area
  89.     Information setting to <path>FAREA.DAT.
  90.  
  91.     -------------------------------------------------------------------
  92.  
  93.     Modified code that runs FBP to add the '-a' switch to run FBP over
  94.     all your file areas if none have been changed and you elect to do
  95.     so. (Max 3.0 ONLY)
  96.  
  97.     Fixed the date display problem for those of you who wanted the date
  98.     display shut off in your FILES.BBS windows.
  99.  
  100.     Disabled hard error popups while testing for CD file areas. Those of
  101.     you who only have one CD-ROM drive and like to listen to music CDs
  102.     while working with your file areas will appreciate this one. :-)
  103.     Please note: If you don't have a data CD in your drive when
  104.     MaxFile/PM starts up, there WILL be a *significant* slow down as
  105.     MaxFile/PM is scanning your file area information. OS/2's problem,
  106.     not mine, it takes a while for OS/2 to figure out there is a problem
  107.     with CD-ROM drives.
  108.  
  109.     Added the characters ".+-_" to the All Files List block character
  110.     set.
  111.  
  112.     Expanded areaname field in internal structures to allow for longer
  113.     area names (tags).
  114.  
  115.     Reworked All Files List generator code, it still eats up a lot of
  116.     CPU time but at least it works faster now.
  117.  
  118.     New menu item on the FILES.BBS Window context menu, Archives->Touch.
  119.     This will update the selected archive(s) time and date stamp to the
  120.     latest file in the archive. NOTE: This only works if the archiver
  121.     for the selected archive supports it!
  122.  
  123. 04-11-95
  124.  
  125.     Fixed a problem parsing FILES.BBS files for systems using either
  126.     extended description method when multiple consecutive comments were
  127.     present in a FILES.BBS. This is turn pointed me to a fix that was
  128.     needed in the All Files and New Files list generator, the TRAPs that
  129.     were occuring in the list generator are fixed.
  130.  
  131. 03-30-95
  132.  
  133.     New item in the FILES.BBS window Context Menu, Descriptions sub-menu
  134.     "Download Flags". This applies ONLY to Maximus users, it allows you
  135.     to add time and byte flags to the selected files in a FILES.BBS
  136.     window.
  137.  
  138.     New configuration option on Main Page 3 "Extract All Files on
  139.     Document Scan". When checked ALL the files in an archive will be
  140.     extracted when you perform a Descriptions->Scan Docs.
  141.  
  142.     Rewrote the BroadCastClose() and IsAreaWindowOpen() functions in an
  143.     attempt to squash the timing errors that are happening with REXX
  144.     scripts.
  145.  
  146. 03-28-95
  147.  
  148.     Fixed a bug in the AllFiles/NewFiles Generator code that was
  149.     causing comments to be written out to the lists incorrectly.
  150.  
  151. 03-02-95
  152.  
  153.     Added "Revert" to the FILES.BBS window context menu.
  154.  
  155. 02-02-95
  156.  
  157.     Fixed bug with virus scanner getting called with a doubled-up path
  158.     instead of path and filename..
  159.  
  160. 01-31-95
  161.  
  162.     Changed from Borland's TLINK to LINK386.EXE, it produces a smaller
  163.     slightly faster loading executable.
  164.  
  165. 01-27-95
  166.  
  167.     MaxFile/PM is now distributed as a self-extracting HA archive which
  168.     was created by my port of Harri Hirvola's HA archiver utility.
  169.  
  170. 01-23-95
  171.  
  172.     MAXFMPM.INF removed from the distribution archive, everything that
  173.     was documented in it, is now documented in MAXFMPM.HLP and is
  174.     available using F1 inside the program.
  175.  
  176. 01-21-95
  177.  
  178.     Corrected a problem when reading in Avatar FILES.BBS headers.
  179.  
  180.     Added the ability to define an external archive viewer utility. See
  181.     the settings notebook Viewer page. It gets used when you double
  182.     click on an archive in a FILES.BBS window.
  183.  
  184.     Some types of self-extracting archives are indentified. ZIP, ARJ and
  185.     RAR. Not all the types of SFX archives of those types will be
  186.     identified. Those created with; PKWare's 2.04g ZIP2EXE.EXE, ARJ
  187.     2.41a and RAR 1.53 (NOT solid types) will be.
  188.  
  189. 01-20-95
  190.  
  191.     Modified makefile and memory options in an attempt to speed up the
  192.     initial load time.
  193.  
  194.     Accelerator keys are now implemented in the File Area window. See
  195.     the docs for their definitions.
  196.  
  197.     Removed one major source of headaches. I wrote my own string library
  198.     to replace the run-time string library. This should clear up a LOT
  199.     of problems (and headaches for me.) I *have* tested *all* of the
  200.     functions, but *PLEASE* report any problems you find.
  201.  
  202. 01-19-95
  203.  
  204.     Thanks to the efforts and generousity of Elliott Goodman the
  205.     description formatting routines for those systems using extended
  206.     description markers has been fixed. No more traps or WPS lockups
  207.     when formatting long descriptions. Borland's run-time library is
  208.     causing me quite a bit of grief.
  209.  
  210.     Corrected exit list processing so that if MaxFile/PM itself traps
  211.     the WPS won't get locked up. However, if a trap occurs inside of
  212.     PMMERGE.DLL or PMCTLS.DLL (both are OS/2 components) there will be
  213.     problems.
  214.  
  215.     Sped up the container refreshing that occurs when multiple items are
  216.     selected and modified. Removing items is still a bit slow, but
  217.     everything else moves along very quickly now.
  218.  
  219. 01-18-95
  220.  
  221.     Corrected a problem identifying newer RAR archives. Also corrected
  222.     the archiver defaults in the settings notebook.
  223.  
  224. 01-17-95
  225.  
  226.     Online help is enabled, you can now wear out your F1 key. :-)
  227.  
  228. 01-14-95
  229.  
  230.     In the settings notebook on Main Page 2; Renamed "Hide CD Areas" to
  231.     "Hide CDs". Added "File Headers", MaxFile/PM can now generate
  232.     headers for your FILES.BBS files that contain a short statistics
  233.     blurb about the file area. The header gets written when you save the
  234.     FILES.BBS from *inside* a FILES.BBS window.
  235.  
  236.     Extra carriage returns EXPLICITLY removed from strings now. I *KNOW*
  237.     they are history this time.
  238.  
  239. 01-13-95
  240.  
  241.     More work done to stop mysterious traps when formatting
  242.     descriptions.
  243.  
  244.     The notebook page "Colors" has been added. It allows you to easily
  245.     configure the colors used to display orphan file entries and
  246.     comments in a FILES.BBS window.
  247.  
  248.     The File Date and File Size columns are now displayed empty for
  249.     comment entries in FILES.BBS windows. This is another one I just
  250.     figured out how to do. :-)
  251.  
  252. 01-12-95
  253.  
  254.     REXX.ERR no longer catches the error text from a REXX script,
  255.     instead STDERR is redirected into the output window itself.
  256.  
  257.     Extra carriage returns in extended description lines have been taken
  258.     care of. ::sigh:: See above.. :-/
  259.  
  260.     I spent a LOT of time working on the way REXX and MaxFile/PM
  261.     interact with each other in attempt to fix some mysterious traps
  262.     that have been happening.
  263.  
  264.     Event semaphore is reset as soon as it is created and a small delay
  265.     was added after the WinPostMsg() call to open a FILES.BBS window
  266.     when instructed to do so from a REXX script. There's a timing
  267.     problem here I haven't quite figured out how to overcome yet.
  268.  
  269. 01-11-95
  270.  
  271.     Moved the DosPostEventSem() call used to serialize REXX window open
  272.     calls to after a FILES.BBS window is populated.
  273.  
  274. 01-10-95
  275.  
  276.     The All Files List generator is now run at a lower priority so that
  277.     it won't eat up too many CPU cycles and detract from other
  278.     processes. This does slow it down some, especially when a CPU
  279.     hogging DOS program is polling its life away.. The best solution in
  280.     this case is to tame the DOS program since that is where the problem
  281.     is.
  282.  
  283.     Worked on the code that inserts records into the File Area window in
  284.     an attempt to speed up the initial loading time.
  285.  
  286. 01-09-95
  287.  
  288.     Comments are now skipped when you perform a sort in a FILES.BBS
  289.     Window. Comments can NOT be sorted at all, period. You have to move
  290.     them around manually using drag and drop.
  291.  
  292.     You can now create a text file called MAXFMPM.EXC containing the
  293.     area tags of file areas you want excluded from the File Area window.
  294.  
  295. 01-08-95
  296.  
  297.     Another bug squashed.. When a drag was initiated in a FILES.BBS
  298.     window that had no files in it, MaxFile/PM would die a silent death.
  299.  
  300.     Added a REAL button bar to the FILES.BBS windows. It is fully
  301.     configurable, clear down to what functions go on what button and the
  302.     bitmap that gets displayed on the button. See the settings notebook
  303.     page "Buttons" for the configuration options.
  304.  
  305.     Lots of numerous code tweaks that were made to accommodate the new
  306.     button bar code.
  307.  
  308. 01-06-95
  309.  
  310.     Found a bug in the Cleanse Description code that was causing the
  311.     cleanse to be a bit agressive and strip ALL the whitespace from the
  312.     description. I do NOT know how it got in there, I haven't touched
  313.     that portion of the code since version 1.04 and it was working. None
  314.     the less, it has been fixed. [N.B: I *think* this can be attributed
  315.     to the quirky nature of the Borland run-time library, I am not sure
  316.     though. The new code does the same extact things, just at different
  317.     times. I ran into the same thing when writing some code for another
  318.     project.]
  319.  
  320.     Found a small error (not a bug, an oversight) in the drop code for
  321.     the Main File Area window that would cause long descriptions to get
  322.     mangled when dropping a file onto an area that was closed.
  323.  
  324.     Found a genuine bug in the code that handled skipping download
  325.     counters when cleansing or formatting a file description.
  326.  
  327. 01-05-95
  328.  
  329.     Two new menu items on the Main File Area window context menu;
  330.     Request Files and Receive Files. Together, these two will allow you
  331.     to request files and when they come in have them tossed directly to
  332.     where they belong. FILE_ID.DIZ, DESC.SDI or SDN.ID are extracted and
  333.     used if they are present in any archives. Nifty, eh? :-}
  334.  
  335.     Added another configuration item to Main Pg 1 in the settings
  336.     notebook; File Inbound.
  337.  
  338. 01-04-95
  339.  
  340.     Reworked drag initialization code sections to explicitly load and
  341.     destroy the icon images used during a drag operation. Which fixes
  342.     the display corruption during a drag after the first couple of drag
  343.     and drops.
  344.  
  345. 01-03-95
  346.  
  347.     Moved the File Database Utility setting back to Main Pg 1 to make
  348.     room on Main Pg 2 for "Hide CD Areas." You can now hide the CD areas
  349.     in the File Area window, they are still there, you just can't see
  350.     them when Hide CD Areas is turned on. [N.B: 01-11-95 This is NOT the
  351.     case anymore, when CD areas are hidden, they are NOT added to the
  352.     container list.]
  353.  
  354.     In addition to FILE_ID.DIZ, DESC.SDI and SDN.ID are now looked for
  355.     to get a description from an archive. The order is FILE_ID.DIZ,
  356.     DESC.SDI and then SDN.ID.
  357.  
  358.     Split the online reference files up, the REXX Extensions are now
  359.     listed in their own file (MPMREXX.INF).
  360.  
  361.     When running the allfiles generator or a REXX script from the
  362.     command line, MaxFile/PM will now take a back seat and not stomp
  363.     over the foreground windows.
  364.  
  365. 12-30-94
  366.  
  367.     Added a whole bunch of new REXX extensions, see the docs. :-)
  368.  
  369.     MPM_DeselectArea() has changed, by omitting the area name argument,
  370.     all tagged areas will be deselected.
  371.  
  372.     MPM_OpenArea() has been modified so that the window you want to open
  373.     WILL DEFINITELY be open when this call returns if the return value
  374.     is 'OK'. No more looping or SysSleep()'s are needed to make sure the
  375.     window has had time to open.
  376.  
  377. 12-26-94
  378.  
  379.     I lost the source code to the install program that first appeared
  380.     with version 1.24. The new installer is a bit prettier and allows
  381.     you to make some decisions before-hand. I hope everyone likes it.
  382.  
  383.     Please note: If you don't let the installer create/update the
  384.     desktop references and this is your first installation of
  385.     MaxFile/PM, the first time you run MaxFile/PM it will ask you for
  386.     your settings.
  387.  
  388.     Fixed CN_ENTER message response so you get the file you double
  389.     clicked on instead of a random selection.
  390.  
  391. 12-24-94
  392.  
  393.     Added file summaries when saving a FILES.BBS. The configuration
  394.     option for them is in the Settings notebook on Main Page 2 - Create
  395.     File Summaries.
  396.  
  397.             *****             MAJOR CHANGE               *****
  398.  
  399.     OS2.INI is no longer used to store the window presentation
  400.     parameters! This means that a smaller subset of presentation
  401.     parameters are stored for each window, but this should make those of
  402.     you worried about the size of your OS2.INI happy.
  403.  
  404.     To clean up your OS2.INI from previous versions of MaxFile/PM please
  405.     see the REXX command script INICLEAR.CMD. Please *READ* the file
  406.     before running it! You need to supply it with a list of your file
  407.     areas so it knows what to remove from OS2.INI.
  408.  
  409.     NOTE: All your previous window positions and colors will be lost.
  410.     This is a ONE TIME only conversion, all future versions of
  411.     MaxFile/PM will use the current method of storing window
  412.     presentation parameters.
  413.  
  414.             *****                                        *****
  415.  
  416. 12-23-94
  417.  
  418.     Recovered from a system crash, I was a single generation behind on
  419.     the file list generator source as far as backups are concerned. So I
  420.     rewrote it from scratch. Expanded the file area headers and spruced
  421.     up the listing some. The file list generator is slower now, but the
  422.     end result looks MUCH better.
  423.  
  424. 12-09-94
  425.  
  426.     When rearchiving files if a file is already in the format that
  427.     archives are being converted to, it will be skipped. This stops
  428.     MaxFile/PM from deleting files inadvertantly.
  429.  
  430. 12-05-94
  431.  
  432.     Brand new installer, it's a _real_ PM installation program with some
  433.     pretty buttons and a bit of intelligence. More so than the REXX
  434.     script I was using before.
  435.  
  436.     Extended description markers are now stripped from file announcements
  437.     made from a FILES.BBS window.
  438.  
  439. 12-02-94
  440.  
  441.     The Shift+Fx accelerators are now on the FILES.BBS context menu.
  442.     (Serge? :-)
  443.  
  444. 12-01-94
  445.  
  446.     Added 4 new REXX extensions; MPM_FileAreaSort(), MPM_SaveFilesBBS(),
  447.     MPM_AllFilesList() and MPM_SetWindowState().
  448.  
  449.     Fixed up Remove Entries so that it will remove file entries for
  450.     files that don't exist when removing just entries.
  451.  
  452.     Modified "Scan Docs..." so that the file dialog opens along with the
  453.     Get Description Text dialog.
  454.  
  455.