home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / vrac_os2 / mr2_205.zip / read.me < prev    next >
Text File  |  1994-07-17  |  46KB  |  903 lines
  1. MR/2 - A QWK Compatible Mail Reader for OS/2.  07/17/94
  2.  
  3. Copyright (c) 1994, Knight Writer Software Company.
  4. All rights reserved.
  5.  
  6. ===================================================================
  7.                           N O T I C E
  8. ===================================================================
  9. This IS a shareware package, and does require a registration fee if
  10. you choose to continue using it after 30 days.   The registration
  11. fee is currently $25 US.  Eventually, the product MAY have a
  12. "begging" screen with a key-file that will register the software
  13. and suppress it.  The more interest I get, the more likely I am to
  14. continue with improvements.
  15. ------------------------------------------------------------------
  16.  
  17. CONTACTING THE AUTHOR
  18. =====================
  19.  
  20. You  can contact me in a number  of ways.  Unfortunately, I can't
  21. provide a phone number at this time.
  22.  
  23. US Mail:       Nick Knight
  24.                1823 David Ave.
  25.                Parma, Ohio 44134
  26.  
  27. Fido netmail:  1:157/2 to "Nick Knight"
  28.  
  29. Internet:      User "Nick Knight", (nick.knight@pcohio.com)
  30.  
  31. Fido Echomail: Find the Fidonet OS2PRODSUPPORT conference.  I'm there.
  32.  
  33.                Echomail messages to  me in more general conferences are
  34.                discouraged, as keeping them "on  topic" and
  35.                interesting to the masses would be difficult.  I do
  36.                read OS2, OS2PROG, C_PLUSPLUS and DR DEBUG daily,
  37.                though.  OFFLINE echo also (deals with mail readers),
  38.                this might be THE place to ask public questions, eh?
  39.  
  40.                I recently have acquired access to a host of other
  41.                networks with OS/2 conferences.  These include RIME,
  42.                SmartNet, Uninet, Intelec, Nanonet, Racenet and some
  43.                others I can't remember.
  44.  
  45.                I also do poll the Fidnet OS2PRODSUPPORT echo.
  46.  
  47. Direct BBS:    Leave a message on the Nerd's Nook BBS (1:157/2) at (216)
  48.                356-1772, 356-1872 or 356-1431.  I check in here
  49.                multiple times a day.  I will also keep the most recent
  50.                copy of MR/2 posted here.  Other boards (non-local)
  51.                will get updates at my convenience.
  52.  
  53. **************************************************************************
  54. **************************************************************************
  55. **             NOTE:  Nerd's now supports an MR/2 conference            **
  56. **             and file area.  Conference #208 is dedicated to          **
  57. **             MR/2 support and files.  File area #45 contains          **
  58. **             MR/2-related files.  Any file uploaded into              **
  59. **             conference 208 will be placed in file area 45.           **
  60. **************************************************************************
  61. **************************************************************************
  62.  
  63.                Nerd's does support file requests (157/2 or 157/3)
  64.  
  65. Compuserve:    I check only once a week or thereabouts.  Try mail to my
  66.                user ID  - 76066,1240, although internet mail has proven
  67.                to be a faster approach.
  68.  
  69.  
  70. Changes included in v2.05
  71. -------------------------
  72.  
  73. o   Resolution of the source Internet address enhanced slightly.  I moved
  74.     the check for PC-Boards @From: specifier before some of the others, as
  75.     if this line is there, it's much more reliable than searching for the
  76.     tokens like "From: ".  Some of my recent replies detected invalid
  77.     Internet addresses.  This should help. (After a couple of replies,
  78.     it does! :).
  79.  
  80. o   Setting extended attributes on packets stored on a LAN Server network
  81.     drive would actually modify the datestamp.  I added code to query the
  82.     original date/time and then reset this *after* the EA's were applied.
  83.     Seems to behave properly now.
  84.  
  85. o   I screwed up and overwrote a large, completely unread packet tonight.
  86.     I was bummed.  But wait!  I now save the PTR file and can reset my
  87.     pointers!!  Only ... MR/2's saving mechanism seems to have been broken
  88.     and I uploaded a 3 month old file.  Needless to say, I got more messages
  89.     than I needed!  What a mess ... I had to reset all my pointers by hand
  90.     and I know I missed some mail.  I then fixed the date compare of PTR
  91.     files.  They should overwrite the existing one now, if newer, and do
  92.     it correctly.  For whoever it was that reported this and that I
  93.     ignored ... you got your revenge!
  94.  
  95. o   MR/2 would crash when you pressed escape from the "NO PACKETS FOUND"
  96.     message.  Had something to do with the aggressive optimizations.  I've
  97.     "unoptimized" a bit until I can figure this out.
  98.  
  99. o   I made a slight goof when I fixed the recursive variable replacement
  100.     in the last release.  I made it so any *real text* with an "@" in it
  101.     would get removed, whether it had a "\" proceeding it or not.  You see,
  102.     the "\" would *not* be there the second pass, so the "@" was unprotected.
  103.     If there was a string between two @'s, this would be removed too, as
  104.     it was assumed it was an invalid variable name.  I now leave unresolved
  105.     variables in the text as-is.  This bug effected mostly fidonet
  106.     and internet addresses.  Fixed.
  107.  
  108.  
  109. Changes included in v2.04
  110. -------------------------
  111. NOTE:  This version includes alot of optimization from compiler switches
  112. and from some rearranging of localized code.  I used it personally for
  113. several weeks, and the only "problems" I saw were minor video (cosmetic)
  114. issues ... like a "black hole" for a second or two when one of the "use
  115. existing?" prompts comes down.  I'll track this, but you may see it until
  116. the next version.  The fixes in this release are beneficial, and the
  117. video problems just minor and cosmetic.
  118.  
  119. I've also traced some recent slow downs to the folder subsystem; packing
  120. log files and building indices in particular.  I do this way too often, and
  121. it takes too long.  I will spend some time on these shortly, attempting to
  122. hit the disk far less than happens currently.
  123.  
  124. o   New INI variable "ALIAS" allows you to set a user name for yourself
  125.     other than the one found in the BBS Control.dat file.  This alias
  126.     name will be placed in the FROM field of all your replies.  Best used
  127.     in a "local", BBS-specific INI file when accessing multiple BBS's.
  128.     For Example:  Alias=Billy-Bob will override the settings in Control.dat
  129.     (say for this example the BBS name was "William B Gooden").  Replies
  130.     would come from Billy-Bob.
  131.  
  132. o   Turns out that the @variable logic was not as recursive as I had
  133.     advertised.  For example, inserting a "phrase file" line that
  134.     contained yet another variable to replace did not work.  It does now :)
  135.  
  136. o   Fixed a crash when modifying replies (changing, killing ...).  If the
  137.     subject happenned to end in column 25 with a number BUT not be a
  138.     "split reply", MR/2 would crash looking for the "/" in "x/n".  For
  139.     example "OS/2 <...> 2.11" would cause this crash to occur.
  140.  
  141. o   Reply log would not always be accessible without an existing packet.
  142.     If you had no messages in your inbasket or replies for a specific
  143.     BBS, ALT-E (No packet entry) would not allow access to the reply log.
  144.     Fixed.
  145.  
  146. o   Some major under-the-hood work.  I played around with some compiler
  147.     switches that have always been there, but have remained undiscovered
  148.     until now. <read: it sometimes pays to read the manual, even if
  149.     it's 3 years late :>.  I've compiled MR/2's code, including the
  150.     speller, thesaurus and editor, with 286-or-better code generation
  151.     turned on.  The 386 code generator caused problems, and I still have
  152.     some v1.3/286 users.  One day I'll go full 32-bit, but not yet :)
  153.     Also, I turned on some aggressive optimizations.  I also recompiled
  154.     the ZTC tools with these switches.  I tried the C runtime library,
  155.     but it showed some bad signs, so I switched back.
  156.  
  157.     All this does is provides a little more snap, and a 12k reduction
  158.     in EXE size.  Nothing revolutionary, but every bit helps.
  159.  
  160.  
  161. Changes included in v2.03
  162. -------------------------
  163.  
  164. o   ADD/DROP still had a problem whenever the DOOR and CONTROLNAME
  165.     specifiers did not match (in dorr.id).  Fixed.  Cammail-Gold door
  166.     configuration now works.
  167.  
  168. o   Reply logging would work wonderfully ... until you started replying
  169.     to subsequent packets into the same REP file.  In other words, if
  170.     you had a week's worth of packets (as I ended up having), and rifled
  171.     through ALL of them without uploading replies, only the replies from
  172.     the first packet would be logged.  I fixed another bug after that
  173.     having to do with source messages, but this wasn't relevant until
  174.     the other bug was tackled.
  175.  
  176. o   Killing replies with multiple parts:  fixed the bug that killed the
  177.     WRONG messages.  Big bug (sorry), but it works now.
  178.  
  179. o   Fixed some problems and made some enhancements to the Fidonet node
  180.     detection logic (replacing @FIDONET@ with the source message's
  181.     fidonet address).  Three digit zones are now supported where two
  182.     digits was the previous max (800:676/23).  There was a problem with
  183.     "@" symbols as part of the Origin line text - fixed.  I also now
  184.     attempt to extract the Fidonet address from a source message format
  185.     that I had never seen before.  This format came from a source on
  186.     the NITELOG BBS, one which is home to many MR/2 users.  I now
  187.     look for and use the "Reply:" line when found in a source netmail
  188.     message.
  189.  
  190. o   When using U to UNMARK a message (to unkill a reply, for example),
  191.     the INDEX markings would not be removed.  Fixed.
  192.  
  193. o   Reports of sporadic crashing:  some users have emailed me with
  194.     crash-reports and supplied debugging addresses.  Often these
  195.     point me right to a problem.  I have a couple of addresses that
  196.     are in general routines, and the information supplied is not
  197.     helping.  I haven't forgotten you!  I'm looking for these and
  198.     trying to come up with another way to find these.  I am also
  199.     changing the way I archive older version so as not to "lose"
  200.     the chance of making sense out of info from these older version.
  201.  
  202.  
  203. Changes included in v2.02
  204. -------------------------
  205.  
  206. o   Modified the after-packet-selection processing so that a local
  207.     INI might be loaded *before* the unzipper is called.  I've always
  208.     held that MR/2 can't know the true BBS name until the packet is
  209.     unzipped and the control.dat file is parsed.  What happens now is,
  210.     as soon as a packet is selected, a "base name" is derived from
  211.     the packet name.  For example, "e:\dl\pc-ohio.qwk;12" would be
  212.     whittled down to "pc-ohio".  If an INI file is found with this
  213.     base name, it is instantly loaded.  Again, this is *before* the
  214.     packet is opened, so that BBS-specific unzippers can be identified.
  215.     If an INI cannot be found matching this derived name, then MR/2
  216.     tries again, the old-fashioned normal way, after the packet has been
  217.     opened.  If one is found on the first try, no secondary loading is
  218.     performed.  This *should* work in most cases, particularly when
  219.     OS/2 comm packages are used.
  220.  
  221.     NOTE that this is *still* too late to identify a different "working"
  222.     directory.  MR/2 has already changed the default path by this time.
  223.  
  224. o   Mouse hot spots on message viewing screen changed a little.  I made
  225.     clicking on the word "Subject:" equal to pressing the "Q" key and
  226.     anywhere after the ":" and up to the "Conf:" word is still the same
  227.     as pressing "H".  This adds easier access to the Q key.  Previously,
  228.     the entire area was mapped to the "H" key.
  229.  
  230.     While I was at it, I added three more hotspots.  The only correlation
  231.     between word and feature is that the word starts with the same letter
  232.     as the feature.  That's how I picked the area :).  Click on the "Ref#"
  233.     area to "R" Reply.  Click on the "Date" area to "D" defer.  Click on
  234.     the "Status" area to "S" Save.
  235.  
  236. o   That pesky lockup that occured when marking and deleting a block
  237.     up to and including the EOF marker has been squashed.  I could easily
  238.     recreate it here, now it seems to be handled.  I simply make sure that
  239.     the end mark can't be placed on or after the EOF triangle.
  240.  
  241. o   Bug:  With PositionOnMatch set to NO, the key-word highlight would
  242.     also be suppressed for virtual conferences.  Now the keywords hilite
  243.     regardless of the setting of this switch.
  244.  
  245. o   By request ... remapped the numeric keyboard "5" key, when not in
  246.     numeric mode (arrows are active) to be equivelent to the ESCAPE key.
  247.     As was pointed on, one can now do most message selection and
  248.     reading/movement functions from just the numeric pad.
  249.  
  250.  
  251. Changes included in v2.01
  252. -------------------------
  253.  
  254. o   Trying to open the WELCOME.QWK packet in the home MR/2 directory
  255.     caused a trap and terminated the program.  This was caused because of
  256.     an error in the code that checks for the "\" character in the packet
  257.     file name.  If one wasn't there, it would crash.  Fixed.
  258.  
  259. o   If a bad "working directory" was set in an icon, MR/2's background
  260.     searching virtual conference builder would crash.  I've fixed this,
  261.     although some questions remain.
  262.  
  263.  
  264. Changes included in v1.99cx thru v2.00
  265. --------------------------------------
  266. Well, this is the long awaited v2.0 release!  As usual, I wish I
  267. would have had *just another week*, but I'm already 10 weeks late
  268. from my original Jan 1 target.  I'm sure there will be some quick
  269. updates as this hits the streets and some more bugs shake out.
  270. I've got to at least get to v2.03 soon, so as that Steve fellow that
  271. still uses v1.03 in Fido's OS/2 conferences will finally upgrade :)
  272.  
  273. Lots of exciting things still to come.  I just added CLONING as an
  274. experiment, and there's lots of potential here.  Multiple sessions
  275. for different BBS's has been working ok; also has more potential.
  276. I'm personally in desperate need of a more complete folder setup.
  277. This means some type of database capability - entirely optional and
  278. user defined.  I will be collecting ideas, requests and suggestions
  279. for subsequent versions.  If I didn't get to something you want or
  280. need, feel free :)  I *do* have every piece of correspondence ever
  281. sent to me, and I will pass through this yet again.
  282.  
  283. o   More work on the manual - 91 printed pages.  Updated several
  284.     sections and the corresponding table of contents entries.  No
  285.     index yet, but I plan on keeping this more up-to-date than it's
  286.     been in the past.  I also plan a more nicely formatted version
  287.     for those that want more than just ASCII text.
  288.  
  289. o   Modified MR2INI.ORG extensively.  This is the default INI file
  290.     that is copied to MR2.INI the first time you bring up MR/2.
  291.     Mostly a rearrange; I divided the file into sections:
  292.     Basic setup, Reply/Quoting, Intermediate, Advanced and Misc.
  293.     Some explanation at the front of the file, with notes to
  294.     reference SEARCH.INI and EXAMPLE.TF where appropriate.
  295.     Much cleaner.  I hope this helps new users get going more
  296.     smoothly.
  297.  
  298. o   Added more examples to SEARCH.INI, focusing on some of the
  299.     newer and more power virtual conference features.
  300.  
  301. o   Added mr2icons.zip to the distribution zip (7k).  Several misc.
  302.     MR/2 and MR/2 PM icons provided compliments of long-time
  303.     registered user John Bales.  Thanks John!
  304.  
  305. o   Fixed a bug where, when killing certain replies, MR/2 would
  306.     seem to hang, but then come back.  There was an uninitialized
  307.     counter under certain circumstances.  This caused a loop to
  308.     "do nothing" for some random amount of time until the counter
  309.     ticked down.  In the debugger session where I discovered this,
  310.     the counter was set to 27,000+.  It took about 2 minutes to
  311.     come back.  Fixed.
  312.  
  313. o   Spaces within an address-book "tag" field would keep the address
  314.     from being selectable from the pick-list.  Fixed.
  315.  
  316. o   WPS Associations referencing .REP files would fail, as would
  317.     referencing a .REP file on the command line (same thing).
  318.     This works now.
  319.  
  320. o   Fixed a problem where the reply packet would often be rezipped
  321.     even though no changes were made to it.  This happened when
  322.     using no-packet entry and when selecting a .REP file directly
  323.     from the packet selection screen.
  324.  
  325. o   Fidonet addresses that had two digit ZONES (e.g., 40:383/1) were
  326.     not working properly.  The zone was seen as only the last digit.
  327.     Fixed for two digit zones - sorry, I didn't even know they
  328.     existed :)
  329.  
  330. o   Address book:  when selecting an address specified as private,
  331.     either through the pick-list of by direct "!tag" identifier,
  332.     the private flag would often remain public.  Fixed.
  333.  
  334.  
  335. Changes included in v1.99bx
  336. ---------------------------
  337.  
  338. o   When using the /I or /W command line parameters (to open a
  339.     second MR/2 session, for example), MR/2 would exit when the first
  340.     packet was exited.  Now it correctly returns to the packet select
  341.     screen.
  342.  
  343. o   A user noticed that the highlighted item on the message index screen
  344.     was a little difficult to read.  In checking, I found that I used
  345.     "light red" for foreground.  Normal "red" is now used and the text
  346.     appears slighlty sharper and easier to read.  This effects most
  347.     Blue selection boxes and confirmation prompts.
  348.  
  349. o   I *really* didn't want to do this so close to a scheduled major
  350.     release.  In fact, I don't know if I'll even try to finish this for
  351.     v2.0, as to get it just right may take some time and experimentation.
  352.     Cloning a session.  It works, but there are tons of "how should this
  353.     be handled questions".  Read the next two entries.
  354.  
  355. o   New command line switch - /Clone or just /C.  This *assumes* that
  356.     a packet is already open in your default (or overridden with /w)
  357.     working directory.  This mode simply "uses existing packet",
  358.     sets "go to last read position" and opens MR/2.  When the packet
  359.     menu is exited, you exit the program without cleanup.  This is for
  360.     use with an already running MR/2, so as to allow reading of the
  361.     same open packet in another session.
  362.  
  363. o   Added some preliminary function keys to the MR/2 message viewer.
  364.     CTRL-F1 "clones" a windowed session.  CTRL-F3 clones full screen.
  365.     This opens a second copy of MR/2, using the existing packet.  This
  366.     allows for multiple windows or session reading independently.
  367.     The cloned window will not cleanup files, will not have bookmarks
  368.     recorded (they are currently lost when session is closed).
  369.  
  370.     I just cloned three additional sessions from one "main" session.
  371.     That's 4 windows into the same packet.  This is *too* neat.
  372.  
  373.     This will take more thinking, but it's already been useful to me,
  374.     so I'll let this out for others to experiement with.  Some problems
  375.     for me to resolve (and that means others should feel free to
  376.     influence me :).
  377.  
  378.     Is it too restrictive to only let replies be generated from the
  379.     "master" session?  Hmmm.  I've having some brainstorms here.  I'm
  380.     going to sleep on this one.
  381.  
  382.     NOTE:  I've already thought this out to a level that's way too
  383.     complicated to finish for v2.0.  I will complete this code after
  384.     v2.0 is released, and I will take suggestions in the meantime.
  385.     So, while this feature will be left for those who wish to
  386.     explore it, it will remain undocumented and "unsupported" for
  387.     v2.0.  I just don't want to rush to fix bugs in this right now.
  388.  
  389.     ALSO NOTE:  Each cloned window is a child of the session doing
  390.     the cloning.  If you close the parent, the clildren disappear,
  391.     too.  There are so many possibilties here, and so may possible
  392.     problems :).
  393.  
  394. o   Fixed a minor problem with selection lists where, when paging down
  395.     at the end of the list, the cursor would sometimes move up or down
  396.     the list, but not land on the last entry.
  397.  
  398. o   Mouse cursor would sometimes leave a "black hole" on blue prompt
  399.     boxes.  In fact, mouse cursor was not visible for these boxes unless
  400.     first moved.
  401.  
  402. o   Read.me file:  removed pre v1.95 material.  I will make all complete
  403.     modification logs available on Nerd's Nook sometime after v2.0 is
  404.     released.
  405.  
  406.  
  407. Changes included in v1.99Ax
  408. ---------------------------
  409.  
  410. o   Phantom "killed" status would sometimes show up in the corner of
  411.     the messge viewer when reading inbasket/logged messages.  The
  412.     messages was often active, and the status report in error.  I've
  413.     fixed this.
  414.  
  415. o   More manual work.  Checked for spelling mistakes and generated a
  416.     preliminary table of contents.
  417.  
  418. o   Thesaurus - cleaned up all the fancy features.  They didn't always
  419.     work as advertised :(
  420.  
  421. o   Fixed a bug where, upon reentering an "existing", previously opened
  422.     packet, the local INI file was not loaded before parts of the packet
  423.     where reloaded.  This caused things like conferences that were
  424.     declared as hidden to be displayed.  They would be hidden when the
  425.     packet was open the first time, but ALT-X, go back in and they'd
  426.     be listed.
  427.  
  428. o   Added S-Save and P-Print to Bulletins, Files and News viewers.
  429.     Careful, as ANSI codes *are not* stripped before saving/printing.
  430.     Help screen also updated.
  431.  
  432. o   I scrunched the message header form one more time, getting 3 more
  433.     characters for taglines.  That makes a max tag of 69 chars.  When
  434.     I get more energy I'll expand this again.  I figure I can get 3-4
  435.     more, but I'd have to rework the whole form.  Not something I care
  436.     to do at this time.
  437.  
  438. o   Ouch!  Big problem with ADD/DROP logic; whether using the default
  439.     door name or a INI-declared name.  Both Subject and To fields
  440.     in the message header received C-type (zero terminated) strings
  441.     instead of QWK formatted, fill-with-spaces strings.  I'm sure this
  442.     confused many a mail door and was probably the reason I received
  443.     so many "not working" complaints.  Heck, it confused my message
  444.     index screen!  Sorry :(.  Thanks you to Marc Bourassa for getting
  445.     me enough info to find this!
  446.  
  447.  
  448.  
  449. Changes included in v1.99x
  450. --------------------------
  451.  
  452. o   More manual work, of course.  I'm up to 81 pages and still more
  453.     to do.
  454.  
  455. o   Help screen touch-ups to reflect new keys added in the last
  456.     release or two.
  457.  
  458. o   Added new reply-time replacable template variables:  TargetTo,
  459.     TargetToFirst and TargetToLast.  These are the same as the "TO"
  460.     series, except that TO is replaced by the original messages TO
  461.     and is useful mostly for attribution lines.  It was brought to my
  462.     attention that accessing the target user's name was not available.
  463.     It is now!  Still thinking about Subject and others along those
  464.     lines ...
  465.  
  466. o   Removed MR2.HST from the distribution zip list.  I read it over
  467.     and every feature it describes is now documented.
  468.  
  469. o   Added Hotkeys back to the Edit Message Header screen.  F4 used to
  470.     bring up the tagline picklist, and for awhile F6 brought up the
  471.     Address pick list.  I removed these keys and received some
  472.     complaints.  I've added alternate ways to get to the picklists on
  473.     this screen:  ALT-T to select taglines, ALT-C for conferences and
  474.     ALT-A for addresses (these work from *any* field).
  475.  
  476. o   Added some options for accessing external utilities differently.
  477.     This was partially in an attempt to solve some rare problems with
  478.     either 4os2 or booting from the D:\ drive, or both.  These may
  479.     offer a performance boots in other cases.  Since I just spelled
  480.     this all out in a messages, I'll use that:
  481.  
  482.     For all of MR/2 classic's external utility access, I used the
  483.     system(command) call.  This is a C function that says "load the
  484.     command processor and give it this command".  This is all dependent
  485.     on the comspec being set correctly, and on ZTC's runtime code (which
  486.     did look ok, BTW). Still, BW/2 mentioned being able to run an editor
  487.     and/or pkzip directly, w/o loading CMD.EXE.  I thought for a second,
  488.     and remembered that MR/2 PM does exactly this.
  489.  
  490.     So, I scarfed the Run() function out of my MR/2 PM code and made it
  491.     optionally accessible.  Now, mind you, this gets a little silly and
  492.     is subject to one final change :).  I still call external EXE's the
  493.     same old way ... UNLESS you prefix it with a code or two.
  494.  
  495.     For example:
  496.  
  497.     Editor=q                loads q.exe the same old way.
  498.  
  499.     Editor=!c:\qe3\q.exe    loads a windowed Q.exe on the desktop,
  500.                             running q.exe directly (no cmd.exe
  501.                             involved).  File must be fully qualified
  502.                             with full path specifications.
  503.  
  504.     Editor=!!c:\qe3\q.exe   loads a full screen session w/o loading
  505.                             cmd.exe - q.exe loads directly.
  506.                             Fully qualify the file name.
  507.  
  508.     Editor=!$c:\qe3\dos\q.exe
  509.  
  510.                             loads a DOS windowed session, loading Q.exe
  511.                             directly.  CMD.exe is not accessed, but
  512.                             command.com is.  May still cause D:\ booting
  513.                             problems, but it's an option.
  514.  
  515.     Editor=!$!c:\qe3\dos\q.exe
  516.  
  517.                             Loads the DOS Qedit into a Full screen DOS
  518.                             session w/o accessing cmd.exe.
  519.  
  520.     NOTE that these work with the zipper/unzipper, too, as well as
  521.     PreEdit, PostEdit, F2-F10, etc.,.  Anytime an external util is
  522.     called, I check for these prefixes for special processing.    I
  523.     should have done this a long time ago :)
  524.  
  525.     Since CMD.exe is removed from the loop with these commands, the
  526.     programs should load more quickly.  In fact, they seem to, but it's
  527.     very hard to measure.
  528.  
  529. o   Problem with BackDropMaxLines.  If this maximum line count was
  530.     GREATER than the actual lines in the file, MR/2 would end up
  531.     searching/displaying *past* the end of the buffer.  This caused
  532.     garbage to the screen at best, crashing in most cases.  The GCO
  533.     ANSI Goodbye screen was only 20 lines long, and with the max lines
  534.     set at 24, horrible things would happen.  Fixed.
  535.  
  536.  
  537. Changes included in v1.98x
  538. --------------------------
  539.  
  540. o   Manual work.  It's growing fast.  Enclosed is a new "preliminary"
  541.     MR2.DOC file.  The old manual was 22 pages, this one is 70 or so
  542.     and there's still plenty to add.  Some sections are incomplete.
  543.     No, I haven't checked for spelling errors.  I'm open for comments,
  544.     but don't dig too deeply, please.
  545.  
  546. o   PurgeAfterDays and PurgeAfterCount now actually function.  Here's
  547.     how it works:  When you close a packet, MR/2 has always "packed"
  548.     your InBasket, if any.  This process simply involved passing through
  549.     the InBasket and removing "killed" message by writing over them with
  550.     active ones.  When the ReplyLog was added, the same process was
  551.     performed.  Since the reply log grows with each reply, I added code
  552.     to control the number of messages kept, by maximum age or by maximum
  553.     count, or by both.
  554.  
  555.     If PurgeAfterDays is not specified (or set to zero), no age
  556.     check is performed on replylog messages.  Otherwise ...
  557.  
  558.     The Reply log is first packed the old way with a slight additional
  559.     check.  If a message is found to be active and older that the
  560.     cut-off date (older that PurgeAfterDays old), then the message is
  561.     marked as killed.  The normal removal process follows after this
  562.     check.  If a message is killed and it has a "source" or "original"
  563.     message after it (these have special MR/2-internal markings), this
  564.     is also killed.  Once this pass has been completed, all manually
  565.     killed and "old" message have been removed, along with any "source"
  566.     messages recorded with them.  A count of active messages is returned
  567.     to the packing process.
  568.  
  569.     If PuregAfterCount is not specified, or set to zero, no maximum
  570.     message checking is performed.  Otherwise ...
  571.  
  572.     Now, MR/2 compares the active message count to the specified maximum
  573.     (PurgeAfterCount).  If found to be greater, then the number of
  574.     messages to delete is calculated.  A new pass is made through the
  575.     folder, and the oldest messages are marked and deleted until the
  576.     number of messages to delete has been reached.  Again, if a message
  577.     is removed, so is its source/original message, if one exists.
  578.  
  579.     I will add a way to mark a reply as "permanent".  This will keep
  580.     the packing routines from removing it.  A permanent message will
  581.     not be deleted until you manually kill it.  As an additional
  582.     feature, I want to add an "unkill" key.  I've killed a couple of
  583.     replylog messages that I didn't want to, and saving them was a
  584.     real pain.  And I even know how!  I wouldn't expect anyone else to
  585.     be able to figure this out.
  586.  
  587. o   Double confirmation prompt on exiting the editor w/out saving. I
  588.     lost my last long-winded reply to this gotcha.  If you would press
  589.     ESCAPE too many times, too fast, while in the internal editor, you
  590.     would often end up losing any/all changes.  This was because ESCAPE
  591.     is seen as a request to exit the editor, and the "would you like to
  592.     save" question, when ESCAPE is pressed, says "No". Two escapes and
  593.     you've lost any changes.  I've done this more than once by accident.
  594.     It angered me; I apologize for causing anyone else this frustration.
  595.     Now, if you escape out of the editor and changes have been made, it
  596.     asks you if you wish to save them.  If you press ESCAPE, it askes if
  597.     you're sure, and ESCAPE says "no, I'm not sure" and saves your work.
  598.     You must press YES or press ENTER to abort changes.
  599.  
  600. o   Cutting from a DOS windowed session and pasting to MR/2, using
  601.     ALT-* fails.  Previous versions would actually crash, leaving the
  602.     clipboard open and locking up any program that tried to access it
  603.     afterwards.  I'm still trying to find out why this fails, but in
  604.     the meantime, I removed the crashing, and the subsequent lockups.
  605.  
  606. o   Packing the folders (Inbasket, ReplyLog).  A informative popup
  607.     window now is displayed while this process performs it's work.
  608.  
  609. o   Added a "Make Permanent" key for use within the Reply Log.
  610.     Pressing "!" will mark the Reply Log message as a "keeper" and
  611.     the Folder packing routine will no automatically delete this
  612.     message, nomatter how old it is or how many messages over the
  613.     maximum exist.
  614.  
  615. o   Added an "UnKill" keystroke.  Pressing "U" will remove the "Killed"
  616.     marking from any message.
  617.  
  618. o   New INI parameter - BackdropMaxLines.  This controls the maximum
  619.     number of lines from the WELCOME and GOODBYE screens will be flashed
  620.     to the screen.  Some BBS's have ANSI Welcome screens that are
  621.     multiple pages long.  MR/2 would proceed to flash these messages
  622.     completely at various times.  Set BackdropMaxLines to 25, for
  623.     example, to flash only the first screen.  Setting this parameter to
  624.     zero will suppress the Welcome screen altogether.  The default is
  625.     set to -1, which will flash any and all lines of the file to the
  626.     screen.
  627.  
  628. o   I think I fixed the problem with crashing when trying to finish
  629.     out of MR/2 *before* the background searching was finished.  This
  630.     would not happen if all virtual conferences had been created but,
  631.     if you would open a packet by mistake and try to quickly get out
  632.     of it, crash!  This was because I was deleting all the work files
  633.     before the background process was told to stop ... and it was
  634.     trying to read messages.dat.
  635.  
  636. o   New INI parameters: F2 through F10.  Used to attach command-line
  637.     actions to function keys.
  638.  
  639.  
  640. Changes included in v1.97x
  641. --------------------------
  642.  
  643. o   I forgot to list the INI options SavePointerFiles, PurgeAfterDays
  644.     and PurgeAfterCount in the MR2INI.ORG file.  These are now listed.
  645.  
  646.     More INI's, as I try to clean up some smaller user problems and
  647.     requests:
  648.  
  649. o   "DoorName" may now be used to identify the target BBS door "user
  650.     name" to which to address ADD/DROP messages.  This not only aids
  651.     in the case where a BBS door provides no DOOR.ID file, but also
  652.     when trying to perform ADD/DROP functions from no-packet entry or
  653.     reply packet maintenance.  For example, DoorName=RoseMail will
  654.     address all ADD/DROP messages TO: RoseMail.
  655.  
  656. o   "CursorSize" may now be specified for the normal internal editor
  657.     cursor.  Many users complained that, in certain video modes
  658.     (large number of lines/screen), and under some setups, the cursor
  659.     could not be seen.  By default, MR/2's normal editor cursor is
  660.     1 scanline high (maybe two?).  When lines/screen is 34 or more,
  661.     MR/2 changes the cursor to 6 or 7 scanlines.  This was reported to
  662.     still not be visable sometimes.  So, You may now specify the number
  663.     of scanlines for a normal cursor - from 1 to 13.  MR/2's "overtype"
  664.     cursor is 13 (14?) scanlines tall and is not configurable at this time.
  665.     Example:  CursorSize = 10
  666.  
  667. o   I did manage to finalize the thesaurus data file.  The "officially
  668.     released" thesaurus wordbase will consist of 9242 "key" words
  669.     with a total of 70,101 synonyms.  The technique I'm using makes it
  670.     easy to find synonyms, even if the word is not found to be a key.
  671.  
  672. o   There was a problem with using a MessageOrder of anything BUT
  673.     subject.  A variable remained uninitialized in all cases except
  674.     by subject, and this caused crashing as soon as a conference was
  675.     selected and the message index sort was started.  Fixed.
  676.  
  677. o   Selection lists had a bug that wouldn't allow you to select the
  678.     LAST entry (if the "page" was full).  Clicking on the bottom
  679.     line of the box did nothing (it's supposed to page down), and
  680.     clicking on the slot for the last entry on the page paged-down.
  681.     Fixed.
  682.  
  683. o   INI file now includes a default virtual conference.  This will
  684.     help new users "discover" this key feature much quicker.
  685.  
  686. o   Manual has actually been worked on!  No, it's not in here.
  687.     It's not in *that* great a shape yet, but it's progressing :)
  688.  
  689.  
  690. Changes included in v1.96x
  691. --------------------------
  692. Still lots left to do, I'll try to get a summary list together
  693. and post it next time.  I'm getting close, tho.  Bug reports seem
  694. to be light, which makes me happy.  I wanted to hit Feb 1st, but
  695. I'm not sure now.  If I can get a couple of good days in I can call
  696. it soup.  It will be *very* soon, the manual being the last major
  697. "feature" to address.
  698.  
  699. o   New and Improved help screens.  Added definitions for dozens of
  700.     previously-unlisted keystrokes and functions.  HELPS include 20
  701.     or so completely *new* screens, too, covering many of the newer
  702.     enhancements.
  703.  
  704.     NOTE that mr2.hlp is a simple editor file with [TAG] markers to tell
  705.     me where a help section starts.  The section ends at the next tag
  706.     marker.  If you don't like my HELP text, you *can* create your own
  707.     text (modify my descriptions).  A section must fit on the screen,
  708.     tho, with a char/line or two reserved as border.  Hey, if you end up
  709.     with something you think is better, send it to me and if I agree,
  710.     I'll use it :)
  711.  
  712.     I start on the manual next - actually already have, but now I have
  713.     to be serious!
  714.  
  715. o   Updated MR2INI.ORG with a section that describes the newest
  716.     INI variables.
  717.  
  718. o   Tab expansion in the message viewer.  I default this to 4
  719.     characters, but allow you to toggle this value via ALT-TAB.
  720.     Sequence is 4,8,0,2 where "0" means show the tab character and
  721.     don't expand.
  722.  
  723. o   I discovered that searching while in the INBASKET or the REPLYLOG
  724.     didn't work.  Searching within an INBASKET has never worked.
  725.     Fixed this (modified QWK.Getfh()).
  726.  
  727. o   By request (several), the spacebar may now be used as an alternate
  728.     to ENTER for selecting a conference w/mail to read.  This was a
  729.     tough call, as the ' ' is a valid typing character, and I can see
  730.     some folks trying to do a conference name prefix jump to the "main
  731.     board" conference by typing "Main ".  Where this would previously
  732.     work, and it still *might*, the spacebar press will cause the
  733.     highlighted conference to now be selected.  Open for comments, I
  734.     think this will be OK, tho.
  735.  
  736. o   It was pointed out to me that many keyboards don't have an F11 key,
  737.     and that's what I chose as the "mark" key on selection list.  (At
  738.     this time, "marking" within a list only has a purpose on the packet
  739.     selection screen, for merging QWK packets.)  After some thinking and
  740.     experimentation, I made the "*" key a synonym for F11 on pick lists.
  741.     It was suggested to use + and - to mark, unmark, but the minus or
  742.     dash often comes up as part of conference and packet names.  So,
  743.     "jump to prefix" would be affected.  The "*" key will toggle the
  744.     mark on and off.  This key is easily selected w/o shifting by using
  745.     the one on the numeric keypad (eeek!  Assuming you have one :).
  746.  
  747. o   UNQWK.CMD bug - my first user "fix" to this routine!  Thank you
  748.     Wolfgang von Thuelen for pointing this out.  In the check for long
  749.     file names, I ignored the case where file names were exactly 12
  750.     characters long BUT were still non-FAT names (e.g., "mwcst.qwk;11").
  751.     The first 'if' statement was changed from "if flongnames < 0" to "if
  752.     flongnames <= 0".
  753.  
  754. o   More thesaurus work - mostly minor cosmetics.  I've almost got
  755.     what I want, although I know the ALT-S and ALT-L are buugy now.
  756.     I'm letting it out with these bugs, as it's still functional and
  757.     I doubt many are using this feature (yet?).  Keys you may press
  758.     with descriptions are placed above editor window.
  759.  
  760.  
  761. Changes included in v1.95x
  762. --------------------------
  763. I'm calling this v1.95x, as I consider myself "close" to what I wanted
  764. in a v2.0 release.  I do have a few features to add; although not many.
  765. Believe me, I've got plenty of ideas for v2.01 and beyond.  Existing
  766. users know that this has never been a static product :).  I've created
  767. quite a few monsters here ... huge new features that are going to take
  768. some "shaking out" to get them working perfectly.
  769.  
  770. o   Clipboard:  When doing an "append" (ALT-GREY-= or ALT-GREYENTER)
  771.     to an empty clipboard, MR/2 would crash.  The first text copied to
  772.     the clipboard had to be done with the ALT-+ command, then appending
  773.     would work.  Fixed.  You can now append to an empty clipboard.
  774.  
  775. o   Reply log messages can now be "Copied" and/or "Replied to".  The
  776.     message is then copied into the reply conference as to be "sent
  777.     again".
  778.  
  779. o   INI parsing problem prevented FolderPath from being recognized.
  780.     (Discovered when relinking and testing MR/2 PM).
  781.  
  782. o   Mouse could not be used to select the very first entry in a selection
  783.     list.  This was broken recently - now fixed.
  784.  
  785. o   Template Sections labeled as "New" using routing lines:  I had
  786.     previously noted in this document AND personally corresponded
  787.     electronically with a few of you about this.  Specifically, *before*
  788.     this version, the $Body line was needed *before* the routing line,
  789.     as for "new" messages, only the "signature" sections was placed in
  790.     the reply file.  THIS HAS ALL BEEN CHANGED.  The 'New' Sections now
  791.     work the way you would expect; the entire section is placed in the
  792.     reply file, and the $Body (while still necessary) should be placed
  793.     where you would normally start your reply.  In other words, these
  794.     sections should be setup the way you would expect from using the
  795.     "normal" sections as an example.
  796.  
  797. o   Packet selection screen:  You may now MARK two or more packets on
  798.     this screen and actually MERGE them together as one QWK packet.
  799.     Use F11 to mark the packets to combine, then ALT-M (Merge) to
  800.     merge them together.  This process calls upon my new and improved
  801.     MQWK.CMD REXX command file to do most of the work.  This makes the
  802.     process configurable/extendable, as long as you want to tinker with
  803.     REXX source code.
  804.  
  805.     Multiple/automatic archiver detection is not supported at this time;
  806.     the archiver name is hard-coded in the script to be "pkunzip -n"
  807.     and the zipper is 'pkzip'.  Modify these in MQWK.CMD if necessary.
  808.  
  809.     When you press ALT-M, and if 2 or more packets are marked, MR/2 will
  810.     prompt for a target packet name.  If a name is supplied, all marked
  811.     QWK packets will be merged into one with this name.  If no name is
  812.     supplied, MR/2 simply combines the packets in the TMP$$ work
  813.     directory, where they can be read as a combined packet.  NOTE,
  814.     however, that bookmarks will be lost, as there will be no "target"
  815.     packet to record them to.  I suggest always allowing MR/2 to
  816.     repack the combined QWK packet.
  817.  
  818.     FURTHER NOTE:  I've now modified the script so that there is very
  819.     little reason *not* to repack the combined messages into a new QWK
  820.     file.  If a name is supplied as a target, MR/2 combines all marked
  821.     packets and jumps right into "read" mode.  AT THE SAME TIME, I spawn
  822.     another session, in the background, to archive the combined packet.
  823.     This becomes invisible to you and should not impede your normal
  824.     reading operations.  If the combined packet does not show up on the
  825.     packet selection screen, you may reference MQWK.LOG for possible
  826.     error messages.  All output from the archiving process is redirected
  827.     to this file.
  828.  
  829.     Index files (*.ndx) are discarded by the merge process ... MR/2 will
  830.     create index files when it opens the combined packet.
  831.  
  832.     I've tested this procedure with QMail and CamMail doors.  I expect
  833.     that other doors may created cases that call for a little adjusting.
  834.     Keep me posted.  ALSO, no error checking is performed to assure that
  835.     all the packets you are merging together are of the same BBS.  THIS
  836.     IS IMPORTANT, as merging dissimilar packets WILL NOT WORK CORRECTLY.
  837.  
  838.     ALSO NOTE that this takes alot of free disk space.  A set of QWK
  839.     packets totaling 2MB might require 4-5 MB additional free disk space
  840.     to function.
  841.  
  842. o   INTERNAL: Messages.dat is now opened in READ-ONLY mode.  This allows
  843.     the file to be accessed in a background task for archiving.
  844.  
  845. o   INTERNAL: Modifications to zDList, zDLSelect and zDirSelect (linked
  846.     list and selection from list(s) routines) to further support "marking"
  847.     of members and retrieval of "marked" status in various forms.
  848.  
  849. o   I received a packet via CIS email from the Channel1 BBS.  This
  850.     board has been a great logic-breaker for me ... they ought to quit
  851.     growing! Anyway, their control.dat files finally made it over 64k,
  852.     which has always been an MR/2 limitation (due to an initial design
  853.     flaw on my part).  This is now fixed so that there is *no* maximum
  854.     control.dat file size limitation.  I now handle/parse this file one
  855.     line at a time w/o loading it all into memory up front.  Channel1
  856.     packets once again work!
  857.  
  858. o   HideConferences can now be specified multiple times within a set
  859.     of INI files.  The hidden conferences list is now cumulative where
  860.     before only the last HideConference line was effective.
  861.  
  862. o   I expanded the packet selection screen even more and added columns
  863.     for Per (Personal) and Rep (Replied-to) message counts.  I know that
  864.     I'm constantly trying to remember which packet had all the personals
  865.     to me in it, so this helps me out.  The reply count may also help
  866.     tell you something about a particular packet.
  867.  
  868. o   Modified ZTC's library routine system().  Command line was deemed
  869.     invalid when > 128 characters.  OS/2 allows much more; I changed
  870.     the max to 256.  This will allow more QWK packets to be merged
  871.     together (it broke today at 4 fully qualified packet names).
  872.  
  873. o   Changes to the way the built-in thesaurus functions.  I've still
  874.     got some fancy things to do, but it's getting closer.  Invoking
  875.     the thesaurus for a word that was not a "key" in the word base
  876.     previously did nothing; it just ignored you.  Now, MR/2 posts a
  877.     message and jumps into a sequential "match" search.  When you
  878.     request a further search of the database using ALT-S, a similar
  879.     message is posted.  Both messages mention that you can now press
  880.     ESCAPE to hault the search.  Also, when a search completes with
  881.     out finding any new words, MR/2 keeps the previous word list on
  882.     the screen.  Before, you would be placed out of the thesaurus.
  883.  
  884.  
  885. KNOWN BUGS AND STUFF
  886. ====================
  887.  
  888. The TEMPORARY directory MUST remain a subdirectory of the MR2 home dir.
  889.  
  890. You can't use "\" or "&" as part of any search text (since MR/2 uses them
  891. as delimiters).
  892.  
  893. You can't cancel a search until the first "hit" is displayed.  This is
  894. particularly irritating when soundex searching, since soundexing is
  895. noticably slower.
  896.  
  897. If you set "SkipReadMessages" to true, you cannot gain access to a
  898. conferences where all messages have previously been read.
  899.  
  900. Other frills that have not yet been addressed:  Bulk marking, twit filter.
  901. There are probably others. Feel free to bombard me with requests.
  902.  
  903.