home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / OS2 / MR2_200.ZIP / MR2.DOC < prev    next >
Text File  |  1994-03-13  |  232KB  |  5,331 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                          MR/2
  17.  
  18.                          A QWK Compatible Offline Mail Reader
  19.                                   for OS/2 Text Mode
  20.  
  21.                               Version 2.0 User's Manual
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                                   Table of Contents
  29.                                   =================
  30.  
  31.  
  32.                          Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . 1
  33.  
  34.                          Disclaimer of Warranty  . . . . . . . . . . . . . . . . . . . . 1
  35.  
  36.                          Registration Policy . . . . . . . . . . . . . . . . . . . . . . 2
  37.  
  38.                          Upgrades  . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  39.  
  40.                          Bug Reports, Suggestions and General Feedback . . . . . . . . . 3
  41.  
  42.                          Major Features  . . . . . . . . . . . . . . . . . . . . . . . . 4
  43.  
  44.                          A Brief Introduction to QWK Packets and Offline Reading . . . . 7
  45.  
  46.                          Reading Mail Offline  . . . . . . . . . . . . . . . . . . . . . 8
  47.  
  48.                          System Requirements . . . . . . . . . . . . . . . . . . . . . . 9
  49.  
  50.                          Command Line Parameters . . . . . . . . . . . . . . . . . . . . 9
  51.  
  52.                          Installing MR/2 . . . . . . . . . . . . . . . . . . . . . . .  10
  53.                                    Optional Support Files Distributed Separately  . . . . .  10
  54.  
  55.                          MR/2 Setup - the MR2.INI file . . . . . . . . . . . . . . . .  11
  56.                                    INI File Parameter/Options - Alphabetical Listing  . . .  12
  57.  
  58.                          Using MR/2 for the First Time . . . . . . . . . . . . . . . .  13
  59.                                    Menus  . . . . . . . . . . . . . . . . . . . . . . . . .  13
  60.                                    Selection Lists  . . . . . . . . . . . . . . . . . . . .  13
  61.  
  62.                          Selecting a QWK Packet  . . . . . . . . . . . . . . . . . . .  15
  63.                                    Deleting a Packet  . . . . . . . . . . . . . . . . . . .  15
  64.                                    Renaming a Packet  . . . . . . . . . . . . . . . . . . .  15
  65.                                    Relisting the Packets Available  . . . . . . . . . . . .  16
  66.                                    Changing your current Packet Path  . . . . . . . . . . .  16
  67.                                    Merging Multiple Packets . . . . . . . . . . . . . . . .  16
  68.                                    Modifying the MR2.INI file . . . . . . . . . . . . . . .  18
  69.                                    Entering Message for a BBS without a Packet  . . . . . .  18
  70.                                    Toggling the Video Display Mode  . . . . . . . . . . . .  19
  71.  
  72.                          The "Unpacking" Process . . . . . . . . . . . . . . . . . . .  20
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.           ----------------------------------------------------------------- 
  80.           MR/2 User's Manual - Table of Contents                     Page i
  81.  
  82.  
  83.  
  84.  
  85.  
  86.           Packet Main Menu  . . . . . . . . . . . . . . . . . . . . . .  21
  87.                                    Mail . . . . . . . . . . . . . . . . . . . . . . . . . .  21
  88.                                    Searching All Conferences  . . . . . . . . . . . . . . .  22
  89.                                    Adding/Dropping  . . . . . . . . . . . . . . . . . . . .  22
  90.                                    Reading Messages . . . . . . . . . . . . . . . . . . . .  23
  91.                                              Message Sort Order  . . . . . . . . . . . . . . . .  23
  92.                                              Using the Spacebar  . . . . . . . . . . . . . . . .  24
  93.                                              Mousing Around  . . . . . . . . . . . . . . . . . .  24
  94.                                              Selecting Messages by Header Information  . . . . .  25
  95.                                              Replying  . . . . . . . . . . . . . . . . . . . . .  26
  96.                                              Using an Editor in a Separate Window/Session  . . .  27
  97.                                              Killing the Current Reply . . . . . . . . . . . . .  28
  98.                                              Modifying a Reply . . . . . . . . . . . . . . . . .  28
  99.                                              Searching . . . . . . . . . . . . . . . . . . . . .  28
  100.                                              Multiple Search Strings . . . . . . . . . . . . . .  29
  101.                                              Soundex Searching . . . . . . . . . . . . . . . . .  29
  102.                                              Examining Search Results  . . . . . . . . . . . . .  29
  103.                                              Searching All Conferences . . . . . . . . . . . . .  30
  104.                                              Saving to a Text File . . . . . . . . . . . . . . .  30
  105.                                              Reading by Subject/Thread . . . . . . . . . . . . .  30
  106.                                              Fast Exit from MR/2 . . . . . . . . . . . . . . . .  30
  107.                                              Spawning an OS/2 command line . . . . . . . . . . .  31
  108.                                              Printing  . . . . . . . . . . . . . . . . . . . . .  31
  109.                                              Stealing Taglines . . . . . . . . . . . . . . . . .  31
  110.                                              Entering a New Message  . . . . . . . . . . . . . .  31
  111.                                              Quick Thread Summary Screen . . . . . . . . . . . .  32
  112.                                              Displaying Embedded ANSI Escape Sequences . . . . .  32
  113.                                              Copying a Message (Carbon or Silicon Copies)  . . .  32
  114.                                              Forwarding a Message  . . . . . . . . . . . . . . .  33
  115.                                              Deferring a Message . . . . . . . . . . . . . . . .  33
  116.                                              Zipping (Skipping) to Next Unread Message . . . . .  33
  117.                                              Copying to the System Clipboard . . . . . . . . . .  33
  118.                                              Jumping to a Logged Reply's Source Message  . . . .  34
  119.                                              Recording a Message's Address in the Address Book .  34
  120.                                              Rewrapping a Message for Display  . . . . . . . . .  34
  121.                                              Unkilling the Current Reply or Message  . . . . . .  34
  122.                                              Marking a Reply Log Message as Permanent  . . . . .  35
  123.                                              Simple Encryption/Decryption - Rot13  . . . . . . .  35
  124.                                              Changing the Default Tab Expansion Size . . . . . .  35
  125.                                              Checking the Spelling of an Existing Reply  . . . .  35
  126.                                              Using the Thesaurus with an Existing Reply  . . . .  36
  127.                                    Write New - Creating New Message . . . . . . . . . . . .  37
  128.                                    New File Listings  . . . . . . . . . . . . . . . . . . .  37
  129.                                    Bulletins  . . . . . . . . . . . . . . . . . . . . . . .  38
  130.                                    The NEWS File  . . . . . . . . . . . . . . . . . . . . .  38
  131.                                    Packing Replies On Demand  . . . . . . . . . . . . . . .  38
  132.                                    Exiting the Current QWK Packet . . . . . . . . . . . . .  39
  133.  
  134.  
  135.  
  136.  
  137.  
  138.           ----------------------------------------------------------------- 
  139.           MR/2 User's Manual - Table of Contents                    Page ii
  140.  
  141.  
  142.  
  143.  
  144.  
  145.           The Internal Editor . . . . . . . . . . . . . . . . . . . . .  40
  146.                                    Search . . . . . . . . . . . . . . . . . . . . . . . . .  40
  147.                                    Search and Replace . . . . . . . . . . . . . . . . . . .  41
  148.                                    Search Again . . . . . . . . . . . . . . . . . . . . . .  41
  149.                                    Marking and Bounding a Block of Text . . . . . . . . . .  41
  150.                                    Unmark . . . . . . . . . . . . . . . . . . . . . . . . .  42
  151.                                    Save and Exit  . . . . . . . . . . . . . . . . . . . . .  42
  152.                                    Exiting without Saving . . . . . . . . . . . . . . . . .  42
  153.                                    HOME and END . . . . . . . . . . . . . . . . . . . . . .  42
  154.                                    Toggling the Display of Marker Characters  . . . . . . .  43
  155.                                    Importing and Exporting Text . . . . . . . . . . . . . .  43
  156.                                    Optional Utilities - Spelling Checker and Thesaurus  . .  43
  157.  
  158.                          The Internal Spelling Checker . . . . . . . . . . . . . . . .  44
  159.  
  160.                          The Internal Thesaurus  . . . . . . . . . . . . . . . . . . .  47
  161.                                    ALT-S Search for more  . . . . . . . . . . . . . . . . .  48
  162.                                    ALT-L Lookup this word . . . . . . . . . . . . . . . . .  48
  163.                                    ALT-E New search word  . . . . . . . . . . . . . . . . .  49
  164.                                    ALT-A Append word  . . . . . . . . . . . . . . . . . . .  49
  165.                                    ALT-I Insert word  . . . . . . . . . . . . . . . . . . .  49
  166.                                    ESCAPE  Back one level . . . . . . . . . . . . . . . . .  49
  167.                                    ALT-X Exit thesaurus . . . . . . . . . . . . . . . . . .  49
  168.  
  169.                          Advanced features . . . . . . . . . . . . . . . . . . . . . .  50
  170.                                    Internal Spelling Checker and Thesaurus  . . . . . . . .  50
  171.                                    External Spelling Checker  . . . . . . . . . . . . . . .  50
  172.                                    Local INI files  . . . . . . . . . . . . . . . . . . . .  51
  173.                                    Virtual Conferences  . . . . . . . . . . . . . . . . . .  52
  174.                                    Template Files and Sections  . . . . . . . . . . . . . .  54
  175.                                    Template Variables . . . . . . . . . . . . . . . . . . .  56
  176.                                    Additional Notes about Variables . . . . . . . . . . . .  61
  177.                                    Address Book . . . . . . . . . . . . . . . . . . . . . .  63
  178.                                    Selecting from the Address Book  . . . . . . . . . . . .  64
  179.                                    Address Book Maintenance . . . . . . . . . . . . . . . .  64
  180.                                    Configuring for Multiple Archivers . . . . . . . . . . .  65
  181.                                    Merging Packets  . . . . . . . . . . . . . . . . . . . .  65
  182.                                    Running Multiple Copies of MR/2  . . . . . . . . . . . .  66
  183.                                    Reply Log  . . . . . . . . . . . . . . . . . . . . . . .  67
  184.                                    Cut/Paste - Accessing the PM Clipboard . . . . . . . . .  68
  185.                                    Notes on Running External Executables  . . . . . . . . .  68
  186.  
  187.                          INI File Parameter/Options - Detailed Descriptions  . . . . .  70
  188.  
  189.                          CONTACTING THE AUTHOR . . . . . . . . . . . . . . . . . . . .  86
  190.  
  191.                          REGISTERING MR/2  . . . . . . . . . . . . . . . . . . . . . .  87
  192.  
  193.  
  194.  
  195.  
  196.  
  197.           ----------------------------------------------------------------- 
  198.           MR/2 User's Manual - Table of Contents                   Page iii
  199.  
  200.  
  201.  
  202.           MR/2 - A QWK Compatible Mail Reader for OS/2
  203.           User's Manual - Version 2.0
  204.  
  205.           Introduction
  206.           ============
  207.  
  208.           MR/2 is an offline mail reader for use with QWK compatible mail
  209.           packets.  It is a native OS/2 character-mode reader written in
  210.           C++, using Zortech's 3.0 release.
  211.  
  212.           Simple help screens are available at any time by depressing F1. 
  213.           If you find a spot where HELP is unavailable, please report this
  214.           to the author. The package was initially tested under OS/2 1.3,
  215.           however, most later development and testing was performed using
  216.           the version 2.0 and 2.1 releases.
  217.  
  218.           This IS a shareware package, and does require a registration fee
  219.           if you choose to continue using it after 30 days.   The
  220.           registration fee is currently $25.  When you register, you will
  221.           be sent an individually serialized MR2.ID file.  This file is
  222.           placed in the MR/2 home directory, and the "NR" markings are
  223.           removed from the taglines of subsequent replies.  Optionally,
  224.           your serial number can be included in each tagline.    The more
  225.           interest (read: registered users) I get, the more likely I am to
  226.           continue with improvements.
  227.  
  228.           Print out REGISTER.DOC, fill it out and send it to me along with 
  229.           your payment.  You may also charge your registration fee to any
  230.           VISA or MASTERCARD account.  See Register.Doc for details. 
  231.           (NOTE:  A copy of the registration form is also attached as the
  232.           last page of this document).
  233.  
  234.           ----------------------------------------------------------------
  235.           IMPORTANT:  READ THE READ.ME FILE FOR NEW FEATURES AND BUG FIXES
  236.           ----------------------------------------------------------------
  237.  
  238.           DISCLAIMER OF WARRANTY
  239.           ======================
  240.  
  241.           THIS SOFTWARE AND MANUAL ARE DISTRIBUTED AND SOLD "AS IS" AND
  242.           WITHOUT WARRANTIES AS TO PERFORMANCE OF MERCHANTABILITY OR ANY
  243.           OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED.  BECAUSE OF THE
  244.           VARIOUS HARDWARE AND SOFTWARE ENVIRONMENTS INTO WHICH THIS
  245.           PROGRAM MAY BE PUT, NO WARRANTY OF FITNESS FOR A PARTICULAR
  246.           PURPOSE IS OFFERED.
  247.  
  248.           GOOD OPERATING PROCEDURE DICTATES THAT ANY PROGRAM BE THOROUGHLY
  249.           TESTED WITH NON-CRITICAL DATA BEFORE RELYING ON IT.  THE USER
  250.           MUST ASSUME THE ENTIRE RISK OF USING THE PROGRAM.  ANY LIABILITY
  251.           OF THE SELLER WILL BE LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT
  252.           OR REFUND OF PURCHASE PRICE. 
  253.  
  254.  
  255.  
  256.           -----------------------------------------------------------------
  257.           MR/2 User's Guide - Version 2.0                            Page 1
  258.  
  259.  
  260.  
  261.           Registration Policy
  262.           ===================
  263.  
  264.           Once you have registered MR/2, you will be sent a registration
  265.           disk that contains the latest MR/2 zipped distribution file,
  266.           along with an MR/2 ID file.  This ID file contains an encrypted
  267.           and checksummed serial number, as well as your name as it
  268.           appeared on the registration form.  When MR/2 is loaded, it
  269.           checks for the existence of the file "MR2.ID", and if found, it
  270.           is checked for validity.  If it passes this test, MR/2 recognizes
  271.           you as a registered user.
  272.  
  273.           As a registered user, your taglines will no longer contain the
  274.           "NR" markings (for "Not Registered").  Instead, the serial number
  275.           from your MR2.ID file will be displayed.  This may be suppressed,
  276.           if desired, via an INI setting.
  277.  
  278.           If you register MR/2 or MR/2 PM, you are considered to be
  279.           registered for both versions.  As I see it, you can only use one
  280.           of these readers at a time, and I should not penalize those that
  281.           wish to switch between them.  Your MR2.ID file can be shared
  282.           between both versions.
  283.  
  284.           NOTE that your MR2.ID file contains your name and personal serial
  285.           number, identifying you to MR/2 as a registered user.  In no
  286.           instance should this file be distributed to anyone else or placed
  287.           in a location where it can be considered publicly available. 
  288.           This file does contain your name and is registered specifically
  289.           to you.  No one but you should have possession of this file.
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.           -----------------------------------------------------------------
  316.           MR/2 User's Guide - Version 2.0                            Page 2
  317.  
  318.  
  319.  
  320.           Upgrades
  321.           ========
  322.           To upgrade MR/2 to the latest version, simply download the new
  323.           version (or obtain it in some other way) and replace the
  324.           pertinent older files with the newer ones.  Care must be taken so
  325.           as not to overwrite MR/2 files that have been edited and 
  326.           customized to your liking.  This would include, but is not
  327.           limited to tagline files, templates, the dictionary word base,
  328.           INI files, and the various REXX .CMD files that are distributed
  329.           as utilities.  PLEASE, make frequent backups of your working MR/2
  330.           directory, and make sure you do a fresh backup before installing
  331.           a newer version of MR/2.
  332.  
  333.           The author reserves the right, at anytime he deems it necessary,
  334.           to ask for an additional "upgrade" fee from registered users. 
  335.           While this is not currently part of any plan, I would like to
  336.           keep the option open.  I would ask, under the same shareware
  337.           "honor system", that registered users wishing to take advantage
  338.           of the "upgrade" submit some nominal amount to be considered
  339.           fully registered for that level.
  340.  
  341.           NOTE:  In accordance with my previous stated policy, all users
  342.           who had registered prior to the release of version 2.0 are
  343.           considered registered for all future versions of MR/2.  The above
  344.           policy change effects only those registering at the v2.0 level or
  345.           later.  Thank you for supporting this program in its infancy!
  346.  
  347.  
  348.           Bug Reports, Suggestions and General Feedback
  349.           =============================================
  350.           If you've been using MR/2 for any amount of time, and/or you've
  351.           been posting messages in OS/2-related conferences, you might know
  352.           that I'm easy to find.  I welcome all correspondence, whether it
  353.           be harsh criticism, bug reports, ideas or suggestions of any
  354.           kind.  Various email addresses are listed at the end of this
  355.           manual, as well as in the read.me file.  In addition, I scan as
  356.           many different OS/2 related conferences as I can find, as well as
  357.           many OFFLINE (mail reader) conferences.  Mention MR/2 in any
  358.           message and the chances are that one of my virtual conferences
  359.           will catch it for me.  I try not to miss any mention of my
  360.           products.
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.           -----------------------------------------------------------------
  375.           MR/2 User's Guide - Version 2.0                            Page 3
  376.  
  377.  
  378.  
  379.           Major Features
  380.           ==============
  381.  
  382.           o    OS/2 Character mode specific. (A PM version is available.)
  383.  
  384.           o    Menu and Selection list interface.
  385.  
  386.           o    Context sensitive help.
  387.  
  388.           o    Mouse support.
  389.  
  390.           o    Multithreaded message searching.  Soundexing optional.
  391.  
  392.           o    You can build your own set of "virtual" or "custom"
  393.                conferences using search criteria.  You can specify the
  394.                logical conference name, the "real" conferences to search,
  395.                the keyword(s) to look for and which parts of the message to
  396.                examine.  These custom, user-defined conferences are built
  397.                in a background process, while you read your normal
  398.                messages.
  399.  
  400.           o    A "template file" is used to provide boiler plate text and
  401.                formatting for replies and new messages.  You can control
  402.                the layout of new "unprovoked" messages, replies, private
  403.                mail replies (Internet, Fidonet and Rime-routed) and more.
  404.                There's even a template section for forwarded, saved and
  405.                printed message headers.
  406.  
  407.           o    A large number of internal, reply-time replaceable variables
  408.                are available for use in the template file.  These variables
  409.                handle such things as complex attribution and signature
  410.                lines, as well as being able to handle most of the
  411.                intricacies of private mail routing.
  412.  
  413.           o    Integrated address book.  Load addresses into the address
  414.                book from any message or reply.  Full address-book
  415.                maintenance is also supplied.  Address book supports target
  416.                conferences and private routing information.
  417.  
  418.           o    Use your existing external editor or word processor for
  419.                replying or use MR/2's built-in editor.  You can even edit
  420.                in another session's window.
  421.  
  422.           o    Integrated spelling checker available from within the
  423.                internal editor and/or as a hot-key utility for checking
  424.                existing replies.  You can check the spelling of replies
  425.                even when using an external editor.  Hooks exist to allow
  426.                access to an external spelling checker, if desired.
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.           -----------------------------------------------------------------
  434.           MR/2 User's Guide - Version 2.0                            Page 4
  435.  
  436.  
  437.  
  438.           o    Messages can be "deferred" for later action.  This places a
  439.                copy of the message in your "In Basket".  The InBasket is a
  440.                special conference that is persistent across all packets
  441.                from the same BBS.  Messages are removed only on your
  442.                command.  This is handy for those times when a message is
  443.                crying out for a reply, but you wish to do so at a later
  444.                time.
  445.  
  446.           o    Optional reply logging.  This creates a conference for all
  447.                of your outgoing messages and lets you keep as many as you
  448.                like, for as long as you like.  Replies can be deleted
  449.                individually, or you can specify a maximum age and/or a
  450.                maximum count, and MR/2 will remove messages automatically. 
  451.                Any reply can be marked as "permanent", protecting it from
  452.                the age/count purge.  You can repost any reply with ease. 
  453.                You may also, optionally, tell MR/2 to log the original
  454.                "source" messages that provoked each reply. 
  455.  
  456.           o    Thread support includes sorting messages by subject (the
  457.                default) with special parsing to remove "RE: " type prefixes
  458.                of various forms.  There is also the "Q" key that displays a
  459.                pick-list of alphabetized threads in the current conference. 
  460.                This makes scanning for specific subjects very fast and
  461.                easy.
  462.  
  463.           o    Message sorting can be configured to use fields other than
  464.                SUBJECT.  The sort order is changeable "on the fly".  When
  465.                changed to sort by FROM or TO user, the "Q" key invokes a
  466.                summary pick-list of messages by user.
  467.  
  468.           o    Copy any message to another user, making you the originator. 
  469.                This is great for creating carbon-copy replies, but may also
  470.                be used to copy message from any conference.  Forwarding of
  471.                any message is available, too, with a definable text header
  472.                section.
  473.  
  474.           o    Text-searching is available in pick-list displays.
  475.  
  476.           o    Run multiple instances of MR/2.
  477.  
  478.           o    Access to the system clipboard.
  479.  
  480.           o    Long file name support.
  481.  
  482.           o    Configurable via the MR2.INI text file for global settings. 
  483.                BBS-specific settings can be specified in a BBSname.INI
  484.                file.  MR/2 is highly configurable.
  485.  
  486.           o    Bookmark-like features using extended attributes attached to
  487.                each packet.  Bookmarks are handled in such a way as to make
  488.                them "crash-resistant".
  489.  
  490.  
  491.  
  492.           -----------------------------------------------------------------
  493.           MR/2 User's Guide - Version 2.0                            Page 5
  494.  
  495.  
  496.  
  497.           o    Replies can be split at a user-defined line count, or not
  498.                split at all.  You may also use ".pg" commands embedded
  499.                within the reply to control where messages are split. 
  500.                Multiple part replies can be reassembled for modification,
  501.                if desired, preserving any ".pg" markers used.
  502.  
  503.           o    ANSI and PC Board color support for BBS provided screens and
  504.                messages.
  505.  
  506.           o    Rot13 encryption is supported both in the internal editor
  507.                and from within the message viewer.
  508.  
  509.           o    Message can be entered for a target BBS, even if no packet
  510.                for that BBS exists (BBS must have been read at least once
  511.                with MR/2).
  512.  
  513.           o    Full tagline support with enhanced tagline stealing.  If
  514.                MR/2 doesn't steal the right line, you can choose another.
  515.  
  516.           o    Multiple archiver support is provide via a REXX .CMD file
  517.                interface.  This REXX script handles most commonly used
  518.                archivers already, but may be extended to support any set of
  519.                circumstances you might desire.
  520.  
  521.           o    Merge multiple packets from the same BBS together to form a
  522.                single "combination" packet.  This is handled through a REXX
  523.                .CMD file with a direct "mark-and-merge" interface to MR/2's
  524.                Packet Selection screen.  Packets are combined and made
  525.                available immediately for reading, while MR/2 compresses the
  526.                combination packet into a final QWK file in the background.
  527.  
  528.           o    Support for various video display-mode line counts.  The
  529.                normal 25 line display is the default, but 28, 34, 40, 43,
  530.                50 and 60 line displays are supported and are easily
  531.                selectable.
  532.  
  533.           o    Support for WPS Associations.  If you set up a WPS
  534.                Association between MR/2 and *.Q*, for example, any time a
  535.                QWK packet is selected in the WPS drives folder, MR/2 will
  536.                be invoked. 
  537.  
  538.           o    Most of the "normal" features of other QWK reader are
  539.                included or are on the list of future enhancements.  Ideas
  540.                and suggestions are always welcome.
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.           -----------------------------------------------------------------
  552.           MR/2 User's Guide - Version 2.0                            Page 6
  553.  
  554.  
  555.  
  556.           A Brief Introduction to QWK Packets and Offline Reading
  557.           =======================================================
  558.  
  559.           The most popular PC format for packaging and reading offline mail
  560.           today is the QWK format.  A QWK packet is basically a collection
  561.           of files compressed into a single "packet" file, usually with a
  562.           ".QWK" extension.  A QWK packet contains at least a message data
  563.           file, and a control file.  Usually, though, several other support
  564.           files are included.
  565.  
  566.           To obtain a QWK packet, you must logon to a BBS that offers a QWK
  567.           mail "door".  This is simply a BBS external utility (although
  568.           some BBS systems are supporting this format internally) that has
  569.           the ability to scan the message bases, collect the mail that you
  570.           ask it to and assemble any and all support files.  It then packs
  571.           these files into a single, compressed QWK packet file.  From
  572.           there, you use your communications software to download the
  573.           packet to your PC.
  574.  
  575.           Once you've actually read the packet (which we'll get to in a
  576.           moment), you may have created replies that you wish to post to
  577.           the BBS's message base.  If so, MR/2 will have created a ".REP"
  578.           packet, which is a compressed file containing these replies.  For
  579.           example, if the original packet was from the FernWood BBS, the
  580.           reply packet would be called "FernWood.Rep".  You would then dial
  581.           back into the BBS and once again enter the QWK door used to
  582.           download the source packet.  The door's menus should contain an
  583.           option for "Upload Replies".  Select this option and upload the
  584.           reply file.  The QWK door should indicate whether or not the
  585.           upload was successful, and many actually acknowledge each reply
  586.           as it is recorded in the BBS's message base.
  587.  
  588.           That's an extremely brief overview of the process.  To actually
  589.           use a BBS's QWK door or internal capability, you must usually
  590.           perform some configuration and setup while online.  It is beyond
  591.           the scope of this manual to instruct you on this procedure. 
  592.           There are too many different types of QWK doors and each does
  593.           things in a different manner.  For more information on the BBS
  594.           side of things, read the QWK door's online documentation and/or
  595.           contact the BBS's sysop.
  596.  
  597.           If you were successful in configuring the BBS software and
  598.           downloading a packet, you may now use MR/2 to read its contents. 
  599.           MR/2 will allow you to select the packet from a pick list, then
  600.           will proceed to uncompress the packet and organize the files for
  601.           your viewing.  You have access to all requested messages,
  602.           organized by source conference.  In addition, bulletins, new file
  603.           lists and BBS news files, if any, will be available to examine. 
  604.           This is where the fun begins!
  605.  
  606.  
  607.  
  608.  
  609.  
  610.           -----------------------------------------------------------------
  611.           MR/2 User's Guide - Version 2.0                            Page 7
  612.  
  613.  
  614.  
  615.           Reading Mail Offline
  616.           ====================
  617.  
  618.           Why read mail offline?  For many, access to their favorite BBS is
  619.           a long distance or toll call.  There may also be limitations
  620.           placed on a user's BBS connection times.  It may not be possible
  621.           for some people to tie up a phone line for an hour or more while
  622.           reading message online.  Additionally, an offline reader usually
  623.           offers many features to make offline reading extremely
  624.           advantageous.  MR/2 is no exception.
  625.  
  626.           As a brief example, once a mail packet is opened, it may remain
  627.           opened all day long; for multiple days if you so desire.  You may
  628.           reply to a message and take as long as you'd like.  You can open
  629.           and close a single message and/or reply packet countless times.  
  630.           You can even use your favorite text editing tool to do so, if you
  631.           have one (MR/2 boasts a powerful yet easy-to-use internal text
  632.           editor, if needed.)  You can save it, move on, then modify it
  633.           some time later (as long as it hasn't yet been uploaded to the
  634.           BBS).  You can save individual messages to ASCII text files for
  635.           later reference.  You may "defer" messages, keeping them around
  636.           indefinitely, until you have a chance to reply or otherwise
  637.           process it.  You can search through all or individual conferences
  638.           for keywords.  You can set up keyword searches to be performed
  639.           automatically by MR/2, creating "virtual" conference, named by
  640.           you, that will contain any and all messages found.  In addition,
  641.           there are facilities to keep and reference complex "email"
  642.           addresses.  There is much, much more.
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.           -----------------------------------------------------------------
  670.           MR/2 User's Guide - Version 2.0                            Page 8
  671.  
  672.  
  673.  
  674.           System Requirements
  675.           ===================
  676.           MR/2 requires OS/2 v1.3 or later in order to load and operate. 
  677.           It will run in a strictly character mode environment, however,
  678.           due to the addition of PM clipboard code in version 2.0, the PM
  679.           DLL "PMWIN.DLL" is required.  If not found in the LIBPATH
  680.           specified within your Config.sys file, MR/2 will crash with an
  681.           error.  If PMWIN is copied into a LIBPATH directory, MR/2 will
  682.           operate.  MR/2 successfully loaded and function properly in tests
  683.           involving a boot floppy, no PM shell, and a single command line. 
  684.           It worked, that is, once access to PMWIN was provided.
  685.  
  686.           If PM is not loaded and operational, clipboard access will not
  687.           function and requests of MR/2 regarding the clipboard will be
  688.           ignored.
  689.  
  690.           If problems arise in the future regarding MR/2 and its need for
  691.           certain PM DLL's, I may be enticed to create a small "dummy" DLL
  692.           specifically for the purpose of resolving MR/2's external
  693.           references but providing no real functionality.  Please, let me
  694.           know if this becomes a problem.
  695.  
  696.           MR/2 has a couple of optional "utilities" that require the OS/2
  697.           REXX interpreter.  OS/2 can be configured to install without
  698.           REXX, although very little disk space is saved.  If the REXX
  699.           option is not loaded, the UNQWK/MSG2REP multiple archiver support
  700.           utilities will be unavailable, as will the MQWK Packet Merge
  701.           utility.
  702.  
  703.  
  704.           Command Line Parameters
  705.           =======================
  706.           There are a couple of command line parameters that may be passed
  707.           to MR/2.  Some users may find these handy.
  708.  
  709.           /Wpath         This may be used to override the MR2.INI WORKPATH
  710.                          specification and instruct MR/2 to use a different
  711.                          work subdirectory.  Replace "path" with the name
  712.                          of the desired subdirectory, which will be created
  713.                          if found not to exist.  This is handy, and in fact
  714.                          necessary, in order to have multiple MR/2 sessions
  715.                          running, each accessing a different packet.
  716.  
  717.           /Ialt.ini      You may use this command line switch to instruct
  718.                          MR/2 to access a default INI file other than
  719.                          MR2.INI.
  720.  
  721.           MR/2 can be passed one or more specific packets to read as
  722.           command line parameters.  Packet names should be fully qualified
  723.           (complete path specifications).  You may also set up WPS
  724.           associations so that MR/2 can be access from the drives folder
  725.           simply by clicking on a QWK or REP packet.  Add "*.q*" and
  726.           "*.rep" to an ICON that starts MR/2.
  727.  
  728.           -----------------------------------------------------------------
  729.           MR/2 User's Guide - Version 2.0                            Page 9
  730.  
  731.  
  732.  
  733.           Installing MR/2
  734.           ===============
  735.  
  736.           Unpack the MR/2 ZIP file (MR2_200.zip, for example) into an
  737.           appropriate directory ("\MR2", for instance).  All MR/2 files
  738.           should be kept together in the same directory.  You must invoke
  739.           MR/2 only while pathed into this directory - this is the only way
  740.           that MR/2 will be able to find its supporting files.
  741.  
  742.           Unpacking the zipped distribution file is all that's involved in
  743.           installing MR/2.  You may choose to create and edit an ".ini"
  744.           parameter file for MR/2.  This file may be used to set up various
  745.           run-time options.  A template file, "MR2INI.ORG" is supplied that
  746.           provides examples of all available parameters along with some
  747.           explanations.
  748.  
  749.           When using MR/2 for the first time, you will be given the chance
  750.           to have the default/example INI file copied to MR2.INI.  You will
  751.           then be placed into the system editor and allowed to modify this
  752.           file.
  753.  
  754.           To install support for the internal spelling checker and/or
  755.           thesaurus, simply unzip the corresponding distribution archives
  756.           into the same directory as the MR/2 executable file.  These
  757.           optional features are usually distributed as separate .zip files,
  758.           as they are quite large and not all users will find them
  759.           beneficial.  MR/2 will allow access to these additional features
  760.           if it finds the file(s) necessary are present.  Otherwise, a
  761.           dialog box is displayed, politely informing you that the
  762.           necessary files could not be found.
  763.  
  764.  
  765.           Optional Support Files Distributed Separately
  766.           ---------------------------------------------
  767.  
  768.                MR2DICTS.ZIP   Spelling checker "small" dictionary (128k)
  769.                               Contains 60,000 words, 248k uncompressed.
  770.  
  771.                MR2DICTL.ZIP   Spelling checker "large" dictionary (280k)
  772.                               Contains 120,000 words, 480k uncompressed.
  773.  
  774.                MR2THSRS.ZIP   Thesaurus word base (311k)
  775.                               Contains 9200 keywords, 70,000 synonyms,
  776.                               356k uncompressed.
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.           -----------------------------------------------------------------
  788.           MR/2 User's Guide - Version 2.0                           Page 10
  789.  
  790.  
  791.  
  792.           MR/2 Setup - the MR2.INI file
  793.           =============================
  794.  
  795.           When MR/2 is invoked for the very first time (actually, any time
  796.           where the file "MR2.INI" is not found), it will allow for
  797.           creation of this file. A short prompt will ask for your
  798.           permission, and if given, the file "MR2INI.ORG" will be copied to
  799.           "MR2.INI", and the OS/2 system "E" editor will be loaded, ready
  800.           for you to make any desired modifications.  Once the editor is
  801.           exited, you will see the MR/2 packet selection screen.
  802.  
  803.           It is very important to identify the correct "packet path" in the
  804.           MR2.INI file. This must identify the directory in which all your
  805.           .QWK packets are kept.  MR/2 does include a provisions for
  806.           changing the "packet path" on demand, in leu of modifying the
  807.           MR2.INI file and reloading.  From the packet selection screen (or
  808.           the "no packets found" message box), the packet path may be
  809.           edited by pressing ALT-P.
  810.  
  811.           The initial MR2.INI file contains an explanation of each option. 
  812.           Examine and set these options carefully to fit your specific
  813.           needs.  All INI parameters are listed alphabetically, below, and
  814.           are described in detail in Appendix A.
  815.  
  816.           If you fail or neglect to edit the MR2.INI file, the defaults
  817.           will look for packets in the MR/2 home directory.  MR/2's basic
  818.           install provides a "Welcome.QWK" packet that provides some basic
  819.           instructions.
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.           -----------------------------------------------------------------
  847.           MR/2 User's Guide - Version 2.0                           Page 11
  848.  
  849.  
  850.  
  851.           INI File Parameter/Options - Alphabetical Listing
  852.           -------------------------------------------------
  853.  
  854.           AllUpperCase                       PacketSort
  855.           Attributes                         PositionOnMatchLine
  856.           AutoFirstKey                       PostEdit
  857.           AutoUnpack                         PreEdit
  858.           BackDropMaxLines                   PurgeAfterCount
  859.           BackupOldReplies                   PurgeAfterDays
  860.           BeepOnPersonals                    QuoteBody
  861.           Check                              ReassembleSplits
  862.           Colors                             RemoveReplyBookmarks
  863.           Conference                         ReplyFile
  864.           CursorSize                         ReplyPath
  865.           DisplayStatus                      ReplyStripTagline
  866.           DoorName                           SaveFile
  867.           Editor                             SavePointerFiles
  868.           ExitAtEndOfParams                  SeparaterBar
  869.           F# (F2-F10)                        SerialInTagline
  870.           FileSpec                           ShowBBSID
  871.           FileViewer                         ShowEmpties
  872.           FolderPath                         ShowReadPercent
  873.           GoToLastRead                       SkipReadMessages
  874.           HeaderEditing                      SmartQuoting
  875.           HeaderInQuote                      SmartWrapping
  876.           HideConferences                    SortMasterConference
  877.           Internet                           SplitLongReplies
  878.           KeepMessageMarks                   String
  879.           LogReplies                         SuppressVersionInTag
  880.           MakeConference                     Tagline
  881.           MessageOrder                       TagMode
  882.           MouseClickSpeed                    TagStyle
  883.           MouseMode                          TemplateFile
  884.           MouseScrollSpeed                   ThreadChangeTone
  885.           Netmail                            UnZipper
  886.           NewMessageEditor                   V# (V0-V9)
  887.           OldQuoteDetect                     VideoMode
  888.           PacketPath                         WrapLinesAtColumn
  889.           PacketRefresh                      Zipper
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.           -----------------------------------------------------------------
  906.           MR/2 User's Guide - Version 2.0                           Page 12
  907.  
  908.  
  909.  
  910.           Using MR/2 for the First Time
  911.           =============================
  912.  
  913.           MR/2's user interface consists mainly of menus, selection lists
  914.           and confirmation prompts.  This, coupled with the context-
  915.           sensitive help, makes it relatively easy to use, even without a
  916.           manual.
  917.  
  918.           The ESCAPE key will usually move you back to a previous menu or
  919.           list.  It can be used to exit MR/2 when the Packet Selection List
  920.           is displayed.  Pressing ESCAPE may also be used to respond
  921.           negatively to most of the decision-type prompts that MR/2
  922.           displays.
  923.  
  924.           Clicking the RIGHT mouse button is recognized by MR/2 to be the
  925.           same as pressing the ESCAPE key one time.
  926.  
  927.  
  928.           Menus
  929.           -----
  930.           To select from a menu, simply use the up/down arrow keys to
  931.           highlight the desired option and press enter.  Alternatively, you
  932.           may click on an entry with the mouse.  Usually, a "hot key" is
  933.           defined for each entry.  This key is normally the first
  934.           capitalized character in the selection (e.g., "E" for "Exit" and
  935.           "M" for "Mail").
  936.  
  937.  
  938.           Selection Lists
  939.           ---------------
  940.           Many MR/2 items are displayed for interaction using "Selection
  941.           Lists".  For instance, the list of available packets, as well as
  942.           the list of conferences that contain mail, both use Selection
  943.           Lists.
  944.  
  945.           There are several methods for choosing an item from a Selection
  946.           List.  The simplest method involves using the up/down arrow keys
  947.           to move the highlight bar to the desired entry.  ENTER is then
  948.           used to select the highlighted item.  If you choose to use the
  949.           mouse, simply "double click" on the desired element.
  950.  
  951.           If more than one page of items exist, you may move through the
  952.           list a screen at a time using the PAGE UP and PAGE DOWN keys. 
  953.           The HOME key may be used to move to the very first item in the
  954.           list, as the END key moves to the last.  Pressing PAGE DOWN on
  955.           the last page of the list will move the highlight bar to the very
  956.           last element as well.
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.           -----------------------------------------------------------------
  965.           MR/2 User's Guide - Version 2.0                           Page 13
  966.  
  967.  
  968.  
  969.           In addition, you may type one or more normal alphabetic
  970.           characters to jump to an entry.  For example, if you are
  971.           positioned on the first entry of an alphabetical conference list
  972.           and press 'M', MR/2 will jump ahead and position the highlight on
  973.           the first entry in the list that starts with an 'M'.  If another
  974.           letter character is press immediately following this, a jump
  975.           ahead is performed looking for the combination of the two
  976.           characters as a prefix.  For example, if an 'A' was pressed as
  977.           the second character, MR/2 would scan ahead for an entry starting
  978.           with 'MA' and position the highlight on this entry.  If no entry
  979.           is found, the cursor position remains unchanged.  Pressing any
  980.           non-letter key will reset the prefix-match list.  In other words,
  981.           all prefix letters should be typed in succession without pressing
  982.           any cursor movement keys between them.
  983.  
  984.           The mouse may be used to move within a selection list, also. 
  985.           Selections lists display with a "scroll bar" on the right border. 
  986.           You may click on the up and down arrows to scroll the list up or
  987.           down one line for each click.  Holding the left mouse button down
  988.           while positioned on an arrow will simulate multiple clicks and
  989.           scroll the list in a faster fashion.  In addition, the mouse may
  990.           be positioned on the white block in the scroll region and
  991.           "dragged" to a relative position within the list.  For example,
  992.           if the position marker is dragged to the middle of the scroll
  993.           area, the selection list will be displayed starting at it's
  994.           midpoint.
  995.  
  996.           Clicking within the scroll area in effect drags the position
  997.           marker to the spot of the click.  This is handled differently
  998.           than standard GUI fashion where a click in these areas is
  999.           considered a PAGE DOWN or UP.  To page up a full screen with the
  1000.           mouse, click on the line immediately above the first displayed
  1001.           entry.  To page down, click on the bottom bar of the selection
  1002.           box.
  1003.  
  1004.           Some Selection Lists enable other "special" keystroke options. 
  1005.           These additional functions will be discussed in their
  1006.           corresponding sections.
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.           -----------------------------------------------------------------
  1024.           MR/2 User's Guide - Version 2.0                           Page 14
  1025.  
  1026.  
  1027.  
  1028.           Selecting a QWK Packet
  1029.           ======================
  1030.  
  1031.           After MR/2 has been configured, the first thing that is usually
  1032.           displayed is the Packet Selection List.  Displayed will be the
  1033.           names of all QWK packets found, as defined by the path and
  1034.           wildcard specification in MR2.INI.  Also displayed are any reply
  1035.           packets found in the defined reply path.  Reply packets, if any,
  1036.           always display at the end of the list, separated from full
  1037.           packets by a divider bar.
  1038.  
  1039.           If no packets are found to list, MR/2 will display a dialog box
  1040.           explaining this and listing the available options.
  1041.  
  1042.           Packets are displayed in date/time-order by default, with the
  1043.           most recent packet being at the top of the list.  Other options
  1044.           may be specified in the MR2.INI file.  To open a packet for
  1045.           reading, simply choose it by highlighting the name and pressing
  1046.           ENTER.  The chosen packet will be "unpacked" and readied for
  1047.           reading.
  1048.  
  1049.           MR/2 is also configured, by default, to update the packet list
  1050.           every 60 seconds.  This update will relist the packets and
  1051.           replies.  Any new, freshly downloaded packets will appear, as
  1052.           will any other changes made to the packets/replies available in
  1053.           any other session.
  1054.  
  1055.  
  1056.           Deleting a Packet
  1057.           -----------------
  1058.           You may delete any packet displayed on the Packet Selection list
  1059.           by positioning the highlight bar on it and pressing ALT-D.  A
  1060.           confirmation box will be displayed, and if acknowledged, the file
  1061.           will be deleted and the display updated.
  1062.  
  1063.  
  1064.           Renaming a Packet
  1065.           -----------------
  1066.           You may rename any packet displayed on the Packet Selection list
  1067.           by positioning the highlight bar on it and pressing ALT-R.  A
  1068.           form will be displayed prompting for a "new" name.  Fill in the
  1069.           desired new name and press ENTER to rename the file and update
  1070.           the display.  You may instead press ESCAPE to cancel the rename.
  1071.  
  1072.           You may delete any packet displayed on the Packet Selection list
  1073.           by positioning the highlight bar on it and pressing CTRL-D.  A
  1074.           confirmation box will be displayed, and if acknowledged, the file
  1075.           will be deleted and the display updated.
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.           -----------------------------------------------------------------
  1083.           MR/2 User's Guide - Version 2.0                           Page 15
  1084.  
  1085.  
  1086.  
  1087.           Relisting the Packets Available
  1088.           -------------------------------
  1089.           Pressing ALT-N will cause MR/2 to rebuild the list of available
  1090.           packets.  The screen display will then be updated to reflect the
  1091.           new list.  This is particularly handy when packets are being
  1092.           downloaded in another session and may not show up on an older
  1093.           list.
  1094.  
  1095.  
  1096.           Changing your current Packet Path
  1097.           ---------------------------------
  1098.           The packets normally listed are those found to exist in the
  1099.           packet path specification within MR2.INI.  You may change the
  1100.           packet path and wildcard specifiers used to find files "on-the-
  1101.           fly".  Simply press ALT-P and modify the displayed specification,
  1102.           then press ENTER to obtain the updated packet list.
  1103.  
  1104.  
  1105.           Merging Multiple Packets
  1106.           ------------------------
  1107.           MR/2 has the ability to merge one or more QWK packets into a
  1108.           single packet for easier scanning and reading.  Often, a BBS will
  1109.           limit the amount of message that will be sent in a single QWK
  1110.           packet, and it is necessary to download 2 or more packets to get
  1111.           all the messages available.  Reading them individually is always
  1112.           an option, but there are advantages to reading them as a single
  1113.           unit.
  1114.  
  1115.           To implement this feature, MR/2 uses a REXX script called
  1116.           MQWK.CMD.  While this file seems to handle most of the common
  1117.           packet merging problems, it may be necessary to edit it and
  1118.           change some system-specific commands.  If merging packets fails,
  1119.           simply edit this file and read the notes located at the very
  1120.           beginning.  The instructions placed there will explain some more-
  1121.           common problems, and how to solve them.  
  1122.  
  1123.           To merge two or more packets, you must start at the MR/2 opening
  1124.           screen, the Packet Selection list.  You select the packets to
  1125.           merge by moving the highlight bar to each packet and pressing F11
  1126.           (or the "*" key for those keyboards without extended function
  1127.           keys).  The packet name will be prefixed with a double-arrow-like
  1128.           symbol.  Once all packets that you wish to merge have been
  1129.           marked, press ALT-M.
  1130.  
  1131.           NOTE that all packets *must* have originated from the same BBS,
  1132.           and that there is no error checking for this.  Trying to merge
  1133.           QWK packets from different BBS's will produce unpredictable
  1134.           results and is not supported.
  1135.  
  1136.           After you press ALT-M, you will be asked to supply a file name
  1137.           for the combination QWK packet.  A default will be displayed, and
  1138.           you may accept this by simply pressing ENTER.  If this is
  1139.           unacceptable, make the desired changes then press ENTER.  MR/2
  1140.  
  1141.           -----------------------------------------------------------------
  1142.           MR/2 User's Guide - Version 2.0                           Page 16
  1143.  
  1144.  
  1145.  
  1146.           will warn you if a file by that name already exists, and will let
  1147.           you continue or supply a different name.  You may also leave the
  1148.           name totally blank, in which case MR/2 will simply merge the
  1149.           packets into the "working" directory for reading, but will not
  1150.           create a combination QWK packet.  This is not recommended, as
  1151.           bookmarks will not be able to be recorded for this temporary
  1152.           packet.  It remains, however, an option.
  1153.  
  1154.           Once a new packet name has been supplied, MR/2 calls upon the
  1155.           MQWK.CMD REXX script.  The first packet will be unzipped into the
  1156.           working directory.  Each subsequent packet will be unpacked and
  1157.           merged with the existing files.  MQWK.CMD will merge the message
  1158.           bases and the "Control.dat" files, and will save the newest of
  1159.           any file lists, news files, bulletins and any other supporting
  1160.           files.  All .NDX files are discarded, as MR/2 has the ability to
  1161.           create its own, and will do so before the packet is given to the
  1162.           user to read.
  1163.  
  1164.           If all goes well, MR/2 will again receive control of the session,
  1165.           build the NDX files for the new combination packet, and allow you
  1166.           to start reading.  At the same time, in the background (and if
  1167.           you supplied a combined-packet name), will invoke your archiver
  1168.           to pack the merged files into the file names specified.
  1169.  
  1170.           If all does not go well, please read the directions in the front
  1171.           of MQWK.CMD with a text editor.  Common problems will be
  1172.           described, along with any existing solutions or suggestions.  If
  1173.           all else fails, contact the author with information on the
  1174.           problem.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.           -----------------------------------------------------------------
  1201.           MR/2 User's Guide - Version 2.0                           Page 17
  1202.  
  1203.  
  1204.  
  1205.           Modifying the MR2.INI file
  1206.           --------------------------
  1207.           While on the Packet Selection screen, the ability to edit the
  1208.           MR2.INI configuration file using the defined text editor is
  1209.           provided through the ALT-C key combination.  This will call your
  1210.           editor (or the default of the "E" editor, if not specified) and
  1211.           load the MR2.INI file.  Once you exit the editor, MR/2 reloads
  1212.           the .ini file, and changes take effect immediately.
  1213.  
  1214.           NOTE:  MR/2 will not automatically load a "local" or BBS-specific
  1215.           INI file for modification.  You may, however user your editor's
  1216.           open/save logic (if any) to modify an files desired.
  1217.  
  1218.  
  1219.           Entering Message for a BBS without a Packet
  1220.           -------------------------------------------
  1221.           While on the Packet Selection List, you may press ALT-E to enter
  1222.           messages for any BBS ever accessed through MR/2.  This allows
  1223.           messages to be entered for a BBS when all previously read packets
  1224.           have been deleted.
  1225.  
  1226.           When you open any packet with MR/2, the BBS control data is
  1227.           copied into the MR/2 home directory.  The name of the file will
  1228.           be built from the BBS name "ID", suffixed with ".cfg".  For
  1229.           instance,  If the BBS ID is NerdNook, then the file will be
  1230.           called "NerdNook.cfg".
  1231.  
  1232.           A list of BBS ".cfg" files is displayed by pressing ALT-E, while
  1233.           the normal Packet Selection List is removed from view.  You may
  1234.           use the ESCAPE key to return to the list of packets, or you may
  1235.           choose one of the BBS name for new message entry.
  1236.  
  1237.           Once a BBS name is picked, MR/2 checks for existing replies.  If
  1238.           any are found for the specified BBS, you are asked if you wish to
  1239.           keep these, or discard them.  Respond appropriately.  The Packet
  1240.           Main Menu is now displayed with some of the options disabled. 
  1241.           You will only be allowed to enter new messages, as well as review
  1242.           any previous messages (contained in the Replies conference).  If
  1243.           you have active messages in your InBasket conference for the
  1244.           target BBS, these will also be available.  In addition, your
  1245.           ReplyLog will be available if reply logging has been activated.
  1246.  
  1247.           See "Creating New Messages", below, for more instructions on
  1248.           creating unprovoked messages.
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.           -----------------------------------------------------------------
  1260.           MR/2 User's Guide - Version 2.0                           Page 18
  1261.  
  1262.  
  1263.  
  1264.           NOTE:  Some BBS's and/or QWK door combinations will place an
  1265.           abbreviated "control.dat" file in each QWK packet.  This causes
  1266.           problems for MR/2 whenever a new message is written, as only
  1267.           those conferences defined in the Control.Dat file are accessible. 
  1268.           If one of these abbreviated files is saved as a BBS.CFG file
  1269.           (used for no-packet entry), then MR/2 has no way of knowing about
  1270.           conferences not included.  If you find this to be a problem,
  1271.           check your QWK doors configuration for a switch to force a full
  1272.           conference list with each packet.  Alternately, ask your sysop
  1273.           about configuration options.  You may, however, enter the number
  1274.           of the conference you wish to post into without it being
  1275.           described in the control file.  This, of course, assumes that you
  1276.           know the conference number   MR/2 will accept any number as the
  1277.           target conference.  A warning will be issued that the conference
  1278.           is "unknown", but the number will be accepted if you wish to
  1279.           continue.
  1280.  
  1281.  
  1282.           Toggling the Video Display Mode
  1283.           -------------------------------
  1284.           You may toggle the number of text lines displayed on the packet
  1285.           selection screen by pressing ALT-V.  This will jump to the next
  1286.           higher count of display lines.  For example, MR/2 is configured
  1287.           by default to start in 25 line mode.  By pressing ALT-V, the
  1288.           screen is repainted in 28 line mode.  Modes that follow are
  1289.           dependent on your video card and the way OS/2 is configured with
  1290.           it.  The "normal" display-line modes available are 25, 28, 34,
  1291.           40, 43, 50 and 60.
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.           -----------------------------------------------------------------
  1319.           MR/2 User's Guide - Version 2.0                           Page 19
  1320.  
  1321.  
  1322.  
  1323.           The "Unpacking" Process
  1324.           =======================
  1325.  
  1326.           If you choose a packet for reading, it is unarchived using the
  1327.           unpacking utility defined in MR2.INI.  If this command fails, an
  1328.           informational box will be displayed showing the complete command
  1329.           for debugging and correction.
  1330.  
  1331.           After the packet is unpacked, a check is made for existing
  1332.           replies.  If replies for the packet's source BBS are found, you
  1333.           are asked if you wish to keep or discard them.  If these replies
  1334.           have been previously uploaded to the BBS, you may discard them,
  1335.           otherwise, you will probably want to keep them.
  1336.  
  1337.           If you have not disabled the "bookmark" feature (it's enabled by
  1338.           default), then another prompt may appear.  If you have previously
  1339.           read part of the current packet, you will be asked if you wish to
  1340.           return to your previous reading position.  Responding YES will
  1341.           place you at the last message MR/2 remembered you reading. 
  1342.           Responding NO will place you at the Packet Main Menu.
  1343.  
  1344.           MR/2 can be configured to respond "YES" to either or both of the
  1345.           above prompts automatically, if desired.  This can result in
  1346.           faster packet-open times, if you normally respond "YES" anyway. 
  1347.           See the INI parameters "AutoUnpackReplies" and "GoToLastRead".
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.           -----------------------------------------------------------------
  1378.           MR/2 User's Guide - Version 2.0                           Page 20
  1379.  
  1380.  
  1381.  
  1382.           Packet Main Menu
  1383.           ================
  1384.  
  1385.           Once a packet is ready for reading, the Main Menu is displayed. 
  1386.           The following options are listed:
  1387.  
  1388.                Mail
  1389.                Write new
  1390.                Files
  1391.                News
  1392.                Bulletins
  1393.                Pack Replies
  1394.                Exit
  1395.  
  1396.           MR/2 will examine the contents of the current packet and
  1397.           enable/disable any of these options that are not applicable.  For
  1398.           instance, if the packet contains no "new files" listing, then the
  1399.           "Files" option will display de-emphasized and can not be chosen.
  1400.  
  1401.  
  1402.           Mail
  1403.           ----
  1404.           Select this option to read the messages contained in the current
  1405.           packet.  Once selected, a list of conferences with mail will be
  1406.           displayed.  If any messages addressed specifically to you are
  1407.           found, a "Personal" conference will be placed at the top of the
  1408.           list for easy access.  Next to each conference, in parenthesis,
  1409.           will be the number of messages found in that conference.
  1410.  
  1411.           In addition to the "Personal" conference, two other special
  1412.           conference might appear.  The "Inbasket" conference contains all
  1413.           active messages that have been "deferred" for the current BBS. 
  1414.           These messages may have originated from countless older packets,
  1415.           as a deferred messages is kept in the inbasket until it is
  1416.           manually removed by the user.
  1417.  
  1418.           The "ReplyLog" conference is another special conference that, if
  1419.           MR/2 is configured to log replies, might appear.  This conference
  1420.           will contain a log of your recent replies, in QWK format, for
  1421.           your review and reference.  The maximum count and age of kept
  1422.           replies is configurable via two MR2.INI parameters.  See
  1423.           PurgeAfterDays and PurgeAfterCount in the section that describes
  1424.           INI parameters.
  1425.  
  1426.           MR/2 can also build special "virtual" conferences, if you
  1427.           instruct it to do so.  Virtual conferences are user-named and are
  1428.           filled with messages that match certain search criteria; usually
  1429.           keywords of interest.  You may define multiple keywords that are
  1430.           used in "or" mode.  You can also limit the search to specific
  1431.           conference numbers, and tell MR/2 to check all or only certain
  1432.           areas of the message (Subject only, for instance).  If you
  1433.           specify no keywords but provide a list of conferences, MR/2 will
  1434.           combine all messages from these conferences into a single virtual
  1435.  
  1436.           -----------------------------------------------------------------
  1437.           MR/2 User's Guide - Version 2.0                           Page 21
  1438.  
  1439.  
  1440.  
  1441.           conference.  This makes it easier to scroll though common areas
  1442.           that might otherwise have only contained a few messages in each. 
  1443.           This feature is often used with the INI parameter
  1444.           "HideConferences" so that the individual, original conferences
  1445.           are not listed separately.
  1446.  
  1447.           If virtual conferences have been defined, MR/2 will build these
  1448.           conferences in the background.  You may read messages normally
  1449.           while this takes place.  A low beep tone will be made when all
  1450.           virtual conferences have been built.  If you happen to have the
  1451.           Conferences w/Mail screen displayed when this happens, MR/2 will
  1452.           automatically update the selection list with all new conferences.
  1453.  
  1454.           If more than one screen of conferences exist, you may use the
  1455.           PAGE UP/DOWN keys, or the arrow keys to move through them.  HOME
  1456.           and END are also functional here.
  1457.  
  1458.  
  1459.           Searching All Conferences
  1460.           -------------------------
  1461.           While on the Conference Selection screen, you have the option of
  1462.           searching all conference with mail for one or more text strings. 
  1463.           Pressing ALT-F will bring up the Search Criteria entry form. 
  1464.           Fill in the text string you wish to find and press ENTER. 
  1465.           Matching entries will be queued up and displayed as requested. 
  1466.           See the section on searching below for a more detailed
  1467.           description.
  1468.  
  1469.  
  1470.           Adding/Dropping
  1471.           ---------------
  1472.           You may also have MR/2 send certain configuration messages to
  1473.           your BBS's mail door.  These message include requests to ADD a
  1474.           new conference to your active reading list, or to remove or DROP
  1475.           a conference you are currently downloading.
  1476.  
  1477.           This function may be accessed from the Conferences w/Mail screen,
  1478.           or from the Conference selection list available when editing a
  1479.           reply or new messages header (ALT-C).  Since the latter is the
  1480.           more complete list, most ADD actions will be requested from that
  1481.           list.  Move the cursor so that the target conference is
  1482.           highlighted.  Press ALT-A to ADD the conference to future
  1483.           packets; ALT-D to DROP the conference from your "reading" list.
  1484.  
  1485.           MR/2 finds and parses the DOOR.ID file, if the packet contains
  1486.           one.  This is usually necessary for the proper door messages to
  1487.           be generated.  If not found, MR/2 assumes you are using the QMAIL
  1488.           door and generates QMAIL-type configuration messages.  You may
  1489.           also specify a different default door name using the DoorName INI
  1490.           parameter.
  1491.  
  1492.  
  1493.  
  1494.  
  1495.           -----------------------------------------------------------------
  1496.           MR/2 User's Guide - Version 2.0                           Page 22
  1497.  
  1498.  
  1499.  
  1500.           Reading Messages
  1501.           ----------------
  1502.           After Choosing the conference you wish to read, the first message
  1503.           in that conference will be displayed.  At this point, a variety
  1504.           of options present themselves.  Remember, pressing F1 at anytime
  1505.           while in MR/2 will display a help screen listing the available
  1506.           keystrokes.  Pressing F1 while on a message display results in
  1507.           the following information being displayed:
  1508.  
  1509.           -----------------------------------------------------------------
  1510.                                   MESSAGE READING HELP
  1511.           +   (ENTER) Move forward one message    P - Print to "prn" device
  1512.           G/- Move backward one message           O - Shell a command line
  1513.           S   Print the message to a file         Z - Skip to next "unread"
  1514.           F   Find text within the conference     Q - Thread Selection menu
  1515.           T   Steal the message's tagline         D - Defer to INBASKET
  1516.           I   List messages w/header information  W - ForeWard a message
  1517.           K/U Kill/UnKill (reps & folders ONLY)   C - Copy a message/reply
  1518.           R   Reply to message/modify a reply     A - ANSI Viewer
  1519.           N/L Find NEXT/PREVIOUS find match       * - Put message in editor
  1520.           X   Exit MR/2 fast (after Confirm)      E - Enter a NEW message
  1521.           H/B Move forward/backward w/in thread   J - View ReplyLog orig.
  1522.                                                   ! - Make permanent
  1523.           F2 -> F10      User definable
  1524.           TAB/BACKSPACE  NEXT/PREVIOUS thread    ALT-A   Save address
  1525.           PAGE UP/DOWN   Forward/back 1 screen   CTRL-F2 Spell check reply
  1526.           UP/DOWN ARROW  Scroll up/down 1 line   ALT-E   unEncrypt (ROT13)
  1527.           RIGHT/LEFT     Scroll right/left       ~       Rewrap message
  1528.           HOME/END       Jump start/End          ALT-N   Next find-match
  1529.           spacebar       Next Page/Next message          w/in current msg
  1530.           ESCAPE         Exit message            ALT-TAB Toggle tabs [4802]
  1531.           -----------------------------------------------------------------
  1532.  
  1533.           Some of these options are self-explanatory and will not be
  1534.           discussed further.
  1535.  
  1536.  
  1537.           Message Sort Order
  1538.           ------------------
  1539.           Message sort order is initially set within MR2.INI, or in a local
  1540.           BBS.INI file.   This sort order controls the order in which
  1541.           messages are displayed as you read them sequentially.  It also
  1542.           effects the displayed order of the message index, and what
  1543.           happens when the Quick Summary screen is requested.  By default,
  1544.           sort order is set to "thread", so that all messages are sorted
  1545.           alphabetically by subject.
  1546.  
  1547.           The sort order for any conference can be changed "on the fly", if
  1548.           desired.  See the section "Selection Messages by Header
  1549.           Information", below.
  1550.  
  1551.  
  1552.  
  1553.  
  1554.           -----------------------------------------------------------------
  1555.           MR/2 User's Guide - Version 2.0                           Page 23
  1556.  
  1557.  
  1558.  
  1559.           Using the Spacebar
  1560.           ------------------
  1561.           The spacebar will move forward through message one screen at a
  1562.           time.  For instance, if a message is three "screens" long,
  1563.           pressing the spacebar will show you screen two, pressing it again
  1564.           screen three.  When it's pressed the next time, the next message
  1565.           in sequence will be displayed.
  1566.  
  1567.  
  1568.           Mousing Around
  1569.           --------------
  1570.           Some mouse support is provided when on the message viewing
  1571.           screen.  Clicking in various areas or on certain words will
  1572.           perform functions equivalent to the more common keyboard
  1573.           commands.  For example:
  1574.  
  1575.           o    Click on the bottom "status" line works the same as
  1576.                hitting ENTER.
  1577.  
  1578.           o    Click on the next line up (last display line) and
  1579.                you've simulated "spacebar".
  1580.  
  1581.           o    Any other line on the bottom half of the message area
  1582.                is a page-down.
  1583.  
  1584.           o    Click on any line in the top half of the message is the
  1585.                same as a "page up".
  1586.  
  1587.           o    Click on the "==" header dividing line and you've
  1588.                requested the previous  message ("G" or "-").
  1589.  
  1590.           o    Click on "Subject:" pages forward by thread, "Conf:"
  1591.                brings up the index and on "Hit" (or where it should be
  1592.                displayed) for the next search.
  1593.  
  1594.           o    Click on the [M] at the end of the divider line to
  1595.                access the "mouse menu", a pick-list of message reading
  1596.                functions.
  1597.  
  1598.           o    Click on the arrow boxes at the end of the divider line
  1599.                to scroll up/down as desired.
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.           -----------------------------------------------------------------
  1614.           MR/2 User's Guide - Version 2.0                           Page 24
  1615.  
  1616.  
  1617.  
  1618.           Selecting Messages by Header Information
  1619.           ----------------------------------------
  1620.           Pressing "I" or the INSERT key will bring up the Message Header
  1621.           Selection List.  Messages will be listed, one per display line,
  1622.           providing the message number, from-name, to-name, subject and
  1623.           date/time.  If a message has been previously read, an asterisk
  1624.           "*" will proceed its entry.  If a message has been saved, replied
  1625.           to or killed (replies only), status marks will be placed at the
  1626.           end of the entry ("S", "R", "K", respectively).
  1627.  
  1628.           To select a message, simply move the highlight bar to the desired
  1629.           entry and press ENTER.  The mouse may also be used, as well as
  1630.           all other standard selection list keystrokes.
  1631.  
  1632.           When the Message Header List is displayed, the highlight bar will
  1633.           be positioned on the currently displayed message.
  1634.  
  1635.           The sort order for any conference can be changed "on the fly", if
  1636.           desired.  From the Message Index screen ('I" while viewing any
  1637.           message), simply press ALT-O.  A selection menu will be
  1638.           displayed.  Pick a desired sort order from the following
  1639.           possibilities:
  1640.  
  1641.                          Number
  1642.                          Subject 
  1643.                          From
  1644.                          To
  1645.                          Date/Time
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.           -----------------------------------------------------------------
  1673.           MR/2 User's Guide - Version 2.0                           Page 25
  1674.  
  1675.  
  1676.  
  1677.           Replying
  1678.           --------
  1679.           When you find a message that you wish to reply to, simply press
  1680.           "R".  MR/2 will "quote" the message (i.e., copy the original
  1681.           message with the author's initials) to a reply file and invoke
  1682.           the editor defined in your MR2.INI file, if one is defined.  The
  1683.           quoted message is usually modified by trimming off excess lines
  1684.           and making it look more presentable.  Add your reply text to the
  1685.           end of the quoted section.
  1686.  
  1687.           Once the reply is complete, save it and exit the editor.  MR/2
  1688.           will retrieve the modified file and record it as a reply.
  1689.  
  1690.           You will be asked to review and accept the "reply header"
  1691.           information, either before or after editing the reply, or
  1692.           sometimes in both instances.  This is "configurable" via an
  1693.           option in the MR2.INI file.  Usually, the header will be
  1694.           acceptable unchanged.  You do have the option, though, to do such
  1695.           things as change the addressee name, conference, tagline and
  1696.           security status.  Also, if you wish to reply and address the
  1697.           message to the original message's addressee, the F3 "Toggle To"
  1698.           function is available.  The F2 key works as a pick-list selection
  1699.           key from the TO, CONFERENCE and TAGLINE fields.  When pressed
  1700.           while the cursor is within the TO field, the address book
  1701.           selection list will be displayed.  When pressed from within the
  1702.           CONFERENCE field, a pick-list of all available conferences will
  1703.           be displayed.  Also, you may pick a different tagline from a list
  1704.           of those available by pressing F2 while in this field.
  1705.  
  1706.           Specific Pick-lists can be displayed regardless of the current
  1707.           field via special hot-keys.  ALT-C will display the conference
  1708.           list, ALT-A the address book list and ALT-T the tagline list.
  1709.  
  1710.           NOTE that MR/2 allows you to enter conference numbers that do not
  1711.           exist.  This is to accomodate situations where a conference
  1712.           number is known to exist, but the BBS's control.dat file does not
  1713.           contain an entry for it.  This occurs with some mail doors that
  1714.           allow abbreviated control.dat files, and with PC-Board's command
  1715.           line QWK option.  While entry of unknown conference numbers is
  1716.           allowed, you will be warned of the possibility of an error.
  1717.  
  1718.           By default, long replies are split into messages of about 100
  1719.           lines in length.  This length is entirely configurable using the
  1720.           SplitLongReplies INI parameter.  Set this value to NO to suppress
  1721.           splitting altogether.  When a long reply is split, its subject
  1722.           field is modified to contain the literal sequence (e.g., "...
  1723.           (1/3)").  MR/2 will also allow reassembly of split replies by
  1724.           default.  This allows you to modify a split reply as a complete,
  1725.           unsplit entity.  NOTE that a user may force a "split" at a
  1726.           particular line by simply placing the ".pg" split-here command at
  1727.           the desired location (on a line of its own).  When a reply split
  1728.           using ".pg" is reassembled, any original manual breaks will be
  1729.           remembered and preserved.
  1730.  
  1731.           -----------------------------------------------------------------
  1732.           MR/2 User's Guide - Version 2.0                           Page 26
  1733.  
  1734.  
  1735.  
  1736.           Using an Editor in a Separate Window/Session
  1737.           --------------------------------------------
  1738.           While loading an editor "on demand" is usually quick and easy in
  1739.           character mode, using a PM based editor can be cumbersome.  For
  1740.           this reason, MR/2 provides an option for editing replies in a
  1741.           separate session.
  1742.  
  1743.           First, the MR2.INI file should contain a line specifying "NONE"
  1744.           for the editor:
  1745.  
  1746.                Editor=NONE
  1747.  
  1748.           You may also wish to declare the name of the "ReplyFile" to be
  1749.           simple and easy to locate (e.g., "C:\Reply").  When you request
  1750.           to reply to a message, MR/2 will quote the message to the named
  1751.           reply file.  With the editor option set to "NONE", MR/2 then
  1752.           merely posts an informative "Waiting - press any key" message and
  1753.           waits for a key press.  This allows you to switch to another
  1754.           session, load the reply file, modify it, save it and return to
  1755.           MR/2.  Once a key is pressed, MR/2 retrieves and records the
  1756.           reply in the normal way.
  1757.  
  1758.           NOTE:  You must be sure to save the reply and release the file
  1759.           before switching back to MR/2, as MR/2 provides very little error
  1760.           checking in this mode.
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.           -----------------------------------------------------------------
  1791.           MR/2 User's Guide - Version 2.0                           Page 27
  1792.  
  1793.  
  1794.  
  1795.           Killing the Current Reply
  1796.           -------------------------
  1797.           Once a reply exists, the Conference Selection list will include
  1798.           an entry for reviewing replies.  You may read these in the same
  1799.           manor as you read regular incoming mail.  If you find a reply
  1800.           that you wish to remove, you may "kill" it by pressing the "K"
  1801.           key.  After confirming this action, MR/2 will mark the message as
  1802.           "killed".  It will still be viewable, but will not be packed in
  1803.           the reply file.
  1804.  
  1805.           NOTE:  As long as you don't leave the current session and packet,
  1806.           any killed reply can be "unkilled" easily.  Simply move to the
  1807.           message to be reactivated and press "U" to "unkill" it. 
  1808.           Alternatively, you can display the message and press "R" to
  1809.           modify the reply.  Save the message as-is and the killed status
  1810.           will be removed.  Once you exit the current packet and replies
  1811.           are packed, any killed messages are gone forever.
  1812.  
  1813.  
  1814.           Modifying a Reply
  1815.           -----------------
  1816.           Once at least one reply exists, the Conference Selection list
  1817.           will include an entry for reviewing replies.  You may read these
  1818.           in the same manor as you read regular incoming mail.  If you find
  1819.           a reply that you wish to modify, you may do so by pressing the
  1820.           "R" key.  The message will be displayed for modification using
  1821.           the default editor.  Make the desired changes and save the
  1822.           message and MR/2 will place the updated message into the reply
  1823.           file.
  1824.  
  1825.  
  1826.           Searching
  1827.           ---------
  1828.           You may search a conference for one or more text strings. 
  1829.           Messages found contain the string(s) will be displayed, one at a
  1830.           time.  Searching is multithreaded, meaning that while your
  1831.           viewing the first (or subsequent) matching message, MR/2 will
  1832.           continue to search through the rest of the messages for more.
  1833.  
  1834.           To search the current conference, simply press "F" while on any
  1835.           message from that conference.  This will invoke the Search
  1836.           Criteria Entry form.  Fill in a text string to search for and
  1837.           press ENTER.  You will have to wait until MR/2 finds the first
  1838.           match, which will then be displayed for your viewing.
  1839.  
  1840.           When a "hit" is displayed, MR/2 will attempt to display the
  1841.           message so that the message line containing the matching text is
  1842.           the second display line.  If the match was caused by the From, To
  1843.           or Subject fields, then the message is displayed at its starting
  1844.           point.
  1845.  
  1846.  
  1847.  
  1848.  
  1849.           -----------------------------------------------------------------
  1850.           MR/2 User's Guide - Version 2.0                           Page 28
  1851.  
  1852.  
  1853.  
  1854.           While performing the search, MR/2 constantly updates the bottom
  1855.           line of the screen with information on its progress. 
  1856.           Additionally, while viewing search result, "Hit x of xx" is
  1857.           updated in the upper right corner of the display.
  1858.  
  1859.  
  1860.           Multiple Search Strings
  1861.           -----------------------
  1862.           You may search for more than one text strings in a single pass by
  1863.           separating the different strings with backslashes "\".  MR/2 will
  1864.           check each message for each separate string, and will call the
  1865.           message a "match" if any one of them is found.
  1866.  
  1867.  
  1868.           Soundex Searching
  1869.           -----------------
  1870.           MR/2 also supports "soundex" searching, or searching for sound-
  1871.           alike words.  To request a soundex search, simply prefix the
  1872.           search text with an ampersand "&".  For instance, "&Windoze" will
  1873.           match Windows, windoze, etc.,.  The soundexing algorithm is very
  1874.           loose, requiring the use of larger words in order to avoid a hit
  1875.           on every message.
  1876.  
  1877.  
  1878.           Examining Search Results
  1879.           ------------------------
  1880.           You may move freely through any resulting message hits by
  1881.           pressing "N" for the "Next" message, or "L" for the "Last" or
  1882.           previous message.  Alternatively, you may use the mouse to move
  1883.           forward by clicking on the "Hit x of xx" status area.
  1884.  
  1885.           When a search record is displayed, all words matching the search
  1886.           criteria will be displayed in a different color (user-
  1887.           controllable via the INI parameter "Colors").  Usually, the
  1888.           message will be displayed so that the first match within the
  1889.           message will be found on the second display line.
  1890.  
  1891.           In addition to using "N" to move to the next message with a
  1892.           search-hit, you may press ALT-N to search forward within the
  1893.           current message for the "next", undisplayed match.
  1894.  
  1895.           Requesting a new search will destroy the results of the previous
  1896.           search.  Escaping to the Conference Selection List will also
  1897.           discard the results.
  1898.  
  1899.           If you request a "next" or "previous" record, and you are at the
  1900.           beginning or end of the list of hits, MR/2 will post an
  1901.           information box and wait for a key.
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.           -----------------------------------------------------------------
  1909.           MR/2 User's Guide - Version 2.0                           Page 29
  1910.  
  1911.  
  1912.  
  1913.           Searching All Conferences
  1914.           -------------------------
  1915.           As mentioned previously, you can search for text in all
  1916.           conferences by pressing ALT-F on the Conference Selection List. 
  1917.           The search process will be performed in a manner similar to a
  1918.           single conference search.  When reviewing messages found in this
  1919.           way, many of the keystrokes normally available are disabled or
  1920.           their behavior is modified.  For example, since there is no
  1921.           sequential "next" record, pressing ENTER will give you the "next"
  1922.           message hit.
  1923.  
  1924.  
  1925.           Saving to a Text File
  1926.           ---------------------
  1927.           If you wish to save any message to a text-based save file, press
  1928.           "S" while viewing the message.  This will invoke the Save File
  1929.           Name form with the default name of the last file name used.  You
  1930.           may used this file name simply by pressing ENTER.  You may make
  1931.           any manual changes to the name desired and then press ENTER.  If
  1932.           you wish to select from a list of existing save files, pressing
  1933.           F2 will provide a list from which to choose.  The list if built
  1934.           from scanning the disk for wildcard matches built using the
  1935.           currently displayed name.  You may place wildcards in the
  1936.           displayed specification to control the displayed list.
  1937.  
  1938.           Saving first appends the message header to the names file, then
  1939.           the text of the message.  The exact format of the saved message
  1940.           header can be defined by the user.  The template section
  1941.           "SaveHeader" is used by MR/2, if it exists.  The example template
  1942.           file contains a default definition for this section.
  1943.  
  1944.  
  1945.           Reading by Subject/Thread
  1946.           -------------------------
  1947.           You may move forward or backwards through messages based on
  1948.           subject by pressing "H" for forward movement or "B" for backwards
  1949.           movement.  You may also click the mouse on the Subject area of
  1950.           the message to move forward by thread.
  1951.  
  1952.  
  1953.           Fast Exit from MR/2
  1954.           -------------------
  1955.           You may exit MR/2 quickly any time you are reading a message by
  1956.           pressing "X".  This will bypass the display of all menus and
  1957.           selection lists normally performed when you use ESCAPE to "back
  1958.           out" of the program.  It will also suppress the packing of
  1959.           replies and the cleanup of the work directory.  This will allow
  1960.           you to reenter MR/2 at a later time, and pick up exactly where
  1961.           you left off.
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.           -----------------------------------------------------------------
  1968.           MR/2 User's Guide - Version 2.0                           Page 30
  1969.  
  1970.  
  1971.  
  1972.           Spawning an OS/2 command line
  1973.           -----------------------------
  1974.           While somewhat redundant, access to the OS/2 command line is
  1975.           provided by pressing "O" while viewing a message.  You MUST
  1976.           remember to use the "exit" command to return to MR/2.
  1977.  
  1978.  
  1979.           Printing
  1980.           --------
  1981.           You may format any message to the default "prn" device by
  1982.           pressing the "P" key.  No prompting for confirmation is
  1983.           performed, and error checking is non-existent.
  1984.  
  1985.           Printing first output the message header, the text of the message
  1986.           followed by a formfeed.  The exact format of the printed message
  1987.           header can be defined by the user.  The template section
  1988.           "PrintHeader" is used by MR/2, if it exists.  The example
  1989.           template file contains a default definition for this section.
  1990.  
  1991.  
  1992.           Stealing Taglines
  1993.           -----------------
  1994.           MR/2 has the ability to "steal" a tagline from the current
  1995.           message and add it to the tagline file specified in MR2.INI. 
  1996.           While viewing a message with a tagline you want to swipe, press
  1997.           "T".  MR/2 will attempt to determine which of the lines is most
  1998.           likely a tagline, an extract this line.  The chosen line is
  1999.           displayed for confirmation, and you may make any desired changes
  2000.           to it at this time.  If the line automatically selected is not
  2001.           the tagline you want, you can use the up and down arrow keys to
  2002.           scroll through the current message's lines.  Once the line is
  2003.           displayed, you may modify it as desired, then press ENTER to save
  2004.           it.
  2005.  
  2006.  
  2007.           Entering a New Message
  2008.           ----------------------
  2009.           The 'E' key is available at any time from within the message
  2010.           viewer to enter NEW messages without having to return to the
  2011.           Packet menu (i.e., it is the equivalent of entering the "Write
  2012.           new" function on that menu).  The current conference will be the
  2013.           default for the new message, but To and Subject remain blank.  No
  2014.           quoted text will be present in the reply when editing, it will be
  2015.           a "fresh", empty file (generated from the `NewMessage` section of
  2016.           the template file.)
  2017.  
  2018.  
  2019.  
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.           -----------------------------------------------------------------
  2027.           MR/2 User's Guide - Version 2.0                           Page 31
  2028.  
  2029.  
  2030.  
  2031.           Quick Thread Summary Screen
  2032.           ---------------------------
  2033.           Pressing "Q" while viewing messages will invoke the Quick Thread
  2034.           Summary screen.  This list all threads in the conference, in
  2035.           alphabetical order, along with the count of previously read
  2036.           messages vs. total message in the thread.   All threads that have
  2037.           been read completely are marked with a checkmark.
  2038.  
  2039.           This is a full feature "selection" screen, so you can page
  2040.           around, pick and peck at only the subjects that interest you.
  2041.  
  2042.           NOTE:  When message sort-order is set to FROM or TO user, this
  2043.           selection screen is converted into a Quick "User" Selection
  2044.           screen.  It will summarize all user names with message counts for
  2045.           each.
  2046.  
  2047.  
  2048.           Displaying Embedded ANSI Escape Sequences
  2049.           -----------------------------------------
  2050.           Basic "ANSI" color and animation escape sequences code can be
  2051.           played in the message viewer on demand.  Press "A" while viewing
  2052.           any message with ANSI escape sequences.  If the scrolling of the
  2053.           screen does not seem to work as it should, results can usually be
  2054.           improved by switching into a higher line/screen mode (ALT-V).  28
  2055.           and 34 line modes seem to give the best results for viewing ANSI
  2056.           art.
  2057.  
  2058.  
  2059.           Copying a Message (Carbon or Silicon Copies)
  2060.           --------------------------------------------
  2061.           The Carbon Copy feature is available from the message reading
  2062.           screen and is invoked by pressing the C key.  This "Copy"
  2063.           function simply places a copy of the current message in the reply
  2064.           conference, changes the FROM user to your name and places the
  2065.           EDIT HEADER screen up.  You can copy any message to someone else
  2066.           and make it "from you"; not just your own replies.
  2067.  
  2068.           Copy loops for multiple copies until your ESCAPE from the "next"
  2069.           message header edit.
  2070.  
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081.  
  2082.  
  2083.  
  2084.  
  2085.           -----------------------------------------------------------------
  2086.           MR/2 User's Guide - Version 2.0                           Page 32
  2087.  
  2088.  
  2089.  
  2090.           Forwarding a Message
  2091.           --------------------
  2092.           You can forward the message you are reading to another user
  2093.           and/or conference.  Simply press "W" and the Message Header Edit
  2094.           screen will appear.  Fill out the To field and change anything
  2095.           else as needed.  Accepting this form will create a forwarded copy
  2096.           of this message in the reply conference.
  2097.  
  2098.           The original message will be copied into the replies directory
  2099.           with a short "forwarded by ..." prefix section, usually 3 or 4
  2100.           lines long.  The default MR/2 prefix is three text lines and a
  2101.           dashed divider line.  If a `Forward` template section has been
  2102.           defined in the MR/2 template file, it is used as the template
  2103.           "prefix" for forwarded messages.
  2104.  
  2105.           NOTE:  MR/2's tagline does not appear in these messages UNLESS
  2106.           you modify it later.  Making revisions to a forwarded message
  2107.           will cause MR/2 to place/replace its tagline on the message.
  2108.  
  2109.  
  2110.           Deferring a Message
  2111.           -------------------
  2112.           You can now "Defer" any message to a QWK save area independent of
  2113.           the current packet for later processing.  This will create an
  2114.           "InBasket" conference which will contain all messages for the
  2115.           current BBS that have been deferred and never manually deleted.  
  2116.           This allows you to reply to a message later, when time permits,
  2117.           without having to keep the entire packet around, trying to
  2118.           remember why, and which message it was.   Press "D" or "/" while
  2119.           viewing the message you want to defer.
  2120.  
  2121.  
  2122.           Zipping (Skipping) to Next Unread Message
  2123.           -----------------------------------------
  2124.           The "Z" key, used when viewing a message, now allows you to "Zip"
  2125.           to the next "unread" message in a conference.
  2126.  
  2127.  
  2128.           Copying to the System Clipboard
  2129.           -------------------------------
  2130.           While viewing any message, it is possible to copy or append parts
  2131.           of the message to the system clipboard.  This allows for
  2132.           passages, or the entire message, to be imported into other
  2133.           applications.  Since you can append to the existing clipboard
  2134.           data, it allows you to build a collection of passages from
  2135.           multiple messages.  These might be inserted into a message or
  2136.           reply as a unit.
  2137.  
  2138.           To perform clipboard writes, press "*".  This places the message
  2139.           inside the internal editor in "no save" mode.  You may perform
  2140.           most editing function, but keep in mind that the changes will not
  2141.           be saved.  This function is provided only to access a message's
  2142.           text for export to the clipboard or a text file (ALT-W).
  2143.  
  2144.           -----------------------------------------------------------------
  2145.           MR/2 User's Guide - Version 2.0                           Page 33
  2146.  
  2147.  
  2148.  
  2149.           Jumping to a Logged Reply's Source Message
  2150.           ------------------------------------------
  2151.           While viewing the reply log, and when logging is set to "Full", a
  2152.           special key is available in order to view a reply's "source"
  2153.           messages.  The source or "original" message is the message that
  2154.           provoked the reply.  Press the "J" key to "Jump" to the source
  2155.           message.  If one exists (not all messages have a source, new
  2156.           messages, for example), it will be displayed.  
  2157.  
  2158.  
  2159.           Recording a Message's Address in the Address Book
  2160.           -------------------------------------------------
  2161.           While viewing a message, you may wish to save the originator's
  2162.           electronic address in MR/2's address book.  This is most handy
  2163.           for private, routed mail, but also can be useful for public
  2164.           addresses.  To save the address, simply press ALT-A.  MR/2 will
  2165.           collect all the information it can from the message and display
  2166.           it in the address-book maintenance screen for manual correction. 
  2167.           Make any changes you deem necessary and press F10 to save the
  2168.           address.  There is an entire section dedicated to address book
  2169.           maintenance in the advanced features area, below.
  2170.  
  2171.  
  2172.           Rewrapping a Message for Display
  2173.           --------------------------------
  2174.           While viewing any message, you can press "~" to rewrap it.  This
  2175.           is useful only in USENET (Internet) conferences where sometimes a
  2176.           message gets posted without linefeeds.  MR/2 would display it on
  2177.           a single line, but only give you access to the first 160
  2178.           characters.  This rewrapping is quite temporary (if you "go back"
  2179.           later to view the same message, you'll have to rewrap it again),
  2180.           and totally manual; performed by user keypress only.
  2181.  
  2182.  
  2183.           Unkilling the Current Reply or Message
  2184.           --------------------------------------
  2185.           If you somehow kill a reply or a message (InBasket and ReplyLog
  2186.           messages are the only types of non-reply messages that can be
  2187.           "killed"), you can remove the killed marking by pressing the "U"
  2188.           key.  The screen will update and the status markings (upper right
  2189.           hand corner of the screen) will indicate that the message is no
  2190.           longer "killed".
  2191.  
  2192.  
  2193.  
  2194.  
  2195.  
  2196.  
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202.  
  2203.           -----------------------------------------------------------------
  2204.           MR/2 User's Guide - Version 2.0                           Page 34
  2205.  
  2206.  
  2207.  
  2208.           Marking a Reply Log Message as Permanent
  2209.           ----------------------------------------
  2210.           The "!" key may be used to mark a message contained in the Reply
  2211.           Log conference as permanent.  Making it permanent protects it
  2212.           against the automatic purge process, where logged messages are
  2213.           killed after a certain number of days or when a certain count is
  2214.           reached.  This key is functional only inside the ReplyLog
  2215.           conference, of course.  A permanent message may still be manually
  2216.           killed, which will then cause the message to be removed when the
  2217.           ReplyLog is packed (when the current packet is closed).
  2218.  
  2219.  
  2220.           Simple Encryption/Decryption - Rot13
  2221.           ------------------------------------
  2222.           Some users like to use simple Rot13 encryption to hide text from
  2223.           plain view.  This is hardly a way to keep a secret, as Rot13
  2224.           encryption is simple to decipher.  Its use is intended more for
  2225.           situations like, for example, the writer is revealing the
  2226.           surprise ending to a movie and he doesn't want to ruin the
  2227.           surprise for someone who has not seen it yet.  In this case, he
  2228.           would post a normal text message telling readers to Rot13 the
  2229.           text that follows only if you wish to know how the movie ends.
  2230.  
  2231.           While in the message viewer, ALT-E will rot13 the whole message. 
  2232.           Read the desired part and ALT-E to return the message to normal
  2233.           viewing.  Replying to a message displayed in rot13'd form is OK,
  2234.           the message buffer is only temporarily converted and almost any
  2235.           action switches it back.
  2236.  
  2237.           The internal editor also supports Rot13 encryption.  Simply mark
  2238.           a block of text and press ALT-E.  The block will be encrypted (or
  2239.           unencrypted, if previously Rot13'd).
  2240.  
  2241.  
  2242.           Changing the Default Tab Expansion Size
  2243.           ---------------------------------------
  2244.           Tab expansion in the message viewer.  I default this to 4
  2245.           characters, but allow you to toggle this value via ALT-TAB.
  2246.           Sequence is 4,8,0,2 where "0" means show the tab character and
  2247.           don't expand.
  2248.  
  2249.  
  2250.           Checking the Spelling of an Existing Reply
  2251.           ------------------------------------------
  2252.           You have the ability to spell check an existing reply at any
  2253.           time, even if you use an external editor.  Ctrl-F2 while the
  2254.           reply is visible.  This basically puts you into the MR/2 internal
  2255.           editor and auto-invokes the speller.  You have no opportunity to
  2256.           edit the message header, but you can exit the speller and do
  2257.           normal text editing if you wish.  You must use F10 to save the
  2258.           changes to the reply.
  2259.  
  2260.  
  2261.  
  2262.           -----------------------------------------------------------------
  2263.           MR/2 User's Guide - Version 2.0                           Page 35
  2264.  
  2265.  
  2266.  
  2267.           Using the Thesaurus with an Existing Reply
  2268.           ------------------------------------------
  2269.           You may access the thesaurus (if installed) for use with an
  2270.           existing reply at any time.  This is performed in the same manner
  2271.           as checking the spelling of an existing reply (see above).  You
  2272.           must first request that the reply be accessed for spell checking
  2273.           by pressing CTRL-F2.  Once the spelling checker's menu is
  2274.           displayed, simply press ESCAPE, and you will be inside MR/2's
  2275.           internal editor.  Move to the work you wish to see synonyms for,
  2276.           and press ALT-F1 (or ALT-T).  You may invoke the thesaurus as
  2277.           many times as desired, and other changes may be made, too. 
  2278.           Remember, though, that to save any changes made to the existing
  2279.           reply, you must press F10 (save and exit).  You will be reminded
  2280.           of this if you try to exit without saving any changes; MR/2 will
  2281.           ask you if you are sure you want to proceed, and you will have an
  2282.           option to save.
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.  
  2320.  
  2321.           -----------------------------------------------------------------          ----------------------------------------------------------------- 
  2322.           MR/2 User's Guide - Version 2.0                           Page 36          MR/2 User's Manual - Table of Contents                    Page 36
  2323.  
  2324.  
  2325.  
  2326.           Write New - Creating New Message
  2327.           --------------------------------
  2328.           Replying to existing message is fun, but if you want to start a
  2329.           new "conversation", what do you do?  When you wish to create a
  2330.           new, "unprovoked" message, Select this option, "Write new", from
  2331.           the Packet Main Menu.
  2332.  
  2333.           NOTE:  This same functionality is available even while reading
  2334.           existing messages.  To write a "new" message while in the message
  2335.           viewer, simple press 'E'.
  2336.  
  2337.           The Conference Selection List will be displayed, but it will be
  2338.           different from the display of conferences with mail.  All
  2339.           conferences supported by the source BBS will be listed, and no
  2340.           count of messages is given.  Choose the conference where the new
  2341.           message is to be posted.  You will then be walked through a
  2342.           procedure identical to "replying" to a message.  The Message
  2343.           Header form will default to a target user of ALL, you may change
  2344.           this as desired.  Also, since you are not replying to an existing
  2345.           message, no quoting is performed, and an empty reply file is
  2346.           provided.  Enter your new message and save it.  MR/2 will add it
  2347.           into the reply file for uploading to the BBS.
  2348.  
  2349.           You may review and edit any "new" messages by accessing the
  2350.           replies conference.  To MR/2 and all other QWK readers, new
  2351.           messages are just replies with no reference message.
  2352.  
  2353.  
  2354.           New File Listings
  2355.           -----------------
  2356.           If a "new files" listing was provided in the QWK packet, this
  2357.           option will be displayed using "bright" letters and may be
  2358.           selected.  If chosen, the new files listing will be displayed for
  2359.           your viewing.  You may use the Page Up and Down keys to move
  2360.           about the file, as well as the arrow keys, spacebar, HOME and END
  2361.           keys.  As an added option, you may press "E" to view the file
  2362.           listing using your specified editor.
  2363.  
  2364.           You may also press "S" to save/append the new files listing to
  2365.           another file of your choosing.  The file list may be printed to
  2366.           the primary LPT port by pressing "P".
  2367.  
  2368.           NOTE:  Requesting to "edit" the file with your Editor set to NONE
  2369.           won't really do much.
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.           -----------------------------------------------------------------
  2381.           MR/2 User's Guide - Version 2.0                           Page 37
  2382.  
  2383.  
  2384.  
  2385.           Bulletins
  2386.           ---------
  2387.           If the current packet contains any bulletins, this option will be
  2388.           displayed using "bright" letters and may be selected.  If chosen,
  2389.           a list of all bulletins found will be displayed.
  2390.           If you pick any bulletin from the list it will be displayed for
  2391.           your viewing.  You may use the Page Up and Down keys to move
  2392.           about the file, as well as the arrow keys, spacebar, HOME and END
  2393.           keys.  As an added option, you may press "E" to view the bulletin
  2394.           listing using your specified editor.
  2395.  
  2396.           You may also press "S" to save/append the displayed bulletin to
  2397.           another file of your choosing.  The bulletin may be printed to
  2398.           the primary LPT port by pressing "P".
  2399.  
  2400.           NOTE:  Requesting to "edit" the file with your Editor set to NONE
  2401.           won't really do much.
  2402.  
  2403.           While viewing a bulletin, pressing ESCAPE will take you back to
  2404.           the Bulletin Selection List.  Pressing ESCAPE at this point will
  2405.           return you to the Packet Main Menu.
  2406.  
  2407.  
  2408.           The NEWS File
  2409.           -------------
  2410.           If a "news file" was provided in the QWK packet, this option will
  2411.           be displayed using "bright" letters and may be selected.  If
  2412.           chosen, the news file will be displayed for your viewing.  You
  2413.           may use the Page Up and Down keys to move about the file, as well
  2414.           as the arrow keys, spacebar, HOME and END keys.  As an added
  2415.           option, you may press "E" to view the file listing using your
  2416.           specified editor.
  2417.  
  2418.           You may also press "S" to save/append the news file to another
  2419.           file of your choosing.  The news file may be printed to the
  2420.           primary LPT port by pressing "P".
  2421.  
  2422.           NOTE:  Requesting to "edit" the file with your Editor set to NONE
  2423.           won't really do much.
  2424.  
  2425.  
  2426.           Packing Replies On Demand
  2427.           -------------------------
  2428.           This option may be used to expedite important replies back into a
  2429.           BBS's message base.  While it is a handy option to have
  2430.           available, it must be used with care.
  2431.  
  2432.           Often, a reply is critical or important, and while you may have
  2433.           other messages to read and/or replies to write, you want to get
  2434.           the existing replies back to the BBS and into its message base
  2435.           right away.  This option is specifically for that purpose.
  2436.  
  2437.  
  2438.  
  2439.           -----------------------------------------------------------------
  2440.           MR/2 User's Guide - Version 2.0                           Page 38
  2441.  
  2442.  
  2443.  
  2444.           When you select this option from the menu, you are first shown a
  2445.           detailed dialog explaining exactly what you are about to do and
  2446.           the problems that may result if you don't do it properly.  This
  2447.           screen reads:
  2448.  
  2449.                     NOTE that you are about to pack all current
  2450.                     replies and removed them from this session.
  2451.  
  2452.                     MR/2 assumes that you will now immediately
  2453.                     upload the resulting REP packet to the BBS
  2454.                     The REP packet should be uploaded and deleted
  2455.                     as soon as possible.
  2456.  
  2457.                     If you create more replies w/o first uploading
  2458.                     these, the old replies (REP file) may BE LOST.
  2459.  
  2460.                     If you are logging replies, these replies will
  2461.                     be recorded in the Reply Log now.  Adding to
  2462.                     this REP file later may cause duplicate
  2463.                     entries in the log.
  2464.  
  2465.                     Press ESC to Abort, any other key to continue.
  2466.  
  2467.           If you continue past this screen (you don't press ESCAPE to
  2468.           abort), you are asked again, using a simpler prompt, if you wish
  2469.           to continue.  If you do, then your archiver is invoked, a .REP
  2470.           file is created, the "Replies" conference is removed from the
  2471.           Conference selection list, and all replies are appended to the
  2472.           reply log, if this option is activated.
  2473.  
  2474.  
  2475.           Exiting the Current QWK Packet
  2476.           ------------------------------
  2477.           You can exit MR/2 by pressing ESCAPE at the Packet Selection
  2478.           List, or by using the "Fast Exit" option while viewing a message. 
  2479.           Fast Exit does not perform cleanup nor does it actually pack your
  2480.           replies.  Its purpose is to provide a quick way to exit MR/2
  2481.           where the intention is to return shortly and work with the same
  2482.           packet.  Exiting by escaping from the Packet Selection screen is
  2483.           the more "normal" way of leaving MR/2; all packets are closed and
  2484.           all reply message saved using this method.
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.           -----------------------------------------------------------------
  2499.           MR/2 User's Guide - Version 2.0                           Page 39
  2500.  
  2501.  
  2502.  
  2503.           The Internal Editor
  2504.           ===================
  2505.           MR/2 includes an built-in text editor for use by those who don't
  2506.           have a favorite external editor, or those who wish to benefit
  2507.           from the speed and features it provides.  By default, the MR2.INI
  2508.           file contains the line "Editor=INTERNAL", which tells MR/2 to use
  2509.           its own editor for creating replies and new messages.
  2510.  
  2511.           Press F1 while using the editor to display this help screen:
  2512.  
  2513.           -----------------------------------------------------------------
  2514.                               Internal Editor Help
  2515.  
  2516.            F1 - Help                      ALT-A - Drop Anchor (mark)
  2517.            F2 - Search (^S)               ALT-U - Unmark (mark off)
  2518.            F3 - Search and Replace        ALT-T - Thesaurus* (ALT-F1)
  2519.            F4 - Search again (^F)         ALT-V  - Toggle  display
  2520.            F5 - Mark/Bound (^K)           ALT-R/W - Read/Write file.
  2521.            F6 - Move block (^R @M)
  2522.            F7 - Copy block (^Y @C)        CTRL-F2 - Spelling checker*
  2523.            F8 - Delete block (^U @D)      CTRL-F9 - Reformat paragraph
  2524.            F9 - Center line               CTRL-END (^Z) - erase to EOL
  2525.           F10 - Save and Exit             CTRL-RIGHT/LEFT - move by word
  2526.           F11 - Mark begin (^A)           CTRL-B  - Start of file
  2527.           F12 - Mark end (^K)             CTRL-E  - End of file
  2528.                                           CTRL-X  - Delete current line
  2529.           HOME/END  PAGE UP/DOWN
  2530.           ESCAPE - exit w/o save (confirmed)
  2531.                                                  * optional (if installed)
  2532.           -----------------------------------------------------------------
  2533.  
  2534.           To move around within the editor, simply use the cursor keys,
  2535.           inserting characters simply by typing them.  Many of the
  2536.           functions listed above are self-explanatory and will not be given
  2537.           any more detail.  Descriptions of the more complex functions will
  2538.           follow.
  2539.  
  2540.           NOTE: the editors normal cursor size is configurable via the
  2541.           CursorSize INI parameter.  Users running MR/2 windowed session in
  2542.           line modes greater than 25 may find it necessary to increase the
  2543.           size to in order to see the cursor.
  2544.  
  2545.           Search
  2546.           ------
  2547.           Pressing F2 or CTRL-S will bring up the search-for-text entry
  2548.           prompt at the top status bar.  Fill in the text you wish to
  2549.           search for and press ENTER.  If the specified string is found,
  2550.           the editor will move the viewing position so the text is visible,
  2551.           and the cursor will be placed on the match.  The search will
  2552.           begin from the current cursor position forward.  To search the
  2553.           entire file you must move to the beginning before searching
  2554.           (press HOME three times).  To search for the NEXT occurrence of a
  2555.           previously matched text string, simply press F4, "Search again".
  2556.  
  2557.           -----------------------------------------------------------------
  2558.           MR/2 User's Guide - Version 2.0                           Page 40
  2559.  
  2560.  
  2561.  
  2562.           Search and Replace
  2563.           ------------------
  2564.           Pressing F3 will bring up the search-and-replace text entry
  2565.           prompt at the top status bar.  Fill in the text you wish to
  2566.           search for and press ENTER.  Then fill in the text you wish to
  2567.           replace the search-for text with.  If the specified string is
  2568.           found, the editor will move the viewing position so the text is
  2569.           visible, and the cursor will be placed on the match.  You will be
  2570.           prompted to press Y or N (Yes or No) to confirm replacing the
  2571.           matched text with the replacement string.  Choose the appropriate
  2572.           response.
  2573.  
  2574.           The search will begin from the current cursor position forward. 
  2575.           To search and replace the entire file you must move to the
  2576.           beginning before searching (press HOME three times).  To search
  2577.           for the NEXT occurrence of a previously matched text string,
  2578.           simply press F4, "Search again".  If more text is found, you will
  2579.           again be asked if it should be replaced.
  2580.  
  2581.  
  2582.           Search Again
  2583.           ------------
  2584.           Search again is attached to the F4 function key.  Its purpose is
  2585.           to continue with the previous search or search-and-replace,
  2586.           whichever was performed last.  If the previous action was to
  2587.           search for a text string, pressing F4 will continue searching for
  2588.           more occurrences of the same string, starting just past the
  2589.           current cursor position.  If the previous action was to search
  2590.           for a text string and replace it with another, pressing F4 will
  2591.           continue searching for more occurrences of the same string,
  2592.           starting just past the current cursor position.  If another
  2593.           occurrence is found, you will be asked if you wish to replace it,
  2594.           or leave it as-is.
  2595.  
  2596.  
  2597.           Marking and Bounding a Block of Text
  2598.           ------------------------------------
  2599.           Many functions require that you identify a section of text to act
  2600.           upon.  For example, to move or copy a paragraph or sentence, you
  2601.           must first define the exact area of text to move or copy.
  2602.  
  2603.           You do this by "marking" the desired section.  The first step is
  2604.           to move the cursor to the desired text-block starting position. 
  2605.           This spot is then identified as the start of the block by
  2606.           pressing ALT-A (drop anchor mark), CTRL-K (Mark/Bound toggle) or
  2607.           F11 (Mark begin).  The cursor is then moved to the end of the
  2608.           desired text section.  This section is then identified as the end
  2609.           of the block, or "bounded", by pressing ALT-A, CTRL-K or F12
  2610.           (Bound).  The text area that is now marked will be identified by
  2611.           being highlighted (reverse video).  You may now use any of the
  2612.           defined block commands on this section of text.
  2613.  
  2614.  
  2615.  
  2616.           -----------------------------------------------------------------
  2617.           MR/2 User's Guide - Version 2.0                           Page 41
  2618.  
  2619.  
  2620.  
  2621.           Unmark
  2622.           ------
  2623.           To remove the highlight, or "unmark" a block of text, simply
  2624.           press ALT-U. 
  2625.  
  2626.  
  2627.           Save and Exit
  2628.           -------------
  2629.           The F10 key may be used to request an exit from the current
  2630.           editing session, saving the work to disk first.  If no changes
  2631.           have been made to the current file, the file is not rewritten.
  2632.  
  2633.  
  2634.           Exiting without Saving
  2635.           ----------------------
  2636.           To exit the editor without saving any changes, simply press
  2637.           ESCAPE.  If not modifications have been made to the displayed
  2638.           text, you will be allowed to exit without answering any
  2639.           confirmation prompts.  If, however, changes have been made to the
  2640.           text, you will be asked if you wish to save your work first.  If
  2641.           you respond YES, the changes will be recorded to disk.  If you
  2642.           respond NO or press ESCAPE, the editor will recognize this as a
  2643.           serious request to exit without saving any changes.  Just to be
  2644.           sure, you will once again be asked if this is really what you
  2645.           want to do.  Responding YES will finally exit you from the
  2646.           editor, discarding any changes you have made.  Responding NO will
  2647.           save the changes to disk and exit.
  2648.  
  2649.  
  2650.           HOME and END
  2651.           ------------
  2652.           The HOME and END keys are treated a little differently than the
  2653.           other keys.  MR/2 is sensitive to the number of consecutive times
  2654.           these two keys are pressed.
  2655.  
  2656.           The first time HOME is pressed, the cursor is moved to the first
  2657.           character on the current line.  If it is immediately pressed
  2658.           again, the cursor is moved to the first character of the first
  2659.           line currently displayed (i.e., the upper left corner of the
  2660.           editor screen).  If it is pressed a third time, the cursor is
  2661.           placed on the very first character contained in the current file. 
  2662.           MR/2 will adjust the display position to the very beginning of
  2663.           the file.
  2664.  
  2665.           The first time END is pressed, the cursor is moved to the last
  2666.           character on the current line.  If it is immediately pressed
  2667.           again, the cursor is moved to the last character of the last line
  2668.           currently displayed (i.e., towards the lower right corner of the
  2669.           editor screen).  If it is pressed a third time, the cursor is
  2670.           placed on the very last character contained in the current file. 
  2671.           MR/2 will adjust the display position to the very end of the
  2672.           file.
  2673.  
  2674.  
  2675.           -----------------------------------------------------------------
  2676.           MR/2 User's Guide - Version 2.0                           Page 42
  2677.  
  2678.  
  2679.  
  2680.           Toggling the Display of Marker Characters
  2681.           -----------------------------------------
  2682.           ALT-V toggles the editor display's "visual mode" on and off. 
  2683.           When visual mode is on, all special characters such as paragraph
  2684.           symbols, centering codes and end-of-file markers become visible. 
  2685.           When toggled off (the default), these symbols are hidden from
  2686.           view and only readable text is displayed.
  2687.  
  2688.  
  2689.           Importing and Exporting Text
  2690.           ----------------------------
  2691.           The editor has a simple system for importing existing text files
  2692.           into the current file, and for exporting marked blocks of text to
  2693.           external files.
  2694.  
  2695.           To import and existing text file at the current cursor position,
  2696.           press ALT-R to "read" in the file.  You will be prompted for a
  2697.           file name.  Fill in the correct name and press ENTER.  The entire
  2698.           contents of the file will be inserted at the cursor's current
  2699.           location.
  2700.  
  2701.           To export a block of text to a file, first, use the Mark (F11)
  2702.           and Bound (F12) keys to identify the section of text you wish to
  2703.           export.  Press ALT-W to "write" the block to a file.  You will be
  2704.           prompted for a file name.  Fill in the desired file name and
  2705.           press ENTER.  The entire block of marked text will be written to
  2706.           the specified file.  If no section is marked, the entire text of
  2707.           the current editor session is written to the file.
  2708.  
  2709.  
  2710.           Optional Utilities - Spelling Checker and Thesaurus
  2711.           ---------------------------------------------------
  2712.           There are some advanced features of the internal editor that are
  2713.           entirely optional.  These options require the existence of one or
  2714.           more files in the MR/2 software directory to be enabled.  Since
  2715.           many users will not choose to use the internal editor, and even
  2716.           those that do may not need these features, the required files are
  2717.           distributed separately from the MR/2 main files.  Additionally,
  2718.           these files tend to be quite large and rarely change, so they
  2719.           need to be downloaded, if desired, only once.  These options
  2720.           include an spelling checker and thesaurus.  See the section about
  2721.           installation (in the front of the manual) for specific
  2722.           information about acquiring these files and their sizes.
  2723.  
  2724.  
  2725.  
  2726.  
  2727.  
  2728.  
  2729.  
  2730.  
  2731.  
  2732.  
  2733.  
  2734.           -----------------------------------------------------------------
  2735.           MR/2 User's Guide - Version 2.0                           Page 43
  2736.  
  2737.  
  2738.  
  2739.           The Internal Spelling Checker
  2740.           =============================
  2741.           Access to the internal spelling checker is provided from within
  2742.           the internal editor.  Even if you're using an external editor for
  2743.           messages, you can load a message into the spelling checker.
  2744.  
  2745.           To access the spelling checker, you must have first "installed"
  2746.           the word database.  Since the spelling checker is totally option
  2747.           (not everyone will find it useful, or wish to bother with
  2748.           downloading it), and the associates file can be quite large, it
  2749.           is distributed as a separate ".zip" file.  Currently there are
  2750.           two different "dictionaries" available; offering small (60,000)
  2751.           or large (120,000) word database.  Others may be made available
  2752.           as needed.  The internal spelling checker is installed and
  2753.           available if the file "MR2DICT.BIN" is found in the MR/2 software
  2754.           directory.  See the section entitled "Install MR/2" for more
  2755.           information.
  2756.  
  2757.           From within the internal editor, CTRL-F2 will invoke the spelling
  2758.           checker main menu.  If MR/2 cannot find a file by the name of
  2759.           "MR2DICT.BIN" in the default MR/2 software directory, the
  2760.           dictionary will not be available.  If you press CTRL-F2 under
  2761.           this condition, MR/2 will simply inform you of this with the
  2762.           message "Dictionary file(s) not found".
  2763.  
  2764.           The spelling checker main menu contains these options controlling
  2765.           how much of the current message to check:
  2766.  
  2767.                     File (from beginning)
  2768.                     Rest of file
  2769.                     Block
  2770.                     Word
  2771.  
  2772.           You may also press ESCAPE to abort the spelling checker process
  2773.           and return to the editor.
  2774.  
  2775.           If you select "File (from beginning)", all words from the
  2776.           beginning of the document will be checked.  Without operator
  2777.           intervention, and if a misspelled word is not encountered, all
  2778.           words through the end of the message will be checked.
  2779.  
  2780.           Selecting "Rest of file" will start checking words from the
  2781.           current cursor position through the end of the document.
  2782.  
  2783.           The "Block" option allows you to mark and bound a specific
  2784.           section of the message to check.  All words form the beginning of
  2785.           the marked section through the end of it will be checked for
  2786.           correct spelling.
  2787.  
  2788.           If you chose the option labeled "Word", only the spelling of the
  2789.           word at the current cursor position is checked.
  2790.  
  2791.  
  2792.  
  2793.           -----------------------------------------------------------------
  2794.           MR/2 User's Guide - Version 2.0                           Page 44
  2795.  
  2796.  
  2797.  
  2798.           NOTE that this is a normal MR/2 menu, so pressing "W", for
  2799.           example, will invoke the "Word" option.
  2800.  
  2801.           The spelling checker process has been programmed to check
  2802.           messages intelligently.  This basically means that "quoted" text
  2803.           lines are not checked for spelling errors.  Only lines of text
  2804.           deemed to be created by you, and seen as part of the reply or new
  2805.           message text will be checked.  You can, if you desire, test
  2806.           individual words inside a quoted section.  There are a other few
  2807.           ways in which quoted text can be tested, but MR/2 usually assumes
  2808.           that anything "quoted" should be left untested.
  2809.  
  2810.           As each word within the message is tested, the status line at the
  2811.           bottom of the screen is updated with the word.  This is a simple
  2812.           progressing indicator.  After all words have been tested, the
  2813.           status line is updated with a "completed" indicator, giving the
  2814.           number of words checked and a count of misspelled words.
  2815.  
  2816.           You may terminate the spell checking process at any time simply
  2817.           by pressing ESCAPE.  MR/2 will display a prompt, asking you if
  2818.           you really want to stop the testing.  This gives you a chance to
  2819.           continue with the spelling checks, or stop and return to the
  2820.           editor.
  2821.  
  2822.           When a word is not found in the word database, your "user
  2823.           dictionary" is checked for the word.  If found, the spelling
  2824.           checker deems the word to be correctly spelled.  If not found in
  2825.           either word lists, a new menu will be displayed offering some
  2826.           options.  For example, a typical option menu would look like:
  2827.  
  2828.                     ╔═══════════════════════════╗
  2829.                     ║   Not found: Soundexing   ║
  2830.                     ║═══════════════════════════║
  2831.                     ║ 1 - sonnetting            ║
  2832.                     ║ 2 - soundproofing         ║
  2833.                     ║ 3 - sounding              ║
  2834.                     ║ 4 - solemnizing           ║
  2835.                     ║ 5 - solidifying           ║
  2836.                     ║ 6 - soliloquizing         ║
  2837.                     ║ 7 - solubilizing          ║
  2838.                     ║ 8 - somnambulating        ║
  2839.                     ║ 9 - sophisticating        ║
  2840.                     ║ 0 - sortieing             ║
  2841.                     ║ ───────────────────────── ║
  2842.                     ║ S - Skip                  ║
  2843.                     ║ I - Ignore on this pass   ║
  2844.                     ║ E - Edit                  ║
  2845.                     ║ A - Add                   ║
  2846.                     ║ Q - Quit                  ║
  2847.                     ╚═══════════════════════════╝
  2848.  
  2849.  
  2850.  
  2851.  
  2852.           -----------------------------------------------------------------
  2853.           MR/2 User's Guide - Version 2.0                           Page 45
  2854.  
  2855.  
  2856.  
  2857.           NOTE that you may also use the internal spelling checker
  2858.           "automatically" even when an external editor is used for
  2859.           messages.  The INI parameter "PostProcess" is available for
  2860.           performing external functions with a reply after leaving the
  2861.           external editor.  This allows for external spelling checkers or
  2862.           any other utility of this type.  If PostProcess is set to
  2863.           "Internal", MR/2 will invoke the spelling checker against the
  2864.           modified reply automatically.
  2865.  
  2866.           By the same token you may use the PostProcess parameter to
  2867.           specify an external spelling checker (or any other utility you
  2868.           wish) that will automatically be invoked after a message has been
  2869.           edited.  This allows for your favorite speller to be used even if
  2870.           you decide to use MR/2's internal editor.
  2871.  
  2872.  
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878.  
  2879.  
  2880.  
  2881.  
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.  
  2909.  
  2910.  
  2911.           -----------------------------------------------------------------
  2912.           MR/2 User's Guide - Version 2.0                           Page 46
  2913.  
  2914.  
  2915.  
  2916.           The Internal Thesaurus
  2917.           ======================
  2918.           The internal thesaurus is installed and available if the file
  2919.           "MR2THSRS.BIN" is found in the MR/2 software directory.  The
  2920.           thesaurus is available as a pop-up selection list of words while
  2921.           inside the internal editor.
  2922.  
  2923.           To activate the thesaurus, simply position the cursor over the
  2924.           word to "look up" and press ALT-T or ALT-F1.  The thesaurus has
  2925.           two internal search modes; key and sequential.  A key search is
  2926.           the quickest, but also the most likely to return without a match. 
  2927.           The sequential mode is the most thorough, searching the entire
  2928.           word base for any trace of the source word.  This also makes it
  2929.           the slowest method.
  2930.  
  2931.           MR/2 combines these two methods to give you the best of both
  2932.           worlds.  The first attempt to find the word is by key.  If the
  2933.           word is a key in the word database, then a list of synonyms will
  2934.           be displayed very quickly.  If not found as a key, MR/2 will
  2935.           start a sequential search for the word (as a synonym to any other
  2936.           word).  While this is being performed, a status message is
  2937.           displayed for your information.  You may press ESCAPE at any time
  2938.           to cancel the word-search and return to the editor.
  2939.  
  2940.           If the source word is not found anywhere in the word database,
  2941.           you will be informed of this and returned to the editor.  In this
  2942.           case, MR/2 will not be able to provide any suggested replacements
  2943.           for the source word.  If you can think of another word that may
  2944.           give better search results, simply type it into the editor, as a
  2945.           separate word, and activate the thesaurus again.  You can remove
  2946.           the word later, if desired.
  2947.  
  2948.           If the source word is located in the word database, a list of
  2949.           synonyms will be displayed, along with various options.  At the
  2950.           top of the screen will be a boxed help-list of possible keyboard
  2951.           actions.  The boxed list will resemble this:
  2952.  
  2953.           -----------------------------------------------------------------
  2954.           ALT-S Search for more  ALT-L Lookup this word  ENTER Replace word
  2955.           ALT-E New search word  ALT-X Exit thesaurus    ALT-A Append word
  2956.           ESC   Back one level                           ALT-I Insert word
  2957.           -----------------------------------------------------------------
  2958.  
  2959.  
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.  
  2967.  
  2968.  
  2969.  
  2970.           -----------------------------------------------------------------
  2971.           MR/2 User's Guide - Version 2.0                           Page 47
  2972.  
  2973.  
  2974.  
  2975.           The list of possible replacement words will be displayed in a
  2976.           selection list.  For example, the word "Large" might result in
  2977.           the following display:
  2978.  
  2979.                     ╔═════════════════╗
  2980.                     ║      LARGE      ║
  2981.                     ║─────────────────║
  2982.                     ║  LARGE          ║ 
  2983.                     ║  FAR-REACHING   ▓
  2984.                     ║  BIG            ░
  2985.                     ║  WIDESPREAD     ░
  2986.                     ║  GLOBAL         ░
  2987.                     ║  COLOSSAL       ░
  2988.                     ║  COMPREHENSIVE  ░
  2989.                     ║  HUGE           ░
  2990.                     ║  EXTENSIVE      ░
  2991.                     ║  MAJOR          ░
  2992.                     ╚═════════════════╝
  2993.  
  2994.           To replace the word "large" in this example with the word
  2995.           "colossal", simply move the cursor down to highlight "colossal"
  2996.           and press ENTER.  If the words listed are not quite what you
  2997.           want, you may chose from the following options:
  2998.  
  2999.  
  3000.           ALT-S Search for more
  3001.           ---------------------
  3002.           This will cause a search for additional occurrences of the source
  3003.           word to be performed.  If you are starting from a synonym list
  3004.           that resulted from a "key" match, the sequential search for more
  3005.           matches will start from the beginning of the word database.  If a
  3006.           sequential search was already performed to acquire the displayed
  3007.           list, or if you have pressed ALT-S before, then the search for
  3008.           more matches will proceed from the current word base position. 
  3009.           MR/2 will inform you if no more matches can be found.
  3010.  
  3011.  
  3012.           ALT-L Lookup this word
  3013.           ----------------------
  3014.           This will cause an entirely new line of searching to be
  3015.           performed, using the currently highlighted word as the new
  3016.           "source" word.  You will not lose your position for the current
  3017.           source word; this simply branches into a new search.  This allows
  3018.           you to explore lists for words that don't seem quite right, but
  3019.           that may them possess a synonym that fits.
  3020.  
  3021.  
  3022.  
  3023.  
  3024.  
  3025.  
  3026.  
  3027.  
  3028.  
  3029.           -----------------------------------------------------------------
  3030.           MR/2 User's Guide - Version 2.0                           Page 48
  3031.  
  3032.  
  3033.  
  3034.           ALT-E New search word
  3035.           ---------------------
  3036.           While searching for a synonym, you might think of a word yourself
  3037.           that is a synonym.  This word may be the replacement you want, or
  3038.           it may give MR/2 a better clue as to which word lists to display. 
  3039.           If the current list doesn't provide what you want, and you wish
  3040.           to explore your new word, you can press ALT-E and enter the new
  3041.           search word manually.
  3042.  
  3043.  
  3044.           ALT-A Append word
  3045.           -----------------
  3046.           This will cause the highlighted word to be inserted into the
  3047.           editing text after the source word.  The source word will be left
  3048.           in place; the new word is added to the text after it.
  3049.  
  3050.  
  3051.           ALT-I Insert word
  3052.           -----------------
  3053.           This will cause the highlighted word to be inserted into the
  3054.           editing text before the source word.  The source word will be
  3055.           left in place; the new word is added to the text before it.
  3056.  
  3057.  
  3058.           ESCAPE  Back one level
  3059.           ----------------------
  3060.           Pressing ESCAPE will exit the current "top" word list and move
  3061.           back one level to the previous list.  If only one list is
  3062.           displayed at the time, the thesaurus will be exited and you will
  3063.           be returned to the editor.
  3064.  
  3065.  
  3066.           ALT-X Exit thesaurus
  3067.           --------------------
  3068.           This will cause an immediate exit of the thesaurus and all its
  3069.           popup menus and word lists.  All levels are exited, and no word
  3070.           replacement is performed.
  3071.  
  3072.  
  3073.  
  3074.  
  3075.  
  3076.  
  3077.  
  3078.  
  3079.  
  3080.  
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.  
  3088.           -----------------------------------------------------------------
  3089.           MR/2 User's Guide - Version 2.0                           Page 49
  3090.  
  3091.  
  3092.  
  3093.           Advanced features
  3094.           =================
  3095.           This section will address issues that a first-time or new user
  3096.           may not want to concern themselves with.  It describes features
  3097.           that are not necessary for basic packet reading and replying, but
  3098.           offer great power and flexibility to the more-experienced user.
  3099.  
  3100.  
  3101.           Internal Spelling Checker and Thesaurus
  3102.           ---------------------------------------
  3103.           These features are described in there own sections, above.
  3104.  
  3105.  
  3106.           External Spelling Checker
  3107.           -------------------------
  3108.           MR/2 recognizes the INI keyword "PostProcess" as a way to
  3109.           identify an external procedure to perform after any message has
  3110.           been edited and saved.  This allows utilities such as spelling
  3111.           checkers or formatting tools to be run against a reply or message
  3112.           file before it is returned to MR/2.
  3113.  
  3114.           For example, the line:
  3115.  
  3116.                PostEdit = c:\utility\ss
  3117.  
  3118.           instructs MR/2 to invoke the command line "c:\utility\ss reply"
  3119.           where reply represents the reply file name just edited.  In this
  3120.           example, the DOS-based shareware spelling checker "ShareSpell" is
  3121.           invoked.  You may use this technique with an external or the
  3122.           internal editor.
  3123.  
  3124.           NOTE:  There is also a "PreEdit" INI keyword for processing of
  3125.           the reply file before the editor gets control of it.
  3126.  
  3127.  
  3128.  
  3129.  
  3130.  
  3131.  
  3132.  
  3133.  
  3134.  
  3135.  
  3136.  
  3137.  
  3138.  
  3139.  
  3140.  
  3141.  
  3142.  
  3143.  
  3144.  
  3145.  
  3146.  
  3147.           -----------------------------------------------------------------
  3148.           MR/2 User's Guide - Version 2.0                           Page 50
  3149.  
  3150.  
  3151.  
  3152.           Local INI files
  3153.           ---------------
  3154.           You may now create a supplemental "INI" file for any/all BBS's
  3155.           that you get mail from.  MR/2 still loads its options from
  3156.           MR2.INI, but you may now change some of these options
  3157.           automatically by BBS, when a packet is opened.  Once the packet
  3158.           is unpacked and the BBS "ID" is extracted, MR/2 checks its "base"
  3159.           directory (where MR2.INI resides) for a file named after the BBS,
  3160.           with a ".INI" suffix.  For example, after unpacking a QWK packet
  3161.           from PC-OHIO, MR/2 will load options from a file named
  3162.           "PC-OHIO.INI", if one exists.  Obviously, some options will have
  3163.           no effect (e.g., PacketPath has already been used and is no
  3164.           longer pertinent, as is WorkPath), but things like tagline files
  3165.           and quoting styles can be changed on a BBS-specific basis.
  3166.  
  3167.           If a "BBS" .INI file is accessed, MR/2 will reload the global
  3168.           MR2.INI file when the current packet is closed.
  3169.  
  3170.           NOTE that when the local, BBS-specific INI is accessed, MR/2 has
  3171.           already changed the directory down one level, to the working
  3172.           subdirectory.  That means that files located in the MR/2 software
  3173.           directory must be named with either a full path specification or
  3174.           prefixed with "..\".  For example, if "OS2.Tag" and "Misc.Tag"
  3175.           are both in the MR2 directory,  MR2.INI may have a tagline
  3176.           specification:
  3177.  
  3178.                TagLine = OS2.Tag
  3179.  
  3180.           However, if a local INI for the CRS BBS is to access "Misc.Tag"
  3181.           instead, the INI line should read:
  3182.  
  3183.                TagLine = ..\Misc.Tag
  3184.  
  3185.           Local INI files are also handy for declaring virtual conferences
  3186.           that tend to be specific to a certain BBS.  Any virtual
  3187.           conference that is to be built using specific conference numbers
  3188.           will probably be placed in a BBS INI file.
  3189.  
  3190.  
  3191.  
  3192.  
  3193.  
  3194.  
  3195.  
  3196.  
  3197.  
  3198.  
  3199.  
  3200.  
  3201.  
  3202.  
  3203.  
  3204.  
  3205.  
  3206.           -----------------------------------------------------------------
  3207.           MR/2 User's Guide - Version 2.0                           Page 51
  3208.  
  3209.  
  3210.  
  3211.           Virtual Conferences
  3212.           -------------------
  3213.           The ability to create virtual conferences is one of MR/2's most
  3214.           prized features.  Basically, virtual conferences are a
  3215.           "virtually" <g> unlimited list of automatic searches to perform. 
  3216.           You see the final, cumulative results of these searches as
  3217.           conferences.
  3218.  
  3219.           MR/2 will build conferences containing messages that match search
  3220.           criteria defined by you.  All messages found to match will be
  3221.           included in the defined conference.  The "MakeConference"
  3222.           parameter is added in the MR2.INI file, or can be added into the
  3223.           BBS specific INI file.  See the included file "Search.Ini" for
  3224.           examples.  You can have criteria listed in the MR2.INI *and* the
  3225.           BBS ini, and they will be combined correctly.
  3226.  
  3227.           For example, the following set of lines:
  3228.  
  3229.                   MakeConference = MR/2
  3230.                   String = MR/2
  3231.  
  3232.           will result in MR/2 searching (in the background, multithreaded)
  3233.           all message for the string "MR/2" and creating a custom "MR/2"
  3234.           conference that will appear in the Conferences w/Mail menu.  Once
  3235.           the defined custom conferences have been built, these new
  3236.           conferences will be added to the displayed selection list.
  3237.  
  3238.           The maximum number of search result conferences is "unlimited" -
  3239.           at least in a practical sense.  Memory is the issue, and valid
  3240.           file names.  Theoretical, it is possible to define up to 26,000
  3241.           virtual conferences, although this might be a little excessive.
  3242.  
  3243.           A single pass is made through the message base - for each
  3244.           message, all combinations of search criteria are evaluated and
  3245.           the message is recorded in any/all of the conferences it's found
  3246.           to belong to.  MR/2 will "beep" (low sounding tone) when it's
  3247.           done searching.
  3248.  
  3249.           As another example:
  3250.  
  3251.                   MakeConference = DR DEBUG/C/C++ & OS/2
  3252.                   Conferences=93,99,111
  3253.                   Check = Body, Subject
  3254.                   String = OS/2
  3255.  
  3256.           defines a conference that will display with a rather verbose
  3257.           name, and will contain all message from conferences 93, 99 and
  3258.           111 in which "OS/2" was found in the body or subject of the
  3259.           message.  A conference number of "*", or a missing conference
  3260.           line will cause ALL conferences to be searched.
  3261.  
  3262.  
  3263.  
  3264.  
  3265.           -----------------------------------------------------------------
  3266.           MR/2 User's Guide - Version 2.0                           Page 52
  3267.  
  3268.  
  3269.  
  3270.           This feature is particularly handy when watching for seldom-
  3271.           occurring words or phrases.  The topics "CTOS" and "bar coding"
  3272.           might appear in only a few messages a month.  Since they rarely
  3273.           appear, it would be impractical to search for them for every
  3274.           packet opened.  With a pre-defined search, these words are always
  3275.           checked for, and an occurrence will never(*) be missed.  Simply
  3276.           add the lines:
  3277.  
  3278.                   MakeConference = Miscellaneous
  3279.                   Conferences=*
  3280.                   String = Barcode\Bar Code\CTOS
  3281.  
  3282.           The building of virtual conferences all happens in a separate
  3283.           "thread"; as a background task.  Every time you open a packet, a
  3284.           background process is launched that searches the entire message
  3285.           base while you do "other things".
  3286.  
  3287.           Virtual conferences are also great for building a pseudo-personal
  3288.           conference for Usenet messages converted to QWK, since these are
  3289.           usually addressed to "ALL".  Simply define a search on your name,
  3290.           listing all the Usenet conferences read.
  3291.  
  3292.           As an extended example, consider the hundreds of "Forsale"
  3293.           messages posted every day, spread across a dozen or so real
  3294.           conferences.  To look for a particular item by opening every
  3295.           conference individually and manually searching for a keyword
  3296.           would be tedious.  Looking for multiple items would be laborious. 
  3297.           This is the perfect place for a virtual conference or two.  Any
  3298.           mention of an interesting item would be recorded in a conference
  3299.           and there would rarely be any reason to open the "real" Forsale
  3300.           conferences individually.  In fact, it is possible to "hide" the
  3301.           real conferences from view, keeping them out of the selection
  3302.           list.
  3303.  
  3304.           Other INI parameters have been added to compliment the new
  3305.           MakeConference option. The parameter "ShowEmpties" controls
  3306.           whether empty custom conferences are to be displayed with message
  3307.           counts of "(0)".  If NO is specified, empty conferences do not
  3308.           appear at all in the conference list.  "DisplayStatus" will show
  3309.           the message search/hit counter on the bottom of the screen if set
  3310.           to YES. "SeparaterBar" will place a line between the normal and
  3311.           custom conferences if set to YES.
  3312.  
  3313.  
  3314.  
  3315.  
  3316.  
  3317.  
  3318.  
  3319.  
  3320.  
  3321.  
  3322.  
  3323.  
  3324.           -----------------------------------------------------------------
  3325.           MR/2 User's Guide - Version 2.0                           Page 53
  3326.  
  3327.  
  3328.  
  3329.           Template Files and Sections
  3330.           ---------------------------
  3331.           The template file contains text that is used as "boilerplate", or
  3332.           simply standard text patterns to use for replying, new messages
  3333.           and several other miscellaneous functions.  The template file is
  3334.           broken into "sections".  A section starts with the name of the
  3335.           section to follow, enclosed within accent characters, "`".  For
  3336.           example, the start of the Internet section will be denoted by a
  3337.           line containing the marker `Internet`.  The section ends when the
  3338.           next section name is encountered, or when the end of file is
  3339.           found.  The very first section has no name or section marker and
  3340.           is called the "default" section.  When a normal, public reply is
  3341.           being created, or when a particular template section does not
  3342.           exist, the default section is used.
  3343.  
  3344.           When MR/2 is to create a message file for you to edit, it will
  3345.           create this file from an appropriate template section.  If you
  3346.           are replying publicly to a message, the default section is used. 
  3347.           If you are replying privately into the conference specified as
  3348.           the Internet conference, then MR/2 will use the `Internet`
  3349.           section.  If the message is a private Internet message and is not
  3350.           a reply but a "new" message, then the `NewInternet` section is
  3351.           used.
  3352.  
  3353.           The template section is copied to the message file before you get
  3354.           to edit it.  At this time, any variable names (words wrapped
  3355.           between "@" symbols) are replaced with the corresponding text
  3356.           value for that variable.  The special marker "$Body" is used to
  3357.           denote where any quoted text should be placed, or where the new
  3358.           text (for a "new" message) will start.  This allows for an 
  3359.           "attribution line" at the beginning of the message to contain
  3360.           such things as the message date and/or time, the user names
  3361.           involved, the conference name or number, etc.,.  In fact, an
  3362.           attribution line can actually be several lines; as many lines as
  3363.           you would like to use.  The same principle applies to a signature
  3364.           or closure line.  The signature section may consist of several
  3365.           lines, a list of your common email address, for example.
  3366.  
  3367.           An example template file is provided with MR/2 as the file
  3368.           "Example.tf".  The default INI created by MR/2 specifies a
  3369.           template file name of "template.tf"   You may wish to modify the
  3370.           example file to fit your tastes, then copy or rename it to
  3371.           "Template.tf".
  3372.  
  3373.           Template lines starting with two semi-colons, ";;", are seen as
  3374.           comment lines and are ignored.
  3375.  
  3376.  
  3377.  
  3378.  
  3379.  
  3380.  
  3381.  
  3382.  
  3383.           -----------------------------------------------------------------
  3384.           MR/2 User's Guide - Version 2.0                           Page 54
  3385.  
  3386.  
  3387.  
  3388.           The following template sections are available for use:
  3389.  
  3390.           Default Reply  This is the "default" template section.  MR/2 will
  3391.                          use this section when no other specialized section
  3392.                          seems appropriate.  All public, non-routed replies
  3393.                          will be created from this section.
  3394.  
  3395.           NewMessage     This is the section that will be used to generate
  3396.                          the initial reply format for all new, unprovoked
  3397.                          messages that are not private and/or routed with a
  3398.                          private address.
  3399.  
  3400.           Internet       This is the section that will be used to generate
  3401.                          replies that are placed in the INI-defined
  3402.                          Internet private-mail conference.  Any reply to a
  3403.                          private Internet mail message will inherit this
  3404.                          format, as will any reply to a public messages
  3405.                          that is transferred to the Internet private mail
  3406.                          conference.
  3407.  
  3408.           NewInternet    This is the section that will be used to generate
  3409.                          new messages that are placed in the INI-defined
  3410.                          Internet private-mail conference.
  3411.  
  3412.           Netmail        This is the section that will be used to generate
  3413.                          replies that are placed in the INI-defined Netmail
  3414.                          private-mail conference.  Any reply to a private
  3415.                          Netmail mail message will inherit this format as
  3416.                          well.
  3417.  
  3418.           NewNetmail     This is the section that will be used to generate
  3419.                          new messages that are placed in the INI-defined
  3420.                          Netmail private-mail conference.
  3421.  
  3422.           Rime           This is the section that will be used to generate
  3423.                          private replies in any conference recognized to be
  3424.                          RIME hosted.  MR/2 will parse the Postlink origin
  3425.                          line and can make Rime site numbers and ID's
  3426.                          available via @ variables.  If you reply to a
  3427.                          public message in a Rime conference and make the
  3428.                          reply private, this section will be used.  If you
  3429.                          reply to a Private, routed Rime message and keep
  3430.                          it private, this section will be also used.
  3431.  
  3432.           NewRime        This is the section that will be used to generate
  3433.                          private "new" messages to address-book entries
  3434.                          with their section marked as "RIME".  MR/2 will
  3435.                          place the message in the designated conference and
  3436.                          will use the data in the "first line" field to
  3437.                          replace both the Rime site number and ID @
  3438.                          variables.
  3439.  
  3440.  
  3441.  
  3442.           -----------------------------------------------------------------
  3443.           MR/2 User's Guide - Version 2.0                           Page 55
  3444.  
  3445.  
  3446.  
  3447.           Forward        This is the header text for forwarded messages. 
  3448.                          The default MR/2 header consists of 3 simple lines
  3449.                          of attribution, followed by a dividing line.  You
  3450.                          may modify this section to create your own
  3451.                          "Forwarded from/to ..." header.
  3452.  
  3453.           SaveHeader     This is the boilerplate text that is used when a
  3454.                          messages is saved to a text file.  It proceeds the
  3455.                          body of the messages, and by default contains an
  3456.                          almost exact copy of the message header as it
  3457.                          appears in the online message viewer.
  3458.  
  3459.           PrintHeader    This is the boilerplate text that is used when a
  3460.                          messages is sent to a printer.  It proceeds the
  3461.                          body of the messages, and by default contains an
  3462.                          almost exact copy of the message header as it
  3463.                          appears in the online message viewer.
  3464.  
  3465.  
  3466.           NOTE: These are the only section names automatically recognized
  3467.           by MR/2 at this time.  You may, however, make up your own section
  3468.           names for use with the address book.  It would be easy and often
  3469.           convenient, for example, to have an informal "InternetBuddy"
  3470.           section defined.  For address book entries where the target user
  3471.           was known personally and considered to be a friend, the template
  3472.           for replies and/or new messages might be made more informal than
  3473.           a normal Internet reply.
  3474.  
  3475.  
  3476.           Template Variables
  3477.           ------------------
  3478.           This section will describe the variables available for use within
  3479.           the template file used by MR/2.  These variables are placed in
  3480.           the template file section(s) desired, wrapped in "@" symbols.  To
  3481.           place the BBSID in a reply to a "normal" public message, the
  3482.           default template section will contain the variable reference
  3483.           "@BBSID@".  For example, the template line:
  3484.  
  3485.                In a message posted on the @BBSID@ BBS:
  3486.  
  3487.           will be replaced with (assuming the current packet is from the
  3488.           PC-OHIO BBS):
  3489.  
  3490.                In a message posted on the PC-OHIO BBS:
  3491.  
  3492.           Most of these variables are straight text-value replacement
  3493.           variables.  There are several, though, that are intended to aid
  3494.           in formatting.  There is a template section in the example
  3495.           template file "example.tf" that demonstrates the use of many of
  3496.           these variables, including some handy formatting examples.
  3497.  
  3498.  
  3499.  
  3500.  
  3501.           -----------------------------------------------------------------
  3502.           MR/2 User's Guide - Version 2.0                           Page 56
  3503.  
  3504.  
  3505.  
  3506.           Variables available for use in template sections include:
  3507.  
  3508.           AMPM           The time of day, either "AM" or "PM" as defined by
  3509.                          the current system time.
  3510.  
  3511.           BBSID          The packet's source BBS 8 character identifier,
  3512.                          "PC-Ohio" for example.
  3513.  
  3514.           CENTER         This is a modifier and does not actually cause
  3515.                          data to be placed in the text.  It modifies the
  3516.                          way the next variable is formatted.  The very next
  3517.                          variable will be centered either between column 1
  3518.                          and the defined "WrapLinesAtColumn" setting, or
  3519.                          centered over a given column.  For example,
  3520.                          "@Center@@ConfName@" will center the current
  3521.                          conference name between the message's margins. 
  3522.                          Using "@Center:20@@ConfName@" will center the
  3523.                          conference name over column 20.
  3524.  
  3525.           COL            This is a modifier and does not actually cause
  3526.                          data to be placed in the text.  It modifies the
  3527.                          way the next variable is formatted.  The very next
  3528.                          variable will be placed at the column specified by
  3529.                          this variable.  For example, "@Col:20@@ConfName@"
  3530.                          will place the current conference name on column
  3531.                          20 of the current line.  Negative columns are
  3532.                          allowed and will result in the specified number of
  3533.                          characters being removed at the end of the current
  3534.                          line before the next text is placed.
  3535.  
  3536.           CONFNAME       The name of the conference that the source message
  3537.                          originated from.
  3538.  
  3539.           CONFNUM        The number of the BBS-specific conference that the
  3540.                          source message originated from.
  3541.  
  3542.           DATE           The current system time in MM/DD/YY format.
  3543.  
  3544.           DAY            The literal for the current system day of the week
  3545.                          (e.g., "Saturday").
  3546.  
  3547.           FIDONET        For a source message with a Fidonet origin line,
  3548.                          this variable will hold the Fidonet address (e.g.,
  3549.                          "1:157/200".  In a new message, the address book
  3550.                          can control the value of this variable.
  3551.  
  3552.           FROM
  3553.           FROMFIRST
  3554.           FROMLAST       The original message "FROM" user's name. 
  3555.                          Accessible as a whole or by first and last.
  3556.  
  3557.  
  3558.  
  3559.  
  3560.           -----------------------------------------------------------------
  3561.           MR/2 User's Guide - Version 2.0                           Page 57
  3562.  
  3563.  
  3564.  
  3565.           IDATE          The "Date" line from an Internet messages, if
  3566.                          found, otherwise it is replaced as the DATE
  3567.                          variable.
  3568.  
  3569.           INTERNET       Will contain the Internet address of the sender of
  3570.                          an Internet or Usenet message.  In a new message,
  3571.                          the address book can control the value of this
  3572.                          variable.
  3573.  
  3574.           ISUBJECT       The "Subject" line from an Internet messages, if
  3575.                          found, otherwise it is replaced as the Subject
  3576.                          variable.
  3577.  
  3578.           ITIME          The "Time" line from an Internet messages, if
  3579.                          found, otherwise it is replaced as the TIME
  3580.                          variable.
  3581.  
  3582.           JULIAN         The current system date as a 3 digit Julian date.
  3583.  
  3584.           LOWER          This is a modifier and does not actually cause
  3585.                          data to be placed in the text.  It modifies the
  3586.                          way the next variable is formatted.  The very next
  3587.                          variable will be converted to all lower case
  3588.                          letters before its data is inserted into the text.
  3589.  
  3590.           MIX            This is a modifier and does not actually cause
  3591.                          data to be placed in the text.  It modifies the
  3592.                          way the next variable is formatted.  The very next
  3593.                          variable will be converted to simple "mixed" case
  3594.                          before its data is inserted into the text.  That
  3595.                          is, the first letter of each word will be
  3596.                          capitalized, all other letters converted to lower
  3597.                          case.
  3598.  
  3599.           MSGDATE        The date of the current message as found in the
  3600.                          QWK header (the same date the viewer shows).
  3601.  
  3602.           MSGNUMBER      The message number of the current message.
  3603.  
  3604.           MSGREFNBR      The reference number of the current message, if
  3605.                          one exists.  Blank if not.
  3606.  
  3607.           MSGSTATUS      The message status for the current messages, as
  3608.                          displayed by the message viewer.
  3609.  
  3610.           MSGTIME        The time of the current message as found in the
  3611.                          QWK header (the same time the viewer shows).
  3612.  
  3613.  
  3614.  
  3615.  
  3616.  
  3617.  
  3618.  
  3619.           -----------------------------------------------------------------
  3620.           MR/2 User's Guide - Version 2.0                           Page 58
  3621.  
  3622.  
  3623.  
  3624.           RANDOM         This is a very complex variable that actually
  3625.                          calls for a random phrase replacement from the
  3626.                          contents of a file.  For example, the variable
  3627.                          "@Random:..\phrase.phr@", will be replaced with a
  3628.                          line from the file "..\phrase.phr".  A random
  3629.                          number generated is used to select the line whose
  3630.                          data is to be inserted.  NOTE that this file may
  3631.                          in fact contain other @ variables that are
  3632.                          replaced before the data is inserted.  See the
  3633.                          example provided below for more detail.
  3634.  
  3635.           RCOL           This is a modifier and does not actually cause
  3636.                          data to be placed in the text.  It modifies the
  3637.                          way the next variable is formatted.  The very next
  3638.                          variable will be right-justified against a
  3639.                          specified column, or the defined right margin (the
  3640.                          "WrapLinesAtColumn" setting).  For example,
  3641.                          "@RCol@@ConfName@" will right justify the current
  3642.                          conference name at the message's right margin. 
  3643.                          Using "@RCol:50@@ConfName@" will right justify the 
  3644.                          the conference name to the left of column 60.
  3645.  
  3646.           RIMEIDCODE
  3647.           RIMESITENO     Will contain the Rime address of the sender of an
  3648.                          Rime "Postlink" message.  In a new message, the
  3649.                          address book can control the value of this
  3650.                          variable.
  3651.  
  3652.           SELECT         This is a very complex variable similar to the
  3653.                          RANDOM variable.  This variable actually calls for
  3654.                          a user-prompted phrase replacement from the
  3655.                          contents of a file.  For example, the variable
  3656.                          "@Select:..\phrase.phr@", will be replaced with a
  3657.                          line from the file "..\phrase.phr".  The user
  3658.                          decides which line to use, as the file is
  3659.                          displayed in selection-list form.  If a phrase is
  3660.                          not selected (ESCAPE is pressed), MR/2 will select
  3661.                          a phrase at random.  NOTE that the phrase file may
  3662.                          in fact contain other @ variables that are
  3663.                          replaced before the data is inserted.  These
  3664.                          imbedded variables will show in the selection list
  3665.                          unaltered; they are not resolved into real data
  3666.                          until a selection is made.  See the example below
  3667.                          for more detail.
  3668.  
  3669.  
  3670.           SERIALNUMBER   This variable contains your MR/2 serial number if
  3671.                          you are a registered user.
  3672.  
  3673.           SUBJECT        Contains the current message's subject string.
  3674.  
  3675.  
  3676.  
  3677.  
  3678.           -----------------------------------------------------------------
  3679.           MR/2 User's Guide - Version 2.0                           Page 59
  3680.  
  3681.  
  3682.  
  3683.           TARGETTO
  3684.           TARGETTOFIRST
  3685.           TARGETTOLAST   The message's targeted "TO" user name.  Accessible
  3686.                          as a whole or by first and last.  This can often
  3687.                          be different when a reply is sent to a different
  3688.                          user or "toggled" to be directed to the original
  3689.                          message's TO user.
  3690.  
  3691.           TIME           The current system time in 12 hour format.
  3692.  
  3693.           TIME24         The current system time in 24 hour format
  3694.                          (military time).
  3695.  
  3696.           TO
  3697.           TOFIRST
  3698.           TOLAST         The original message "TO" user's name.  Accessible
  3699.                          as a whole or by first and last.
  3700.  
  3701.           UPPER          This is a modifier and does not actually cause
  3702.                          data to be placed in the text.  It modifies the
  3703.                          way the next variable is formatted.  The very next
  3704.                          variable will be converted to all upper case
  3705.                          letters before its data is inserted into the text.
  3706.  
  3707.           USERNAME       Your user name as it appears in the BBS's control
  3708.                          file.  This is usually the same name as you use to
  3709.                          sign on to the packet's source BBS, and the same
  3710.                          name that appears in your "personal" messages.
  3711.  
  3712.           VERSION        This variable hold the current MR/2 version
  3713.                          string.  For example "v2.0".
  3714.  
  3715.           YYMMDD         The current system date in YYMMDD format.
  3716.  
  3717.  
  3718.  
  3719.  
  3720.  
  3721.  
  3722.  
  3723.  
  3724.  
  3725.  
  3726.  
  3727.  
  3728.  
  3729.  
  3730.  
  3731.  
  3732.  
  3733.  
  3734.  
  3735.  
  3736.  
  3737.           -----------------------------------------------------------------
  3738.           MR/2 User's Guide - Version 2.0                           Page 60
  3739.  
  3740.  
  3741.  
  3742.           Additional Notes about Variables
  3743.           --------------------------------
  3744.           Variable replacement is recursive, so that the user-defined
  3745.           variables V0 through V9, for example, can contain other
  3746.           variables.
  3747.  
  3748.           Taglines may contain variables.  These variables will be resolved
  3749.           to runtime values when selected from the tagline file.
  3750.  
  3751.           There are two variables for use with templates to allow random
  3752.           and user-selected phrase insertion.  First, there must exist a
  3753.           text file containing a list of possible phrases, one per line. 
  3754.           Then, the template file must contain one of the following
  3755.           (assuming "phrases.phr" is the file name and it resides in the
  3756.           MR/2 home directory.  Remember, when replying, you're pathed into
  3757.           the TMP$$ sub directory):
  3758.  
  3759.                   @SELECT:..\phrases.phr@
  3760.                   @RANDOM:..\phrases.phr@
  3761.  
  3762.           Select will build a list of the file's contents and display the
  3763.           phrases in a selection box for you to pick from.  If you ESCAPE
  3764.           from the selection without picking an entry, MR/2 will randomly
  3765.           select one for you.  If you choose the RANDOM option, no user
  3766.           prompting is performed;  MR/2 randomly selects one of the phrases
  3767.           to include.
  3768.  
  3769.           You may have multiple phrases per template line, as many as you
  3770.           want in any given section.  They are processed one at a time. 
  3771.           Phrases may even contain other @ variables, however, these
  3772.           variables are not replaced with data until AFTER the phrase is
  3773.           selected.  There should be no reason a random phrase couldn't
  3774.           reference another select/random phrase clause, if you care to get
  3775.           that complicated.
  3776.  
  3777.           When you're selecting a phrase manually, the template line in
  3778.           progress is displayed on the bottom "status" line of the screen.
  3779.  
  3780.           Here's an example default template section:
  3781.  
  3782.               ==================================================
  3783.               On @MSGDATE@, @FROM@ @SELECT:..\SAID.PHR@ to @TO@:
  3784.  
  3785.               $BODY
  3786.  
  3787.               To which, @SELECT:..\TOD.PHR@, I reply:
  3788.  
  3789.               Nick
  3790.               ====================================================
  3791.  
  3792.  
  3793.  
  3794.  
  3795.  
  3796.           -----------------------------------------------------------------          ----------------------------------------------------------------- 
  3797.           MR/2 User's Guide - Version 2.0                           Page 61          MR/2 User's Manual - Table of Contents                    Page 61
  3798.  
  3799.  
  3800.  
  3801.           The contents of the file "SAID.PHR" might be:
  3802.  
  3803.                   said
  3804.                   spewed
  3805.                   bellowed
  3806.                   expounded
  3807.                   proclaimed
  3808.                   jabbered
  3809.                   mumbled
  3810.  
  3811.           and "TOD.PHR" might contain:
  3812.  
  3813.                   on this brisk morning
  3814.                   in the heat of the night
  3815.                   in a babbling frenzy
  3816.                   without a hint of intelligence
  3817.  
  3818.           The suffix ".PHR" is used here to stand for "phrases".  Phrases
  3819.           should be of a reasonable length (none longer than 200 chars, for
  3820.           select, only 76 are usable).
  3821.  
  3822.           In this example, MR/2 would prompt you first to pick an entry
  3823.           from "Said.phr", then display a selection list of lines from
  3824.           "Tod.phr".  A reply using the template above combined with the
  3825.           "phrases" you selected would be built and sent to your editor. 
  3826.           If the keyword "SELECT" were to be replaced with "RANDOM", then
  3827.           MR/2 would not prompt for a selection, rather it would simply
  3828.           pick a line from each file at random.
  3829.  
  3830.  
  3831.  
  3832.  
  3833.  
  3834.  
  3835.  
  3836.  
  3837.  
  3838.  
  3839.  
  3840.  
  3841.  
  3842.  
  3843.  
  3844.  
  3845.  
  3846.  
  3847.  
  3848.  
  3849.  
  3850.  
  3851.  
  3852.  
  3853.  
  3854.  
  3855.           -----------------------------------------------------------------          ----------------------------------------------------------------- 
  3856.           MR/2 User's Guide - Version 2.0                           Page 62          MR/2 User's Manual - Table of Contents                    Page 62
  3857.  
  3858.  
  3859.  
  3860.           Address Book
  3861.           ------------
  3862.           MR/2 has the ability to record and recall email addresses and
  3863.           other pertinent information from a simple text file.  To access
  3864.           an address-book entry, you use the first field of the record as
  3865.           the identifier or "tag".  When filling out the message header
  3866.           "TO" field, enter a "!" followed by an address book tag, tab or
  3867.           enter out of this field and the address book data will be
  3868.           accessed and automatically applied.  For example, to send an
  3869.           Internet message to the author (assuming you have a private
  3870.           Internet mail conference defined), type "!NK-I" as the TO user
  3871.           and press ENTER.  MR/2 looks for a BBS.adr (e.g., "NERDNOOK.adr")
  3872.           first, then "MR2.Adr" second, both in the MR/2 base directory.
  3873.  
  3874.           NOTE that you may also press F2 while in the TO field of the
  3875.           message header to pick from a list of existing addresses.
  3876.  
  3877.           The format of the address book file is:
  3878.  
  3879.           Tag | Description | TO | Conf # | Private? | Section | Address
  3880.  
  3881.                Tag is a short identifier used to reference the address.
  3882.  
  3883.                Description is a free-form field to help you remember
  3884.                who/what this address is for.
  3885.  
  3886.                To is the name to plug into the TO; header field.
  3887.  
  3888.                Conf # is the conference in which to place the message. 
  3889.                NOTE that this is usually a specific number, but "I" is
  3890.                allowed and will be replaced with the conference number set
  3891.                as your "Internet" conference. Also, "N" is allowed and
  3892.                represents the defined Netmail conference.
  3893.  
  3894.                Private is either "Y" or "N", representing the privacy flag.
  3895.  
  3896.                Section identifies the template section to use.  Sometimes
  3897.                this may obviously be unnecessary, but it does allow for
  3898.                user-defined sections to be created and used for specific
  3899.                address book entries. "Internet", "Netmail" and "Rime" will
  3900.                be used most frequently.  NOTE: "New" is automatically
  3901.                prepended by MR/2 when entering "new" messages.
  3902.  
  3903.                Address is the first-line address code.  If the template
  3904.                section uses the @Internet@, @Fidonet@ or either of the
  3905.                @Rime*@ variables, the contents of these variables will be
  3906.                set to this string.
  3907.  
  3908.           NOTE:  There is no error checking or identification by BBS name,
  3909.           other than allowing for BBS-specific address books.  MR2.Adr, if
  3910.           it exists, is always references, but after any bbs-specific file
  3911.           has been checked.
  3912.  
  3913.  
  3914.           -----------------------------------------------------------------
  3915.           MR/2 User's Guide - Version 2.0                           Page 63
  3916.  
  3917.  
  3918.  
  3919.           Use of the "N" and "I" conference identifiers helps make some
  3920.           addresses less BBS-specific.  For example, you can send Fidonet
  3921.           Netmail from any of several different BBS's.  Your MR2.adr can
  3922.           contain Netmail addresses for use on all BBS's, as long as your
  3923.           template file(s) have been set up correctly and private mail
  3924.           conferences have been identified in the BBS-specific INI's.  This
  3925.           can get complex - but it also can be quite powerful and handy.
  3926.  
  3927.  
  3928.           Selecting from the Address Book
  3929.           -------------------------------
  3930.           While editing the message header, pressing F2 when inside the TO
  3931.           field will display a selection list of existing addresses.  You
  3932.           may pick an address from this list to use for the current message
  3933.           or reply, or you may actually perform changes to the address book
  3934.           at this time.  To select a target address and have the message
  3935.           header edit screen updated with this address, simply highlight
  3936.           the desired address and press ENTER.  Address Book Maintenance
  3937.           will be covered in detail, below.
  3938.  
  3939.  
  3940.           Address Book Maintenance
  3941.           ------------------------
  3942.           You may add new, modify or delete existing records from the
  3943.           address book selection screen.  Press ALT-A to add a new entry to
  3944.           the book.  You will be presented with an empty Address screen for
  3945.           entering the new address.  Fill in all pertinent data and press
  3946.           F10 to save the information.  If you wish to modify an existing
  3947.           address, simply highlight the entry and press ALT-C to change. 
  3948.           In this case, the Address screen will be displayed containing the
  3949.           data for the selected address.  Change as desired and press F10
  3950.           to save it.  To delete an address book entry , highlight the
  3951.           desired address and press ALT-D to delete it.  You are prompted
  3952.           to confirm the deletion before it is made permanent.
  3953.  
  3954.           NOTE that you can also "steal" an address from an existing
  3955.           message or reply.  Simple press ALT-A while viewing a message.
  3956.  
  3957.           The address book text file is rewritten each time a single change
  3958.           is made.  The previous version is copied to bbsname.old or
  3959.           mr2.old, depending on which book is being modified.  This gives
  3960.           you the ability to "undo" the last change made by copying the
  3961.           .old file back to the original.  Only the very last change may be
  3962.           reversed, though.
  3963.  
  3964.           NOTE:  Address book tags are resolved in a first-found order. 
  3965.           The local address book, if one exists, is checked first.  If not
  3966.           found there, the global MR2.ADR is checked.  If duplicates exist,
  3967.           only the first one found (searching the file(s) sequentially) is
  3968.           the one that's used.  Pick list selections go through the same
  3969.           process ... so picking the "other" one doesn't matter.
  3970.  
  3971.  
  3972.  
  3973.           -----------------------------------------------------------------
  3974.           MR/2 User's Guide - Version 2.0                           Page 64
  3975.  
  3976.  
  3977.  
  3978.           Configuring for Multiple Archivers
  3979.           ----------------------------------
  3980.           The archiver/unarchiver to use for packing replies and unpacking
  3981.           QWK packets, respectively, are specified in the MR2.INI file as
  3982.           the "Zipper" and "Unzipper".  In the majority of cases, these
  3983.           will be specified as PKZip and PKUnzip, or some variation or
  3984.           clone of these two popular utilities.  Some BBS's use different
  3985.           compression software and some let you select the software to use.
  3986.  
  3987.           For users who access one BBS, or who access multiple BBS's that
  3988.           all use the same compression utilities, the simple form of
  3989.           specifying the zipper/unzipper directly may be used.  For cases
  3990.           where a user visits many BBS's, and for some reason these BBS's
  3991.           use different compression software, you will probably choose to
  3992.           use MR/2's REXX-based support for automatic archiver detection.
  3993.  
  3994.           NOTE:  The REXX command files included also provide support for
  3995.           long file names with MS-DOS or other HPFS-unaware compression
  3996.           utilities.
  3997.  
  3998.  
  3999.           Merging Packets
  4000.           ---------------
  4001.           Merging multiple packets from the same source BBS into a single
  4002.           QWK is available.  This features is described in its own section,
  4003.           above.
  4004.  
  4005.  
  4006.  
  4007.  
  4008.  
  4009.  
  4010.  
  4011.  
  4012.  
  4013.  
  4014.  
  4015.  
  4016.  
  4017.  
  4018.  
  4019.  
  4020.  
  4021.  
  4022.  
  4023.  
  4024.  
  4025.  
  4026.  
  4027.  
  4028.  
  4029.  
  4030.  
  4031.  
  4032.           -----------------------------------------------------------------
  4033.           MR/2 User's Guide - Version 2.0                           Page 65
  4034.  
  4035.  
  4036.  
  4037.           Running Multiple Copies of MR/2
  4038.           -------------------------------
  4039.           It is possible, and in fact sometime quite advantageous, to run
  4040.           multiple copies of MR/2 and share data between them.  This is
  4041.           handy for viewing multiple packets at the same time, where you
  4042.           wish to copy all or some of the contents of one message into a
  4043.           message targeted for a different BBS.  You may run these multiple
  4044.           copies in windowed session, if desired, although cut and paste
  4045.           using the system clipboard is available even in full-screen
  4046.           sessions.
  4047.  
  4048.           MR/2 cannot, at this time, share an open packet between two
  4049.           sessions (* see note below).  For this reason, it is necessary to
  4050.           run each separate MR/2 session using a different working
  4051.           directory.  The "/W" command line parameter is available
  4052.           specifically for this purpose.  By default, MR/2 uses the work
  4053.           directory path specified in MR2.INI.  You can override this path
  4054.           and specify a different subdirectory as the working directory
  4055.           simply by using the parameter, followed by the working directory
  4056.           name.  For example, let's assume you've left MR/2's default
  4057.           working directory specification (in MR2.INI) to be "tmp$$".  This
  4058.           means that MR/2, when a packet is selected for reading, will
  4059.           create a subdirectory names "tmp$$" (if it doesn't exist), change
  4060.           its path so that this is the current directory, and unpack the
  4061.           selected QWK packet.  If you wish to unpack into and use a
  4062.           subdirectory named "tmp$$two", you would simply invoke MR/2 with
  4063.           a command line that looks like (or from an icon that mimics):
  4064.  
  4065.                     MR2 /Wtmp$$two
  4066.  
  4067.           You may open more than two copies of MR/2, as long as a different
  4068.           working directory is specified for each.
  4069.  
  4070.           Since MR/2 can write to and read from the system clipboard,
  4071.           transferring data between two or more sessions is very easy.  See
  4072.           the appropriate section on clipboard access for more information.
  4073.  
  4074.           (*)  At this time, this manual is being finalized for the release
  4075.                of MR/2 version 2.0.  Some new features have been started,
  4076.                but will not be available in version 2.0.  Please examine
  4077.                the READ.ME file for any advancements regarding CLONING an
  4078.                existing session and/or working with multiple QWK
  4079.                packet/sessions.
  4080.  
  4081.  
  4082.  
  4083.  
  4084.  
  4085.  
  4086.  
  4087.  
  4088.  
  4089.  
  4090.  
  4091.           -----------------------------------------------------------------
  4092.           MR/2 User's Guide - Version 2.0                           Page 66
  4093.  
  4094.           Reply Log
  4095.           ---------
  4096.           Reply logging is available, if desired, and is set to YES by
  4097.           default in a newly created MR2.INI file.  This option controls
  4098.           whether or not your replies are recorded or "logged" in a special
  4099.           conference for reference.
  4100.  
  4101.           If Reply Logging is set to NO, then new replies will not be
  4102.           appended to the reply log, if one exists.  If a reply log is
  4103.           found for the current BBS, it will be available as a conference
  4104.           for reference regardless of the current setting of this flag.  To
  4105.           completely remove an existing reply log from view, you must
  4106.           delete "ReplyLog.Dat" in the BBS's subdirectory, or rename it to
  4107.           something else.
  4108.  
  4109.           When Reply Logging has been set to YES, normal reply logging is
  4110.           activated.  For each .REP packet that you make for a given BBS, a
  4111.           "shadow" file duplicating those replies is made.  Whenever MR/2
  4112.           is loaded and sees a "shadow" file without a corresponding .REP
  4113.           packet, the shadow file's contents are appended to the reply log,
  4114.           then the shadow file is deleted.  Using this technique, the reply
  4115.           log will contain only those replies from the latest version of
  4116.           any given .REP file, and a .REP file may be deleted even outside
  4117.           of MR/2 without losing the information necessary to log them.  
  4118.  
  4119.           If the ReplyLog parameter is set to FULL, then logging of both
  4120.           replies and the original source message that provoked the reply
  4121.           is logged.  The source message is actually added to the log after
  4122.           the reply.  The original source messages are not shown in the
  4123.           header index list, nor are they shown when stepping through each
  4124.           messages.  To view a reply's source message, press "J" while it's
  4125.           on the message viewer screen.  This will "jump" to the source
  4126.           message.  You may reply to this original message again, if for
  4127.           some reason you wish to.
  4128.  
  4129.           If for any reason you wish to repost a given logged reply, press
  4130.           "R" as you would to modify any existing reply.  You will have an
  4131.           opportunity to make changes to the reply (it will be loaded into
  4132.           your editor for revisions), or you may accept it "as is" simply
  4133.           by saving it.  Once saves, the message will be copied into the
  4134.           reply conference, and will be packed with your next .REP packet.
  4135.  
  4136.           NOTE:  When selecting the reply log from the "Conferences w/Mail"
  4137.           section screen, it may seem to take MR/2 longer than usual to
  4138.           actually display the first message in the viewer.  This will be
  4139.           particularly noticeable if reply logging is set to FULL.  This is
  4140.           because there are usually more message in the log than reported
  4141.           in the pick list.  For any given message, there may be a
  4142.           source/original message recorded with it.  So, while the Reply
  4143.           Log may contain a reported 100 replies, there may actually be as
  4144.           many as 200 message inside.  It takes about twice as long to
  4145.           build a header index from 200 messages than it does with only
  4146.           100, so the wait seems longer than "usual".
  4147.  
  4148.  
  4149.           -----------------------------------------------------------------
  4150.           MR/2 User's Guide - Version 2.0                           Page 67
  4151.  
  4152.  
  4153.  
  4154.           Cut/Paste - Accessing the PM Clipboard
  4155.           --------------------------------------
  4156.           MR/2 allows limited access to the system clipboard from within
  4157.           the internal editor.  This access includes writing marked
  4158.           sections to the clipboard (use F11 to mark, then F12 to bound a
  4159.           section) and retrieving clipboard text into a document.  There
  4160.           are also commands to APPEND a marked section to what already
  4161.           exists in the clipboard, and a key combination that allows the
  4162.           clipboard to be cleared.  Key are as follows, using the grey
  4163.           "numeric" keypad for these keystrokes was the intention (although
  4164.           the normal keypad versions work, too):
  4165.  
  4166.                ALT-      Cut to clipboard
  4167.                Alt+      Copy to clipboard
  4168.                Alt=      Append to clipboard (or ALT-ENTER)
  4169.                ALT/      Clear clipboard
  4170.                ALT*      Paste from clipboard
  4171.  
  4172.  
  4173.           Notes on Running External Executables
  4174.           -------------------------------------  
  4175.           Whenever an external utility is accessed by MR/2 (as specified in
  4176.           your INI file), the default action is to call my compiler's run-
  4177.           time "system()" function.  This function actually loads a new
  4178.           command processor, passing the data you provide as the file
  4179.           specification as the command line.
  4180.  
  4181.           While this is a fine generic solution and usually works
  4182.           dependably and "fast enough", there are times where it is
  4183.           undesirable.  There are also time when this technique doesn't
  4184.           work at all.  Often, loading the command processor may be
  4185.           unnecessary and a waste of time.  To remedy these problems, MR/2
  4186.           offers some prefix codes for direct loading of executables.
  4187.  
  4188.           I have received multiple reports of problems regarding MR/2 and
  4189.           4OS2.  When loaded from an icon with 4OS2 as the command
  4190.           processor, some experience problems.  For others, it works just
  4191.           fine.  There seems to also be a problem when your system actually
  4192.           boots OS/2 from a partition other than C:.  The two of these may
  4193.           be related ... one user both booted from his D: drive and used
  4194.           4OS2 and experienced trouble running MR/2 from an icon.  The
  4195.           problems appeared as errors when loading the zipper/unzipper
  4196.           and/or an external editor.
  4197.  
  4198.  
  4199.  
  4200.  
  4201.  
  4202.  
  4203.  
  4204.  
  4205.  
  4206.  
  4207.  
  4208.           -----------------------------------------------------------------
  4209.           MR/2 User's Guide - Version 2.0                           Page 68
  4210.  
  4211.  
  4212.  
  4213.           There are several methods for specifying an executable that is to
  4214.           be invoked directly (without loading the command processor). 
  4215.           using an external editor as an example, they are:
  4216.  
  4217.                Editor=q                 loads q.exe the same old way.
  4218.  
  4219.                Editor=!c:\qe3\q.exe     loads a windowed Q.exe on the
  4220.                                         desktop, running q.exe directly (no
  4221.                                         cmd.exe involved).  File must be
  4222.                                         fully qualified with full path
  4223.                                         specifications.
  4224.  
  4225.                Editor=!!c:\qe3\q.exe    loads a full screen session w/o
  4226.                                         loading cmd.exe - q.exe loads
  4227.                                         directly.  Fully qualify the file
  4228.                                         name.
  4229.  
  4230.                Editor=!$c:\qe3\dos\q.exe
  4231.  
  4232.                                         loads a DOS windowed session,
  4233.                                         loading Q.exe directly.  CMD.exe is
  4234.                                         not accessed, but command.com is. 
  4235.                                         May still cause D:\ booting
  4236.                                         problems, but it's an option.
  4237.  
  4238.                Editor=!$!c:\qe3\dos\q.exe
  4239.  
  4240.                                         Loads the DOS Qedit into a Full
  4241.                                         screen DOS session w/o accessing
  4242.                                         cmd.exe.
  4243.  
  4244.           NOTE that these work with the zipper/unzipper, too, as well as
  4245.           PreEdit, PostEdit, F2-F10, etc.,.  Anytime an external utility is
  4246.           called, MR/2 checks for these prefixes for special processing.
  4247.  
  4248.  
  4249.  
  4250.  
  4251.  
  4252.  
  4253.  
  4254.  
  4255.  
  4256.  
  4257.  
  4258.  
  4259.  
  4260.  
  4261.  
  4262.  
  4263.  
  4264.  
  4265.  
  4266.  
  4267.           -----------------------------------------------------------------          ----------------------------------------------------------------- 
  4268.           MR/2 User's Guide - Version 2.0                           Page 69          MR/2 User's Manual - Table of Contents                    Page 69
  4269.  
  4270.  
  4271.  
  4272.           INI File Parameter/Options - Detailed Descriptions
  4273.           --------------------------------------------------
  4274.  
  4275.           AllUpperCase=Yes
  4276.                Converts Subject, From and To user names to upper-case
  4277.                before saving replies, if set to YES.  If set to NO, the
  4278.                case you supply is preserved.
  4279.  
  4280.  
  4281.           Attributes=NONE
  4282.           Attributes=Extended
  4283.  
  4284.                When preparing to edit reply files, MR/2 can optionally mark
  4285.                these files as type "Plain Text" so, for example, the "E"
  4286.                editor will not force you to set the type before saving.
  4287.  
  4288.           AutoFirstKey = Q
  4289.  
  4290.                This is a keypress that can be automatically simulated
  4291.                whenever you first enter a conference.  For example, if the
  4292.                first thing you do upon entering a new conference is to
  4293.                press Q for the Quick Thread Summary, specifying Q will do
  4294.                this for you.  Another logical choice would be to specify
  4295.                the I key.  NOTE that this feature works ONLY for
  4296.                conferences with 2 or more messages.
  4297.  
  4298.           AutoUnpack = NO
  4299.  
  4300.                The default is NO, which means that if an existing REP file
  4301.                is found when unpacking a BBS's packet, you will be prompted
  4302.                for its disposition.  If YES is specified here, then the
  4303.                replies are automatically unpacked, as if you had answered
  4304.                "KEEP" to the "Replies exist" prompt.
  4305.  
  4306.           BackDropMaxLines = 0
  4307.  
  4308.                Used to limit the number of lines that are written to the
  4309.                screen during the display of the WELCOME and GOODBYE
  4310.                screens.  Some BBS's have huge files, and this slows the
  4311.                reading process.  You may limit the line count to 25 for
  4312.                greater speed, or set it to 0 to disable the display of
  4313.                these backdrops completely.
  4314.  
  4315.           BackupOldReplies = Yes
  4316.  
  4317.                If YES is specified, any .REP file that is to be deleted is
  4318.                first copied to a .OLD file.  If NO is specified, the .REP
  4319.                files are deleted and no backup is performed.
  4320.  
  4321.  
  4322.  
  4323.  
  4324.  
  4325.  
  4326.           -----------------------------------------------------------------
  4327.           MR/2 User's Guide - Version 2.0                           Page 70
  4328.  
  4329.  
  4330.  
  4331.           BeepOnPersonals = Yes
  4332.  
  4333.                Turns the "beep" when a personal message is displayed off
  4334.                and on.  Specify YES is you want MR/2 to beep on your
  4335.                personal messages, NO for silent running.
  4336.  
  4337.           Check = Subject
  4338.  
  4339.                This parameter is used only in conjunction with the INI
  4340.                parameter "MakeConference".  It is one of the options
  4341.                available in defining a virtual conference.  This variable
  4342.                can be used to tell MR/2 which message sections to check
  4343.                when determining if the message contains the search text
  4344.                criteria.  If not supplied as part of the virtual conference
  4345.                definition, all parts of the message will be searched.  You
  4346.                may limit the areas search by specifying this keyword,
  4347.                followed by one or more of the message section names,
  4348.                separated by commas.  Valid message section names are FROM,
  4349.                TO, BODY, ORIGIN and SUBJECT.  For example, specifying
  4350.                "FROM,TO" will search for the specified text only in the
  4351.                from and to fields of the message header.  See SEARCH.INI
  4352.                for various other examples of how this is used.
  4353.  
  4354.           Colors=1E171EE0
  4355.           Colors=0F0E0AE0
  4356.  
  4357.                Yes, this is crude - I'll include something more friendly
  4358.                later. The first two characters describe the "normal" text
  4359.                color for messages, which is shown here as 1E, or Blue
  4360.                background (1) Yellow foreground (E).
  4361.  
  4362.                The second two are the quoted-text colors, 17 is Blue
  4363.                background (1) with a White foreground (7).  The third set
  4364.                of 2 numbers are the message header display colors (the
  4365.                From/To/Subject section on top).  Finally, the forth pair of
  4366.                numbers is the color combination to use when highlighting
  4367.                searched-for text.  This is the only color configuration
  4368.                support at this time.
  4369.  
  4370.                Colors:
  4371.  
  4372.                   0 = Black    1 = Blue   2 = Green  3 = Cyan  4 = Red
  4373.                   5 = Magenta  6 = Brown  7 = White  8 = Gray  9 = Lt Blue
  4374.  
  4375.                   A = Lt. Green        B = Lt. Cyan      C = Lt. Red
  4376.                   D = Lt. Magenta      E = Yellow        F = Intense White
  4377.  
  4378.                I personally have changed to the second example here, which
  4379.                gives a black background with bold-white text, yellow quotes
  4380.                and green header.
  4381.  
  4382.  
  4383.  
  4384.  
  4385.           -----------------------------------------------------------------
  4386.           MR/2 User's Guide - Version 2.0                           Page 71
  4387.  
  4388.  
  4389.  
  4390.           Conferences = 93,99,174
  4391.  
  4392.                This parameter is used only in conjunction with the INI
  4393.                parameter "MakeConference".  It is one of the options
  4394.                available in defining a virtual conference.  This variable
  4395.                can be used to tell MR/2 which message conferences to check
  4396.                when finding search text criteria.  If not supplied as part
  4397.                of the virtual conference definition, or specified as "*",
  4398.                all conferences are searched.  You may limit the conferences
  4399.                search by specifying this keyword, followed by one or more
  4400.                of conference numbers, separated by commas.  For example,
  4401.                specifying "93,99,174" will search only these specified
  4402.                conferences while building the defined virtual conference. 
  4403.                See SEARCH.INI for various other examples of how this is
  4404.                used.
  4405.  
  4406.           CursorSize = 6
  4407.  
  4408.                Used to control the size of the "normal" cursor when inside
  4409.                the internal editor.  Under some higher-line modes, users
  4410.                have reported trouble seeing the cursor.  My attempts to
  4411.                enlarge it solved only some of the cases.  By default, the
  4412.                cursor size is 1 or 2 scan lines tall in 25 line mode.  When
  4413.                switching to 34 line or greater, the cursor size becomes 6
  4414.                scanlines.  The cursor size for "overtype" cursors if 13
  4415.                scanlines.  USE THIS OPTION ONLY IF NECCESSARY.  It's meant
  4416.                only to solve some specialized, infrequent problems.
  4417.  
  4418.           DisplayStatus = No
  4419.  
  4420.                If set to YES, MR/2 will display a search progression string
  4421.                at the bottom of the screen.  This will appear similar to
  4422.                the normal searching status display.
  4423.  
  4424.           DoorName = RoseMail
  4425.  
  4426.                This parameter is provided as a means of identifying the BBS
  4427.                Door software you use to process your QWK packets.  This is
  4428.                useful, for example, if the QWK door does not provide a
  4429.                DOOR.ID file, in which case MR/2 may not address and create
  4430.                door configuration messages (DROP and ADD) properly.  It
  4431.                will also benefit cases where you are configuring the door
  4432.                offline after selecting NO PACKET entry.  In this case, no
  4433.                DOOR.ID file will be present, and MR/2 will default to QMAIL
  4434.                based configuration messages.
  4435.  
  4436.  
  4437.  
  4438.  
  4439.  
  4440.  
  4441.  
  4442.  
  4443.  
  4444.           -----------------------------------------------------------------
  4445.           MR/2 User's Guide - Version 2.0                           Page 72
  4446.  
  4447.  
  4448.  
  4449.           Editor=e
  4450.           Editor=epm
  4451.           Editor=q -e..\qstartup.mac
  4452.           Editor=INTERNAL
  4453.  
  4454.                This is the command MR2 will use when invoking the editor.
  4455.                By default, the system PM editor "e" is used.  To use QEdit
  4456.                and pass it a start-up macro (-e parameter), change this
  4457.                line to read:
  4458.  
  4459.                          Editor=q -ef:\mr2\qstartup.mac
  4460.  
  4461.                NOTE: when using the PM "E" or "EPM" editors - "word wrap"
  4462.                appears to work great, however, lines are not actually
  4463.                broken with CR/LF's.  This causes formatting problems for
  4464.                MR/2.  Keep Word Wrap off and include linefeeds by hand.
  4465.  
  4466.                The keyword INTERNAL will instruct MR/2 to use its own
  4467.                built-in editor when you request to reply or create a new
  4468.                message.
  4469.  
  4470.           ExitAtEndOfParameters=Yes
  4471.  
  4472.                This parameter defines what MR/2 does when parameters are
  4473.                provided on the command line (or via "association").  If set
  4474.                to YES, MR/2 exits when all packets listed as command line
  4475.                parameter have been read.  If NO, then MR/2 simply returns
  4476.                to the packet selection screen.  NOTE:  If no parameters are
  4477.                passed on the command line, this option has no effect.  See
  4478.                the read.me file for more detail.
  4479.  
  4480.  
  4481.           F2 = D:\Os2util\List c:\phone.nbrs
  4482.           F3 = D:\os2util\q MR2.INI
  4483.  
  4484.                You may attach an OS/2 command to any of the function keys
  4485.                F2 through F10.  NOTE that this works only while viewing
  4486.                messages.  Also, the current message is always written to
  4487.                the INI-defined reply file.  This is to allow the command
  4488.                line utility to access the current message.
  4489.           
  4490.  
  4491.           FileSpec=*.q??
  4492.  
  4493.                This is the wildcard file specification to use when
  4494.                searching for packets to read.  This string is appended to
  4495.                the PacketPath string and all files matching this
  4496.                combination are listed as packets.
  4497.  
  4498.  
  4499.  
  4500.  
  4501.  
  4502.  
  4503.           -----------------------------------------------------------------
  4504.           MR/2 User's Guide - Version 2.0                           Page 73
  4505.  
  4506.  
  4507.  
  4508.           FileViewer=List
  4509.  
  4510.                May be used to specify an external file viewer for viewing
  4511.                news, bulletins and file lists.  The default is to use the
  4512.                internal viewer.
  4513.  
  4514.           FolderPath=..\
  4515.  
  4516.                This is the default directory path from which MR/2 will
  4517.                create BBS specific directories for folders.  Using this
  4518.                default, MR/2 will build a sub directory (when a folder is
  4519.                to be created) for the current BBS directory off of the MR/2
  4520.                "home" directory.  You may specify any other desired "root"
  4521.                directory for folders, though.
  4522.  
  4523.           GoToLastRead = No
  4524.  
  4525.                If set to YES, will suppress the "do you wish to return to
  4526.                your previous reading position" prompt and jump there
  4527.                automatically.
  4528.  
  4529.           HeaderEditing=Both
  4530.  
  4531.                This controls when the Message header is displayed for
  4532.                editing. Options, relative to actually editing the reply are
  4533.                Before, After or Both.
  4534.  
  4535.           HeaderInQuote=No
  4536.                You may optionally include the message header in a reply
  4537.                file.  This is often used with a clever editor "macro" to
  4538.                create sophisticated quoting styles not natively supported
  4539.                by MR/2.  You must be sure to remove all traces of the
  4540.                header before saving the message, as MR/2 makes no attempt
  4541.                to identify or remove it.
  4542.  
  4543.  
  4544.  
  4545.  
  4546.  
  4547.  
  4548.  
  4549.  
  4550.  
  4551.  
  4552.  
  4553.  
  4554.  
  4555.  
  4556.  
  4557.  
  4558.  
  4559.  
  4560.  
  4561.  
  4562.           -----------------------------------------------------------------
  4563.           MR/2 User's Guide - Version 2.0                           Page 74
  4564.  
  4565.  
  4566.  
  4567.           HideConferences =  2344, 1823, 89
  4568.  
  4569.                This is a new "helper" function for search/virtual
  4570.                conference entries.  It allows conferences, specified by
  4571.                number, to be "hidden" from the conferences w/mail selection
  4572.                screen.  You may specify multiple conference numbers on this
  4573.                line, separated by commas.  You may also have multiple
  4574.                HideConference lines, the lines are collected into a single
  4575.                internal list and have a cumulative effect.  I use this, for
  4576.                example, to hide the dozen or so FORSALE conference I
  4577.                download, as I let my virtual conference builder pick out
  4578.                the message I want to see.  I never go into these conference
  4579.                on an individual basis, hence, I need not see them as
  4580.                readable conference.
  4581.  
  4582.           Internet=-1
  4583.  
  4584.                Use this parameter to declare which conference, if any,
  4585.                handles Internet private mail.  For example, PC-Ohio has
  4586.                Internet mail in conference 5.  My PC-OHIO.INI file has
  4587.                "Internet=5".  Nerd's Nook has no Internet capabilities.  My
  4588.                NerdNook.INI file has the line "Internet=-1".  The "-1"
  4589.                tells MR/2 that there is no Internet support, and makes sure
  4590.                that the Internet section template is not referenced.
  4591.  
  4592.           KeepMessageMarks=YES
  4593.  
  4594.                If set to YES, MR/2 will track the read/replied/saved status
  4595.                of every message, as well as your current position in the
  4596.                packet.  This information is stored as OS/2 extended
  4597.                attributes and will stay attached to the file as it is
  4598.                copied or renamed.  When a previously read packet is
  4599.                reopened, you will be asked if you wish to return to you
  4600.                previous position.  Answering YES will return you to that
  4601.                spot, responding NO will place you at the conference
  4602.                selection screen.
  4603.  
  4604.           LogReplies = YES
  4605.  
  4606.                Controls the creation and maintenance of a reply log.  Set
  4607.                to YES, all replies are logged to an online reply "folder". 
  4608.                Set to FULL, copies of the original message preface every
  4609.                reply.  Set to NO, no reply logging is performed.  The reply
  4610.                folder is maintained in a conference named ReplyLog.
  4611.  
  4612.  
  4613.  
  4614.  
  4615.  
  4616.  
  4617.  
  4618.  
  4619.  
  4620.  
  4621.           -----------------------------------------------------------------
  4622.           MR/2 User's Guide - Version 2.0                           Page 75
  4623.  
  4624.  
  4625.  
  4626.           MakeConference = MR/2 Chit Chat
  4627.  
  4628.                This parameter is used to start the definition of a
  4629.                "virtual" or "custom" user-defined conference.  This
  4630.                variable is used to tell MR/2 the name of the conference to
  4631.                display in the "Conferences w/Mail" selection list.  The
  4632.                name you provide can be quite large, but keeping it a
  4633.                reasonable length (30-40 characters maximum) is suggested.  
  4634.                Using the example above, "MR/2 Chit Chat" will be displayed
  4635.                as a readable conference if any messages are found to match
  4636.                the subsequent search criteria, found in the lines
  4637.                immediately following in the INI file.  These lines may
  4638.                identify any or all of the INI virtual conference parameters
  4639.                CHECK, CONFERENCES and STRING.  See SEARCH.INI for various
  4640.                other examples of how this is used.
  4641.  
  4642.           MessageOrder=Subject
  4643.  
  4644.                May be set to "Subject" or "None" and specifies the reading
  4645.                order of messages.  When Subject is chosen, many extra
  4646.                "thread" related keys become available.  For instance, the
  4647.                TAB and BACKSPACE key can be used to skip through threads,
  4648.                and the "Q" key will invoke a thread summary menu.
  4649.  
  4650.           MouseClickSpeed = 500
  4651.  
  4652.                The maximum time, in milliseconds, between mouse clicks for
  4653.                them to be considered "double" clicks.
  4654.  
  4655.           MouseMode = DoubleClick
  4656.  
  4657.                Can be set to DoubleClick (the new default) or SingleClick
  4658.                (the old way).  Double click will be required to select any
  4659.                entry from a selection list.  In SingleClick mode, a single
  4660.                mouse click will select an entry.  DoubleClicking is
  4661.                provided for use with the new "mouse menus".
  4662.  
  4663.           MouseScrollSpeed = 1
  4664.  
  4665.                Controls the speed of scrolling when you park the mouse on a
  4666.                scroll arrow and hold the left mouse button down.  A value
  4667.                of one is the fastest you can get right now, if this is too
  4668.                fast for you, raise this number.  This represents the number
  4669.                of milliseconds delay before MR/2 generates a pseudo mouse
  4670.                click for you.
  4671.  
  4672.  
  4673.  
  4674.  
  4675.  
  4676.  
  4677.  
  4678.  
  4679.  
  4680.           -----------------------------------------------------------------
  4681.           MR/2 User's Guide - Version 2.0                           Page 76
  4682.  
  4683.  
  4684.  
  4685.           Netmail=-1
  4686.  
  4687.                Use this parameter to declare which conference, if any,
  4688.                handles Fidonet netmail.  For example, PC-Ohio has Fidonet
  4689.                netmail in conference 6.  My PC-OHIO.INI file has
  4690.                "Netmail=6".  Setting the Netmail parameter to "-1" tells
  4691.                MR/2 that there is no Netmail support, and makes sure that
  4692.                the Netmail section template is not referenced.
  4693.  
  4694.           NewMessageEditor=E
  4695.  
  4696.                This is an optional entry.  If you wish to run a different
  4697.                editor for NEW messages, or run the same editor with
  4698.                different startup macros for NEW messages, specify it here. 
  4699.                This NEW editor is also used to edit News, Bulletins and
  4700.                Newfile listings.  If not specified, the base editor is
  4701.                always used.
  4702.  
  4703.           OldQuoteDetect=YES
  4704.  
  4705.                When set to YES, MR/2 will not place the quote prefix in
  4706.                front of reply-file lines that already are prefixed with
  4707.                quotes.  This creates (usually) a much cleaner initial reply
  4708.                file.
  4709.  
  4710.           PacketPath=g:\dl\
  4711.  
  4712.                This is where MR2 will look for packets to read.  A wildcard
  4713.                specification is built from this specification, with the
  4714.                FileSpec string appended to it.
  4715.  
  4716.           PacketRefresh = 60
  4717.  
  4718.                Controls how often, in seconds, the packet selection screen
  4719.                is updated to reflect changes in the packet list.  The
  4720.                default is every 60 seconds.  Specify 0 (zero) to suppress
  4721.                the refresh process entirely.
  4722.  
  4723.           PacketSort = ATIME_DDATE
  4724.  
  4725.                This controls the sort order in which packets are shown on
  4726.                the Packet Selection screen.  Possible values are:
  4727.  
  4728.                Name           sort alphabetically
  4729.                DTime_DDate    descending time within descending date
  4730.                               (default)
  4731.                ATime_DDate    ascending time within descending date.  List
  4732.                               todays packets first, morning's first,  the
  4733.                               afternoon's, then evenings. This makes .qwk,
  4734.                               .qw0, .qw1 list in order.
  4735.  
  4736.  
  4737.  
  4738.  
  4739.           -----------------------------------------------------------------
  4740.           MR/2 User's Guide - Version 2.0                           Page 77
  4741.  
  4742.  
  4743.  
  4744.           PositionOnMatchLine = Yes
  4745.  
  4746.                This causes the line that caused a message to "match" to be
  4747.                aligned at the top of the display - as if a search had been
  4748.                performed.  Set this to NO if you wish to see the top of
  4749.                each message in all custom conferences.
  4750.  
  4751.           PostEdit = c:\utility\ss
  4752.           PostEdit = INTERNAL
  4753.  
  4754.                May be used to specify a "pst editing" process for replies. 
  4755.                If specified, the reply file name is appended to this line
  4756.                and executed as a command line after a reply file has been
  4757.                edited and saved but before the messages is recorded in the
  4758.                reply file.  Allows for user intervention at this point in
  4759.                processing, for such things as external spelling checkers. 
  4760.                The example here runs ShareSpell, an MS-DOS shareware spell
  4761.                checker, against all finished replies.
  4762.  
  4763.                NOTE:  INTERNAL may be specified.  This flags MR/2 to run
  4764.                its internal spelling checker against all finished replies. 
  4765.                This allows automatic access to the built-in spelling
  4766.                checker even when using an external editor.
  4767.  
  4768.           PurgeAfterCount = 200
  4769.           PurgeAfterDays = 60
  4770.  
  4771.                Control the automatic purging of ReplyLog messages.  Set
  4772.                either or both of these values to zero to supress all
  4773.                purging functions.  Purging is deactivated by default (no
  4774.                reply log purging will be performed if you don't
  4775.                specifically add these lines to an INI file).
  4776.  
  4777.                Supply a value to PurgeAfterCount to control the maximum
  4778.                number of messages kept in your reply log.  The log may from
  4779.                time-to-time contain contain slightly more messages than
  4780.                what's specified, but MR/2 will periodically adjust to this
  4781.                number by deleting the oldest, non-permanent messages.
  4782.  
  4783.                Provide a number of days to PurgeAfterDays to remove reply
  4784.                log messages after the message dates age past this point. 
  4785.                MR/2 compares the message date to the system date, and if
  4786.                the message is older that the specified number of days, it
  4787.                will be marked for deletion.  NOTE that messages marked as
  4788.                permanent will not be purged.
  4789.  
  4790.                Use the "!" key from within the message viewer to make a
  4791.                reply log message as permanent, protecting it from the
  4792.                automatic purge function.
  4793.  
  4794.  
  4795.  
  4796.  
  4797.  
  4798.           -----------------------------------------------------------------
  4799.           MR/2 User's Guide - Version 2.0                           Page 78
  4800.  
  4801.  
  4802.  
  4803.           QuoteBody="%i>",EachLine
  4804.  
  4805.                Describes how MR/2 will quote the lines of the source
  4806.                message when creating a new reply file.  The optional %i
  4807.                (which is the only parameter-type variable supported at this
  4808.                time) will be replaced by the message originator's initials. 
  4809.                The quote prefix may be placed on EachLine or on the
  4810.                "FirstLine" only (subsequent lines indented).
  4811.  
  4812.           ReassembleSplits = Ask
  4813.  
  4814.                Controls the Prompt when a reply is to be modified and it is
  4815.                found to be one part of a "split" message.  If YES is
  4816.                specified, MR/2 will automatically reassemble all the split
  4817.                parts into one single large "whole" for modifications.  If
  4818.                NO is specified, MR/2 will only bring in the one individual
  4819.                part for editing.  If ASK is specified, MR/2 prompts you for
  4820.                the desired action for each reply you request to modify.
  4821.  
  4822.  
  4823.           RemoveReplyBookmarks = No
  4824.  
  4825.                This flag, if set to YES, sets the last byte of each reply
  4826.                header back to a space before packing the replies.  Any MR/2
  4827.                bookmark information saved with replies is lost, but some
  4828.                networks may use this byte internally and any non-standard
  4829.                value here might cause problems.  Leave set to NO unless you
  4830.                determine that there is an MR/2-specific problem with your
  4831.                origin lines or end of your replies.
  4832.  
  4833.           ReplyFile=C:\Reply.Msg
  4834.  
  4835.                Temporary file name used when creating replies.  This file
  4836.                can be specified with a full path, making easier to edit it
  4837.                in a separate window.
  4838.  
  4839.           ReplyPath=g:\rep\
  4840.  
  4841.                Directory where ".Rep" reply packets are built and
  4842.                maintained.
  4843.  
  4844.           ReplyStripTagline=Yes
  4845.  
  4846.                Used only when SmartQuoting is on.  If set to YES, the
  4847.                quoting will not include the message's tag/origin lines. 
  4848.                Set this to NO to quote the entire message.
  4849.  
  4850.  
  4851.  
  4852.  
  4853.  
  4854.  
  4855.  
  4856.  
  4857.           -----------------------------------------------------------------
  4858.           MR/2 User's Guide - Version 2.0                           Page 79
  4859.  
  4860.  
  4861.  
  4862.           SaveFile=..\save.txt
  4863.  
  4864.                This is the default file to which messages are appended when
  4865.                they are "saved" or filed for later reference.  Use the "S"
  4866.                key while viewing a message to append it to this file in
  4867.                printable form.  NOTE that, if the file specification given
  4868.                contains a wildcard character (e.g., "..\*.txt"), then MR/2
  4869.                will by default show a pick-list of files matching this
  4870.                wildcard pattern.  This happens on the first pick only, the
  4871.                selected name will be the "default" until changed.
  4872.  
  4873.           SavePointerFiles = YES
  4874.  
  4875.                Controls whether or not your packets' message pointer files
  4876.                are saved.  Often a QWK packet will contain a bbsname.PTR or
  4877.                bbsname.PNT file.  These files contain the message pointers
  4878.                for the current session.  If these files are present, the
  4879.                QWK door will accept the uploading of this file in order to
  4880.                reset message pointers to the values recorded within.  This
  4881.                allows you to recover message that may have been lost due to
  4882.                a faulty or corrupt downloaded packet.  If set to YES, any
  4883.                PTR or PNT file found when a packet is opened is saved in
  4884.                the MR/2 directory (note that MR/2 will *not* overwrite an
  4885.                existing file if it is found to be newer that the packet's
  4886.                file.).
  4887.  
  4888.           SeparaterBar = Yes
  4889.  
  4890.                Specify YES if you wish a horizontal bar to appear between
  4891.                normal and custom conferences when listed for selection.
  4892.  
  4893.           SerialInTagline=Yes
  4894.  
  4895.                This option pertains only to registered copies of MR/2.  If
  4896.                you have registered and have the MR2.ID file in the MR/2
  4897.                home directory, you may set this parameter as desired. 
  4898.                Specifying "YES" (the default), tells MR/2 to include your
  4899.                registration serial number in all taglines.  Specifying "NO"
  4900.                will suppress the serial number.  In either case, registered
  4901.                users will not see the "NR" marking in their tags.
  4902.  
  4903.           ShowBBSID = Top
  4904.  
  4905.                Controls the display of the BBS ID string (Packet name, BBS
  4906.                name and conference name).  The default is TOP, which
  4907.                displays this string on the message divider bar.  You may
  4908.                specify BOTTOM, which places it in the lower left corner of
  4909.                the status line; removing the helpful hints text from view. 
  4910.                Specifying BOTH displays the string in both spots, while NO
  4911.                hides it altogether.
  4912.  
  4913.  
  4914.  
  4915.  
  4916.           -----------------------------------------------------------------
  4917.           MR/2 User's Guide - Version 2.0                           Page 80
  4918.  
  4919.  
  4920.  
  4921.           ShowEmpties = No
  4922.  
  4923.                If set to YES, all defined search conferences are listed on
  4924.                the conference selection screen.  Empty conferences are
  4925.                shown with message counts of (0).  If set to NO, empty
  4926.                "custom" conferences are not listed.
  4927.  
  4928.           ShowReadPercent=Yes
  4929.  
  4930.                Controls the packet select screen look.  Setting this to NO
  4931.                will use the old screen look (v1.57 and before) where no
  4932.                percentages and/or counts were displayed.  The default is
  4933.                yes, which gives you an expanded window and per-packet
  4934.                statistics.
  4935.  
  4936.           SkipReadMessages=No
  4937.  
  4938.                If set to YES, MR/2 will bypass any messages you've already
  4939.                read.  The problem with this option is that, if a conference
  4940.                contains only previously-read messages, then MR/2 will skip
  4941.                right out of that conference - there's no way to get back
  4942.                in.
  4943.  
  4944.  
  4945.  
  4946.  
  4947.  
  4948.  
  4949.  
  4950.  
  4951.  
  4952.  
  4953.  
  4954.  
  4955.  
  4956.  
  4957.  
  4958.  
  4959.  
  4960.  
  4961.  
  4962.  
  4963.  
  4964.  
  4965.  
  4966.  
  4967.  
  4968.  
  4969.  
  4970.  
  4971.  
  4972.  
  4973.  
  4974.  
  4975.           -----------------------------------------------------------------
  4976.           MR/2 User's Guide - Version 2.0                           Page 81
  4977.  
  4978.  
  4979.  
  4980.           SmartQuoting=YES
  4981.  
  4982.                SmartQuoting will "prewrap" the reply file that MR/2
  4983.                generates,  compensating for the user initial prefix string. 
  4984.                In other words, when you first see the reply, the original
  4985.                sender's text will be rewrapped and quoted so as to fit
  4986.                inside the WrapLinesAtColumn defined elsewhere in MR2.INI.
  4987.                Options are YES, NO or FULL.  Full is aggressive, where most
  4988.                of the text is totally rewrapped.
  4989.  
  4990.                NOTE: that existing quoted lines ARE NOT REWRAPPED.
  4991.  
  4992.           SmartWrapping=Yes
  4993.  
  4994.                SmartWrapping will change the logic used by MR/2 when the
  4995.                edited reply file is saved. If set to NO, the old wrapping
  4996.                method is used.  When left on, MR/2 will format your NEW
  4997.                text with some intelligence.  There is logic to
  4998.                differentiate between a "hard" and "soft" return, and soft
  4999.                returns will be removed if necessary.
  5000.  
  5001.                The old technique would simply insert hard returns to make
  5002.                the line fit within the declared wrap column.  The remaining
  5003.                section of the original line would often be short (one or
  5004.                two words) and look out of place, stranded on a line by
  5005.                itself.  The new technique attempts to rewrap the text as a
  5006.                whole and eliminate some of the older method's ugly results.
  5007.  
  5008.                Options are YES, NO or FULL.  Full is aggressive, where most
  5009.                of the text is totally rewrapped.  You may always keep a
  5010.                purposely-short line from triggering a "wrap" by ending it
  5011.                with the tilde "~" character.
  5012.  
  5013.                NOTE: Quoted lines ARE NOT REWRAPPED, these are always
  5014.                considered to be prefixed and terminated by hard returns.
  5015.  
  5016.           SortMasterConferences=Yes
  5017.  
  5018.                The master conference list is stored as found in the BBS's
  5019.                control file.  If this parameter is omitted or set to NO,
  5020.                this list is displayed in its default order.  If YES is
  5021.                specified here, the list is sorted alphabetically by
  5022.                conference name.  NOTE:  This is the MASTER conference list
  5023.                (i.e., "Write New" message list).
  5024.  
  5025.           SplitLongReplies=Yes
  5026.  
  5027.                MR/2 will split replies into "multiple" message at somewhere
  5028.                around 92 lines if left at YES.  Set to NO, no splitting is
  5029.                performed.  ALTERNATIVELY, you may specify a number here,
  5030.                which will be the equivalent of saying "YES", but sets the
  5031.                split at count to whatever you specify.
  5032.  
  5033.  
  5034.           -----------------------------------------------------------------
  5035.           MR/2 User's Guide - Version 2.0                           Page 82
  5036.  
  5037.  
  5038.  
  5039.           String =  MR/2\MR2\MR-2
  5040.  
  5041.                This parameter is used only in conjunction with the INI
  5042.                parameter "MakeConference".  It is one of the options
  5043.                available in defining a virtual conference.  This variable
  5044.                is to tell MR/2 text search criteria you wish to include in
  5045.                the conference.  The example above includes any message
  5046.                found to contain the string "MR/2", "MR2" or "MR-2".
  5047.  
  5048.                If not supplied as part of the virtual conference
  5049.                definition, all message will be included.  This is handy,
  5050.                when used with the CONFERENCES keyword to specify specific
  5051.                conference numbers, for combining several smaller
  5052.                conferences into a single, easier-to-read conference.
  5053.  
  5054.                See SEARCH.INI for various other examples of how this is
  5055.                used.
  5056.  
  5057.           SuppressVersionInTagline = NO
  5058.  
  5059.                This controls tagline generation for registered users only. 
  5060.                Specifying YES here will create taglines without the MR/2
  5061.                version number.  You may also suppress the serial number by
  5062.                setting SerialInTag to NO.  These two switches together will
  5063.                cause an MR/2 signature like: " * MR/2 * Tagline goes here"
  5064.  
  5065.           Tagline=@OS2.Tag
  5066.           Tagline=A QWK compatible mail reader for OS/2
  5067.  
  5068.                This sets the default tagline for MR/2 replies.  A single
  5069.                tagline can be "fixed" for all messages (example #2, above),
  5070.                or a file of taglines can be accessed and "rotated"
  5071.                automatically (example #1 - the "@" symbol tells MR/2 to get
  5072.                taglines from the file name following it).  With rotating
  5073.                taglines from a file, each message seems to receive a
  5074.                different tagline.
  5075.  
  5076.                A tagline is a humorous or interesting phrase placed at the
  5077.                bottom of each reply.
  5078.  
  5079.           TagMode=RANDOM
  5080.  
  5081.                This sets the tagline file access method.  RANDOM will skip
  5082.                around and randomly select the next tagline.  SEQUENTIAL
  5083.                will perform a RANDOM seek when MR/2 is first loaded, then
  5084.                move sequentially through the file after that.
  5085.  
  5086.  
  5087.  
  5088.  
  5089.  
  5090.  
  5091.  
  5092.  
  5093.           -----------------------------------------------------------------
  5094.           MR/2 User's Guide - Version 2.0                           Page 83
  5095.  
  5096.  
  5097.  
  5098.           TagStyle=PCBoard,Autosense
  5099.           TagStyle=Fido
  5100.           TagStyle=TwoLine
  5101.  
  5102.                This option has been around for a long time; just never
  5103.                documented.  This controls the type of tearline and tagline
  5104.                characters used. If set to PCBoard (just now changed to the
  5105.                default), you get the customary three dashed followed by the
  5106.                MR/2 identifier surrounded by hi-end ASCII characters "■". 
  5107.                If set to Fidonet mode, underlines replace the dashes, and
  5108.                "*"'s are used as delimiters.
  5109.  
  5110.                Twoline mode uses a more unique format that allows longer
  5111.                taglines.  The keyword AutoSense, when it exists, tells MR/2
  5112.                to determine if the reply is to a Fidonet-sourced message. 
  5113.                If it is, then Fidonet mode is invoked.  Otherwise, PC-Board
  5114.                style tags are used.
  5115.  
  5116.           TemplateFile=..\template.tf
  5117.  
  5118.                This is a template file used in the creation of your
  5119.                replies.  When you reply to any message, MR/2 will format
  5120.                the reply as defined by this file.  This allows for the
  5121.                creation of attribution and signature lines.  Variables are
  5122.                available for accessing source message and system data
  5123.                (e.g., FROM and DATE).  See the read.me file and/or MR2.doc
  5124.                for more details.
  5125.  
  5126.           ThreadChangeTone=20000,10
  5127.  
  5128.                May be used to tell MR/2 to make a tone while paging through
  5129.                messages, when the "thread" changes.  Uncomment the line and
  5130.                play with the numbers - let me know how useful this is to
  5131.                you :)
  5132.  
  5133.           UnZipper=pkunzip -o
  5134.  
  5135.                These are the commands used to archive and unarchive your
  5136.                message packets.  If you use something other than
  5137.                PKZip/UnZip, modify these commands appropriately.
  5138.  
  5139.           V0 = Variable assignment 0
  5140.           V1 = Variable assignment 1
  5141.  
  5142.                For use with templates, you can assign or reassign the value
  5143.                of 10 user-defined variables.  Set V0 through V9 to any text
  5144.                string you might find handy.  These strings can then be
  5145.                placed in any template file line.  When a template line
  5146.                using one of these variables is accessed, the variable
  5147.                (e.g., @V0@) will be replaced with the string you have
  5148.                assigned to it.
  5149.  
  5150.  
  5151.  
  5152.           -----------------------------------------------------------------
  5153.           MR/2 User's Guide - Version 2.0                           Page 84
  5154.  
  5155.  
  5156.  
  5157.           VideoMode=25
  5158.  
  5159.                Specifies the number of lines/screen the display will be set
  5160.                to upon entering MR/2.  Possibilities are: 25, 28, 34, 40,
  5161.                43, 50 or 60.  You may also toggle through these when on the
  5162.                packet selection screen by pressing ALT-V.
  5163.  
  5164.           WrapLinesAtColumn=80
  5165.  
  5166.                This keeps lines within reasonable lengths.  Using the
  5167.                system "E" editor with word-wrap mode causes some problems. 
  5168.                The text appears to wrap on-screen, but MR/2 has no way of
  5169.                knowing where the editor has determined the wrap should be. 
  5170.                With this option set, lines are word wrapped at this column,
  5171.                avoiding truncated messages.
  5172.  
  5173.           Zipper=pkzip
  5174.  
  5175.                These are the commands used to archive and unarchive your
  5176.                message packets.  If you use something other than
  5177.                PKZip/UnZip, modify these commands appropriately.
  5178.  
  5179.  
  5180.  
  5181.  
  5182.  
  5183.  
  5184.  
  5185.  
  5186.  
  5187.  
  5188.  
  5189.  
  5190.  
  5191.  
  5192.  
  5193.  
  5194.  
  5195.  
  5196.  
  5197.  
  5198.  
  5199.  
  5200.  
  5201.  
  5202.  
  5203.  
  5204.  
  5205.  
  5206.  
  5207.  
  5208.  
  5209.  
  5210.  
  5211.           -----------------------------------------------------------------          ----------------------------------------------------------------- 
  5212.           MR/2 User's Guide - Version 2.0                           Page 85          MR/2 User's Manual - Table of Contents                    Page 85
  5213.  
  5214.  
  5215.  
  5216.           CONTACTING THE AUTHOR
  5217.           =====================
  5218.  
  5219.           You can contact me in a number of ways.  Unfortunately, I can't
  5220.           provide a phone number at this time.
  5221.  
  5222.                US Mail:       Nick Knight
  5223.                               1823 David Ave.
  5224.                               Parma, Ohio 44134
  5225.  
  5226.                Fido netmail:  1:157/2 to "Nick Knight"
  5227.  
  5228.                Internet:      User "Nick Knight", (nick.knight@pcohio.com)
  5229.  
  5230.                Rime:          Address private routed mail to "Nick Knight"
  5231.                               and place it in Rime's OS/2 or OFFLINE
  5232.                               conference.  The top line of the message
  5233.                               should contain the address "->1869", which is
  5234.                               the routing information for the PC-Ohio BBS.
  5235.  
  5236.                Fido Echomail: Find the Fidonet OS2PRODSUPPORT conference.
  5237.                               Echomail messages to  me in more general
  5238.                               conferences are discouraged, as keeping them
  5239.                               "on  topic" and interesting to the masses
  5240.                               would be difficult.  I do read OS2, OS2PROG,
  5241.                               C_PLUSPLUS and DR DEBUG daily, though.
  5242.                               OFFLINE echo also (deals with mail readers), 
  5243.                               this might be THE place to ask public
  5244.                               questions, eh?
  5245.  
  5246.                               I recently have acquired access to a host of
  5247.                               other networks with OS/2 conferences.  These
  5248.                               include RIME, SmartNet, Uninet, Intelec,
  5249.                               Nanonet, Racenet and some others I can't
  5250.                               remember.
  5251.  
  5252.                Direct BBS:    Leave a message on the Nerd's Nook BBS
  5253.                               (1:157/2) at (216) 356-1772, 356-1872 or
  5254.                               356-1431.  I check in here multiple times a
  5255.                               day.  I will also keep the most recent copy
  5256.                               of MR/2 posted here.  Other boards
  5257.                               (non-local) will get updates at my
  5258.                               convenience.
  5259.  
  5260.                               Nerd's does support Fidonet file requests
  5261.                                    (157/2 or 157/3)
  5262.  
  5263.                               Optionally, I call into PC-OHIO regularly.
  5264.  
  5265.                Compuserve:    I check in here only when I have to.  Try
  5266.                               mail to my user ID - 76066,1240, although
  5267.                               this isn't the best approach.
  5268.  
  5269.  
  5270.           -----------------------------------------------------------------
  5271.           MR/2 User's Guide - Version 2.0                           Page 86
  5272.  
  5273.  
  5274.  
  5275.           REGISTERING MR/2
  5276.           ================
  5277.           To register MR/2, simply print out this form, fill it in, and
  5278.           mail it along with a check for $25 US (add $1.00 for orders
  5279.           outside the US and Canada) made out to "Nick Knight".  Checks
  5280.           from Canadian banks must include an extra $7 to cover exchange
  5281.           costs (CA $32 total).  CHARGE CARDS CAN NOW BE USED!  Fill out
  5282.           the "charge it" section below.  Send to:
  5283.                               Nick Knight
  5284.                               1823 David Ave.
  5285.                               Parma, Ohio 44134
  5286.  
  5287.           Name:   _______________________________________________________
  5288.  
  5289.           Address:  _____________________________________________________
  5290.  
  5291.                     _____________________________________________________
  5292.  
  5293.           City/State:                           _________________________
  5294.  
  5295.           Phone (optional)
  5296.                  Home:    ____________________    Work:  ________________
  5297.  
  5298.  
  5299.           EMail addresses: ____________________________________________
  5300.  
  5301.  
  5302.           Where did you get your copy of MR/2?: ______________________
  5303.  
  5304.  
  5305.           What version are you using? ________________ Editor?___________
  5306.  
  5307.           *********     CHARGE IT to your Visa/Mastercard!    ************
  5308.  
  5309.           We are  now participating in  the OS/2  Shareware Author  Support
  5310.           Program being implemented by the GREATER CHICAGO Online!! BBS.
  5311.  
  5312.           Register online by  dialing the BBS at (708) 895-4042  or mail in
  5313.           your charge card information to me.
  5314.  
  5315.           **There is a 10% surcharge added for all charge registrations.**
  5316.  
  5317.               US orders: $27.50    Non domestic orders: $28.60
  5318.  
  5319.               Name on card:      _______________________________________
  5320.  
  5321.               Card Number:       _______________________________________
  5322.  
  5323.               Expiration Date:   __________    [ ] Mastercard     [ ] Visa
  5324.  
  5325.  
  5326.  
  5327.  
  5328.  
  5329.           -----------------------------------------------------------------
  5330.           MR/2 User's Guide - Version 2.0                           Page 87
  5331.