home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / PMQWK008.LZH / PmQWK.Doc < prev    next >
Text File  |  1993-04-22  |  45KB  |  985 lines
  1.                                      Oberon PMQWK Offline Mailreader
  2.                                  ** BETA ** Version 1.00, Release #7
  3.                                                     19 January, 1993
  4.  
  5.                                                      Oberon Software
  6.                                                518 Blue Earth Street
  7.                                           Mankato, MN 56001-2142 USA
  8.  
  9.                                                  Voice: 507-388-7001
  10.                                                  Fax:   507-388-7568
  11.                                                  BBS:   507-388-1154
  12.  
  13.                                             Fidonet:        1:292/60
  14.                                            MCI Mail: oberon/413-5847
  15.                                                 CIS:      72510,3500
  16.                                               GEnie:       B.FLOWERS
  17.  
  18. NOTE:
  19. Except for this note, this file has not been updated since the previous 
  20. version of PmQwk.  Please see the online help file for any new information, 
  21. and the whats.new file for new features.
  22.  
  23.  
  24.                         ** CAUTION ***
  25.  
  26. The accompanying software is a BETA TEST version.  It is NOT
  27. guaranteed to be complete or free from defects.  This software and
  28. documentation are subject to change and do not in anyway imply a
  29. commitment on the part of Oberon Software or the author.
  30.  
  31. If you use this software, you do so at your own risk.  Oberon
  32. Software will not be liable for any losses or damages to property,
  33. data, time, or business which arise as the direct or indirect result
  34. of the use, misuse, or failure to be able to use this software or
  35. documentation.  Your acceptance of these terms is implied by your use
  36. of this software and documentation.
  37.  
  38. Although this is a BETA TEST version, Oberon Software has released
  39. this version for wide distribution.  All of the above disclaimers
  40. apply and you are cautioned to not use this software if you do not
  41. agree to the disclaimers in this file.  Your use of this software
  42. will imply your acceptance.  You are free to distribute this package
  43. as you would any other shareware program under the provision that
  44. no changes are made in any way to the software or the accompanying
  45. documentation and that the entire package, complete with this
  46. documentation is distributed together as a unit.
  47.  
  48. If, while using this software, you should discover any program errors
  49. or omissions which are not otherwise mentioned in this document
  50. (please read "Features and Functions Absent in this BETA TEST
  51. Version" below before submitting a problem report), please contact
  52. Kimberly Bobrow at Oberon Software by one of the methods given below
  53. and alert us to the existence of the problem so that it may be
  54. corrected.  If the problem results in a system error popup (i.e., a
  55. TRAP 000D or other system trap) please make note of the values of
  56. "CS" and "IP" from the system error display.  Also, please indicate
  57. the version and release number of the software which experienced the
  58. problem.
  59.  
  60.   ┌────────────────────────────────────────────────────────────────┐
  61.   │ Contact for bug reports and enhancements requests:             │
  62.   │                                                                │
  63.   │   Oberon BBS or OS/2 Shareware BBS to Kimberly Bobrow          │
  64.   │   Fidonet to Kimberly Bobrow at either 1:109/347 or 1:292/60   │
  65.   │   Internet to kimberly.bobrow@f347.n109.z1.fidonet.org         │
  66.   │   Voice phone: 212-465-3367                                    │
  67.   └────────────────────────────────────────────────────────────────┘
  68.  
  69.  
  70.                       **** CONTENTS ****
  71.  
  72.         Caution
  73.  
  74.         I. Overview
  75.  
  76.         II. Installation
  77.           A. Files
  78.           B. First time startup
  79.             1. Paths and Options
  80.             2. Your first QWK packets
  81.  
  82.         III. Using PMQWK
  83.           A. Unpacking QWK packets
  84.           B. Reading messages
  85.             1. The "List" function
  86.             2. The "Copy" function
  87.             3. The "Replies" conference
  88.           C. Replying to messages
  89.             1. The editor
  90.               a. Word Wrap
  91.             2. Messages which are not replies
  92.           D. Packaging replies for upload
  93.           E. The Address Book
  94.             1. Copying information to the Envelope window
  95.           F. Options
  96.             1. Fonts
  97.             2. Colors
  98.             3. Paths
  99.             4. Editor
  100.             5. Preferences
  101.               a. Beep on personal messages
  102.               b. Attribute quotes
  103.               c. Wrap Column for Quotes
  104.               d. Prepend "Re:" to response subject lines
  105.               e. Strip existing "Re:" from subject lines
  106.               f. Prev/Next buttons on right in message reader
  107.               g. Use Taglines
  108.               h. Use PMQWK Cutline
  109.               i. Show only active conferences
  110.             6. Save options
  111.             7. Icons
  112.  
  113.  
  114.                         **************
  115.  
  116. I.   Overview
  117.  
  118. PMQWK is a 32-bit, Presentation Manager (tm) based program for use
  119. with OS/2 version 2.0 or later.  Its purpose is to facilitate the
  120. reading and reply process for messages downloaded from bulletin
  121. boards and other sources which employ the "QWK" format for mail
  122. packets.
  123.  
  124. You may use PMQWK to:
  125.  
  126.   Unpack new QWK mail packets which have been downloaded from a
  127.   bulletin board or other service into a format which is readable
  128.   by PMQWK.  QWK packets from any arbitrary number of bulletin
  129.   boards or services may be examined simultaneously.
  130.  
  131.   Read your unpacked messages.  Each bulletin board or service may
  132.   transmit any number of messages, grouped into 'conferences', and
  133.   all are handled via a tree-like mechanism within PMQWK. Any number
  134.   of conferences for any number of bulletin boards may be opened
  135.   simultaneously within PMQWK.
  136.  
  137.   Reply to any message or enter new messages into a conference and
  138.   prepare them for retransmission to the bulletin board or service.
  139.   PMQWK handles such things as quoting the original message,
  140.   attributing quotes, maintaining reply links and other bookkeeping
  141.   details while you use the editor of your choice to edit the replies
  142.   or messages.
  143.  
  144.   Entire messages or portions of messages may be saved to alternate
  145.   files either directly or via the system clipboard or may be
  146.   integrated via the clipboard into other documents or files.
  147.  
  148.   Pack replies and messages into a format suitable for
  149.   retransmission to the bulletin board or service.
  150.  
  151.   PMQWK currently supports the following compression programs for
  152.   purposes of packing and unpacking mail packets: PKZIP2 (and PKUNZIP2),
  153.   LH2 (LHArc for OS/2) and ARC2 (SEA ARC for OS/2).  More will be
  154.   added in the near future.
  155.  
  156.  
  157. PMQWK will NOT do the following:
  158.  
  159.   Upload or download QWK mail packets to and from the bulletin boards
  160.   and/or on-line services.  A separate telecommunications program is
  161.   required for this purpose.  We recommend Oberon Software's Terminal
  162.   Emulator/2 (TE/2) as a good, general purpose, terminal program for
  163.   use with PMQWK and with OS/2 in general.
  164.  
  165.   Pack or unpack QWK mail packets without the presence of at least
  166.   one archiving program on your system.  Archiving schemes are, in
  167.   some cases, proprietary to the vendor of the archiving software and,
  168.   in almost all cases, subject to change at the vendors discretion.
  169.   For this reason, PMQWK relies on the presence of one or more of the
  170.   following programs on your system: PKZIP (and PKUNZIP) from PKWare,
  171.   LH2 (LHArc for OS/2), or ARC2 from System Enhancement Associates.
  172.   (PLEASE NOTE: the INFOZIP utilities for zipping and unzipping files
  173.   do NOT work correctly with PMQWK as they lack a key command line
  174.   feature which PMQWK requires.  Oberon Software has developed a
  175.   small utility which will be of assistance in working with these
  176.   programs however.  Beginning with PMQWK Beta #7 ZFRONT.EXE is
  177.   packaged with PMQWK; refer to the file ZFRONT.DOC for further
  178.   information regarding using ZFRONT.)
  179.  
  180.   PMQWK does not include a built-in message editor.  Most everyone
  181.   has his or her favorite text editor and, at the very least, all
  182.   installations of OS/2 should have E.EXE. PMQWK will use E.EXE by
  183.   default but you may specify the editor of your choice and it will
  184.   be automatically invoked for you.
  185.  
  186.  
  187. Features and Functions absent in this BETA TEST Version:
  188.  
  189.   *******************************************************************
  190.   This version of PMQWK is tested on OS/2 2.0 "GA" and OS/2 2.0
  191.   with the Service Pack (XR6055) installed only.  We have experienced
  192.   problems running this version of PMQWK under the OS/2 2.1 BETA
  193.   release dated 12/9/92 and do NOT recommend using it in this
  194.   environment until we have determined the cause of these problems.
  195.   The March beta seems to have cleared up the problems.
  196.   *******************************************************************
  197.  
  198.   Paths are not checked for validity in the "Paths" dialog nor are
  199.   the specified archive programs checked for validity at this point.
  200.   The paths and programs ARE checked for existence and/or validity
  201.   before an attempt is made to use any of these however.  This feature
  202.   will be enabled before General Release.
  203.  
  204.   Memory allocation checking is not complete in this version of
  205.   PMQWK.  It is possible to "run out of memory" by opening too many
  206.   conferences and cause PMQWK to abend with a protection violation.
  207.   Define "too many conferences" in the vicinity of ten or more.  This
  208.   feature will be made bulletproof before General Release.
  209.  
  210.   The Color Settings dialog is not fully functional in this release;
  211.   it is not possible to change the color of highlighted text in
  212.   message displays although the setting for it appears in the dialog.
  213.   This feature may or may not be enabled before General Release.
  214.  
  215.   The settings for PMQWK allow you to specify paths for ZOO and UNARJ
  216.   as packer/unpackers but neither of these programs are supported for
  217.   actual use by this release of PMQWK.
  218.  
  219.   An automated setup procedure will be added before General Release.
  220.  
  221.   The current method of setting personalized icons for BBSes and
  222.   conferences is completely manual and infers a certain amount of
  223.   skill with the file system on the part of the user.  This procedure
  224.   will be automated and simplified.
  225.  
  226.   PMQWK will not always sense when an archiving program has problems
  227.   packing or unpacking a file.  If a new packet is mysteriously
  228.   creating problems, try unpacking the QWK packet by hand to see if
  229.   it might be a damaged file.  Error checking here will be made
  230.   more robust before General Release.
  231.  
  232.   Because this is a BETA TEST release, we expect that you may
  233.   encounter other program omissions or errors.  Please alert Oberon
  234.   Software to these problems as you encounter them.
  235.  
  236.   ┌────────────────────────────────────────────────────────────────┐
  237.   │ For bug reports and enhancements requests:                     │
  238.   │                                                                │
  239.   │   Oberon BBS or OS/2 Shareware BBS to Kimberly Bobrow          │
  240.   │   Fidonet to Kimberly Bobrow at either 1:109/347 or 1:292/60   │
  241.   │   Internet to kimberly.bobrow@f347.n109.z1.fidonet.org         │
  242.   │   Voice phone: 212-465-3367                                    │
  243.   └────────────────────────────────────────────────────────────────┘
  244.  
  245.  
  246. Other important notes and considerations:
  247.  
  248.   As mentioned above, the INFOZIP packing and unpacking utilities
  249.   require use of the included program ZFRONT.EXE for use with PMQWK.
  250.   See ZFRONT.DOC for details.
  251.  
  252.   Certain editors will cause problems with PMQWK.  The OS/2 Enhanced
  253.   Editor (EPM.EXE) will work correctly with PMQWK if and only if
  254.   there are no other copies of EPM running on your machine at the
  255.   time you begin an edit session via PMQWK (this includes other PMQWK
  256.   edit sessions).  The IBM IUO editor, LXPM, does not function
  257.   correctly for use with PMQWK.
  258.  
  259.   If you have used an earlier (16-bit) beta version of PMQWK, you MUST
  260.   delete your PMQWK.INI file before running this version and then use
  261.   the current version to reset your options.
  262.  
  263.  
  264. II.  Installation
  265.  
  266.   A. Files
  267.  
  268.   For best results, a dedicated directory should be made for PMQWK.
  269.   We suggest that you make a directory, on the disk of your choice,
  270.   by the name PMQWK and copy PMQWK.EXE and TagLines.txt into that
  271.   directory.  You should ensure that this directory is your current
  272.   working directory while you are running PMQWK as PMQWK will maintain
  273.   subdirectories for each bulletin board underneath this directory.
  274.  
  275.   Copy the file REGEXPUT.DLL into a directory named in the LIBPATH
  276.   statement from your CONFIG.SYS.
  277.  
  278.   Install PMQWK into PM or WPS as you deem fit.  As mentioned above,
  279.   you should ensure that the directory containing PMQWK.EXE is the
  280.   designated "Working Directory" for executing PMQWK however.
  281.  
  282.   B. First time startup
  283.  
  284.     1. Paths and Options
  285.  
  286.   You may start PMQWK from the OS/2 command line by first ensuring
  287.   that the disk and directory containing PMQWK are current and typing
  288.   "PMQWK" at the system prompt.  If you have installed PMQWK into
  289.   your desktop setup (following the rules for current directory) you
  290.   may start it that way.
  291.  
  292.   Example batch file for starting PMQWK assuming that it is installed
  293.   in to directory 'D:\PMQWK':
  294.  
  295.     @echo off
  296.     D:
  297.     CD \PMQWK
  298.     START /PM /N PMQWK
  299.  
  300.   Example of the first page of the 'Settings' Notebook for a PMQWK
  301.   installation assuming that it is installed into directory
  302.   'D:\PMQWK':
  303.  
  304.    ┌──┬──────────────────────────────────────────────────────┬──┬──┐
  305.    │  │ PMQWK Offline Mail Reader - Settings                 │  │  │
  306.    ├──┴──────────────────────────────────────────────────────┴──┴──┤
  307.    │┌────────────────────────────────────────────────┐             │
  308.    ││                                                │┐            │
  309.    ││                                                ││┐           │
  310.    ││                                                │Program      │
  311.    ││                                                ││││          │
  312.    ││                                                ││Session     │
  313.    ││ Required                                       ││││          │
  314.    ││   Path and file name:                          │││Assocation │
  315.    ││   ┌───────────────────────┐   ┌───────┐        ││││          │
  316.    ││   │D:\PMQWK\PMQWK.EXE     │   │Find...│        ││││General   │
  317.    ││   └───────────────────────┘   └───────┘        ││││          │
  318.    ││                                                ││││          │
  319.    ││ Optional                                       ││││          │
  320.    ││   Parameters:                                  ││││          │
  321.    ││   ┌───────────────────────────────────┐        ││││          │
  322.    ││   │                                   │        ││││          │
  323.    ││   └───────────────────────────────────┘        ││││          │
  324.    ││   Working directory:                           ││││          │
  325.    ││   ┌───────────────────────────────────┐        ││││          │
  326.    ││   │D:\PMQWK                           │        ││││          │
  327.    ││   └───────────────────────────────────┘        ││││          │
  328.    ││                                                ││││          │
  329.    ││ ┌───────┐   ┌───────┐                          ││││          │
  330.    ││ │ Undo  │   │ Help  │                          ││││          │
  331.    ││ └───────┘   └───────┘                          ││││          │
  332.    ││                                             < >││││          │
  333.    │└────────────────────────────────────────────────┘│││          │
  334.    │ └────────────────────────────────────────────────┘││          │
  335.    │  └────────────────────────────────────────────────┘│          │
  336.    │   └────────────────────────────────────────────────┘          │
  337.    │                                                               │
  338.    │                                                               │
  339.    └───────────────────────────────────────────────────────────────┘
  340.  
  341.  
  342.  
  343.   Immediately upon entering PMQWK for the first time, select the menu
  344.   item labeled "Options" and the submenu item labeled "Paths".  Set
  345.   the following items:
  346.  
  347.     Inbound QWK Packets: set this item to the name of the directory
  348.     in which new QWK packets will appear after they have been
  349.     downloaded from the BBS or on-line services.  In general, this
  350.     will be the download directory which your telecommunications
  351.     program uses although you may wish to create a new directory
  352.     specifically for this purpose and move QWK packets into this
  353.     directory by other means after they have been downloaded. [NOTE:
  354.     in this version of PMQWK the validity of this path is NOT checked
  355.     at this point.]
  356.  
  357.     Outbound Reply Packets: set this item to the name of the
  358.     directory where you wish PMQWK to deposit packaged reply packets
  359.     to be uploaded back to the BBS or on-line service.  In general,
  360.     this will be a directory in which your telecommunications
  361.     program expects to find files for upload.  [NOTE: in this version
  362.     of PMQWK the validity of this path is NOT checked at this point.]
  363.  
  364.  
  365.     Packers and Unpackers: fill in as many of these as are applicable
  366.     with the drive, path, and name of the appropriate archiving
  367.     program or programs.  If they exist in a directory referred to in
  368.     your PATH environment variable, you may omit the drive and path
  369.     specification and give only the name of the program file.  [NOTE:
  370.     in this version of PMQWK, these programs names and paths are NOT
  371.     checked for validity at this point. FURTHER NOTE: in this version
  372.     of PMQWK, only the first three archivers are supported:
  373.     PK(UN)ZIP, ARC, and LH.  Entries exist for ARJ and ZOO for future
  374.     use only, they are not used by this version of PMQWK.]
  375.  
  376.  
  377.   [General note for beta release version: the previous three items
  378.   have disclaimers stating that validity on these items are not
  379.   checked during this dialog.  The validity IS checked later at
  380.   appropriate points.  If your "InBound" path is invalid or if you
  381.   have specified no valid archiver programs, PMQWK will find nothing
  382.   suitable for unpacking when that option is selected.  If your
  383.   "OutBound" path is invalid, PMQWK will default to the current
  384.   directory for this function after alerting you to the problem.  If
  385.   no valid archivers have been specified by the time you select the
  386.   option to package reply packets, PMQWK will alert you to the
  387.   problem.]
  388.  
  389.   [Further note: As mentioned above, the INFOZIP utilities for
  390.   zipping and unzipping files are not supported in this release of
  391.   PMQWK.]
  392.  
  393.   After setting the paths, you may investigate the other items on the
  394.   "Options" menu for setting your favorite editor as default, setting
  395.   colors and fonts, and other options or you may leave these settings
  396.   for later.
  397.  
  398.   After setting at least your "Paths", select "Save Options" from the
  399.   "Options" menu and your setup will be saved. [Technical note:
  400.   options are not saved in the system files; a file named PMQWK.INI
  401.   will be made in the same directory as PMQWK.EXE.]  If you attempt
  402.   to exit PMQWK before you have saved your options, PMQWK will query
  403.   you for this.
  404.  
  405.  
  406.     2. Your first QWK packets
  407.  
  408.   If you do not have any QWK packets available, you must first access
  409.   a bulletin board or on-line service and obtain at least one QWK mail
  410.   packet.
  411.  
  412.   Make sure that all QWK mail packet in which you are interested are
  413.   in the directory which you specified as your "InBound" path above.
  414.  
  415.   If you have exited PMQWK, restart the program now.
  416.  
  417.   Select "Unpack QWK Packet" from the menu.  A dialog will appear
  418.   listing the valid QWK packets which were found in your "InBound"
  419.   directory.  Select the packet in which you are interested and press
  420.   the OK button.  The QWK packet will be unpacked and the name of the
  421.   BBS should appear now in the "BBS List" window.  Repeat this
  422.   procedure for all packets which you wish to unpack.
  423.  
  424.   [Note: the first time you start PMQWK with a valid "InBound" path,
  425.   or the first time you select "Unpack QWK Packet" with a valid
  426.   "InBound" path, there may be some delay as PMQWK scans the inbound
  427.   directory for the first time.  This delay will only be significant
  428.   if there are many files matching the pattern "*.qw*" in that
  429.   directory.  Only "new files" are scanned so the delay should not
  430.   be significant on subsequent invocations.]
  431.  
  432.  
  433. III. Using PMQWK
  434.  
  435.   A. Unpacking QWK packets
  436.  
  437.   Make sure that any and all QWK packets in which you are interested
  438.   are located in the directory which you specified as your "InBound"
  439.   path (see section II.B.1 above).  Select "Unpack QWK Packet" from
  440.   the menu or press the "Unpack" button in the "BBS List" dialog
  441.   window.  You will be presented with a list of valid QWK packets
  442.   which PMQWK was able to locate in your "InBound" directory.  Select
  443.   one to unpack either by double clicking on the file name and info
  444.   or by selecting it and pressing the "OK" button.  The packet will
  445.   now be unpacked (if you are about to overwrite another packet,
  446.   you will be given to opportunity to abort the action).  Repeat this
  447.   procedure for every QWK packet you wish to unpack.
  448.  
  449.   If you have never unpacked a packet from this source before, a new
  450.   item will appear in the "BBS List" window at this point.
  451.  
  452.  
  453.   B. Reading messages
  454.  
  455.   To begin the process of reading messages, first select a BBS from
  456.   the "BBS List" window (if this list is empty, you must first unpack
  457.   at least one QWK packet! See "Unpacking QWK packets" above).  After
  458.   selecting a BBS, another dialog will appear which will list the
  459.   available conferences for that BBS.  Conferences which contain
  460.   messages will be indicated with a '+' sign in this list while empty
  461.   conferences will have a '-' as the first character.  Each
  462.   conference also has an indication, in parentheses, of how many
  463.   message are available and your "current position" in the list.  For
  464.   example:
  465.  
  466.                 +4/Netmail (5/15)
  467.  
  468.   indicates that area #4, called "Netmail" has messages, that it has
  469.   fifteen messages and that you will enter viewing the fifth message.
  470.  
  471.   Please note that, by default, areas which contain no messages (and
  472.   would thus have a '-' as the first character in their listing, are
  473.   not shown at all.  To enable their visibility, use the
  474.   "Preferences" dialog and toggle the checkbox labeled "Show only
  475.   active conferences" to OFF.
  476.  
  477.   When you select a conference to view, you will be presented with a
  478.   window which contains a "message header" at the top of the window,
  479.   a scrollable region in the central area containing the message
  480.   text, and a set of buttons at the bottom of the window for
  481.   initiating various activities.
  482.  
  483.   The "message header" contains the following information: the
  484.   message number, the number of the message it refers to (if any),
  485.   the position in the list of messages (in our example above, it
  486.   would read "#5 of 15"), the sender's name, the addressee's name, the
  487.   subject of the message, its time and date stamp, whether it is
  488.   a private or public message, and whether the bulletin board has
  489.   marked this message as "Seen by you" or not.  If this is a net
  490.   mail message, the sender's net address will be given after his/her
  491.   name in parentheses.
  492.  
  493.   Most of the activities are self-explanatory: "Next" and "Prev" will
  494.   view the next and previous message in the conference respectively,
  495.   "Quit" closes the window, "Help" invokes the help display (NOTE:
  496.   "Help" is NOT active in this BETA release!).  "Reply" and "Enter"
  497.   will invoke the reply editor (see "Replying to messages" below) the
  498.   difference being that "Reply" will preset much of the reply header
  499.   information with data from the current message while "Enter" will
  500.   begin the creation of a new, unrelated (as least as far as the QWK
  501.   format is concerned) message.  The other two functions deserve a
  502.   little more information which follows immediately.
  503.  
  504.  
  505.     1. The "List" function
  506.  
  507.   This invokes a dialog window which, initially contains a list of
  508.   all messages in the area, their message number, subject, sender,
  509.   receiver, and time/date.  Messages addressed to you are marked with
  510.   an asterisk "*".  You may select a message from this list and press
  511.   the "OK" button to go immediately to that message.
  512.  
  513.   The "Filter" button in this dialog allows you to view a subset of
  514.   the messages in the list.  You may search for text in "envelope"
  515.   fields (Sender, Receiver, and Subject) or in the message body
  516.   itself.
  517.  
  518.   The filtering is for purposes of the "List" dialog only, it does
  519.   not affect the behavior of the message window at all (except as
  520.   regards jumping to a message).
  521.  
  522.  
  523.     2. The "Copy" function
  524.  
  525.   You may mark areas within the message text using the mouse pointer
  526.   and copy them to the system clipboard using CONTROL+INSERT or you may
  527.   use the "Copy" dialog.  This dialog allows you to refine how you
  528.   export the data to a greater degree.  You may chose to copy the
  529.   entire message or just the marked area (if any), you may optionally
  530.   include header information about the message in the export, and you
  531.   may copy it directly to a file or to the system clipboard.
  532.  
  533.  
  534.     3. The "Replies" conference
  535.  
  536.   There is one extra, pseudo-conference which appears at the
  537.   beginning of each BBS's conference list named "Replies".  This is
  538.   where all of your entered messages and replies will be kept until
  539.   they are packed for retransmission to the BBS.  It behaves in most
  540.   ways exactly like a "normal" message window. However, the "Reply" and
  541.   "Enter" functions are replaced with "Edit" and "Delete".  "Edit"
  542.   will allow you to reedit the message, possibly just the "envelope"
  543.   information or the entire message text, while "Delete" will erase
  544.   the currently viewed reply.
  545.  
  546.   If this is a netmail message, the Receiver's net address will
  547.   appear in parentheses after his/her name.
  548.  
  549.  
  550.  
  551.   C. Replying to messages
  552.  
  553.   To reply to a message, simply invoke the "reply" button while you
  554.   are viewing the message in question.  The message will be placed
  555.   into a file in "quoted" form and your editor will be invoked on
  556.   that file.  You may edit any part of this file and/or append to the
  557.   file.  While your editor is in the process of editing the reply, a
  558.   new icon will appear in the main client window. "Active Edit
  559.   Sessions" contains a list of all current invocations of the editor
  560.   and a button which will allow you immediately switch to any of the
  561.   listed editor sessions.
  562.  
  563.   When you finish editing your reply, you will be returned to PMQWK
  564.   and given the opportunity to edit the "Envelope" information.  This
  565.   will already have your name, the receivers name, net address (if
  566.   applicable), the conference for the message, and the subject filled
  567.   in.  You may edit any of these items except your own name.  If
  568.   "TagLines" are enabled (see "Options") you may select a tagline to
  569.   use from this dialog.
  570.  
  571.   If you press "OK" and all of the required fields are filled in, the
  572.   reply will be saved.  If you press "Cancel" the message will be
  573.   discarded after you confirm that this is your desire.
  574.  
  575.   Should you need to reedit a reply message or delete a reply message,
  576.   invoke the "Replies" pseudo-confernce and perform the desired
  577.   action from there (see "The "Replies" Conference" above).
  578.  
  579.  
  580.     1. The editor
  581.  
  582.   By default PMQWK will invoke E.EXE, the OS/2 system editor to edit
  583.   your replies and other outgoing messages.  If you have an editor
  584.   which you prefer to use, use the "Editor" dialog from the "Options"
  585.   menu (see "Options" below) to specify your editor of choice.
  586.  
  587.  
  588.       a. Word Wrap
  589.  
  590.   Because messages are reformatted based on your setting for "Wrap
  591.   Column" both when quoting a message before a reply and when
  592.   importing your message from the editor back into PMQWK, you should
  593.   be aware of the algorithm used for message formatting so that you
  594.   can achieve a pleasing result.
  595.  
  596.   The message formatter is paragraph based.  It assumes that a new
  597.   paragraph has started when it encounters either a blank line or
  598.   an indented line.  It will pull the entire paragraph together
  599.   to make a "best fit" within your defined wrap column.  For example,
  600.   assuming you have the (unlikely) wrap setting of 30, the following
  601.   text:
  602.  
  603.                     |---|----|----|----|----|----|
  604.                     Now is the time for all good men to
  605.                     come to the aid
  606.                     of their country.
  607.  
  608.   would be reformatted as:
  609.  
  610.                     |---|----|----|----|----|----|
  611.                     Now is the time for all good
  612.                     men to come to the aid of
  613.                     their country.
  614.  
  615.   While the following:
  616.  
  617.                     |---|----|----|----|----|----|
  618.                     Table data:
  619.                         Column 1       Column 2
  620.                         --------       --------
  621.                         Apples         Oranges
  622.  
  623.   would not be reformatted at all because of the indentation.  If you
  624.   are not aware of the way this behaves, you may end up with
  625.   undesirable results.  For instance, if you entered the following:
  626.  
  627.                     |---|----|----|----|----|----|
  628.                     Hello Joe!
  629.                     Whatcha know?
  630.                     I just got back from Kokomo!
  631.                     Yours truly,
  632.                     Ira
  633.  
  634.   it would end up looking like:
  635.  
  636.                     |---|----|----|----|----|----|
  637.                     Hello Joe! Whatcha know? I
  638.                     just got back from Kokomo!
  639.                     Yours truly, Ira
  640.  
  641.   Use blank lines and indentation to avoid having lines pulled back
  642.   for you when you don't want this to happen.
  643.  
  644.  
  645.     2. Messages which are not replies
  646.  
  647.   Sometimes you may wish to enter a message which is not a reply to
  648.   any existing message.  There are two ways to do this: via the
  649.   "Enter" button while viewing a conference, and via the "Message"
  650.   button from the Conference List dialog.  In both cases, the
  651.   procedure that follows is almost exactly that of creating a reply
  652.   message with the following exceptions:
  653.  
  654.     * The "Envelope" dialog will appear both before AND after you
  655.       edit the message.
  656.  
  657.     * No default information is filled in in the "Envelope" dialog
  658.       the first time; you must specify all fields.
  659.  
  660.   Otherwise, for all intents and purposes, a message of this sort is
  661.   treated exactly like any other reply.
  662.  
  663.  
  664.  
  665.   D. Packaging replies for upload
  666.  
  667.   Select "Pack Replies" from the menu or press the "Pack" button is
  668.   the "BBS List" dialog window.  You will be presented with a
  669.   list of all BBSes which have unpacked reply messages defined. 
  670.   Select one or more from this list and press "OK".
  671.  
  672.   For each selection from the previous list, you will be given a
  673.   dialog wherein you may select the archiver to use for packaging
  674.   this reply packet and, if a file by the target name already exists
  675.   in your "OutBound" directory, the option of overwriting that file
  676.   or appending the new messages to it.
  677.  
  678.   There are possibly two buttons in this dialog labeled "List
  679.   Replies"; one which always appears and another which will only be
  680.   present if there already exists a reply packet in your "OutBound"
  681.   path.  This second button appears inside of a group box labeled
  682.   "Existing Replies" in this case.  The first of these buttons will
  683.   provide a list of "Reply Headers" (the conference number, receiver,
  684.   and subject) for each message in the group of new messages the
  685.   second will do the same for the existing replies.  Note, if the
  686.   existing reply packet was not created using PMQWK, PMQWK will not
  687.   attempt to list its contents.
  688.  
  689.   The button labeled "Change Path" will invoke a dialog wherein you
  690.   may override the currently set "OutBound" path (or reset it to the
  691.   default value if you have changed it).
  692.  
  693.   Press the "OK" button to begin the packing process, press "Cancel"
  694.   to abort the process.
  695.  
  696.  
  697.   E. The Address Book
  698.  
  699.   The address book feature of PMQWK is activated by choosing "Address
  700.   Book" from the "Files" menu in the main client window of PMQWK. 
  701.   This is a small database wherein you may keep an organized list
  702.   of names, netmail addresses, and notes for future reference.
  703.  
  704.   Each data record in the Address Book consists of four fields:
  705.   a 'Search key', and 'Name', and a 'Net Address', each of which may
  706.   be up to 25 characters long plus a 'Notes' field which can hold
  707.   up to 949 characters of information.
  708.  
  709.   The reason for having the 'Key' field separate from the 'Name'
  710.   field is so that you may enter the name as it is to appear in
  711.   your reply envelopes (i.e., Name: "Barney Rubble") and still have
  712.   your list sorted by something other than first name (i.e.,
  713.   Search Key: "Rubble, Barney").
  714.  
  715.   There are five buttons in the Address Book window, each of which
  716.   will initiate an action.  'Close' will close the address book
  717.   window, 'New' will insert a new, empty record and place the
  718.   Address Book in edit mode for that record, 'Edit' will place the
  719.   address book into edit mode for the currently viewed record,
  720.   'Delete' will delete the currently displayed record (NOTE WELL:
  721.   in the BETA release of the program, the user is NOT queried at
  722.   this point whether or not to really delete the record!), and
  723.   'Help' will display help for the Address Book functions (NOTE:
  724.   in this BETA release, the 'Help' button is not active.).
  725.  
  726.   By default, the Address Book comes up in 'lookup mode'.  You may
  727.   view the details for any entry by either selecting its key from
  728.   the listbox at the left of the window or by typing the first
  729.   character or characters of the key into the entry field labeled
  730.   'Search Key' in the upper left of the window.  The latter performs
  731.   an 'incremental search' through the list of keys, that is, if you
  732.   type 'F', the listbox highlight moves to the first entry which
  733.   begins with an 'F' (this is not case sensitive), if you then
  734.   proceed to type an 'L', the highlight moves to the first entry
  735.   in the listbox which begins with 'FL'.
  736.  
  737.   You enter 'edit mode' by pressing either the 'New' button or the
  738.   'Edit' button.  The 'New' button inserts a new, blank record and
  739.   allows you to edit that record; the 'Edit' button is only available
  740.   if a valid record is currently displayed and it allows you to edit
  741.   the currently viewed record.
  742.  
  743.   In 'edit mode', the listbox is replaced with a short, informational
  744.   message and all four of the entry fields (Search key, Name, Net
  745.   Addr, and Notes) will now accept input.  You may type anything into
  746.   these fields you wish; you may use all of the standard OS/2 editing
  747.   keys and clipboard functions (i.e., Shift+Delete, Ctrl+Insert, and
  748.   Shift+Insert for Cut, Copy, and Paste).  To save the record as
  749.   edited, press the "Save" button, to cancel changes press the
  750.   "Cancel" button (NOTE: in this BETA release of the program, the
  751.   "Help" button is not active).  If you have edited the 'Search Key',
  752.   the listbox in the 'view mode' window will be rearranged as needed.
  753.  
  754.   1. Copying information to the Envelope window
  755.  
  756.   As mentioned above, the OS/2 editing keys which allow you to access
  757.   the system clipboard are active, that is, you may 'Mark' the name
  758.   in the Address Book with the mouse or the keyboard, copy it to
  759.   the clipboard (Ctrl+Insert) and paste it into any OS/2 application
  760.   which will accept clipboard data.  This, of course, includes the
  761.   the fields in PMQWK's Envelope windows.  For direct communication
  762.   with the Envelope window, however, you may elect to use the built-in
  763.   "Drag and Drop" interface.
  764.  
  765.   If you press and hold Mouse Button Two (usually the right mouse
  766.   button) while the mouse pointer is over the 'Name" field or field
  767.   label in the Address Book window, the mouse pointer will change
  768.   into a small rectangle with the word "NAME" in it.  Still holding
  769.   mouse button two, move the mouse pointer to the Envelope window
  770.   in which you wish this name to appear until the superimposed circle
  771.   with a slash disappears and release the mouse button.  The name
  772.   will replace whatever text is currently in the "To:" field in the
  773.   envelope window.  If you begin this operation from the "Net Addr"
  774.   field or field label in the Address Book window, the mouse pointer
  775.   will instead read "NET" and the data will be placed into the "Net:"
  776.   field in the envelope window.  If you begin from anywhere else in
  777.   in the Address Book window other than directly over the above
  778.   mentioned fields or their labels, the mouse pointer will appear as
  779.   two rectangles, "NAME" and "NET", and the data will go to both
  780.   fields in the Envelope window.  To cancel the drag and drop
  781.   operation, simply release the mouse button anywhere where it DOES
  782.   have the circle-slash visible.
  783.  
  784.   There is no corresponding drag and drop mechanism for copying data
  785.   from the Envelope into the Address Book in this release of PMQWK.
  786.   You may, of course, use the system clipboard to accomplish this as
  787.   outlined above.
  788.  
  789.  
  790.   F. Options
  791.  
  792.   There are several user settable options which you may specify via
  793.   the various items on the "Options" menu.
  794.  
  795.     1. Fonts
  796.  
  797.   This dialog will allow you to set the fonts which PMQWK will use
  798.   for message displays and list boxes.
  799.  
  800.  
  801.     2. Colors
  802.  
  803.   This dialog will allow you to set the colors which PMQWK will use
  804.   for message displays and list boxes. [NOTE: In this BETA release
  805.   of PMQWK, entries appear for "Message HiLited Text" and "Message
  806.   HiLited Text Background".  These setting are NOT functional in this
  807.   release, the highlighted colors in message displays are a function
  808.   of the normal, non-hilighted colors.]
  809.  
  810.  
  811.     3. Paths
  812.  
  813.   This topic has already been covered elsewhere in this document. 
  814.   Please refer to Section II.B.1 for information on these settings.
  815.  
  816.  
  817.     4. Editor
  818.  
  819.   You may select your editor of choice here for purposes of editing
  820.   reply messages.  Type the name of the editor in the indicated
  821.   field, if the program file is not in a directory referred to in
  822.   your PATH environment variable, you must include the entire drive
  823.   and path specification for the program.  Once you have specified
  824.   a valid program name here you will be given the opportunity to
  825.   select how the program will be executed, i.e., as a Presentation
  826.   Manager program, in a full screen session, or in a windowed
  827.   session.
  828.  
  829.  
  830.     5. Preferences
  831.  
  832.   Preferences is a catchall for a number of semi-related settings.
  833.  
  834.       a. Beep on personal messages
  835.  
  836.   If this setting is checked, PMQWK will alert you with a tone
  837.   whenever you view a message addressed to you.
  838.  
  839.       b. Attribute quotes
  840.  
  841.   If this setting is checked, you specify that you want PMQWK to
  842.   provide an "Attribution" to the quotes in your reply messages and
  843.   you may further specify how you wish this Attribution to appear.
  844.   Type any text you wish into the associated entry field and it will
  845.   be echoed into your reply messages.  There are several special
  846.   character sequences which you may embed into this text which will
  847.   cause PMQWK to insert relevant information from the message header:
  848.  
  849.     %s inserts the SENDER's name from the original message
  850.     %r inserts the RECEIVER's name from the original message
  851.     %j inserts the SUBJECT of the original message
  852.     %d inserts the DATE of the original message
  853.     %t inserts the TIME of the original message
  854.     %_ inserts a line break in the attribution string
  855.     %% is used to insert a '%' character in the string.
  856.  
  857.   Please note, these codes ARE case sensitive!  "%S" will NOT work
  858.   like "%s", instead it will simply insert the characters "%S" into
  859.   the attribution string.
  860.  
  861.  
  862.       c. Wrap Column for Quotes
  863.  
  864.   The column at which lines will be broken for purposes of quoting
  865.   original messages.  PMQWK attempts to be intelligent about word
  866.   boundaries and will try to wrap lines at word breaks.
  867.  
  868.  
  869.       d. Prepend "Re:" to response subject lines
  870.  
  871.   Automatically place the characters "Re: " at the beginning of
  872.   subjects lines in replies.  "Re: " will NOT be prepended if those
  873.   characters are already present at the beginning of the subject.
  874.  
  875.  
  876.       e. Strip existing "Re:" from subject lines
  877.  
  878.   Remove the characters "Re:" and any white space following from
  879.   subject lines in replies.  Note that this option and the previous
  880.   are NOT mutually exclusive!  If they are both checked, subject
  881.   lines in replies will always contain one and only one "Re:", if
  882.   neither is checked, no subject line is ever altered by PMQWK.
  883.   Note further that you have the ability to add or remove any
  884.   characters you wish from a subject line via the "Envelope"
  885.   dialog; these setting are provided as a convenience.
  886.  
  887.  
  888.       f. Prev/Next buttons on right in message reader
  889.  
  890.   You may prefer it if the "Next" and "Prev" buttons appeared on the
  891.   right side of the message reader window and closer to the scroll
  892.   bars which govern the message text.  If so, set this option ON.
  893.   Be warned, however, that if you move the focus in this window
  894.   using the TAB or arrows keys that the focus will appear to move
  895.   out of order with respect to these buttons!
  896.  
  897.  
  898.       g. Use Taglines
  899.  
  900.   If this option is checked, PMQWK will look in the same directory
  901.   that contains the PMQWK.EXE file for a file named "TagLines.txt".
  902.   If it is found it will use this for it's source of tag lines
  903.   (humorous or provocative short quotes which will be appended to
  904.   your outgoing messages) and the "TagLine" drop-down list will
  905.   be enabled in the various "Envelope" dialogs.  From there you
  906.   may select a line from the list, type in a fresh one "on the fly",
  907.   or erase it entirely.
  908.  
  909.   The TagLines.txt file is a flat ASCII file containing one tagline
  910.   per line of file; you may edit this file with any text editor.
  911.   Taglines should not be longer than about 60 or 70 characters.
  912.  
  913.  
  914.       h. Use PMQWK Cutline
  915.  
  916.   If this option is set OFF then PMQWK will not append it's own
  917.   "signature line" to your outgoing messages.
  918.  
  919.  
  920.       i. Show only active conferences
  921.  
  922.   If this option is set ON (the default), PMQWK will only display
  923.   those conference names belonging to conferences containing more
  924.   than zero messages in the "Conference List" dialog.  Use this
  925.   setting if you have a large number of empty conferences listed
  926.   by a BBS and you do not wish to navigate past them to find the
  927.   active areas.
  928.  
  929.  
  930.     6. Save options
  931.  
  932.   All options discussed in this section may be saved
  933.   semi-permanently in an initialization file by selecting this
  934.   option.  You may always change an option again and resave it.
  935.   If you change options and do not select "Save options" before
  936.   you attempt to exit PMQWK, you will be alerted to this fact and
  937.   given the opportunity to do so at that point.
  938.  
  939.   Options are saved in a file named PMQWK.INI in the same directory
  940.   as PMQWK.EXE.  If you've really made a mess of your settings and
  941.   wish to "start from scratch" just delete this file while PMQWK is
  942.   not running and restart the program (see section II.B.1 for first
  943.   time startup directions).
  944.  
  945.     7. Icons
  946.  
  947.   Though not on any menu within this version of PMQWK, you may
  948.   specify your own custom icons and attach them to any "BBS
  949.   Conference List" dialog or to any "Conference" dialog.  You must
  950.   use OS/2 version 1.3 compatible color or black and white icon
  951.   files (.ICO).  To do this, create a directory underneath the
  952.   directory containing PMQWK.EXE named "PMQIcons" and place all of
  953.   your custom icon files in this directory.  PMQWK will determine
  954.   how to use these icons by the names you give the files:
  955.  
  956.     To attach an icon to a BBS (Conference List Dialog) give the
  957.     icon file the same "first name" as the BBS id and an extension
  958.     of .ICO.  (Example: A BBS id might be "FERNWOOD", name the
  959.     icon file "FERNWOOD.ICO").
  960.  
  961.     To attach an icon to a specific conference for a specific BBS,
  962.     use the same first name as above but give the file an extension
  963.     which is the conference number, left padded to three characters
  964.     with zeros (Example: to attach an icon to conference #5 for the
  965.     "FERNWOOD" BBS, name the icon file "FERNWOOD.005").
  966.  
  967.     To attach an icon to the "Personal Messages" conference, do as
  968.     above but give the icon file the extension ".PER".  To attach
  969.     it to the "Replies" pseudo-conference, give it the extension
  970.     ".ANS".
  971.  
  972.   [NOTE: This procedure will be built into the program and made more
  973.   easy for the average user in the future.  Do not attempt this
  974.   procedure if the above discussion made little or no sense to you!]
  975.  
  976.  
  977.  
  978.  
  979. Happy Mail Reading!
  980. Brady Flowers
  981. Kimberly Bobrow
  982. Oberon Software
  983. 19 January, 1993
  984.  
  985.