home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_mail / pq215c.arj / POWERQWK.DOC < prev    next >
Text File  |  1992-02-09  |  47KB  |  1,031 lines

  1.  
  2.          POWER-QWK v2.15  Shareware from POWERLINE SYSTEMS Ltd
  3.  
  4.            (C) Gale Green and PowerLine Systems Limited 1991
  5.  
  6.      POWER-QWK  is  SHAREWARE. This means that you can try it out
  7.      to ensure that it suits your needs before you pay for it. It
  8.      is not free software and if you continue to use the  program
  9.      AFTER 4 WEEKS OF TESTING YOU MUST REGISTER IT. If you do not
  10.      wish  to register you must cease using the software. Info on
  11.      the very low registration cost is included  at  the  end  of
  12.      this  DOC file. There is also a file named PRINT.ME included
  13.      with Power-Qwk which you can print and post to register  the
  14.      software,  Upon registration you will be sent a registration
  15.      number which will  not  only  allow  you  to  register  this
  16.      version  of  the software but also future versions. Register
  17.      now and support the Shareware concept.
  18.  
  19.      This program may not be sold or included with any commercial
  20.      product  without written permission from  Powerline  Systems
  21.      Ltd.
  22.  
  23.  
  24.      Contents
  25.      ~~~~~~~~
  26.  
  27.           1. Background and Introduction to Power-QWK
  28.  
  29.           2. Installing Power-QWK
  30.  
  31.           3. Running Power-QWK
  32.  
  33.                3.1 Getting Started
  34.  
  35.                3.2 Configuration Manager
  36.  
  37.                3.3 The Message Base and Topics Menus
  38.  
  39.                3.4 The Bulletins Menu
  40.  
  41.                3.5 The Conference Menu
  42.  
  43.                3.6 Messages and Replies
  44.  
  45.                3.7 The History Menu
  46.  
  47.                3.8 Reading Files and Bulletins
  48.  
  49.                3.9 Automating Power-QWK
  50.  
  51.           4. Acknowledgments
  52.  
  53.           5. Disclaimer
  54.  
  55.           6. Registration and Support.
  56.  
  57.      1.   Background and Introduction to Power-QWK
  58.  
  59.           Power-QWK  was  born  of my  dissatisfaction  with  the
  60.           offline  readers  available  for  bulletin  boards  and
  61.           Online Services such as Direct-Line.
  62.  
  63.           None that I found offered any facilities for  retaining
  64.           mail  or  bulletins in an orderly accessible  manner  -
  65.           they  simply allowed the unpacking and reading of  mail
  66.           packets which, once read, were of no further value.
  67.  
  68.           Power-QWK,  written for Direct-Line but usable  on  any
  69.           Online  Service  which  has a QWK mail door, is a  full
  70.           Message  Base Manager. The principal facilities are  as
  71.           follows:
  72.  
  73.             -  permanent  storage  of  all  downloaded  messages,
  74.                bulletins and standard files such as the  NEWFILES
  75.                listing;
  76.  
  77.             -  full  ANSI  emulation for spectacular  viewing  of
  78.                animated  messages  and  bulletins;  ANSI   format
  79.                bulletins   are   recognised   automatically    by
  80.                Power-QWK;
  81.  
  82.             -  friendly,  effective, access to your message  base
  83.                with    one-key    commands    for     go-to-next,
  84.                go-to-previous, find-next-in-thread, and so on;
  85.  
  86.             -  DOS  filing and printing of any message,  file  or
  87.                bulletin, even printing ANSI bulletins as long  as
  88.                they  don't contain upwards  cursor  repositioning
  89.                sequences;
  90.  
  91.             -  reply  to a message received or 'say' an  original
  92.                message, automatically including received messages
  93.                in reply files to allow them to be quoted in  your
  94.                replies,  optionally importing the contents  of  a
  95.                DOS  file  into the message; several  methods  for
  96.                'fancy' quoting;
  97.  
  98.             -  having  written a message, it can be  recalled  at
  99.                any  time  prior  to  upload  (even  in  a   later
  100.                Power-QWK session) to be edited or to have changed
  101.                its Addressee, Destination Conference, Subject  or
  102.                Public/Private Status;
  103.  
  104.             -  reply  deletion;  you can change your  mind  about
  105.                sending  a  message  right up  to  the  moment  of
  106.                upload;
  107.  
  108.             -  taglines:  witty one-liners added to the  ends  of
  109.                your messages and replies; either selected by  you
  110.                for  each message or added randomly  by  Power-QWK
  111.                (or omitted if you don't like taglines);
  112.  
  113.             -  Power-QWK supports any number of tagline files;
  114.  
  115.             -  tagline  stealing:  you  can 'grab'  a  string  of
  116.                characters for insertion in your tagline file from
  117.                any  file,  bulletin  or message while  it  is  on
  118.                display;
  119.  
  120.             -  almost  everything configurable, including  screen
  121.                colours,  file  names, directory  names,  options,
  122.                etc;
  123.  
  124.             -  multiple  message bases if you subscribe  to  more
  125.                than one Online Service;
  126.  
  127.             -  automatic treatment of NEWFILES, appending to  the
  128.                list   maintained  by  Power-QWK,   ignoring   the
  129.                standard  files which appear as new every  day  on
  130.                Wildcat!  services; a sort feature allows  you  to
  131.                sort the NEWFILES list into alphanumeric sequence,
  132.                if your mail packets are obtained  from  a  Tomcat
  133.                mail door.
  134.  
  135.             -  automatic  memory  of which  files,  messages  and
  136.                bulletins have been read plus the ability to  mark
  137.                as read or unread or delete;
  138.  
  139.             -  message base prune facilities with the ability  to
  140.                keep  as many day's messages as you wish  (may  be
  141.                different  in  each conference) plus  the  ability
  142.                either to discard pruned messages or save them  in
  143.                a  Prune  Archive file (which looks  to  Power-QWK
  144.                just  like  another  conference  so  even   pruned
  145.                messages  may  be viewed and replied  to  just  as
  146.                though   they   were  still  in   their   original
  147.                conference);
  148.  
  149.             -  rebuild  and validation facilities to  ensure  the
  150.                integrity  of  your message base  following  power
  151.                failure  or  installation  of  a  new  version  of
  152.                Power-QWK;
  153.  
  154.             -  automatic  installation procedure to  ensure  that
  155.                Power-QWK  is installed properly with the  correct
  156.                layout  and complement of help  and  configuration
  157.                files. This procedure does not corrupt any  system
  158.                files such as config.sys or autoexec.bat.
  159.  
  160.             -  many  other  features will have been  added  since
  161.                the document you are reading was first written.
  162.  
  163.                Please read the file HISTORY.DOC  for  details  of
  164.                all new facilities added with each release  of the
  165.                product.
  166.  
  167. 2.   Installing Power-QWK
  168.  
  169.      Power-QWK Installation could not be simpler. All you need to
  170.      pre-create, if you don't have  them  already,  are  the  DOS
  171.      directories you wish to use for downloading mail packets and
  172.      uploading  reply  packets.  Power-QWK  also  uses   a   Work
  173.      Directory but you should not pre-create it.  Power-QWK  will
  174.      ask you during the installation configuration  session  what
  175.      name to use when creating this directory, but it is  created
  176.      at the start of every Power-QWK session and deleted again at
  177.      the end.
  178.  
  179.      You may use the same directory for uploading and downloading
  180.      but many people prefer to keep the functions separated.
  181.  
  182.      If you have to create these directories, DO NOT create  them
  183.      in your Power-QWK directory - this is reserved for files and
  184.      directories  created  by  Power-QWK  itself.  To  create the
  185.      directories, use the DOS command MKDIR, or MD for short.
  186.  
  187.      e.g.,       MD C:\DOWNLOAD
  188.                  MD C:\UPLOAD
  189.  
  190.      or, if you already have a general  communications  directory
  191.      called, say, COMMS then
  192.  
  193.                  MD C:\COMMS\DOWNLOAD
  194.                  MD C:\COMMS\UPLOAD
  195.  
  196.      Provided with Power-QWK is a file called INSTALL.EXE. If you
  197.      execute  this  file  and  then  answer  the  straightforward
  198.      questions  which  appear on the screen from  time  to  time,
  199.      Power-QWK  installation should take no longer than a  couple
  200.      of minutes. During the configuration session, Power-QWK will
  201.      offer default answers to most questions. If you have  doubts
  202.      about what answer you should give, just press the Return key
  203.      to make Power-QWK use the default value. You will be able to
  204.      come back and change your mind as often as required  in  the
  205.      future so it doesn't matter if you get a few things wrong at
  206.      first - the default answers will WORK!
  207.  
  208.      DO NOT ATTEMPT TO INSTALL Power-QWK OTHER THAN BY USING THIS
  209.      PROCEDURE. VITAL FILES WILL NOT BE CREATED, HELP FILES  WILL
  210.      NOT  BE LOCATED CORRECTLY AND Power-QWK WILL NOT WORK AS  IT
  211.      SHOULD.
  212.  
  213.      INSTALL.EXE CREATES FILES ONLY IN  THE  DIRECTORY  THAT  YOU
  214.      TELL IT, PLUS IT CREATES ONE SUBDIRECTORY 'OWNED BY' THE TOP
  215.      LEVEL Power-QWK DIRECTORY.
  216.  
  217.      SYSTEM FILES SUCH AS CONFIG.SYS  AND  AUTOEXEC.BAT  ARE  NOT
  218.      WRITTEN TO OR TAMPERED WITH IN ANY WAY.
  219.  
  220.      ALSO, IF YOU LATER REGISTER YOUR COPY OF Power-QWK THEN  YOU
  221.      WILL  NEED  TO  RUN  THE INSTALL  PROCEDURE  AGAIN  TO  TELL
  222.      Power-QWK  YOUR REGISTRATION NUMBER - SO DO NOT  DELETE  THE
  223.      FILE INSTALL.EXE EVEN WHEN INSTALLATION IS COMPLETE, YOU MAY
  224.      NEED IT LATER!!
  225.  
  226.      e.g., if you have downloaded Power-QWK from a bulletin board
  227.      then  you must have unzipped the file you received in  order
  228.      to  read  this document. To install Power-QWK, use  the  DOS
  229.      command  CD  to change to the directory containing  all  the
  230.      downloaded  files and then type INSTALL and  press  Carriage
  231.      Return.
  232.  
  233.      During the installation, the Power-QWK Configuration Manager
  234.      will  be invoked. You will be asked a variety  of  questions
  235.      related  to  the way in which Power-QWK is  to  handle  your
  236.      mail, files, bulletins, archives, etc.
  237.  
  238.      If  you are unsure how to answer any question  simply  press
  239.      Carriage  Return.  This causes Power-QWK to  use  a  default
  240.      answer for the question. You can always change your mind  at
  241.      a later date by running the Power-QWK Configuration  Manager
  242.      again (see section 3.2).
  243.  
  244.  
  245. 3.   Running Power-QWK
  246.  
  247.      3.1  Getting Started
  248.  
  249.           To  run  Power-QWK, switch to the  directory  in  which
  250.           Power-QWK  was  installed, type PQ and  then  press the
  251.           Enter key.
  252.  
  253.           e.g., if you installed Power-QWK in a directory  called
  254.           C:\POWER then you should enter the following commands:
  255.  
  256.                       CD C:\POWER
  257.                       PQ
  258.  
  259.           The  next  thing to appear will be the  Power-QWK  Main
  260.           Menu.
  261.  
  262.           From  now on, you can press the F1 key at any  time  to
  263.           obtain  full context-sensitive help for  ALL  Power-QWK
  264.           functions.
  265.  
  266.           The  Help  files are the definitive  documentation  for
  267.           Power-QWK.  If  you  would rather  have  this  text  in
  268.           printed form then, at any time in Help, press P to send
  269.           the currently active Help file to the printer.
  270.  
  271.           This   facility   is   intended   to   make   Power-QWK
  272.           documentation  as  easy to use as possible -  you  only
  273.           need to print out the bits that really interest you.
  274.  
  275.           Next,  select the item 'Process New Mail Packets'  from
  276.           the menu and press Enter. If there are any mail packets
  277.           (files  with  an  extension of .QWK)  in  the  Download
  278.           Directory   you   specified   during   the    Power-QWK
  279.           installation procedure then these will be unpacked.  If
  280.           there are no packets waiting then  Power-QWK  will  not
  281.           allow you to select this menu item.
  282.  
  283.           Power-QWK will automatically create a new message  base
  284.           for  each  Online  Service for  which  there  are  mail
  285.           packets. Each message base will be given the same  name
  286.           as  the .QWK file name used by the online  service  so,
  287.           for Direct-Line users, a message base named DLINE  will
  288.           be created.
  289.  
  290.           This  name is obtained from INSIDE the .QWK file so  it
  291.           does not matter if you have renamed your .QWK files for
  292.           your  own convenience (as long as they still  have  the
  293.           extension .QWK).
  294.  
  295.           If  Power-QWK finds more than one mail packet  then  it
  296.           processes them in chronological order of file  creation
  297.           time  within  date.  This is  not  strictly  necessary,
  298.           Power-QWK can apply .QWK files to message bases in  any
  299.           order,  but chronological order is fastest and  ensures
  300.           that the proper bulletins are made current.
  301.  
  302.           Unless  you  have told it otherwise  in  Configuration,
  303.           Power-QWK  will ask your permission before adding  each
  304.           mail packet to the message base.
  305.  
  306.           You  will now see a sequence of messages,  telling  you
  307.           that Power-QWK is creating your message base(s), adding
  308.           new files, bulletins and messages and creating new Mail
  309.           Conferences whenever required.
  310.  
  311.           Downloaded  NEWFILES  listings  are  appended  to   any
  312.           already  existent  listing  within  the  message   base
  313.           (remember  there  is a separate message base  for  each
  314.           online service to which you subscribe). The files which
  315.           are  shown  as  'new'  each  day  on  Wildcat! services
  316.           are automatically ignored.
  317.  
  318.           Bulletins automatically overwrite any already  existent
  319.           bulletins  with  the same number so your  message  base
  320.           always  contains  the latest version of  each  bulletin
  321.           maintained by your online service.
  322.  
  323.           Messages are stored in date/time order with a  separate
  324.           file  and  index  being  created  for  each  conference
  325.           (Wildcat Folder) supported by the online service.
  326.  
  327.           Whenever  Power-QWK detects the presence  of  messages,
  328.           bulletins  or other files which are  time/date  stamped
  329.           earlier than those already in the message base, it will
  330.           ask you for confirmation before accepting them.
  331.  
  332.           When all .QWK files have been processed (if there  were
  333.           any), Power-QWK re-displays the Main Menu.
  334.  
  335.           From  this menu, you can elect to enter  the  Power-QWK
  336.           Offline   Reader  (if  any  message  bases  have   been
  337.           created); call the Power-QWK Configuration Manager  (as
  338.           you've already seen during Installation); or Quit.
  339.  
  340.           If you elect to Quit, Power-QWK closes down its  screen
  341.           windows  plus  any open files and returns  to  the  DOS
  342.           command line.
  343.  
  344.           If  you call the Configuration Manager or  the  Offline
  345.           Reader (see below for details of what to do if you call
  346.           one of these) then the appropriate part of Power-QWK is
  347.           entered.  When  you quit the Configuration  Manager  or
  348.           Offline Reader, you return to the Power-QWK Main Menu.
  349.  
  350.      3.2  Configuration Manager
  351.  
  352.           The  Power-QWK Configuration Manager is in  two  parts:
  353.           General Configuration and Colour Customising.
  354.  
  355.           You can call the Power-QWK Configuration Manager either
  356.           from  the Power-QWK Main Menu or by running one of  the
  357.           programs  POWERCFG (General Configuration) or  POWERCOL
  358.           (Colour Customising) in the Power-QWK main directory.
  359.  
  360.           Colour  Customising  shows you, on a full  screen,  the
  361.           colours  that  are  used for  the  different  Power-QWK
  362.           menus. You can change them by using single key strokes.
  363.  
  364.           If one menu is always seen 'on top  of' another  within
  365.           Power-QWK  then it is shown in the same way  in  Colour
  366.           Customising  so  that you can see how the  two  screens
  367.           will look together.
  368.  
  369.           The  General  Configuration system is  menu-driven  and
  370.           forms nothing more than a question-and-answer session.
  371.  
  372.           The  General Configuration Manager's main  menu  offers
  373.           you  a selection of subject areas which you can  choose
  374.           to  configure.  For instance, you may  choose  to  tell
  375.           Power-QWK how you want your Personal mail to be handled
  376.           or  you may wish to change the names of various  system
  377.           files used by Power-QWK.
  378.  
  379.           You  can  press  F1 at any  time  within  Configuration
  380.           Manager  to obtain full context-sensitive Help on  each
  381.           item before committing yourself to a particular  course
  382.           of action.
  383.  
  384.           Once you have installed Power-QWK and done the  initial
  385.           configuration,   running  the   General   Configuration
  386.           Manager  is  one  of the best ways  of  learning  about
  387.           Power-QWK's facilities.
  388.  
  389.           Simply  press Enter to move from question  to  question
  390.           without  changing any of your original  answers.  Every
  391.           time you feel that you would like to know more about an
  392.           item, press F1 to read the associated Help file.
  393.  
  394.           As  long  as  you keep  pressing  Enter,  Configuration
  395.           Manager   will  continue  to  cycle  through  ALL   the
  396.           Configuration questions.
  397.  
  398.           Press  Esc  when  reading  an item  to  return  to  the
  399.           Manager's  Main  Menu;  press Esc  again  to  quit  the
  400.           Manager.
  401.  
  402.           Information   supplied  by  you  in  response  to   the
  403.           Configuration  Manager's questions is stored in a  file
  404.           named POWERQWK.CFG.
  405.  
  406.           This file is accessed every time you call Power-QWK  so
  407.           changes  you make have immediate effect, from the  next
  408.           time you run Power-QWK.
  409.  
  410.      3.3  The Message Bases and Topics Menus
  411.  
  412.           When you first enter the Power-QWK Offline Reader  from
  413.           the Main Menu, you will be offered one of two menus.
  414.  
  415.           If  you have more than one message base then  you  will
  416.           first  be  asked to select one for  processing  at  the
  417.           Message Bases Menu.
  418.  
  419.           You can have up to 30 message bases. Power-QWK sets one
  420.           up  automatically whenever it processes a  .QWK  packet
  421.           which  was downloaded from an online service  which  is
  422.           new to Power-QWK.
  423.  
  424.           Once  you have selected a message base, you move on  to
  425.           the  Power-QWk  Topics Menu. You will  have  come  here
  426.           straight away if you have only one message base.
  427.  
  428.           The available Topics represent the constituent parts of
  429.           .QWK  mail packets: Hello, News,  Bulletins,  NewFiles,
  430.           Messages, User Info and Goodbye.
  431.  
  432.           Hello,  News  and  Goodbye are  files  of  information,
  433.           supplied by the Sysop of the Online Service.
  434.  
  435.           User  Info is a screen of information relating to  your
  436.           use  of  the  online service - how  many  times  you've
  437.           logged  on to date, how many files you've uploaded  and
  438.           downloaded, etc. Some QWK mail  doors  do  not  include
  439.           this information in their mail packets.
  440.  
  441.           Bulletins   are   files  of  information   related   to
  442.           particular topics of interest. On Direct-Line, any  one
  443.           Bulletin  Number will nearly always relate to the  same
  444.           topic. For instance, Bulletin 14 is always the  current
  445.           list of the top twenty most active Direct-Line users.
  446.  
  447.           NewFiles  is  a  listing of all new  files  which  have
  448.           become  available for download from the online  service
  449.           since the last time you looked.
  450.  
  451.           'Messages' are the Personal and Public mail items which
  452.           were available for you to read on the online service at
  453.           the time you did your download.
  454.  
  455.           The  Topics  Menu, and all its  underlying  menus,  are
  456.           designed  to  allow you to read  all  currently  unread
  457.           files,  bulletins and messages by  repeatedly  pressing
  458.           the Enter key.
  459.  
  460.           When you press Enter at the Topics Menu, for  instance,
  461.           if  the  currently highlighted  Topic  contains  unread
  462.           information   then   Power-QWK   will   present    that
  463.           information for reading. Pressing Enter repeatedly will
  464.           cause  Power-QWK  to present all unread  items  in  the
  465.           Topic,  in sequence. When there are no  further  unread
  466.           items, Power-QWK returns to the Topics Menu.
  467.  
  468.           If  the  current Topic contains no  unread  information
  469.           then Power-QWK moves on to the next item automatically.
  470.  
  471.           Sometimes, you will want to read items or browse topics
  472.           which  you have read already. If this is the case  then
  473.           use  Tab instead of Enter. Tab forces entry to a  topic
  474.           even if it contains no unread items.
  475.  
  476.           In the case of the NewFiles Topic, Enter allows you  to
  477.           read "today's" NewFiles. Tab lets you see ALL  newfiles
  478.           to date.
  479.  
  480.           Power-QWK also has a powerful multi-phase sort facility
  481.           which  allows  you  to  sort  the  NewFiles  file  into
  482.           alphanumeric  sequence, at the same time including  any
  483.           old  NewFiles files which you may have  accumulated  in
  484.           the  past, perhaps using some other less powerful  mail
  485.           reader. Press F1 (Help) at the Topics Menu for details.
  486.  
  487.           In current releases of Power-QWK, NewFiles Sort is only
  488.           available for systems which store NewFiles in  Wildcat!
  489.           two-line-entry format. As other formats become sortable
  490.           the Help file will be updated to let you know. Also, of
  491.           course, new facilities such as this are always reported
  492.           in the file HISTORY.DOC which is  included  with  every
  493.           release of Power-QWK.
  494.  
  495.           Most Wildcat! Online services include two special files
  496.           in the NewFiles listing every day. Power-QWK recognises
  497.           these and ignores them automatically.
  498.  
  499.           If you ever subscribe to a Service which includes  only
  500.           one,  or more than two, such files then you can  inform
  501.           Power-QWK  of the correct number by pressing N  at  the
  502.           Topics Menu.
  503.  
  504.           Having selected an item from the Topics Menu, you  will
  505.           be shown single-file items like Hello and News straight
  506.           away.  If,  however, you choose Bulletins  or  Messages
  507.           then you will be presented with a further menu.
  508.  
  509.      3.4  The Bulletins Menu
  510.  
  511.           At the Bulletins menu, you can choose to read or delete
  512.           any of up to 1000 bulletins per conference  or  folder,
  513.           depending  on  how  many are supported  by  your online
  514.           service. As with all Power-QWK  menus,  there is a 'Key
  515.           Line' at the foot of the screen, to  remind  you of the
  516.           one-or-two-key commands which  are available.  For more
  517.           detailed information,  press F1  to enter the Power-QWK
  518.           context-sensitive Help system.
  519.  
  520.           As  with  the Topics Menu, Tab rather than  Enter  will
  521.           allow you to read Bulletins even if they have been read
  522.           already.  Pressing  Enter skips  bulletins  which  have
  523.           already been read.
  524.  
  525.           The Bulletin numbers are presented ten to a screen  and
  526.           you  can  read  'all currently  unread'  by  repeatedly
  527.           pressing Enter.
  528.  
  529.           You can select specific numbers by moving the  Bulletin
  530.           highlight  bar with the cursor and/or paging  keys  and
  531.           then pressing Enter or Tab.
  532.  
  533.           Press Del to delete the highlighted Bulletin (Power-QWK
  534.           will   ask  for  confirmation  before  performing   the
  535.           deletion).
  536.  
  537.           As with all Power-QWK information and message  screens,
  538.           once you are actually reading a bulletin, you can press
  539.           P to print it, F to file it (in a DOS file) and you can
  540.           press  L  or  N if you  require  Linefeeds  or  Newpage
  541.           characters  sending  to  the  printer  to  format  your
  542.           output.
  543.  
  544.      3.5  The Conference Menu
  545.  
  546.           If  you select Messages at the Topics  Menu,  Power-QWK
  547.           moves on to the Conference Menu. With current  releases
  548.           of  Wildcat!, a Power-QWK Conference corresponds  to  a
  549.           Wildcat! Message Folder.
  550.  
  551.           Conferences are presented for selection in alphabetical
  552.           sequence, ten to a screen. Two exceptions to this  rule
  553.           are   Personal  Mail  Conference  and   Prune   Archive
  554.           Conference,  described  later. If you have  a  Personal
  555.           Mail  Conference  then it always appears first  in  the
  556.           list  of  conferences;  if you  have  a  Prune  Archive
  557.           Conference  then  it  always appears  last.  The  Prune
  558.           Archive  conference also has the distinction of  always
  559.           being skipped by pressing Enter - you must press Tab to
  560.           read the Prune Archive Conference.
  561.  
  562.           Similar in action to the Bulletins Menu, you can  enter
  563.           in  turn each conference which contains unread mail  by
  564.           repeatedly pressing the Enter key. Continuing to  press
  565.           Enter  will automatically page you through  all  unread
  566.           messages in each such conference, finally returning  to
  567.           the  Conference  Menu  whenever there  are  no  further
  568.           unread messages in a conference.
  569.  
  570.           As  well as forming a gateway to the mail  conferences,
  571.           the Conference Menu also offers some extra  facilities,
  572.           each obtained by pressing a single key:
  573.  
  574.           P -  Prune current conference or all conferences;  this
  575.                causes Power-QWK to discard out-of-date  messages,
  576.                retaining  the number of days' worth  of  messages
  577.                specified  either in Configuration Manager  or  by
  578.                pressing D (see below).
  579.  
  580.                Old  messages will either be discarded or, if  you
  581.                have  specified to the Configuration Manager  that
  582.                you  wish  to  keep  a  Prune  Archive,  then  old
  583.                messages will be added into the PRUNE Conference.
  584.  
  585.                Here, they can be viewed and responded to just  as
  586.                though  they  were still in  their  conference  of
  587.                origin.
  588.  
  589.           D -  set  prune Days. This allows you to  set  specific
  590.                values for each conference, over-riding the global
  591.                value   you   have   already   set   in    General
  592.                Configuration Manager.
  593.  
  594.                You  might for instance want to keep the  contents
  595.                of your Personal Mail conference (if you have one)
  596.                forever.  Just  set  the number  of  days  on  the
  597.                PERSONAL conference to 999.
  598.  
  599.                You  might  wish  to keep messages  in,  say,  the
  600.                COMPUTER  conference for a fortnight but for  only
  601.                five days in, say, the COMMS conference.
  602.  
  603.           R -  Rebuild; press R again for full Rebuild or press V
  604.                just to Validate Counters;
  605.  
  606.                Rebuild  completely  reconstructs  all  Conference
  607.                Message  Indexes, ensuring that they  truly  match
  608.                the contents of the actual Message Files.
  609.  
  610.                Validate  Counters simply checks and  corrects  if
  611.                necessary all of Power-QWKs Pointers and Counters,
  612.                ensuring  that they reflect the true  contents  of
  613.                the Message Indexes.
  614.  
  615.                If  you ever doubt the integrity of  your  message
  616.                base,  run Validate Counters. If you are still  in
  617.                doubt then run Rebuild.
  618.  
  619.           E -  Edit Taglines. If you like to use taglines,  witty
  620.                one-liners  added to the bottom of your  messages,
  621.                then  this  key allows you to edit  your  file  of
  622.                taglines - POWERQWK.TAG.
  623.  
  624.                If you have set 'Select each time' in the Taglines
  625.                section of General Configuration Manager then  you
  626.                can  also edit POWERQWK.TAG by pressing E  at  the
  627.                Taglines Selection screen.
  628.  
  629.           B -  Enter the Bulletin Area of the current conference.
  630.  
  631.           R -  mark  Read.  This  causes  all  messages  in   the
  632.                highlighted  conference  to  be  marked  as  Read,
  633.                whether you have actually read them or not.
  634.  
  635.           U -  mark  Unread.  This  causes all  messages  in  the
  636.                highlighted  conference  to be marked  as  unread,
  637.                even if they have actually been read.
  638.  
  639.           H -  History.  This  allows  you  to  edit,  or  change
  640.                details  of,  all  messages  which  are  currently
  641.                waiting  to  be packed for upload  to  the  online
  642.                service. This includes all messages written during
  643.                the  current Power-QWK session AND any written  in
  644.                previous  sessions  which have not  been  uploaded
  645.                yet.
  646.  
  647.                At the History Menu, you can change the  Addressee
  648.                of  any message, the Subject (Title),  the  Status
  649.                (Public  or Private), the  destination  Conference
  650.                (Wildcat!  Message Folder),  the  tagline,  or the
  651.                actual message contents.
  652.  
  653.           S -  Say.  This  allows you to 'say' a message  to  the
  654.                highlighted conference. Say is distinct from Reply
  655.                in that Say potentially initiates a conversational
  656.                thread whereas Reply continues one.
  657.  
  658.                If  you  'Say'  to either the  PERSONAL  or  PRUNE
  659.                conference  then,  after  entering  your  message,
  660.                Power-QWK  will  offer  you a  list  of  available
  661.                conferences   from  which  you  may   choose   the
  662.                destination.
  663.  
  664.                As with all Power-QWK Menus and screens,  pressing
  665.                G enters a Gateway to DOS, allowing you to 'shell'
  666.                to the operating system, enter commands, and  then
  667.                type EXIT to return to Power-QWK.
  668.  
  669.      3.6  Messages and Replies
  670.  
  671.           When  you are reading a conference, i.e., you  actually
  672.           have a message on the screen, there are many facilities
  673.           available at the press of a key or two.
  674.  
  675.           As usual, the best way to learn about them is to read a
  676.           conference, get a message on the screen and then  press
  677.           F1 for Help.
  678.  
  679.           You can practice as much as you like. Then, when you've
  680.           finished,  return to the Conference Menu, press  H  for
  681.           History and then delete any practice messages you  have
  682.           created but don't want to send.
  683.  
  684.           As  with all Power-QWK screens, there is a Key Line  at
  685.           the foot containing a list of all (or most) of the keys
  686.           that  you can press to cause specific actions. Even  if
  687.           there  is  no  room for all the available  keys  to  be
  688.           mentioned  in the Key Line, they will all be  described
  689.           in Help.
  690.  
  691.           When  reading a message, the Enter and Page  Down  keys
  692.           have  the same effect: move on to the next page of  the
  693.           current message or, if there are no more pages, move on
  694.           to  the next unread message in the  current  conference
  695.           or, if there are no more unread messages, return to the
  696.           Conference Menu.
  697.  
  698.           The other available keys are as follows:
  699.  
  700.  
  701.           R -  Reply to the current message. Power-QWK constructs
  702.                a  reply  file  containing  the  current  message,
  703.                automatically incorporating the Quoting style  you
  704.                have  requested in General Configuration  Manager,
  705.                and then calls your Editor Program, also named  in
  706.                Configuration Manager.
  707.  
  708.                When  you  exit  from your editor  and  return  to
  709.                Power-QWK, a tagline will be appended if  required
  710.                and the message will then be added to the file  of
  711.                messages waiting for upload.
  712.  
  713.                Power-QWK will automatically direct the message to
  714.                the  same  conference as that of  the  message  to
  715.                which  you are replying. You will be prompted  for
  716.                Subject, Addressee and Public/Private Status.
  717.  
  718.                You will be offered the name of the sender of  the
  719.                original message as the default Addressee name but
  720.                you  can  change this if you wish or press  F2  to
  721.                bring  up a list of your top twenty most  recently
  722.                used addressee names, from which you can select  a
  723.                name to use without actually typing it.
  724.  
  725.                Then,  you will be asked if you wish to  send  any
  726.                carbon  copies to any other addressees. These  may
  727.                have  different Public/Private Status and  Subject
  728.                fields to the original reply (these fields are all
  729.                changeable later at the History Menu anyway).
  730.  
  731.                You  can  use F2 to obtain the names  of  all  the
  732.                carbon copy recipients.
  733.  
  734.           I -  same  as  R  but, as  well  as  incorporating  the
  735.                original message in the reply file, Power-QWK will
  736.                also Include a file which you nominate.
  737.  
  738.           S -  'Say'  a  message to the current  conference.  You
  739.                cannot  Say to PRUNE or PERSONAL in  this  manner.
  740.                i.e., a 'proper' conference must be current.
  741.  
  742.                This  is similar in action to R for  Reply  except
  743.                that Power-QWK will not be able to offer a default
  744.                Addressee  name  and obviously there  will  be  no
  745.                original message placed in the reply file.
  746.  
  747.                You  can  still use F2 to pick an  addressee  from
  748.                your  top-twenty list and taglines are  added  (or
  749.                not) as normal.
  750.  
  751.           X -  same  as  S but Power-QWK will  include  an  eXtra
  752.                file, which you nominate, in the reply file.
  753.  
  754.           A -  Animate   the  current message. If you  receive  a
  755.                message which contains Ansi sequences then press A
  756.                to  see the file 'properly' including full  colour
  757.                and animation capability.
  758.  
  759.                This  facility  has the bonus that  you  can  also
  760.                decipher  messages which contain  cursor  movement
  761.                sequences.  Sometimes, you will  receive  messages
  762.                which contain sequences of [D [C or similar. These
  763.                are  implanted  in  the file as a  result  of  the
  764.                sender  using  the cursor keys to  'go  back'  and
  765.                correct  errors.  Press A for  Animate  and  these
  766.                sequences  will  be translated  into  the  correct
  767.                on-screen  cursor  movements so that you  see  the
  768.                message as the sender intended.
  769.  
  770.           T -  steal a Tagline from the current message.
  771.  
  772.           As   with all Power-QWK screens, you can use F to  File
  773.           the  current  message, P to Print it plus N and  L  for
  774.           Newpage and Linefeed respectively.
  775.  
  776.           You can also use the cursor keys to move to a different
  777.           message in the conference, whether it has been read  or
  778.           not.
  779.  
  780.           CursorUp/Down  moves  to the Previous/Next  message  in
  781.           chronological sequence.
  782.  
  783.           Ctrl-CursorUp/Down  moves to the Previous/Next  message
  784.           in  the current thread (Wildcat! defines a 'thread'  as
  785.           any group of messages which have the same Subject).
  786.  
  787.           Home and End move to the chronologically first and last
  788.           messages in the conference.
  789.  
  790.           Alt-CursorUp/Down  allows you set full Wildcard  search
  791.           criteria  on  the To, From and Subject  fields,  for  a
  792.           Backwards/Forwards  search  of the  current  conference
  793.           from  the  current  position.  You  can  use  as   many
  794.           wildcards  as  you  like in  search  criteria  so,  for
  795.           instance, From=steve* plus Subject=*pc* will match  all
  796.           messages from people whose names begin with the letters
  797.           'steve'   which   have   the  letters   'p'   and   'c'
  798.           consecutively   anywhere  in  their   titles.   Pattern
  799.           matching is case insensitive.
  800.  
  801.           Having  set  the  criteria  for  a   Forwards/Backwards
  802.           Search,  repeated  pressing  of the F4  key  finds  all
  803.           matching  messages in the message base between  current
  804.           position and End/Beginning of the conference.
  805.  
  806.           Once  search criteria have been set, they survive  even
  807.           changes  of conference. So you can set up a search  and
  808.           then perform it in as many conferences as you like.
  809.  
  810.           Note that Power-QWK allows the D and U keys to be  used
  811.           instead  of CursorDown and CursorUp. This will help  if
  812.           your  system  does not support, for instance,  the  key
  813.           combinations  Ctrl-CursorDown or Alt-CursorDown  -  use
  814.           Ctrl-D or Alt-D instead.
  815.  
  816.           As always, you can press G to pass through the  Gateway
  817.           to DOS, enter commands and then type EXIT to return  to
  818.           Power-QWK.
  819.  
  820.           Above all, don't forget F1 for Help.
  821.  
  822.      3.7  The History Menu
  823.  
  824.           This  menu shows all the prepared messages and  replies
  825.           which  are waiting to be uploaded. They may  have  been
  826.           prepared in the current Power-QWK session or in one  or
  827.           more previous sessions.
  828.  
  829.           Messages  and  replies are placed by Power-QWK  into  a
  830.           file  called *.MSG where * represents the  mail  packet
  831.           name   used  by  the  online  service.   Messages   for
  832.           Direct-Line go into a file named DLINE.MSG.
  833.  
  834.           Whenever you end a Power-QWK session, the file *.MSG is
  835.           packed,  using the Packer Program supplied  to  General
  836.           Configuration Manager, into a further file named *.REP.
  837.  
  838.           *.REP  is  the  file which you have to  upload  to  the
  839.           Tomcat! door in the online service.
  840.  
  841.           Whenever you select 'Messages' at the Power-QWK  Topics
  842.           Menu, Power-QWK automatically attaches to, and  unpacks
  843.           into *.MSG, any already existent *.REP file. So you can
  844.           append  to  this  file during  the  course  of  several
  845.           Power-QWK sessions.
  846.  
  847.           The  History  Menu shows all the messages  and  replies
  848.           which  currently  reside  in *.MSG. You  can  move  the
  849.           highlight bar to point to a specific message using  the
  850.           usual cursor and paging keys.
  851.  
  852.           The following commands are available at this menu:
  853.  
  854.           T -  change  the contents of the To field. You can  use
  855.                F2 to call up your top-twenty Addressee Pick  List
  856.                if you wish.
  857.  
  858.           S -  change the contents of the Subject field.
  859.  
  860.           C -  change  the  name of the  destination  Conference.
  861.                Power-QWK will display a multi-page screen  called
  862.                the   Conference  Pick  List,  showing   all   the
  863.                available  conferences. Just highlight a name  and
  864.                press Enter.
  865.  
  866.           P -  toggle the Private/Public Status field.
  867.  
  868.           A -  'Also  send'  the highlighted message  to  another
  869.                Addressee.  Having pressed A, you can press F2  to
  870.                access the Addressee Pick List.
  871.  
  872.           D -  Display the highlighted message. This facility  is
  873.                provided to enable the checking of  Ansi  Art  and
  874.                Ansi Music messages before you send them.
  875.  
  876.                Non-Ansi files will display  correctly  but  in  a
  877.                fairly primitive manner. Such files are best shown
  878.                by using Enter to invoke your editor (see below).
  879.  
  880.           Enter -   edit the contents of the highlighted message.
  881.  
  882.                     This  action has the side-effect  of  causing
  883.                     the  highlighted message to be moved  to  the
  884.                     end  of the *.MSG file (and therefore to  the
  885.                     end of the History Menu)
  886.  
  887.           Del -     Delete  the  highlighted  message.  Power-QWK
  888.                     will  ask for confirmation before  performing
  889.                     the deletion.
  890.  
  891.           G   -     Gateway to DOS
  892.  
  893.  
  894.      3.8  Reading Files and Bulletins
  895.  
  896.           Having  selected a file or bulletin to read,  Power-QWK
  897.           automatically analyses the contents of the file to  see
  898.           how it is formatted.
  899.  
  900.           Power-QWK recognises fully formatted Ansi files,  which
  901.           may have many screens delimited by Home/Clear sequences
  902.           (Esc[2J).  Power-QWK  has full Ansi  animation  so  the
  903.           files can be in colour and contain any amount of cursor
  904.           movement.
  905.  
  906.           Non-Ansi  files must either be CR/LF delimited  or  not
  907.           delimited at all. In the latter case, Power-QWK inserts
  908.           a CR/LF pair every 80 bytes when displaying.
  909.  
  910.           Once the file or bulletin is on display, you can scroll
  911.           up or down through the file using the PgUp, PgDn,  Home
  912.           and End keys.
  913.  
  914.           You can also press any of the following characters:
  915.  
  916.           P -  Print the file or bulletin.
  917.  
  918.           F -  File (in a DOS file) the file or bulletin.
  919.  
  920.           N -  Send a NewPage (Formfeed) character to the printer
  921.                device.
  922.  
  923.           L -  Send a LineFeed character to the printer device.
  924.  
  925.           T -  Steal a Tagline from the display.
  926.  
  927.           Enter - same as PgDn.
  928.  
  929.           Esc - Quit the current file or bulletin.
  930.  
  931.      3.9  Automating Power-QWK
  932.  
  933.           If you are an experienced online user then you may wish
  934.           to  incorporate a call of Power-QWK into a script  file
  935.           or   .BAT   file  so  that  downloaded   messages   are
  936.           automatically  incorporated  in your  message  base  in
  937.           'hands free' mode.
  938.  
  939.           To accomplish this, call General Configuration  Manager
  940.           and  switch OFF the facilities of .QWK file  processing
  941.           confirmation and 'More? Prompts?'.
  942.  
  943.           These facilities are both in the 'Prompting' section of
  944.           Configuration Manager.
  945.  
  946.           Then, in your script or .BAT file, call Power-QWK using
  947.           the command POWERQWK X.
  948.  
  949.           When  called  in this manner, Power-QWK  by-passes  the
  950.           menu system, processes any existent .QWK files and then
  951.           exits back to the Operating System.
  952.  
  953. 4.   Acknowledgments
  954.  
  955.      Wildcat! is a registered trade mark of Mustang Software.
  956.  
  957.      Qmail is a registered trade mark of SparkWare.
  958.  
  959.      Tomcat!  is  a registered trade mark of  Technique  Computer
  960.      Systems, Victoria BC, Canada.
  961.  
  962. 5.   Disclaimer
  963.  
  964.      Every  attempt has been made to ensure that Power-QWK  is  a
  965.      safe and reliable product to use. None the less, neither the
  966.      Author nor PowerLine Systems Limited may be held responsible
  967.      for  any  damage caused by its use,  howsoever  such  damage
  968.      occurs. If you do not accept this, do not use the software.
  969.  
  970. 6.   Registration and Support
  971.  
  972.      For  easy  registration print out the PRINT.ME file included
  973.      with Power-Qwk. (TYPE PRINT.ME > PRN)
  974.  
  975.      REGISTRATION VIA ENGLAND - UK
  976.      -----------------------------
  977.      Send a cheque or  Postal  Order  for  £20  made  out  to:
  978.      'POWERLINE  SYSTEMS  LTD'  and mail to:
  979.      Powerline Systems
  980.      44 Rydal Way,
  981.      Ruislip, Middx.
  982.      HA4 ORU.
  983.      ENGLAND
  984.  
  985.      REGISTRATION VIA CALIFORNIA - USA
  986.      ---------------------------------
  987.      Enclose a cheque  or  money  order  for  $38  made  out  to:
  988.      'Southland  Trading  Company' and mail to:
  989.      Southland Trading
  990.      900-91 Howard Avenue,
  991.      Escondido,
  992.      CA 92025.
  993.      USA
  994.  
  995.      Enclose the following info:
  996.      Your Name
  997.      Your Address
  998.      Your Postcode/Zip
  999.      Your Country
  1000.  
  1001.      You  will be sent a unique registration number to enter into
  1002.      POWER-QWK to register your copy.  Once registered to you the
  1003.      program MUST NOT be passed on  to  others.   Only  Shareware
  1004.      copies  may be passed on. Registered versions do not display
  1005.      the  Shareware  banner  displayed  by   the   non-registered
  1006.      version.   As  new versions of Power-Qwk appear simply enter
  1007.      your registration number  to  change  them  into  registered
  1008.      versions bearing your ID.
  1009.  
  1010.      UK FEEDBACK & LATEST VERSIONS
  1011.      -----------------------------
  1012.      Feedback  on  this  program  is welcomed via the Direct-Line
  1013.      Online System. Direct-Line  operates  on  the  following  UK
  1014.      numbers   (set  your  communications  software  for  8/N/1).
  1015.      Address messages to GALE GREEN or SYSOP.
  1016.  
  1017.      081-841-4114 Speeds 3/12/1275/2400    + MNP5
  1018.      081-845-8228 Speeds 3/12/24/9600(v32) + HST 96/14.4k  + v42bis & MNP5
  1019.  
  1020.      Multiple lines are available on each number.
  1021.  
  1022.      WORLDWIDE FEEDBACK & LATEST VERSIONS
  1023.      ------------------------------------
  1024.      The latest version of  Power-Qwk  is  always  available  via
  1025.      UKFORUM  on  CompuServe  (GO  UKFORUM),  and Support for the
  1026.      program is  available  in  the  Comms  message  area  there.
  1027.      Address messages to 70007,4737.
  1028.  
  1029.      Copyright (C) Gale Green & Powerline Systems Ltd. 1991/2
  1030.  
  1031.