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