home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / m / mrpm_098.zip / READ.ME < prev    next >
Text File  |  1993-03-07  |  20KB  |  454 lines
  1. MR/2 PM - A QWK Compatible Mail Reader for OS/2 PM.  03/08/93
  2.  
  3. Copyright (c) 1992, 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 $20 US.  This will increase to $25 when the final
  12. release is officialy distributed.  Register now and avoid the price
  13. increase!  Register MR/2 PM also registers you for MR/2 character
  14. mode, and visa versa.
  15.  
  16. Existing MR/2 registered users are automatically registered users
  17. of MR/2 PM.  The same MR2.ID file can be used by both versions.
  18. ------------------------------------------------------------------
  19.  
  20.  
  21. MR2.INI - your MR/2 PM parameter file
  22. -------------------------------------
  23.  
  24. This is where you tell MR/2 PM all it needs to know about your system
  25. and the way you'd like it to work.  If you don't have an MR2.INI file
  26. from MR/2 classic (character mode), or you've never modified one for
  27. MR/2 PM before,  MR/2 will attempt to place you into the E editor
  28. with a starter INI loaded.  Make any necessary changes and save the file.
  29.  
  30. NOTE:  Problems ... you'll have to edit MR2.INI, then exit out of MR/2 PM
  31. and reenter for any changes to take effect.  My "reload INI" code needs
  32. some looking at.
  33.  
  34. ** If it can't or doesn't load the editor to create the initial MR2.INI
  35. file, it's best that you do this by hand, from the command line:
  36.  
  37.     copy mr2ini.org mr2.ini
  38.     e mr2.ini
  39.  
  40. ***************************************************************************
  41. NOTE:  You may use an existing MR2.INI file, if you have one.  The only
  42. change that's really required is that your editor and zipper/unzipper
  43. file names be fully qualified.  Use a complete path and add the appropriate
  44. file extension (e,g, "d:\os2util\pkunzip.exe").  These changes *will* work
  45. with MR/2 classic, also.
  46. ****************************************************************************
  47.  
  48. Oh yea, I have the thing logging some messages to mr2pm.log.  This file
  49. may aid me in solving problems that occur in testing.  It *will not* be
  50. part of the final distribution reader.
  51.  
  52.  
  53. KNOWN BUGS AND STUFF
  54. ====================
  55.  
  56. THIS IS BETA, PRE-RELEASE SOFTWARE.  THE BUG LIST IS QUITE EXTENSIVE
  57. AND ALL KNOWN PROBLEMS ARE BEING ADDRESSED.  USE THIS PRODUCT AT YOUR
  58. OWN RISK - THE AUTHOR ASSUMES NO LIABILITY FOR LOST OR DAMAGED DATA.
  59.  
  60. For instance, I *know* that the unzip and zip functions should be
  61. in a separate thread, and that the output should be piped to the
  62. screen.  I'm getting to it :)  Right now, if the zipper/unzipper fails,
  63. it often locks up PM until the "not responding" dialog box pops up.
  64.  
  65. I've got a big hit-list, and I'm anxious to start hitting.  I'd like to
  66. get as much feedback as possible while I'm in this process, though.
  67.  
  68. Feel free to report bugs or offer suggestions.  MR/2 PM is based on my
  69. seemingly solid QWK routines from MR/2 "classic", but the user
  70. interface is all new.
  71.  
  72.  
  73. Version 0.95 - Original ALPHA release 10/12/92
  74. Version 0.96 - Second release - BETA  10/25/92
  75. ----------------------------------------------
  76.  
  77. There is no way to view the bbs news, new file listings or bulletins
  78. at this time, nor is there any way to enter "new" messages (w/o replying
  79. to a message and changing the To and Subject manually).
  80.  
  81. No ANSI code support exists.
  82.  
  83. Message display is relatively slow, particularly on long messages.
  84.  
  85. Forget about resizing any windows for awhile, as well as "maximizing"
  86. any.  Also, no font support exists.  No color configuration.
  87.  
  88. No online HELP exists at this time.
  89.  
  90. Just for fun, here's my "to do" list in its current form.  Note that these
  91. notes aren't intended to make sense to you ... don't worry, they do to me :)
  92. Listing these may help identify problems I'm already aware of.  There seems
  93. to be alot, but the thing works fairly well.
  94.  
  95. To Do's (Bugs/Fixes):
  96. =====================
  97. o   Pipe PKZip/Unzip into dlg, multithread
  98. o   Reorder Message read buttons?
  99. o   Expand message index, horizontal scroll bars.
  100. o   Hit counter for searching (checking ... )
  101. o   Repaint conference select when canned search is done.
  102.  
  103. o   WPS Associations & command line parameter processing.
  104. o   Online help
  105. o   Manual
  106. o   Returning to last read position
  107. o   Find across ALL conferences
  108. o   News, New files, bulletins.
  109. o   Writing a NEW message
  110. o   Edit Reply Header:
  111.         Start editing at TO user if NEW.
  112.  
  113. o   Keep focus out of message box - reset focus to NEXT?
  114. o   Keep focus in list box for OpenDlg?
  115. o   Make all confirm dialog boxes one and change text as appropriate.
  116. o   no qwk button weirdness, reset path on CANCEL (is now mr2-dir)
  117. o   Tagline window needs Ok, Cancel ... others?
  118. o   Edit button on Save dialog doesn't work
  119. o   Version on front screen.
  120. o   Save files - remember last path / filename - ditto w/packets
  121.  
  122. To Do's (Long term enhancements):
  123. =================================
  124. o   Toolbar(s) instead of pushbuttons.
  125. o   Get rid of listbox for message viewer and write to window myself,
  126.     paging, scroll bars much faster.
  127. o   Make 32 bit and use v2.0 controls (eg, settings in a notebook).
  128. o   Font control - colors?  Moveable/sizeable windows?
  129. o   Multiple open packets - multiple open conferences.
  130. o   Speed up conference load, control.dat load.
  131. o   Speed up thread list building.
  132. o   Internal editor?
  133.  
  134. There's more - like long file names, but those ideas aren't "immediate"
  135. problems.  
  136.  
  137.  
  138. Changes included in v0.96
  139. -------------------------
  140.  
  141. o   Personal messages now beep if configured to do so.
  142.  
  143. o   The "find" text is cleared when a new conference is selected.  Old way,
  144.     the text locator would still be in effect when a new conference was
  145.     entered.
  146.  
  147. o   Packet path was previously lost when a packet was exited, resulting in
  148.     an empty packet selection list.  This has been fixed.
  149.  
  150. o   If the FROM user is changed when replying, this change is remembered for
  151.     all subsequent replies, until a new packet is selected.
  152.  
  153. o   Message viewer keyboard interface enhanced.  Up/Down arrows now scroll
  154.     message by line; Page Up/Down by page.  Home jumps to beginning,
  155.     End to end.  Insert key calls up INDEX (still trying to stay SLMR
  156.     keystroke compat for some reason :)  Paging improved somewhat.
  157.  
  158. o   Added a more direct way to get message lines from the QWK engine.  The
  159.     previous method involved querying the message line by number, walking
  160.     through increasing number requests.  Each call resulted in the entire
  161.     message being traversed until the line was found.  Now, the new call
  162.     oStart = GetNextMessageLine(char *target, int oStart) speeds this up.
  163.     Filling the message list box is now faster.
  164.  
  165. o   Columnized listboxes now display selected item in a more "correct"
  166.     color.
  167.  
  168. o   Bookmark flags were not getting set and/or being read.  This has
  169.     been corrected.
  170.  
  171. o   Message window now displays the bookmark flags in a minimal fashion.
  172.     If a message has been read, a "√" is displayed next to the reference
  173.     number.  After this, an "R" appears if the message was replied to,
  174.     an "S" if it was saved, and a "K" if it's a reply that's been killed.
  175.  
  176. o   Taglines are now selectable via the "taglines" button.  Hot key of
  177.     F2 not yet implemented.
  178.  
  179. o   Save Header button on reply message header now functions.
  180.  
  181. o   If using an existing packet, flags to save replies and bookmark flags
  182.     were not being defaulted to TRUE.  This caused problems - now fixed.
  183.  
  184. o   When modifying or killing a reply, the message header and message text
  185.     are now updated on screen when the action is complete.
  186.  
  187. o   When spawning to the editor, the path was *not* inherited from MR/2 PM.
  188.     You would usually end up with a default path of C:\.  This cause
  189.     problems with reply files named "reply.msg" (not fully qualified) to
  190.     appear to be missing.  You now start editing while pathed into the
  191.     tmp$$ working directory.
  192.  
  193. o   Enabled the "T" key when viewing a message.  This now steals the current
  194.     message's tagline.  As with MR/2 classic, the arrow keys let you scroll
  195.     through the message lines.  Pushbuttons are also provided for this
  196.     purpose.
  197.  
  198. o   Save-to-file has also been enabled.  Press "S" while viewing a message.
  199.     A file dialog screen comes up for save-file selection.  There are some
  200.     inconsistencies here that I hope to clean up quickly ... but it does
  201.     work.
  202.  
  203. o   Enabled the F2, F3, F9 and F10 keys on the Reply Header Edit screen
  204.     to function as in MR/2 classic;  Pick tag, Toggle to, Save Header Only,
  205.     Accept, respectively.  F10 won't register for some reason (it's a PM
  206.     special "menu" key - I'll have to read up :), so I've assigned F11 as
  207.     the "Accept" hot key (in addition to F10, which I hope to get working).
  208.  
  209. o   The "Save Header" botton when editing the message header is enabled
  210.     only when editing an existing reply.  This allows you to modify
  211.     the destination data w/o editing the message content.  This makes no
  212.     sense unless the message already exists.
  213.  
  214. o   The "R" replied mark wasn't showing up immediately after a message was
  215.     replied to.  Fixed.
  216.  
  217. o   The Page Up/Down "buttons" on the message viewer no longer obtain the
  218.     focus when clicked on.
  219.  
  220. o   Private/Public buttons now work correctly while editing a reply's header.
  221.     Conference name is now static text - no user editing can be performed.
  222.  
  223. o   Expanded the conferences w/mail listbox width a tad.
  224.  
  225. o   Most pushbuttons now have associated hotkeys that are underlined.  I
  226.     may have went a little overboard, but I dunno.
  227.  
  228. o   When modifying a reply, old tagline is extracted and becomes the
  229.     default tagline for the "new", updated reply.  This was previously
  230.     broken.
  231.  
  232. o   There was some crazyness happening with WM_CHAR messages (keyboard
  233.     characters) that I've kludged around.  For example, with a message
  234.     displayed and a secondary dialog box up (pick thread, reply header,
  235.     etc.,.) and a pushbutton highlighted, pressing the "X" key would
  236.     prompt you to exit.  The "S" key would bring up the save dialog.
  237.     Even stranger things would happen.  I'm not sure what I'm doing
  238.     wrong when nesting dialogs, but I put a simple filter in that
  239.     disables keystrokes to the message window when another dialog box
  240.     is on top.
  241.  
  242. o   Double clicking on the system menu button, or ALT-F4'ing from either
  243.     of the programs main screens now exits cleanly.  It used to trap.
  244.  
  245. o   MR/2 classic uses TAB/BACKSPACE while viewing a message to move
  246.     forward/backwards an entire thread.  Since TAB is used by the PM
  247.     dialog routines, this key is logically unavailable.  I've attached
  248.     the same functionality to the CTRL-PAGEDN (fwd) and CTRL_PAGEUP (back)
  249.     keys.  These work the same way in MR/2 classic - they're a carry-over
  250.     from SLMR-compatibility days.
  251.  
  252. o   Often MR/2 PM would leave a file or conference unselected by default.
  253.     When this occurred and ENTER was pressed, the program would process
  254.     it as if ESCAPE was hit, either closing the packet, or exiting the
  255.     program.  I've now taken steps to always have something selected by
  256.     default when the dialog box is initially displayed.
  257.  
  258. o   Thread summary - message count is now columnized.
  259.  
  260. o   Custom conferences now align the line containing matching text on
  261.     the second line of the message listbox.  Also, the alignment process,
  262.     which is shared with the "Find" search function, now parses compound
  263.     search strings and matches any one string.  (Previously, the PM
  264.     listbox message LM_SEARCHSTRING was used - this was for straight
  265.     word-for-word matches only).
  266.  
  267. o   The "Find" dialog box now displays any currently active search string.
  268.  
  269. o   The "L" key (find LAST search hit) did not function properly.  Fixed.
  270.  
  271. o   Played around with WinMessageBox to post the "Replies Exist" message.
  272.     This is what I'll use for most confirmations, since I'm supposed to :)
  273.  
  274. o   Played with changing the color of text/quoted text in the message
  275.     viewer.  It worked, but I'm not very happy with it.  I'm leaving it
  276.     at this time to do quoted test in "halftone".  I'll make this optional,
  277.     or allow a wider selection of color options.
  278.  
  279. o   The "hit" status (Hit nn/nnn) is now displayed on the message viewing
  280.     screen if the message is part of the current search results.
  281.  
  282. o   Logging of messages (my "remote" debugging trail) is now off by default,
  283.     but can be invoked by supplying a command-line parameter (anything).
  284.  
  285. o   The "Config" button now functions to edit the MR2.INI file.  I place
  286.     a dialog box up that requires an "OK" when editing is complete.  This
  287.     will be removed when I get to reading the editor's exit queue.
  288.  
  289. o   If no MR2.INI file exists, an initial one is made and you're placed in
  290.     the E editor to make any necessary revisions.
  291.  
  292. o   If you answer NO to "use the existing open packet?", the packet is
  293.     actually deleted.  Before, this prompt could come up several times.
  294.  
  295. o   While building the message header index (short pause on a fast machine,
  296.     more significant on a slower machine), a "waiting" dialog is displayed.
  297.     I need to find that snippet about setting the hour-glass mouse pointer.
  298.     No, actually, I need to add some secondary threads to this stuff ...
  299.     maybe this weekend.
  300.  
  301. o   Most all of the message viewer letter command found in MR/2 classic
  302.     are now functional in MR/2 PM.  The exception seems to be the "B"
  303.     command, read backwards w/in thread.  I'll fix this one soon :)
  304.     The "Z" key now works (zip to first non-read in conference).
  305.  
  306. o   The "B" key (read backwards w/in thread, go to thread summary at
  307.     beginning of thread) now functions correctly.  Note that selecting a
  308.     thread from the thread summary places you at the FIRST message in a
  309.     thread, not the last.
  310.  
  311. o   There's a new button on the Conference Select dialog box labeled
  312.     "Write".  This is for composing new messages w/o a message to
  313.     reply to.  I just have to put some code behind it now :)
  314.  
  315. o   The No QWK button is now operational on the packet select screen.
  316.     If you depress this button, the "Pick BBS" dialog pops up and allows
  317.     you to select a BBS.  From then on you're in "write new" mode.
  318.  
  319. o   The reply header edit dialog now has a "Conferences" button for
  320.     selecting a different response conference.  The MR/2 classic hotkey
  321.     F4 also maps to conference selection.  Also, the conference number
  322.     may be plugged in by hand.  MR/2 now validates the number supplied and
  323.     displays the conference name, or "Unknown" if a bad conference number
  324.     is specified.
  325.  
  326. o   The Message Index dialog box now has horizontal scrollbar.  There's
  327.     nothing to scroll yet, but the scrollbar's there :)
  328.  
  329. o   I changed the way messages are displayed when unpacking a packet and
  330.     checking for existing replies.  This still isn't right, but it's better
  331.     than it was.  I still need to multithread and pipe the PKZip/unzip stuff.
  332.     That'll be first thing on the list for the next beta.
  333.  
  334. o   The Config button now properly resets the packet path, if it is changed
  335.     in the INI file.  Previously, the path would not be changed.
  336.  
  337. o   OK, so my message index listing has a horizontal scrollbar, and I've
  338.     got stuff to scroll.  Hmmm, I must have to actually do the scrolling,
  339.     too.  I thought all this stuff was magic?  I guess not.
  340.  
  341. o   OK, Cancel buttons added to message index dialog.
  342.  
  343.  
  344. Changes included in v0.97
  345. -------------------------
  346.  
  347. o   Buttons on the Message Index dialog box are now functional.
  348.  
  349. o   Removed some unnecessary screen repaints that would occur when a
  350.     function (e.g., Pick Thread) was canceled and the same message was
  351.     left on the screen.
  352.  
  353. o   If CTRL-PAGEDN was used to page forward by thread, pressing the NEXT
  354.     button would redisplay the same message immediately afterwards (only
  355.     once).
  356.  
  357. o   Focus for reading messages now starts on the NEXT button.
  358.  
  359. o   The SPACEBAR now functions as it does in MR/2 classic (page down,
  360.     next message if at end of current message).  NOT YET !!!!  BROKEN
  361.  
  362. o   Origin recognition enhancements inherited from MR/2 classic.  Custom
  363.     Conference now recognize the "origin" section of a message better
  364.     whe using the "check = origin" option.
  365.  
  366. o   After "reList"-ing packets, the focus is set on the OPEN button.
  367.  
  368. o   Thread summary listbox - sometimes the last entry would be malformed
  369.     (characters missing from the front of the thread text).  Fixed.
  370.  
  371. o   You can now (again) double click on a packet name to open it, save file
  372.     to save to it.
  373.  
  374. o   Pressing the Tagline button while editing a reply header would crash
  375.     MR/2 PM.  This now works correctly.
  376.  
  377. o    Color is supported in the message viewer listbox.  I wouldn't call
  378.     it pretty, but it's there.  A new MR2.INI entry has been added just
  379.     for specifying PM viewer colors.  PMColor=1,2,3 ... where 1 is the
  380.     color for quoted text, 2 the color for normal text and 3 is the
  381.     background color.  The defaults are half-tone, black and default
  382.     entry field color (half-tone yellow, sorta).  You may specify one,
  383.     two or all three and let whatever's left default.  See the MR2INI.ORG
  384.     file for colors possible.
  385.  
  386. o   Many improvements inherited from MR/2 classic.  The speed of conference
  387.     name sorting has been dramatically improved.  Some obscure control.dat
  388.     file problems cleared up.  Personal message beeping problem fixed.
  389.     Minor tagline problems fixed (?).
  390.  
  391. o   Packet selection dialog sometimes had the file date/time clipped.
  392.     This has been corrected.
  393.  
  394.  
  395. Changes included in v0.98
  396. -------------------------
  397.  
  398. NOTE: Version 0.97 never really made it into distribution.
  399.  
  400. o   Relinked with many of MR/2's latest features being added automatically.
  401.     Others needed some minor code adjustments.  Deferred messages are
  402.     functional, as is the new "template" feature.  I'll include MR2READ.ME
  403.     for anyone that wants to get a feel for what else *might* be new.
  404.     Also, the "TwoLine" TagStyle is now available.
  405.  
  406. o   I played around with saving window positions.  It works OK, but isn't
  407.     quite right, particularly with regards to secondary dialog boxes.  Work
  408.     will continue.  MR/2 PM now creates and maintains an "MR2PM.INI" file
  409.     in the software's base directory.
  410.  
  411.  
  412. CONTACTING THE AUTHOR
  413. =====================
  414.  
  415. You  can contact me in a number  of ways.  Unfortunately, I can't
  416. provide a phone number at this time.
  417.  
  418. US Mail:       Nick Knight
  419.                1823 David Ave.
  420.                Parma, Ohio 44134
  421.  
  422. Fido netmail:  1:157/2 to "Nick Knight"
  423.  
  424. Internet:      User "Nick Knight", (nick.knight@pcohio.com)
  425.  
  426. Fido Echomail: Echomail messages to  me are discouraged,  as
  427.                keeping  them "on  topic" and  interesting to
  428.                the  masses would  be difficult.   I  do read
  429.                OS2,  OS2PROG,  C_PLUSPLUS and DR DEBUG daily,
  430.                though.   OFFLINE  echo also  (deals with mail
  431.                readers), this might be THE place to ask public
  432.                questions, eh?
  433.  
  434.                I recently have acquired access to a host of other
  435.                networks with OS/2 conferences.  These include RIME,
  436.                SmartNet, Uninet and some others I can't remember.
  437.  
  438.  
  439. Direct BBS:    Leave  a  message  on  the  Nerd's  Nook  BBS
  440.                (1:157/2)  at  (216)  356-1772,  356-1872  or
  441.                356-1431.   I check in here  multiple times a
  442.                day.  I  will also keep the most  recent copy
  443.                of   MR/2  posted   here.      Other   boards
  444.                (non-local)   will   get   updates    at   my
  445.                convenience.
  446.  
  447.                Nerd's does support file requests (157/2 or 157/3)
  448.  
  449.                Optionally, I call into PC-OHIO regularly.
  450.  
  451. Compuserve:    I check in  here only  when I have  to.   Try
  452.                mail to  my  user ID  - 76066,1240,  although
  453.                this isn't the best approach.
  454.