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