home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / os2 / kwq12.zip / KWQ.DOC < prev    next >
Text File  |  1993-06-24  |  77KB  |  1,709 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                                                     KWQ Mail/2
  8.                             A 32 Bit Mail Reader For OS/2 Presentation Manager
  9.                                                                    Version 1.2
  10.                                           Copyright 1992-1993, Kurt Westerfeld
  11.  
  12.                                                  Registration and Information:
  13.  
  14.                                                                Kurt Westerfeld
  15.                                                         7935 Tyson Oaks Circle
  16.                                                          Vienna, Virgina 22182
  17.  
  18.                                                                June 24th, 1993
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.      Introduction
  26.  
  27.          Congratulations!  You've managed to beg, borrow, steal or download
  28.          a copy of the new 32 bit QWK mail reader for OS/2 Presentation
  29.          Manager.  With KWQ Mail/2, you will be able to read mail generated
  30.          by many popular electronic bulletin boards while remaining in the
  31.          comfort and confines of your own OS/2 2.X system.
  32.  
  33.          KWQ Mail/2 is a shareware package.  To those of you who don't know
  34.          or have a vague idea what this means, read on.  Otherwise, skip to
  35.          the next section.  Shareware is software you may "share" with your
  36.          friends and colleagues.  You may use KWQ Mail/2 as much as you wish
  37.          for up to 45 days with absolutely no obligation to buy it.  But
  38.          shareware isn't free. You must pay for KWQ Mail/2 if you decide to
  39.          use it past 45 days.  The initial charge for KWQ Mail/2 is $25,
  40.          which will not include printed documentation and disks initially,
  41.          However, registering KWQ Mail/2 will include free upgrades to the
  42.          software for up to but not including the next major revision (ie,
  43.          1.X to 2.0).  Some time at a later date printed documentation may
  44.          be available, depending on demand.
  45.  
  46.          Registration is available via the Compuserve software registration
  47.          forum.  The cost for registering electronically through this
  48.          service is $30.
  49.  
  50.          The copy of KWQ Mail/2 you have is not crippled, and hopefully it
  51.          isn't "annoyware."  However, there are a few features that aren't
  52.          provided by the reader unless you buy it.  These features that are
  53.          left out with the demo version are very minor, and should in no way
  54.          hinder your ability to evaluate the product.  The first feature
  55.          that is not available in the demo version is the disabling of the
  56.          "tagline feature." (Taglines are described later on in this
  57.          document)  When using the demo version of the product, the taglines
  58.          will always be enabled.  The second difference between the demo and
  59.          registered copy is that there is a product information dialog box
  60.  
  61.  
  62.                                             KWQ Mail/2, Version 1.2.    Page 1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.          that appears when KWQ Mail/2 is initially run; registering KWQ
  69.          Mail/2 removes this screen.
  70.  
  71.  
  72.  
  73.      What is a Mail Reader?
  74.  
  75.          You may have received this copy of KWQ Mail/2 because you are
  76.          curious, because someone told you about it, because you are looking
  77.          into electronic mail, or any of a hundred reasons.  However, the
  78.          term "Mail Reader" is many times confusing, and it bears mentioning
  79.          what exactly is meant by this term.
  80.  
  81.          First of all, KWQ Mail/2 is not a communications program or
  82.          terminal emulator.  In fact, it knows nothing and cares for even
  83.          less about the communications ports on your computer.  KWQ Mail/2
  84.          is a program written specifically to decode mail files that you
  85.          obtain from an electronic service provider, commonly called an
  86.          electronic bulletin board (BBS).  You generally use another
  87.          program, called a terminal emulator, to interact with this BBS,
  88.          tell it what kind of mail topics you are interested in, and then
  89.          initiate a download sequence to obtain the mail.  The result is a
  90.          file which KWQ Mail/2 understands how to decode and assemble into a
  91.          well-organized set of topics.  You can then read the mail after you
  92.          have disconnected from the BBS, compose reply messages to mail
  93.          topics you are interested in, and later upload a reply mail file to
  94.          the BBS.
  95.  
  96.          Mail Readers are actually a little more sophisticated than what was
  97.          outlined above, but this is the basic principle: connect to a BBS,
  98.          download a mail file, use mail reader to browse mail, compose
  99.          replies, and upload a mail reply file to the BBS.
  100.  
  101.  
  102.  
  103.      On this Mail Reader
  104.  
  105.          Mail readers are applications that help to allow people to
  106.          communicate messages and mail around the world.  The author of KWQ
  107.          Mail/2, Kurt Westerfeld, wanted to develop an application that
  108.          helped to communicate and facilitate the transmission of
  109.          information about OS/2, but also to help many people making the
  110.          transition from DOS and/or Windows to IBM's newest operating system
  111.          offering.  To many who use their PCs to communicate, having a
  112.          native Presentation Manager mail reader will be important, and this
  113.          application is for them.
  114.  
  115.  
  116.  
  117.      Restrictions
  118.  
  119.  
  120.  
  121.  
  122.  
  123.                                             KWQ Mail/2, Version 1.2.    Page 2
  124.  
  125.  
  126.  
  127.  
  128.  
  129.          You have obtained a copy of a shareware package, which means you
  130.          may let your friends and colleagues have a copy if you wish, as
  131.          long as you abide by the following restrictions:
  132.  
  133.              1.  You do not charge for the transfer of KWQ Mail/2 or any of
  134.                  its components.
  135.  
  136.              2.  You supply the exact files and packaging for the shareware
  137.                  version of KWQ Mail/2 that you obtained electronically or
  138.                  other means.
  139.  
  140.              3.  You DO NOT share the licensing information provided once
  141.                  you register KWQ Mail/2.
  142.  
  143.          The author, Kurt Westerfeld, makes no claim as to the viability or
  144.          usefulness of the product to suit particular needs.  Use the
  145.          product initially for no charge, and when the test drive is over,
  146.          decide if you like it and register it if you do.
  147.  
  148.          KWQ Mail/2 is copyrighted property developed by Kurt Westerfeld.
  149.  
  150.  
  151.  
  152.      Forward
  153.  
  154.          KWQ Mail/2 (referred to as KWQ, the meaning of which we'll get to
  155.          later...) will not run under any version of OS/2 earlier than OS/2
  156.          2.0.  This is because I have decided to use features only provided
  157.          by the new 32 bit environment, and these features have only been
  158.          available since OS/2 2.0 has been generally available.  In
  159.          addition, I do not guarantee that KWQ will run with one of the OS/2
  160.          2.X betas.  I simply don't have the time or desire to load an old
  161.          copy of beta code to test any problems that crop up.
  162.  
  163.          Some of the features KWQ has are:
  164.  
  165.              -  A fully (who am I kidding?) CUA compliant user interface
  166.                 with menus, scroll bars, etc.
  167.  
  168.              -  Number of conferences, message base size, and replies are
  169.                 only limited by virtual memory, which under OS/2 is pretty
  170.                 much your hard disk size.
  171.  
  172.              -  The ability to use any editor, be it OS/2 fullscreen,
  173.                 Presentation Manager, DOS, or Windows as your reply/compose
  174.                 editor.
  175.  
  176.              -  Save messages to files with long names, if system is
  177.                 configured with High Performance File System.  This feature
  178.                 was a prime motivator for writing this offline reader.  The
  179.                 save dialog remembers the last 10 messages you have saved,
  180.                 available with a pull down list.
  181.  
  182.  
  183.  
  184.                                             KWQ Mail/2, Version 1.2.    Page 3
  185.  
  186.  
  187.  
  188.  
  189.  
  190.              -  The ability to save "bookmarks" to your messages, which
  191.                 will get saved with your mail packets as a small extended
  192.                 attribute (typically less than 300 bytes in size).  This
  193.                 feature is useful in saving spots of a message base you're
  194.                 really interested in returning to, while you swap to
  195.                 another conference or another part of a conference.
  196.  
  197.              -  Background (multi-threaded) searches.  Search by the
  198.                 'From', 'To', 'Subject', or 'Message' portion of a message,
  199.                 or search with any combination of these.  Search for whole
  200.                 words or simply parts of them, case sensitive or case
  201.                 insensitive.  Search across all the conferences in a mail
  202.                 packet.   Continue to read mail while your search takes
  203.                 place.  Boolean logic will be supported at a later date.
  204.  
  205.              -  Use an optional tagline file, choose a random tagline, or
  206.                 totally  turn off the tagline feature, including the KWQ
  207.                 banner (this option is only available once you register KWQ
  208.                 Mail/2).
  209.  
  210.              -  Support for all major archive formats, including ZIP, ZOO,
  211.                 LHA, ARC and ARJ.
  212.  
  213.              -  Display messages in any font you choose, including Adobe
  214.                 Type Manager  outline fonts (included with OS/2).  You may
  215.                 print with these fonts as well
  216.  
  217.              -  Relatively familiar keystrokes.  KWQ is inspired by a few
  218.                 unnamed mail readers for DOS.  Where possible, a consistent
  219.                 user interface is maintained between PM and DOS-style
  220.                 keystrokes.
  221.  
  222.              -  Session saving.  KWQ will remember what messages and
  223.                 conferences you have seen between sessions.  KWQ will also
  224.                 remember the bookmarks you've added to return to at a later
  225.                 date, as well as remember cosmetic setup such as the
  226.                 position and size of various windows and dialogs.
  227.  
  228.              -  Support for the Workplace Shell.  KWQ can be setup as an
  229.                 association to the file type *.QWK, so that when a packet
  230.                 file of that type is double clicked on, the packet will be
  231.                 automatically opened and displayed.  Additionally, any file
  232.                 "dropped" on the KWQ program icon will cause KWQ to run
  233.                 against that file in a similar manner.  In addition to file
  234.                 launching, KWQ Mail/2 accepts all dropped fonts and colors
  235.                 and reacts appropriately by changing the window component
  236.                 dropped on.
  237.  
  238.              -   KWQ Mail/2 supports "syntax coloring" found in no other GUI
  239.                  mail reader.  Just like familiar DOS mail readers, KWQ
  240.                  Mail/2 will show the message text, message quotes, and
  241.                  message taglines in different colors.
  242.  
  243.  
  244.  
  245.                                             KWQ Mail/2, Version 1.2.    Page 4
  246.  
  247.  
  248.  
  249.  
  250.  
  251.              -   An internal editor, with cut, copy, paste, quote and import
  252.                  functionality.
  253.  
  254.         Hopefully by now I have your interest!  If not, go on using one of
  255.         those character mode user interfaces you've been using for years,
  256.         and let many of us go on to using Presentation Manager and the
  257.         Workplace Shell.
  258.  
  259.         KWQ was mainly written with a few goals in mind:
  260.  
  261.              1.  Provide the ability to save messages to long file names.
  262.                  Many times I have saved messages to 8.3 character naming
  263.                  styles and not known what I was thinking of in a matter of
  264.                  days after saving the message.  Since I'm involved in BBS-
  265.                  ing for research purposes, I have wanted to have a "message
  266.                  base" on my hard drive of topics I would like to peruse.
  267.                  KWQ enhances this much needed functionality.
  268.  
  269.              2.  Save bookmarks.  Many times I want to return to a spot in
  270.                  the message pool and go on to look for something else.
  271.  
  272.              3.  Provide elaborate searching capabilities.  A reader
  273.                  application should take as complicated a search as possible
  274.                  and do the search in the background while a user continues
  275.                  to read. KWQ delivers on this goal, although version 1.X
  276.                  will not provide Boolean logic.  This feature is in the
  277.                  future for KWQ, because as a BBS-er I want this feature!.
  278.  
  279.              4.  Take advantage of OS/2-specific features whenever possible,
  280.                  including advanced approaches in graphical user interfaces
  281.                  to reduce the time you spend waiting for something to
  282.                  complete (multithreaded architecture).
  283.  
  284.         Hopefully, BBS-ers will see the value in providing these features,
  285.         as well as providing "traditional" offline reader functionality.
  286.  
  287.  
  288.  
  289.      System Requirements
  290.  
  291.          KWQ Mail/2 is a 32 bit application for OS/2 2.X.  Therefore to run
  292.          this application, you must have at least the minimum requirements
  293.          set by IBM for OS/2, which is 4MB of system RAM and a 386 or 486
  294.          Intel or Intel-Compatible processor.  Realistically, however, many
  295.          feel that 6MB of system RAM is needed to run OS/2 2.X properly, and
  296.          it strongly suggested that this be a working minimum for your
  297.          system to run KWQ Mail/2 as well. KWQ Mail/2 allocates virtual
  298.          memory to load each mail packet, so you may experience "swapping"
  299.          to disk on systems with lesser amounts of memory or with reading
  300.          extremely large mail packets.  A future release of KWQ Mail/2 will
  301.          allow you to bound the virtual memory needed to run the application
  302.          within some user-specified limits.
  303.  
  304.  
  305.  
  306.                                             KWQ Mail/2, Version 1.2.    Page 5
  307.  
  308.  
  309.  
  310.  
  311.  
  312.          KWQ Mail/2 has been tested and verified to work well with versions
  313.          2.0 and 2.1 of OS/2, including the 2.0 + Service Pak upgrade..
  314.  
  315.  
  316.  
  317.      Terminology
  318.  
  319.          For some people, the terminology used in this document and BBS-ing
  320.          in general will seem like a foreign language.  We will try to clear
  321.          up some of the potential confusion.
  322.  
  323.          A mail reader is an application that looks at mail packets
  324.          downloaded from an Electronic Bulletin Board, commonly called a
  325.          BBS. A mail reader allows the user to read his/her mail and compose
  326.          replies to messages for a later upload.  Typically a user will join
  327.          a conference or forum on a BBS which will contain messages and
  328.          conversations between people on a certain topic.  Once the user has
  329.          read mail and replied to messages offline, the reply mail is
  330.          uploaded and it becomes part of the stream of messages in a forum.
  331.  
  332.          The term QWK refers to a specification for mail packets that is
  333.          used for downloading mail from many popular BBSes.  Mail packets
  334.          obtained from BBSes are usually contained in files with the
  335.          extension .QWK.  (eg.  OS2SHARE.QWK).  KWQ  is the name of the
  336.          software you just obtained.
  337.  
  338.  
  339.  
  340.      Quick Installation
  341.  
  342.          Installing KWQ is easy.  Unpack KWQ (usually delivered in .ZIP
  343.          format) to a subdirectory.  You should have the following files:
  344.  
  345.              KWQ.EXE         Executable
  346.              KWQMAIL.HLP     Help resource
  347.              KWQMAIL.DOC     KWQ Mail/2 Documentation (this file)
  348.              README.1ST      Last minute information
  349.              TAGLINES.KWQ    Sample tagline file
  350.              TWITFILT.KWQ    Sample twit filter file
  351.              BUGFIXES.DOC    Latest fixes
  352.              WHATS.NEW       Version history
  353.              ORDERKWQ.FRM    Registration form
  354.  
  355.          KWQ builds an INI file the first time it is run, so there is no
  356.          manual step to editing initialization parameters.  Simply type
  357.          "KWQ" on the OS/2 command line, or install a "Program Reference"
  358.          object into the Workplace Shell and run KWQ Mail/2 from its icon.
  359.          If you do create a program reference for KWQ Mail/2, be sure and
  360.          supply the current directory where KWQ is installed.
  361.  
  362.          Once you have KWQ running, it will initially open a Product
  363.          Information banner, and then follow with a "Open QWK Mail Packet"
  364.          dialog.  This is the dialog that is used to choose a mail packet to
  365.  
  366.  
  367.                                             KWQ Mail/2, Version 1.2.    Page 6
  368.  
  369.  
  370.  
  371.  
  372.  
  373.          open.  Chances are, you probably want to setup KWQ first, so press
  374.          "Cancel" and click on the "Setup" menu.
  375.  
  376.          Under the Setup menu there are a number of choices for configuring
  377.          your mail reader.  Changing these options causes KWQ to create an
  378.          INI file with your personalized configuration settings.  To
  379.          configure KWQ Mail/2, choose the menu "Setup->Options..." to view
  380.          the KWQ Mail/2 setup notebook.  This notebook is comprised of
  381.          several pages which divide up the configuration options available
  382.          in KWQ Mail/2.  To start reading mail immediately, you must change
  383.          two options.  First, under the "General" notebook page, you must
  384.          change the path for "*.QWK File" to point to the directory (and
  385.          optionally directory mask) where KWQ Mail/2 will look for QWK Mail
  386.          initially. Second, you must configure KWQ Mail/2 to point to the
  387.          proper archival utility for packing and unpacking the mail you
  388.          receive. The "Archivers" notebook page allows you to specify the
  389.          paths and parameters to each archiver utility.
  390.  
  391.          Follow the next few steps for a quick setup of KWQ:
  392.  
  393.            -   Enter in the path to the "download" directory your
  394.                communications program will put downloaded files.  This is
  395.                where KWQ will look when asking for .QWK mail packets.  Also
  396.                enter in the path to the "upload" directory.  This will be
  397.                where KWQ will place reply packets.  Both options are found
  398.                in the "General" notebook page.
  399.  
  400.            -   If the packets you have downloaded are in ZIP format and you
  401.                own PKZIP or a zip-clone, enter the appropriate paths for the
  402.                programs for the "Zip Unpacker" and "Zip Packer" options in
  403.                the Archiver notebook page.  If these programs are in your
  404.                default path, don't change anything (KWQ should default to
  405.                having these in your Paths dialog).  Other archiver formats
  406.                are available in the same dialog.
  407.  
  408.          Go ahead and look at the other options in the setup notebook.  The
  409.          General page contains yes/no choices to many configuration options
  410.          you may want, as well as configuration options for your paths on
  411.          your hard disk.   The Replies page contains options for setting up
  412.          how mail replies are treated.  The Arhivers page contains
  413.          configuration paths for all archival utilities used within KWQ
  414.          Mail/2.  The Header/Footer page contains options for automatically
  415.          adding message portions to the beginning and end of messages when
  416.          you create replies.  Using the Font and Color pages affect how
  417.          messages will be displayed, and setting the "Sort" option displays
  418.          how the messages will be sorted in the "messages" dialog (more on
  419.          this below).
  420.  
  421.  
  422.  
  423.      Upgrading from Version 1.0
  424.  
  425.  
  426.  
  427.  
  428.                                             KWQ Mail/2, Version 1.2.    Page 7
  429.  
  430.  
  431.  
  432.  
  433.  
  434.          Many new options have been added to KWQ Mail/2 version 1.2 over
  435.          that of version 1.0.  Some of the options are not stored in the 1.2
  436.          INI file in the same way as the previous version, so upgrading may
  437.          cause some customization of KWQ Mail/2 to be lost.  The font
  438.          setting for the message display is likely to be needed attention if
  439.          you choose to view in the non-default font.  Please see the section
  440.          below on how to setup the fonts in version 1.2.
  441.  
  442.          It is a good idea to completely reconfigure KWQ Mail/2 when
  443.          upgrading from version 1.0 or 1.0C by deleting the KWQMAIL.INI
  444.          file.
  445.  
  446.  
  447.  
  448.      Upgrading from Version 1.1
  449.  
  450.          For users of version 1.1 of KWQ Mail/2, upgrading to version 1.2 is
  451.          very simple.  Simply save a copy of your KWQMAIl.INI file, and copy
  452.          the contents of your KWQ Mail/2 distribution file to a directory
  453.          and restore the INI file.  All your customization settings will be
  454.          saved.
  455.  
  456.  
  457.  
  458.      Getting Help
  459.  
  460.          KWQ Mail/2 contains an extensive help system.  Help is simply a
  461.          single keystroke away by pressing F1 in any context in the
  462.          application.   In addition, there are a few special help screens
  463.          available by menu choice.  These include the "Help Index",
  464.          "General Help", "Help For Keys", "Using Help", and "Registration
  465.          Information."
  466.  
  467.  
  468.  
  469.      The Toolbar
  470.  
  471.          The KWQ Mail/2 application contains a fast access button toolbar at
  472.          the top of the window.  There are four groups of buttons visible,
  473.          grouped according to functionality.  The first group, for file
  474.          management, contains the open packet, save message, and print
  475.          message buttons. The next group, dialog management, contains two
  476.          buttons for opening the messages and conferences dialog,
  477.          respectively.  The next set buttons is more "miscellaneous", and
  478.          provides buttons for search, bookmark, steal tagline, write new
  479.          message, and reply/edit reply.  The last group of buttons are used
  480.          for message browsing, and contain the buttons for next/previous
  481.          subject, next/previous message, and page up/page down.  The subject
  482.          buttons are functional only if KWQ Mail/2 is configured for a
  483.          Subject or Thread sort.
  484.  
  485.          If you forget what a toolbar button's function in life is, simply
  486.          press mouse button 2 on the toolbar button, and you will see a
  487.  
  488.  
  489.                                             KWQ Mail/2, Version 1.2.    Page 8
  490.  
  491.  
  492.  
  493.  
  494.  
  495.          description of the function provided at the bottom of the KWQ
  496.          Mail/2 screen.
  497.  
  498.  
  499.  
  500.      Opening a Packet
  501.  
  502.          Once KWQ Mail/2 is configured, it is quite easy to open and unpack
  503.          a mail packet.  Simply choose the "File->Open" menu choice if the
  504.          application is running, or by default KWQ Mail/2 prompts you with
  505.          the "Open QWK Mail Packet" dialog when it is first run.
  506.  
  507.          The open packet dialog is a modified version of OS/2 2.X's common
  508.          dialog.  It contains a window replacement for the file list
  509.          display, which includes the file and date stamp of the files
  510.          listed, as well as the file size in kilobytes (K).  In addition to
  511.          the file open choice, you may choose to delete a packet listed by
  512.          hilighted the file, and then pressing the "Delete" button.  You
  513.          will be prompted to confirm your request.
  514.  
  515.          Following OS/2 conventions, the file details display in the OS/2
  516.          dialog can also be used to rename the listed files.  Simply press
  517.          your mouse button 1 down on the file you wish to rename while
  518.          holding the Alt key down.  The file display will turn into an edit
  519.          field, and you may rename the file to your liking.
  520.  
  521.          When a QWK file is chosen using the "Open" button, a subdirectory
  522.          is created underneath the current directory (called .\KWQMAIL.$$$)
  523.          where the packet will be unpacked.  When the unpacking is complete,
  524.          KWQ Mail/2 reads the "CONTROL.DAT" file and the "MESSAGES.DAT" file
  525.          to decode the message data.  KWQ does not use the "XXX.NDX" index
  526.          files that are in the packet, instead, KWQ reads the entire packet
  527.          into memory and re-indexes it at load time.  This method has proven
  528.          to be much quicker under OS/2 2.X than doing the work to read the
  529.          individual index files.  The name and configuration of the BBS the
  530.          mail was downloaded from is determined from the CONTROL.DAT file,
  531.          and the reply path is checked for a file called "BBS.REP".  If this
  532.          file exists, it too is unpacked and the messages in it are
  533.          displayed under the conference "Replies."
  534.  
  535.  
  536.  
  537.      Choosing a Conference
  538.  
  539.          After opening a packet, a dialog will appear with a list of
  540.          conferences in the mail packet.  The conference dialog contains a
  541.          number of buttons: "Goto" , "Cancel", "Add" and "Drop". Choosing a
  542.          conference in the list and pressing the "Goto" button with the
  543.          mouse will make the chosen conference active. Alternatively, The
  544.          you may choose to "double-click" an item in the list box with the
  545.          mouse, which causes a "Goto" action to occur.
  546.  
  547.  
  548.  
  549.  
  550.                                             KWQ Mail/2, Version 1.2.    Page 9
  551.  
  552.  
  553.  
  554.  
  555.  
  556.          Each conference shown will display the number of messages in the
  557.          conference for the mail packet you are reading.  A percentage read
  558.          field is shown, so that conferences which you have read messages in
  559.          will appear with a non-zero percentage read field. In addition, the
  560.          conference ID assigned by the host BBS the mail came from appears
  561.          on the far left of each list item.
  562.  
  563.          The conferences dialog can also be used to add or drop a conference
  564.          from your BBS mail packet, provided the BBS you dial into supports
  565.          Add/Drop.
  566.  
  567.          The conferences dialog may be called up at any time to browse
  568.          another conference by choosing the menu "Message->Choose
  569.          Conference".  If you like keyboard hotkeys you can hotkey to this
  570.          dialog by pressing <Ctrl>-C, and use the arrow keys to scroll
  571.          through the list of conferences.  When you have highlighted the
  572.          conference you wish to look at, simply press Enter.
  573.  
  574.  
  575.  
  576.      The Messages Dialog
  577.  
  578.          After a conference is chosen, KWQ displays the first message
  579.          available in the chosen conference.  The message order is chosen
  580.          using the "Setup->Sort Order" menu, and the messages dialog
  581.          displays messages in a conference by this sort order.
  582.  
  583.          To bring up the messages dialog, choose the menu "Message->Choose
  584.          Message", or press the INS hotkey.  The dialog displays each
  585.          message's number assigned by the BBS or conference, the person who
  586.          wrote each message, the person the message is addressed to, and the
  587.          subject of each message.  Selecting a message and pressing the
  588.          "Goto" button will jump to that message.  Just as in the
  589.          Conferences Dialog, double clicking on an item in the messages list
  590.          will cause the "Goto" action to occur.
  591.  
  592.          For message browsing purposes (and for people with a high
  593.          resolution monitor) an optional "Keep Dialog Open" selection can be
  594.          made. Choosing this option allows a user to jump to a message, but
  595.          still keep the message dialog open for continuing a browse.  This
  596.          may be useful in hardware configurations that allow for a large
  597.          screen display, where the messages dialog could reside at the
  598.          bottom of the screen, and the main window reside at the top.
  599.  
  600.          Pressing "Cancel" or <Esc> will close the dialog, whether the "Keep
  601.          Dialog Open" choice is marked or not.
  602.  
  603.  
  604.  
  605.      Mouse Conventions
  606.  
  607.          To speed up access to the messages and conferences list dialogs,
  608.          KWQ Mail/2 responds to specific types of mouse actions as
  609.  
  610.  
  611.                                            KWQ Mail/2, Version 1.2.    Page 10
  612.  
  613.  
  614.  
  615.  
  616.  
  617.          "accelerator" features.  First, pressing Button 2 (usually the
  618.          right mouse button) anywhere on the KWQ Mail/2 main window will
  619.          open the messages list dialog.  Second, by pressing a mouse
  620.          "chord", pressing buttons 1 and 2 together, anywhere on the KWQ
  621.          Mail/2 window, you will bring up the conferences list.  This will
  622.          allow you to rapidly browse a set of messages within KWQ Mail/2.
  623.  
  624.  
  625.  
  626.      Configuration/Setup Options
  627.  
  628.          KWQ has a host of features that may be saved as part of its INI
  629.          file.  Most setup options are saved after opening the "Setup-
  630.          >Options..." notebook dialog and pressing the "Save" button. If at
  631.          any time inside the options notebook you are unsure of what a field
  632.          or switch is for, you may press F1 or the Help button within the
  633.          dialog to receive context sensitive help.
  634.  
  635.          There are 6 different notebook "pages" within the options notebook,
  636.          each having a separate category of setup information.  These pages
  637.          are: General, Replies, Archiver, Header/Footer, Colors and Fonts.
  638.          Each of these pages is described in detail in one of the following
  639.          sections.
  640.  
  641.          General Notebook Page
  642.  
  643.              The General notebook page is a combination of "Yes/No" type
  644.              configuration toggles and paths setup. These configuration
  645.              options include:
  646.  
  647.              General Options
  648.  
  649.                  -  Beep on My Mail.  This causes KWQ Mail/2 to sound an
  650.                     alarm if a mail message is read and addressed to you.
  651.  
  652.                  -  Use Twit Filter.  When this option is on, KWQ Mail/2
  653.                     will filter out all messages from or to a given user.
  654.                     User names appear in a file specified in the "Paths"
  655.                     dialog, one per line.
  656.  
  657.                  -  Use Internal Editor.  When this option is on, KWQ Mail/2
  658.                     will not use the external editor defined in the
  659.                     Files/Paths subsection on the General setup page.
  660.                     Instead, when creating a new message or replying to a
  661.                     message KWQ Mail/2 will open its internal editor for you
  662.                     to write your new message or response.
  663.  
  664.                  -  Conference Jumping.  Configure KWQ Mail/2 to
  665.                     automatically goto the next conference with messages
  666.                     when reading the last message in a conference and a
  667.                     "next page" command is requested.
  668.  
  669.  
  670.  
  671.  
  672.                                            KWQ Mail/2, Version 1.2.    Page 11
  673.  
  674.  
  675.  
  676.  
  677.  
  678.                  -  Save Bookmark On Mail Packet.  This option applies to
  679.                     more than bookmarks (discussed below).  It also applies
  680.                     to which messages have been read, what the current
  681.                     conference is and which message you a currently reading.
  682.  
  683.                  -  Save Window Settings On Exit.   Turning this option on
  684.                     causes all the windows and dialogs to save their current
  685.                     size and position. You may want to leave this option on
  686.                     until you have a setup you like, and then turn it off.
  687.  
  688.                  -  Always Append On Save.   Turning this option on answers
  689.                     the question "Do you want to append or replace?" for you
  690.                     without prompting when you save a message to a file that
  691.                     already exists.
  692.  
  693.                  -  Strip 'Re:' Subject Prefixes.  Remove all 'Re:' type
  694.                     prefixes from message subject lines for readability.
  695.                     Note that if this option is turned off, KWQ Mail/2 will
  696.                     still ignore these prefixes when sorting on the subject
  697.                     field.  This is for cosmetic purposes only.
  698.  
  699.              Files/Paths
  700.  
  701.              This subsection contains configuration options for accessing
  702.              tools and files on your hard drive.
  703.  
  704.                  -  *.QWK Files.  This is the path to which KWQ will look
  705.                     when showing the open packet dialog.
  706.  
  707.                  -  Replies.  This is the path KWQ will place packed reply
  708.                     mail.
  709.  
  710.                  -  Save Message To.  This is the default file name where
  711.                     KWQ will save messages.
  712.  
  713.                  -  Tagline File.  This is the full path to a file containing
  714.                     sample taglines, one per line, in plain ASCII.  These will
  715.                     be used when composing replies.
  716.  
  717.                  -  Twit Filter File.  This file contains twits you'd not like
  718.                     to hear from.
  719.  
  720.                  -  External Editor.  The name of the external editor you have
  721.                     installed on your system.  Default is E.EXE.  Your
  722.                     external editor may be an OS/2 or DOS batch file (.CMD or
  723.                     .BAT).
  724.  
  725.              A note on batch files and your external editor.  KWQ creates a
  726.              subdirectory called ".\KWQMAIL.$$$" underneath the subdirectory
  727.              where the KWQ.EXE executable is placed.  This is the subdirectory
  728.              where KWQ will place the quoted reply file, called "REPLY.MSG,"
  729.              when calling the external editor. If you wish to create a batch
  730.              file that will call the external editor and perhaps call a spell
  731.  
  732.  
  733.                                            KWQ Mail/2, Version 1.2.    Page 12
  734.  
  735.  
  736.  
  737.  
  738.  
  739.              checker afterward, use this path and filename as the input to
  740.              your programs.  Take care to ensure that the output of the whole
  741.              process maintains the "REPLY.MSG" file name.
  742.  
  743.        Replies Notebook Page
  744.  
  745.              The Replies notebook page contains many setup options that
  746.              control how messages are handled when creating reply messages.
  747.              There are three subcategories in this page: Reply Options, Reply
  748.              Quoting, and Taglines.
  749.  
  750.                  -  Expand Tabs. This option is used to configure KWQ Mail/2
  751.                     to expand tabs to a certain number of spaces whenever a
  752.                     messages is created and a real tab character is used.
  753.  
  754.                  -  Autoformat Replies.  This option is useful when when the
  755.                     editor you use does not automatically line-wrap the text.
  756.                     The OS/2 system editor, E.EXE, falls into this category,
  757.                     as well as the internal editor, since they both depend on
  758.                     the OS/ 2 multiple line editor control.  Selecting this
  759.                     option tells KWQ Mail/2 to make each line fit into the
  760.                     number of characters specified in the edit field next to
  761.                     this option.  This edit field is labeled "N Characters Per
  762.                     Line"
  763.  
  764.                  -  Reformat Lines That Start With A Blank.  Turning this
  765.                     option on will tell KWQ Mail/2 to allow lines it
  766.                     interprets to start with a blank to be line wrapped if
  767.                     Auto-Format Replies (see above) is turned on.  If this
  768.                     option is turned off, then you can avoid any formatting by
  769.                     placing a blank at the beginning of each line you do not
  770.                     wish to be reformatted.
  771.  
  772.                  -  Create Case Insensitive Replies (Upper Case).  Selecting
  773.                     the upper case option is useful if the BBS you receive
  774.                     your mail packets from requires the use of upper case
  775.                     formatted mail.
  776.  
  777.              Reply Quoting
  778.  
  779.                  -  Quoting Type.  Four types of quoting are supported.  The
  780.                     first type uses the initials of the person quoted with a
  781.                     greater than symbol.  For example, 'KW> '.  The second
  782.                     simply uses the greater than symbol, and the third turns
  783.                     the quoting feature off.  The fourth option allows you to
  784.                     create custom quote masks, using the keyword "%i" to
  785.                     allow you to insert the recipient's initials.  For
  786.                     example, you could supply the custom quote mask "  [%i]
  787.                     " which might expand out to be "  [KW]  ".
  788.  
  789.              Taglines
  790.  
  791.  
  792.  
  793.  
  794.                                            KWQ Mail/2, Version 1.2.    Page 13
  795.  
  796.  
  797.  
  798.  
  799.  
  800.                  -  Use Taglines.  KWQ will not use taglines if desired.
  801.                     However, the demo/shareware version of KWQ will always
  802.                     place taglines with the "KWQ/2"  banner at the bottom of
  803.                     the message.  Once you have registered KWQ, you may
  804.                     choose to turn off this feature.
  805.  
  806.                  -  Pick Tagline At Random.  If this option is chosen, when
  807.                     a new reply is composed or a message written, the
  808.                     message information dialog will appear with a tagline
  809.                     chosen at random with in the multi-choice list box.
  810.                     The taglines are read from a file that is designated
  811.                     within the "Paths" dialog.
  812.  
  813.              Archivers
  814.  
  815.                  The Archivers notebook page contains configurations
  816.                  options for accessing archival programs for packing and
  817.                  unpacking mail packets.  Any of the following programs may
  818.                  be either OS/2, PM, DOS or Windows, and may also be batch
  819.                  files for either OS/2 or  DOS (.CMD or .BAT files).  These
  820.                  configuration options include:
  821.  
  822.                          ZIP Unpack/Pack
  823.                          LHA Unpack/Pack
  824.                          ZOO Unpack/Pack
  825.                          ARJ Unpack/Pack
  826.                          ARC Unpack/Pack
  827.  
  828.                  A note on batch files and the unpack process.  KWQ creates
  829.                  a subdirectory called ".\KWQMAIL.$$$" underneath the
  830.                  subdirectory where the KWQ.EXE executable is placed.  This
  831.                  is the subdirectory where KWQ will look for files that are
  832.                  unpacked. If you wish to create a batch file that will do
  833.                  the unpacking and other chores, ensure that the output of
  834.                  the unpack process places the files in this subdirectory.
  835.  
  836.        Header/Footer Notebook Page
  837.  
  838.              You may choose to add text to the beginning and/or the end of
  839.              messages you create with KWQ Mail/2 by configuration a header
  840.              or footer in the Header/Footer Notebook page.  In this
  841.              section, you specify substitution keys that tell KWQ Mail/2 to
  842.              pull portions of the message you are replying to into the
  843.              message you create.
  844.  
  845.              The substitution keys provided are the following:
  846.  
  847.                     Full Name Of Recipient   %r
  848.                     Full Name Of Author      %a
  849.                     First Name Of Recipient  %o
  850.                     First Name Of Author     %i
  851.                     Mail Address Of Author   %n
  852.                     Current Date             %c
  853.  
  854.  
  855.                                            KWQ Mail/2, Version 1.2.    Page 14
  856.  
  857.  
  858.  
  859.  
  860.  
  861.                     Current Weekday          %u
  862.                     Actual Percent Sign      %%
  863.                     Message Subject          %s
  864.                     Message Date (mm/dd/yy)  %f
  865.                     Message Month (mm)       %m
  866.                     Message Day (dd)         %d
  867.                     Message Year (yy)        %y
  868.                     Message Weekday          %w
  869.                     Message Conference       %e
  870.                     Message Number           %b
  871.  
  872.              By using one of these substitution keys, you may give the
  873.              recipient (or anyone else who may read your message) a better
  874.              idea about the past conversation history.  For example, by
  875.              using the header On %w %f, %a wrote to %r about '%s:', KWQ
  876.              Mail/2 could expand this string to: "On Wednesday, 4/28/93,
  877.              Kurt Westerfeld wrote to Melanie Kim about 'Love and War'."
  878.  
  879.        Colors Notebook Page
  880.  
  881.              Color can be applied to eight different window components
  882.              within KWQ Mail/2.  Four of these are specific to the display
  883.              of the current message and include:
  884.  
  885.                  Message Background  The background color of the  message
  886.                                      display window
  887.  
  888.                  Message Text Normal The color of normal text of a message
  889.  
  890.                  Message Text Quote  The color of a quoted portion of a
  891.                                      message
  892.  
  893.                  Message Text TaglineThe color of a tagline portion of a
  894.                                      message
  895.  
  896.              The remaining components whose color may be changed are the
  897.              detail list view portions of the four subdialogs within KWQ
  898.              Mail/2:
  899.  
  900.                  Message Dialog Background
  901.                  Bookmark Dialog Background
  902.                  Findlist Dialog Background
  903.                  Conference Dialog Background
  904.  
  905.              To change one of the listed colors, simply select its radio
  906.              button and choose a color from the 16 shown.  If you wish to
  907.              use a custom color for one of the listed colors, open an OS/2
  908.              Color Palette and drop one of the colors on the large color
  909.              example display on lower right of the setup page.  Optionally,
  910.              you may drop the color you wish to change onto the message
  911.              display or any of the listed dialog subcomponents.  This will
  912.              only change the background color of these components, however.
  913.  
  914.  
  915.  
  916.                                            KWQ Mail/2, Version 1.2.    Page 15
  917.  
  918.  
  919.  
  920.  
  921.  
  922.        Fonts Notebook Page
  923.  
  924.              A number of facilities for changing fonts within KWQ Mail/2
  925.              exist.  The Fonts notebook page contains a set of radio buttons
  926.              and the OS/2 standard font selection dialog which name eleven
  927.              different components of KWQ Mail/2.  Choosing one of the radio
  928.              buttons at the top of the notebook page will cause the lower
  929.              half to display the font assigned to that component of KWQ
  930.              Mail/2.  You can change this component's font by using the
  931.              standard font selection dialog.
  932.  
  933.              The components you may change for KWQ Mail/2 you may change
  934.              from the Fonts notebook page are:
  935.  
  936.                  Main Window             Set the font for the entire main
  937.                                          window
  938.  
  939.                  Message Text            Set the font for just the message
  940.                                          display text
  941.  
  942.                  Internal Editor         Set the font for the internal editor
  943.  
  944.                  Foundlist Dialog        Set the font for the found list dialog
  945.                                          window and dialog components
  946.  
  947.                  Foundlist Details       Set the font for the found list
  948.                                          dialog details view list
  949.  
  950.                  Message Dialog          Set the font for the message
  951.                                          dialog window and dialog
  952.                                          components
  953.  
  954.                  Message Details         Set the font for the message
  955.                                          dialog message details view list
  956.                                          Bookmarks
  957.  
  958.                  Dialog                  Set the font for the bookmark
  959.                                          list dialog window and dialog
  960.                                          components
  961.  
  962.                  Bookmarks Details       Set the font for the bookmark
  963.                                          list dialog details view list
  964.  
  965.                  Conferences Dialog      Set the font for the conferences
  966.                                          dialog window and dialog
  967.                                          components
  968.  
  969.                  Conferences Details     Set the font for the conferences
  970.                                          dialog details view list
  971.  
  972.              System default fonts and any outline fonts (Adobe fonts)
  973.              loaded into the system will appear in this dialog.  Generally,
  974.              outline fonts can be supported for any pitch value.  Some
  975.  
  976.  
  977.                                            KWQ Mail/2, Version 1.2.    Page 16
  978.  
  979.  
  980.  
  981.  
  982.  
  983.              fonts displayed in larger pitch values will cause KWQ to
  984.              activate the horizontal scroll bar for the messages window.
  985.  
  986.              You may also change a font selection in KWQ Mail/2 by opening
  987.              an OS/2 Font Palette object and dragging and dropping a font
  988.              onto the window or subwindow you wish to change.
  989.  
  990.        Message Sort Options
  991.  
  992.              Message sort options (the order in which the messages will be
  993.              displayed in the messages dialog) are controlled by choosing
  994.              the "Setup->Sort" menu.  There are 6 different sort methods:
  995.              from, to, subject, date, message, and thread.  All of these
  996.              should be self-explanatory, except for thread which is a
  997.              variation on message sorting.  Thread sort attempts to maintain
  998.              ordering based on the message number, with a secondary sort
  999.              based on the reference number (the numbered message that a
  1000.              message may refer to).
  1001.  
  1002.              Packet Component Options
  1003.  
  1004.              KWQ can be configured to automatically display certain mail
  1005.              packet components that may be added to your mail by your host
  1006.              BBS.  These configuration options include the automatic display
  1007.              of the mail welcome, mail news, mail files, and mail good-bye
  1008.              components.  To set these options, choose the "Packet->Show
  1009.              Automatically" menu choice,  and select the components you wish
  1010.              automatically displayed.  Changes to these menu choices will be
  1011.              saved between sessions.
  1012.  
  1013.        Print Setup
  1014.  
  1015.              To setup your default settings, choose the menu choice "File-
  1016.              >Print Setup...".  A dialog will appear listing each printer
  1017.              object you have defined in your system.  To make a printer the
  1018.              default printer for KWQ Mail/2, simply select it in the list.
  1019.              You can change the default job settings by pressing the "Job
  1020.              Properties" button.  Another dialog will be displayed, this one
  1021.              specific to your printer.
  1022.  
  1023.              Two other options are provided for different print needs.  The
  1024.              first is an option to "Print Raw", which will send the message
  1025.              text to the printer in a line printer mode with carriage
  1026.              returns.  To use Adobe or other outline fonts to print, choose
  1027.              "Outline Fonts" and press the "Set Font" button to set the font
  1028.              for printing.
  1029.  
  1030.  
  1031.  
  1032.      Finding Text
  1033.  
  1034.          Support for finding text within the message base is fairly
  1035.          sophisticated, with more support on the way.  Text can be searched
  1036.  
  1037.  
  1038.                                            KWQ Mail/2, Version 1.2.    Page 17
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.          over the 'From', 'To', or 'Subject' fields, as well as the actual
  1045.          subject matter.  Searching can be done without regard to case
  1046.          (check 'case insensitive search'), and whole words can be matched
  1047.          or simply parts of words.  You may also choose to search the
  1048.          current conference or search across all conferences.
  1049.  
  1050.          To search for text, choose the 'Find->Start Find' menu choice, or
  1051.          choose the hotkey 'F'.  The find dialog will appear.  Specify the
  1052.          text to search for in the "Text" field, and choose the message type
  1053.          you wish to search over.  Other options include checking the "Case
  1054.          Insensitive Search" box, which causes text to be searched for
  1055.          without regard to case sensitivity, and checking the "Match Entire
  1056.          Word" box, which causes a search for the string you specify to be
  1057.          delimited by a space or punctuation character.
  1058.  
  1059.          A search is started by pressing the "Find" button or by typing
  1060.          <Enter>.  A status of how many messages found appears in the lower
  1061.          right hand corner of the KWQ main window.  Once all the messages
  1062.          are searched, KWQ shows a dialog containing a list of all the
  1063.          messages found by your search criteria.  This dialog behaves much
  1064.          in the way the Messages dialog does (described above).  To jump to
  1065.          one of the listed messages, simply select and item and press
  1066.          "Goto", or double click one of the listed items.
  1067.  
  1068.          The "Found List" dialog can be shown at any time by choosing "Find-
  1069.          >Found List", or by pressing the hotkey combination "<ctrl>F."
  1070.  
  1071.          If you currently have a found list activated by the find message
  1072.          utility, you may choose to see the next message found in the found
  1073.          list by choosing "Find->Next Message", or likewise see the previous
  1074.          item by choosing "Find->Previous Message."  Hotkeys for these two
  1075.          choices are 'N' and 'P', respectively.
  1076.  
  1077.          The found list is cleared when the mail packet is closed.
  1078.  
  1079.  
  1080.  
  1081.      Replying to Messages
  1082.  
  1083.          Replying to a message you are currently reading is simple.  To
  1084.          start a reply, choose the "Message->New Reply" menu choice, or
  1085.          press the hotkey "R."  If the Paths dialog (described above) is
  1086.          configured properly for you external editor, KWQ will be able to
  1087.          create a quoted reply message and start the editor of your choice.
  1088.  
  1089.          Depending on whether you have KWQ Mail/2 setup to use its internal
  1090.          editor, an external program may or may not be called up to allow
  1091.          you to write your message or reply.  The internal editor is faster
  1092.          opening up because it is not a separate program to run, and has
  1093.          some other nice features specific to writing replies (quoting,
  1094.          etc).
  1095.  
  1096.  
  1097.  
  1098.  
  1099.                                            KWQ Mail/2, Version 1.2.    Page 18
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.          After making changes to the message and saving the changes, exit
  1106.          the message editor.  KWQ will bring up a message detail dialog box
  1107.          if you are configured to use an external editor.  If you are using
  1108.          the internal editor the dialog box for the editor will be
  1109.          integrated with the message detail dialog box.  This dialog box
  1110.          contains information about the reply you have composed, including
  1111.          your name ('From'), the person you are replying to ('To'), the
  1112.          subject you are talking about ('Subject'), the conference the
  1113.          message is in ('Conference'), and an optional message tagline
  1114.          ('Tagline').  To change any of the fields (except Conference),
  1115.          simply type over the supplied text.  To change the conference the
  1116.          message will appear in, use the selection box down arrow to see the
  1117.          other conferences KWQ knows about.  Choosing any other conference
  1118.          within this list changes the conference the reply will appear in.
  1119.  
  1120.          Tagline support is optional, although with the demo version of KWQ
  1121.          taglines are always forced on, if only to display the KWQ Mail/2
  1122.          banner.  To choose a tagline click on the "down arrow" of the
  1123.          selection box.  This selection box is filled with taglines that
  1124.          appear one per line within the file specified in the "Paths"
  1125.          dialog.
  1126.  
  1127.          Tagline selection can also be set into a "random" mode via the
  1128.          "Toggles" setup dialog (described above).  Tagline selection can
  1129.          always be overridden.
  1130.  
  1131.  
  1132.  
  1133.      Editing A Reply
  1134.  
  1135.          You may make changes to any message you have composed by choosing
  1136.          the "Edit Reply" menu. To do so, open the Conferences dialog,
  1137.          choose the "Replies" conference, and find the message you wish to
  1138.          change. To change the message, you must have the reply "active"
  1139.          (you must be reading it).  Choose the menu choice "Message->Edit
  1140.          Reply", or use the hotkey "E" .  At this time, your external editor
  1141.          as defined in the "Paths" dialog will be brought up with your
  1142.          message.  You may then make changes to the message and save them,
  1143.          at which time KWQ will open the message details dialog as described
  1144.          above.  You may make changes to any field within the message
  1145.          details dialog, including changing the conference the message will
  1146.          appear in.
  1147.  
  1148.  
  1149.  
  1150.      Killing A Reply
  1151.  
  1152.          If you decide you do not wish a reply to be integrated into the BBS
  1153.          message stream when you upload a reply packet, you may choose to
  1154.          remove a reply from the list of replies for a packet.  To do so,
  1155.          open the Conferences dialog, choose the "Replies" conference, and
  1156.          find the message you wish to remove.  To remove a reply, you must
  1157.          have the reply "active" (you must be reading it).  Choose the menu
  1158.  
  1159.  
  1160.                                            KWQ Mail/2, Version 1.2.    Page 19
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.          choice "Message->Kill Reply", or use the hotkey "K" to remove the
  1167.          reply.
  1168.  
  1169.  
  1170.  
  1171.      Writing New Messages
  1172.  
  1173.          Writing new messages is very similar to the previous section
  1174.          described for making replies to messages.  The only difference is
  1175.          that no message is initially quoted within your editor, and fewer
  1176.          fields are filled out in the message details dialog.
  1177.  
  1178.  
  1179.  
  1180.      Internal Editor
  1181.  
  1182.          For people who wish to simplify the creation of new messages, KWQ
  1183.          Mail/2 provides a simple text editor to create messages, called the
  1184.          "internal editor."  To setup and use the internal editor, open the
  1185.          settings notebook General page, and choose the check box marked "Use
  1186.          Internal Editor."
  1187.  
  1188.          The internal editor has three major sections.  The first section
  1189.          starting from the top of the window are a set of buttons which give
  1190.          quick access to commonly used functions within the editor.  The
  1191.          second section is referred to as the message envelope, which
  1192.          contains entry fields to allow you to enter the addressee, subject
  1193.          and conference for the message you are writing.  The last section is
  1194.          the area where you type the body of the text.  If you are replying
  1195.          to a message, this area may be divided into two parts: one for the
  1196.          original message and one for your reply.
  1197.  
  1198.              Quick Access Buttons
  1199.  
  1200.                  Save        Pressing this button closes the editor and saves
  1201.                              any changes you have made to your message.
  1202.  
  1203.                  Cancel      Pressing this button or the escape key will
  1204.                              abort editing your message.  Any changes you
  1205.                              have made to the message envelope or message
  1206.                              text will be lost.
  1207.  
  1208.                 Quote       When replying to a message, try selecting an
  1209.                             area of the original message and pressing this
  1210.                             button.  The text you  have selected will be
  1211.                             copied to the message you are editing along
  1212.                             with the quoting style you have selected in the
  1213.                             Replies page of the setup notebook.
  1214.  
  1215.                             Note that if you do not have selected text in
  1216.                             the original message that all of the text is
  1217.                             quoted.  This is a change from Version 1.1,
  1218.                             which gave you a Quote and Quote All button.
  1219.  
  1220.  
  1221.                                            KWQ Mail/2, Version 1.2.    Page 20
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.                  Import      This button allows you to open a file for
  1228.                              importing into your editing session.
  1229.  
  1230.                  Cut         Pressing this button causes any text selection
  1231.                              you have made in the message you are editing to
  1232.                              be removed and placed in the workplace
  1233.                              clipboard.
  1234.  
  1235.                  Copy        Pressing this button causes any text selection
  1236.                              you have made in the message you are editing to
  1237.                              be placed in the workplace clipboard.
  1238.  
  1239.                  Paste       Pressing this button causes text in the
  1240.                              workplace clipboard to be copied to the message
  1241.                              you are editing.
  1242.  
  1243.              Message Envelope
  1244.  
  1245.                  The message envelope contains standard entry fields and
  1246.                  pull down lists to aid in creating the information needed
  1247.                  to address a message to someone.  If you have the message
  1248.                  sort setup to be Thread or Subject, you can use the pull
  1249.                  down added to the 'To:' field to see a list of people
  1250.                  listed in the current thread when creating a reply.
  1251.  
  1252.              Message Text
  1253.  
  1254.                  The message text display uses the standard Presentation
  1255.                  Manager text editing facility, which includes the ability
  1256.                  to cut, copy and paste using the keyboard.  A list of
  1257.                  keyboard strokes that can be used in the message text
  1258.                  editor are listed below in the section titled "Key
  1259.                  Mappings."
  1260.  
  1261.                  If you are replying to a message, the window for editing
  1262.                  the text is divided into a portion for the original message
  1263.                  and a portion for typing your message.  The small border
  1264.                  between the two sections can be used to size the two areas.
  1265.                  Your pointer should change shape to a sizing pointer when
  1266.                  it is placed over this horizontal bar.  Clicking and
  1267.                  dragging this border with BUTTON 1 will cause the text
  1268.                  areas to be resized.
  1269.  
  1270.  
  1271.  
  1272.      Packet Components
  1273.  
  1274.         Many electronic bulletin boards offer the ability to add extra
  1275.         files to a mail packet for you to review offline.  KWQ Mail/2
  1276.         offers the ability to detect the presence of these extra files and
  1277.         display them as requested.  In addition, KWQ Mail/2 can be
  1278.         configured to automatically display components of the mail packet
  1279.         when you open your mail.
  1280.  
  1281.  
  1282.                                            KWQ Mail/2, Version 1.2.    Page 21
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.         Each mail packet generator may not generate each packet component
  1289.         that KWQ Mail/2 can show.  Also, some mail packet generators allow
  1290.         for different components to be included in the mail packet.  Your
  1291.         mileage may vary.
  1292.  
  1293.          Use the choices on the Packet pull-down to display:
  1294.  
  1295.               Information
  1296.  
  1297.                  Display information about the mail packet you are viewing.
  1298.                  Information shown in this dialog are the size
  1299.                  (uncompressed) of the mail packet (the sum of the size of
  1300.                  all the messages), the number of messages in the packet,
  1301.                  the number of pending replies for this BBS, the number of
  1302.                  conferences in the packet, and the date and time the packet
  1303.                  was created. In addition, information may be supplied about
  1304.                  the BBS the packet was downloaded from, including the name
  1305.                  of the BBS, the Address, the "Sysop", and the phone number.
  1306.  
  1307.               Welcome
  1308.  
  1309.                  Display the BBS welcome screen.  Some BBS-es will supply a
  1310.                  "welcome" file which will display a logon screen that a
  1311.                  user would see when logging on to the system.
  1312.  
  1313.               News
  1314.  
  1315.                  Display the BBS news screen.  Some BBS-es will supply a
  1316.                  "news" file containing all the latest information about the
  1317.                  BBS.
  1318.  
  1319.               Bulletins
  1320.  
  1321.                  Display the current BBS bulletins. Bulletins may be
  1322.                  provided by the BBS to show detailed information about
  1323.                  services the BBS is providing, interesting trivia,
  1324.                  statistics, etc.
  1325.  
  1326.               Files
  1327.  
  1328.                  Display a list of the newest files provided by the BBS.
  1329.                  Many BBS-es contain support files and shareware for
  1330.                  downloading.
  1331.  
  1332.               Session
  1333.  
  1334.                  Display the host mail session screen. Some mail generation
  1335.                  doors will send a view of the mail session results included
  1336.                  in the mail packet.  This screen may contain summary
  1337.                  information about the packet you have downloaded.
  1338.  
  1339.               Goodbye
  1340.  
  1341.  
  1342.  
  1343.                                            KWQ Mail/2, Version 1.2.    Page 22
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.                  Display the logoff screen.  The "Goodbye" screen may have
  1350.                  interesting twists, sayings, statistics about remaining
  1351.                  time available, etc.
  1352.  
  1353.               Automatically Show
  1354.  
  1355.                  KWQ Mail/2 may be configured to automatically show the
  1356.                  Welcome, News, Files or Goodbye screen.  Choose any of
  1357.                  these menu choices as a "toggle:" if the menu choice is
  1358.                  selected, it will automatically display one of the above
  1359.                  screens, if it is deselected, the screens will only be
  1360.                  shown if manually selected.
  1361.  
  1362.                  Changes made to any of the "Automatically Show" settings
  1363.                  will be saved between KWQ Mail/2 sessions.
  1364.  
  1365.          NOTE:   Many of these mail components are provided in ANSI" screen
  1366.                  format, and while KWQ Mail/2 can handle most of these, the
  1367.                  ANSI support used by KWQ is what the base operating system
  1368.                  provides.  Some "garbling" may occur of the more fancy
  1369.                  displays.
  1370.  
  1371.  
  1372.  
  1373.      Bookmarks
  1374.  
  1375.          When a message or set of messages is deemed important by you, but
  1376.          you'd like to continue reading elsewhere within the packet or
  1377.          perhaps close the packet and reread it at another time, a
  1378.          "bookmark" can be made to the message base for jumping back to a
  1379.          previous position.
  1380.  
  1381.          To add a bookmark, choose the "Bookmark->Add" menu choice or press
  1382.          <Ctrl>A.  A message will appear at the bottom of the screen
  1383.          indicating that the message has been marked.
  1384.  
  1385.          A list of bookmarks is kept that is similar to the messages dialog
  1386.          described above.  Choosing "Bookmark->List" or pressing <Ctrl>B
  1387.          will bring up this dialog, and you may return to the previously
  1388.          saved position in the same manner as the messages dialog.
  1389.  
  1390.          There is no limit on the number of bookmarks in a message packet,
  1391.          and the bookmarks are saved along with the packet if KWQ is
  1392.          configured to do so.
  1393.  
  1394.          You may choose to save all of the messages in the bookmarks list to
  1395.          a single file you specify.  To save the marked messages, choose the
  1396.          menu choice "Bookmarks->Save To File...".
  1397.  
  1398.  
  1399.  
  1400.      Packet Configuration Files
  1401.  
  1402.  
  1403.  
  1404.                                            KWQ Mail/2, Version 1.2.    Page 23
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.          There may be times you wish to create messages for a particular BBS
  1411.          and you do not have a packet to open in order to create the BBS.
  1412.          To get around this problem, you may save a particular BBS
  1413.          configuration and later open this configuration file to write
  1414.          messages, create a reply packet, and then upload the packet.  BBS
  1415.          configuration files are stored with the name of the BBS and the
  1416.          extension ".BBS".
  1417.  
  1418.          To save a BBS configuration, open a valid QWK packet file, and then
  1419.          choose the "File->Save Packet Configuration" menu choice.  You can
  1420.          later open this configuration file by choosing "File->Open Packet
  1421.          Configuration", which will effectively open an empty packet.  You
  1422.          can then choose to write a new message and perform all the
  1423.          functions of a regular mail packet.
  1424.  
  1425.  
  1426.  
  1427.      Key Mappings
  1428.  
  1429.          A summary of the key mappings for KWQ follows:
  1430.  
  1431.                  Open Mail Packet       Ctrl-O
  1432.                  Close Mail Packet      Ctrl-Q
  1433.                  Pack Replies           Ctrl-Z
  1434.                  Save Message           Ctrl-S
  1435.                  Quick Exit             Alt-X
  1436.                  Write New Message      W
  1437.                  Reply To Message       R
  1438.                  Edit Reply             E
  1439.                  Start Find             F
  1440.                  Next Found Item        Ctrl-N
  1441.                  Previous Found Item    Ctrl-P
  1442.                  Found List             Ctrl-F
  1443.                  Next Message           <enter> or '+'(plus)
  1444.                  Advance Message        <space>
  1445.                  Previous Message       <-> (minus)
  1446.                  Next Subject           Tab
  1447.                  Previous Subject       Shift-Tab
  1448.                  Read Reply             Ctrl-R
  1449.                  Drop Bookmark          Ctrl-A
  1450.                  Bookmark List          Ctrl-B
  1451.                  Steal Tagline          Ctrl-T
  1452.                  View Message In ANSI   Ctrl-V
  1453.                  Message List           <Ins>
  1454.                  Conference List        <Del>
  1455.                  Scroll Message Down    <down>
  1456.                  Scroll Message up      <up>
  1457.                  Scroll Message Right   <right>
  1458.                  Scroll Message Left    <left>
  1459.                  Page Message Down      <pgdn>
  1460.                  Page Message Up        <pgup>
  1461.                  Top of Message         <home>
  1462.                  End of Message         <end>
  1463.  
  1464.  
  1465.                                            KWQ Mail/2, Version 1.2.    Page 24
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.          Many of the key combinations are intended to be similar to those
  1473.          made popular by message readers under the "other" operating
  1474.          system.
  1475.  
  1476.          The following key mappings exist inside the internal editor:
  1477.  
  1478.                  Save Message           Alt-S
  1479.                  Quit Messaage          Esc
  1480.                  Quote From Message     Alt-Q
  1481.                  Quote Whole Message    Alt-T
  1482.                  Cut To Clipboard       Alt-C
  1483.                  Copy To Clipboard      Alt-O
  1484.                  Paste From Clipboard   Alt-P
  1485.                  Delete Line            Alt-D
  1486.                  Cut To Clipboard       Shift-Del
  1487.                  Copy To Clipboard      Ctrl-Ins
  1488.                  Paste From Clipboard   Shift-Ins
  1489.                  Select Text Right      Shift-Right
  1490.                  Select Text Left       Shift-Left
  1491.                  Select To End Of Line  Shift-End
  1492.                  Select To Beginning Of Line Shift-Home
  1493.  
  1494.  
  1495.      Enhancements For Version 1.2.
  1496.  
  1497.           1    Revovering from a crash is now bullet-proof with respect to
  1498.                messages you write.  Any time you create a message within KWQ,
  1499.                the file BBS.MSG is created in the .\KWQMAIL.$$$ directory.
  1500.                This is basically a QWK compatible file that has all the
  1501.                messages you write.  If your system crashes (or God forbid, KWQ
  1502.                does), you will no longer lose any cruicial work.  You have two
  1503.                options: 1) open KWQ and let it read this file and it will
  1504.                prompt you if you want to recover it, 2) Zip the file into
  1505.                BBS.REP and upload it to your Bulletin board.
  1506.           2    Sped up display of message display dramatically through use of
  1507.                different drawing APIs.
  1508.           3.   Configuration option to have KWQ ignore "\n " type of lines
  1509.                during reformatting of reply text.
  1510.           4.   Show message in ANSI viewer.
  1511.           5.   Bulk marking messages to save to a file.  Bookmarked messages
  1512.                can now be saved to one file.
  1513.           5.   Zip replies on demand.
  1514.           6.   Better handling of non-standard, sneaky tagline positioning
  1515.                when stealing taglines.
  1516.           7.   Allow first name of author, first name of reciepient, current
  1517.                date, current weekday, current conference, current message
  1518.                number to be put into message header or footer.
  1519.           8.   Place "All" in the "To:" portion of the message envelope.
  1520.           9.   Saved searches.  KWQ now remembers the last 10 searches you did
  1521.                in a combo box for quick access.
  1522.           10.  Allow user to expand tabs in internal editor to n characters.
  1523.           11.  Page Down/Page Up buttons added to top of KWQ Mail/2 window.
  1524.  
  1525.  
  1526.                                            KWQ Mail/2, Version 1.2.    Page 25
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.           12.  Allow user to insert file to KWQ (text) in the internal editor.
  1533.           13.  Header and Footer are seperate notebook pages in the setup
  1534.                dialog for purely esthetic reasons.
  1535.           14.  Tagline initialization is now on a thread, since really large
  1536.                tagline files can cause KWQ to be sluggish when you first open
  1537.                the application.
  1538.           15.  File Time is now displayed in packet open dialog.
  1539.           16.  Read reply hotkey and menu choice added.
  1540.           17.  "Delete line" key added (Alt-D, for Brief Users) for internal
  1541.                editor.
  1542.           18.  Option to strip 'Re:' crap from all message subjects.
  1543.           19.  Option to automatically jump to next conference.
  1544.           20.  Option for file name expansion for save.  This is a late
  1545.                breaker.  Use any of the header and footer expansion characters
  1546.                in your save file specification, and KWQ will expand these into
  1547.                a file name when you save the message.  For instance, use %e to
  1548.                save messages to the current conference name.
  1549.           21.  I don't know why this is critical, but many people asked for
  1550.                it. KWQ now displays the file name for the packet that is open
  1551.                in the main title.
  1552.  
  1553.  
  1554.      Bugs/Anomolies Fixed in Version 1.2
  1555.  
  1556.           1.   Quoting within the internal editor will now ignore previously
  1557.                quoted text when autowrapping.
  1558.           2.   Page down will now display the right portion of the message
  1559.                (shows last line of previous page at top).
  1560.           3.   Printing now prompts the user to setup the print font when
  1561.                doing a print with outline fonts without ever setting up the
  1562.                outline font to print with.
  1563.           4.   Conference "Ghost" dialog occurs using 9 Lives desktop
  1564.                expander.
  1565.           5.   Can't use TAB character in MLE for internal editor--you now
  1566.                have the option to expand tabs (an enhancement, too).
  1567.           6.   Headers/Footers should be available on write new.
  1568.           7.   0x1a character occassionally showing up at end of file.
  1569.           8.   Handle quoting with names > 2 parts ("Paul von Keep").
  1570.           9.   Inserting very large messages crash KWQ using an external
  1571.                editor.
  1572.           10.  Saving messages sometimes caused a floating point exception.
  1573.           11.  Saving large messages (like "Frequently Asked Questions) would
  1574.                sometimes crash KWQ.
  1575.           12.  User bookmarks not saving properly. Saves first item in list
  1576.                over and over.
  1577.           13.  Information dialog does not have enough space for BBS name with
  1578.                long title.
  1579.           14.  "D:\" is not a valid path for QWK files or replies files.
  1580.           15.  If spooler is disabled, printing causes KWQ to shutdown.
  1581.           16.  Install program prompts for directory, and then forces the
  1582.                directory to upper case.
  1583.           17.  Conference rollover not working properly--would not display the
  1584.                right conference sometimes.
  1585.  
  1586.  
  1587.                                            KWQ Mail/2, Version 1.2.    Page 26
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.           18.  Fix add/drop conferences.
  1594.           19.  Enable keyboard only setup--you can now setup KWQ without
  1595.                having a rodent to use.  To switch from the notebook control
  1596.                tabs to the internal tabs, use Alt-Up and Alt-Down.  Pressing
  1597.                enter saves the changes, pressing esc aborts.
  1598.           20.  Close box in internal editor does not prompt user to save
  1599.                changes.
  1600.           21.  Reply packet creation code would fail with paths that contain
  1601.                trailing blanks.(ie-Path = 'c:\up ' )
  1602.           22.  File open dialog should use file mask that user setup.
  1603.           23.  Fixed crash with paging backwards within a find list very
  1604.                quickly.
  1605.           24.  Private messages now use proper private marker ('*' instead of
  1606.                '~').
  1607.           25.  Better handling of current message in message list.  KWQ now
  1608.                goes to great lengths to keep the message you are currently
  1609.                viewing current within the message display list.
  1610.  
  1611.  
  1612.      What is KWQ, and What Does KWQ Mean?
  1613.  
  1614.          Great, by now you've figured out that KWQ is QWK spelled
  1615.          backwards. The letters KW are the initials of KWQ Mail/2's author,
  1616.          Kurt Westerfeld.  Ergo, KWQ means Kurt Westerfeld's QWK Mail.
  1617.  
  1618.          KWQ was developed using WorkSet/2, the 32 bit development
  1619.          environment from IBM (using C Set/2), the Borland C++ Compiler For
  1620.          OS/2, Q Edit, and GNU RCS.
  1621.  
  1622.  
  1623.  
  1624.      Registration and Support
  1625.  
  1626.          At this time there will be no phone support for KWQ Mail/2
  1627.          offered. If demand requires it, phone support will be added at a
  1628.          later date.
  1629.  
  1630.          Registration and support for KWQ Mail/2 is available by contacting
  1631.          the author directly at one of the following addresses:
  1632.  
  1633.              U.S. Mail:       7935 Tyson Oaks Circle
  1634.                               Vienna, Virgina 22182
  1635.  
  1636.              Compuserve:      71501,3175.
  1637.  
  1638.              Internet:        71501.3175@compuserve.com
  1639.  
  1640.              Fido Netmail:    Kurt Westerfeld, 1:109/347
  1641.                               (Pete Norloff's OS/2 Shareware)
  1642.  
  1643.              Fido OS/2
  1644.              Conference:      Kurt monitors the OS/2 conference on an
  1645.                               almost-daily schedule, so if you have access
  1646.  
  1647.  
  1648.                                            KWQ Mail/2, Version 1.2.    Page 27
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.                               to this conference, you may post here.
  1655.                               However, this is not recommended or suggested
  1656.                               practice, as the message traffic in this
  1657.                               conference is fairly high.  If you can,
  1658.                               please send "Netmail."
  1659.  
  1660.              Direct BBS:      You may post a message to Kurt Westerfeld in
  1661.                               the "Local Area" conference on Pete Norloff's
  1662.                               OS/2 Shareware bulletin board, at (703) 385
  1663.                               4325.
  1664.  
  1665.         Please see the file "ORDERKWQ.FRM" for information about what to
  1666.         send in to register KWQ Mail/2.  When you register KWQ Mail/2 you
  1667.         will be provided with a registration number that enables you to
  1668.         "unlock" the initial Product Information screen, and disable its
  1669.         automatic action when KWQ Mail/2 starts.  A similar registration
  1670.         number is provided to each registered user; sharing this number is
  1671.         prohibited and is considered a violation of copyright.
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.                                            KWQ Mail/2, Version 1.2.    Page 28