home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / comm / amiqwk-2.4.lha / AmiQWK-2.4 / AmiQWK.doc < prev    next >
Text File  |  1994-05-18  |  53KB  |  1,564 lines
  1.  
  2.  
  3. Introduction
  4. ************
  5.  
  6. About this manual
  7. =================
  8.  
  9.    This manual assumes that you have at least a basic knowledge of the
  10. Amiga operating system. If you are not familiar with the Amiga I,
  11. recommend reading the 'Basic Operations' chapter of your AmigaDOS
  12. manual.
  13.  
  14.    This manual was written in `Texinfo', the GNU documentation format,
  15. and processed through `MakeGuide' to generate ASCII, `AmigaGuide', TeX,
  16. and PostScript versions.
  17.  
  18. What is QWKMail?
  19. ================
  20.  
  21.    QWKMail is an offline message format. Using QWKMail allows you to
  22. call a BBS, collect all waiting messages, transfer them to your
  23. computer, and read them after you have logged off of the BBS. You can
  24. then read them with a QWK compatible message reader such as `AmiQWK'.
  25. New messages can be edited with your favorite text editor. Some of the
  26. advantages of using QWKMail include:
  27.  
  28.    * Collecting all waiting messages into a QWKMail packet usually
  29.      takes only a fraction of the time it takes to read messages
  30.      online, resulting in lower phone bills.
  31.  
  32.    * Since your replies are edited offline, you can take as much time
  33.      as you need to enter and reply to messages. You also have the
  34.      advantage of using tools that may not be available when using BBS
  35.      editors, such as spelling and grammar checkers.
  36.  
  37.    * You can easily save or print messages for future reference.
  38.  
  39.    The QWK format was created in 1987 by Mark 'Sparky' Herring. It is
  40. based on Clark Development Corp.'s `PC-Board' Version 12.0 BBS message
  41. base format.  The QWKMail format is now supported by most BBS programs
  42. either internally or by an external 'door' program.
  43.  
  44. What is AmiQWK II?
  45. ==================
  46.  
  47.    `AmiQWK II' is a full featured QWKMail offline message reader for the
  48. Commodore Amiga computer. My goals for `AmiQWK' are (in no particular
  49. order)
  50.  
  51.    * To be the most stable and compatible QWKMail reader available for
  52.      the Commodore Amiga computer.
  53.  
  54.    * To be the most full featured QWKMail reader for the Commodore Amiga
  55.      computer.
  56.  
  57.    * To take advantage of features found Release 2 and higher of the
  58.      Amiga operating system.
  59.  
  60.    * To be easy to use.
  61.  
  62.    * To be highly configurable.
  63.  
  64. Legal Stuff
  65. ***********
  66.  
  67. About Shareware
  68. ===============
  69.  
  70.    `AmiQWK II' is released under the concept of Shareware. This means
  71. that you are granted a license to use `AmiQWK II' for a period of 30
  72. days after the initial use. After 30 days you must either register the
  73. program or discontinue its use. See Registration, for more details.
  74.  
  75. Registration
  76. ============
  77.  
  78.    To register `AmiQWK', fill out the registration form (filename
  79. `Registration.form') and send it along with your payment to the address
  80. on the registration form. You will receive a 16 digit registration key
  81. based on your name. Enter this number into the 'Register' window of the
  82. configuration editor and `AmiQWK II' will generate a keyfile
  83. (`AmiQWK.KEY') that will remove the shareware registration notices.
  84.  
  85.    Recommended method of payment is a check drwan from a U.S. bank or a
  86. money order in US dollars. (I can no longer accept personal checks
  87. drawn from Canadian banks due to a change in bank policy.) Cash is
  88. accepted (US Funds only), however you send cash at your own risk.
  89.  
  90.    AmiQWK users in New Zealand and Australia can register through my
  91. New Zealand distributor. See the registration form (filename
  92. `registration.form' for more details.
  93.  
  94.    The registration key will work with all minor revisions of `AmiQWK
  95. II'.  (i.e. all versions up to, but not including, 3.0) When a new
  96. major revision becomes available, registered `AmiQWK II' users will be
  97. eligible for reduced cost updates.
  98.  
  99.    Most registrations are processed within 2 working days. If a network
  100. address is given, I will send your registration key via email in
  101. addition to postal mail.
  102.  
  103.    Group registrations and site licenses are available, Contact the
  104. author for details. See Technical Support.
  105.  
  106. Warranty
  107. ========
  108.  
  109.    THIS PRODUCT IS PROVIDED "AS-IS" WITHOUT WARRANTY OF ANY KIND. ALL
  110. RISKS AND DAMAGES, INCIDENTAL OR OTHERWISE, ARISING FROM THE USE,
  111. MISUSE, OR INABILITY TO USE THIS PROGRAM ARE ENTIRELY THE
  112. RESPONSIBILITY OF THE USER.  THE AUTHOR DOES NOT MAKE ANY GUARANTEES OR
  113. REPRESENTATIONS REGARDING THE CORRECTNESS, RELIABILITY, ACCURACY,
  114. CURRENTNESS, ETC. OF THIS PROGRAM. THE AUTHOR WILL NOT ACCEPT
  115. RESPONSIBILITY FOR ANY DAMAGE OR LOSSES RESULTING FORM THE USE, MISUSE,
  116. OR INABILITY TO USE THIS PRODUCT.
  117.  
  118. Copyright
  119. =========
  120.  
  121.    The `AmiQWK II' software and documentation are copyright (C)
  122. 1992,1993 Jim Dawson. All rights reserved.
  123.  
  124.    `AmigaGuide', `AmigaGuide.info', `amigaguide.library' (C) Copyright
  125. 1992 Commodore-Amiga, Inc. All Rights Reserved. Reproduced and
  126. distributed under license from Commodore.
  127.  
  128.    `ReqTools' and `reqtools.library' are Copyright (C) Nico François.
  129.  
  130.    All product names used in this document are trademarks of their
  131. respective owners.
  132.  
  133. Distribution
  134. ============
  135.  
  136.    Regardless of the method of distribution, `AmiQWK II' is NOT and
  137. never has been public domain.
  138.  
  139.    `AmiQWK II' may be distributed freely, providing the following
  140. criteria are met:
  141.  
  142.    * Distribution is limited to the original shareware distribution
  143.      only. None of the files in the `AmiQWK II' distribution archive
  144.      may be modified or omitted.
  145.  
  146.    * No material gain may be realized from the distribution of `AmiQWK
  147.      II', other than a small amount to cover distribution materials.
  148.  
  149.    * `AmiQWK II' may be included in freely distributable software
  150.      libraries, including the Fred Fish collection.
  151.  
  152.    * `AmiQWK II' may not be bundled with any hardware or software
  153.      product without prior written consent from Jim Dawson.
  154.  
  155.    * Registration numbers for `AmiQWK', and the key file that `AmiQWK
  156.      II' generates from them (`AmiQWK.KEY') may not be distributed.
  157.  
  158. System Requirements
  159. *******************
  160.  
  161. Hardware Requirements
  162. =====================
  163.  
  164.    `AmiQWK' requires the following hardware:
  165.  
  166.    * Amiga computer.
  167.  
  168.    * 512KB RAM. (1MB or more recommended.)
  169.  
  170.    * Floppy drive (Second floppy drive or hard drive highly
  171.      recommended.)
  172.  
  173.    * Printer. (if you want to print messages.)
  174.  
  175. Software Requirements
  176. =====================
  177.  
  178.    `AmiQWK' requires the following software:
  179.  
  180.    * Workbench 2.04 (V37) or higher.
  181.  
  182.    * A text editor that can save ASCII text without any formatting
  183.      info. (ED and MEMACS that come with Workbench are fine.)
  184.  
  185.    * Any archivers you plan to use. (`ZIP', `LHA/LHArc', `ZOO', and
  186.      `ARC' are currently supported)
  187.  
  188.    * `reqtools.library'. (included with `AmiQWK II' distribution
  189.      archive.)
  190.  
  191.    * `amigaguide.library'. (included with `AmiQWK II' distribution
  192.      archive, only required for online help.)
  193.  
  194. Installation and Quick Setup
  195. ****************************
  196.  
  197.    To install `AmiQWK', just double-click on the 'Install_AQ2' icon.
  198. This will copy the `reqtools.library' and `amigaguide.library' to your
  199. `libs:' directory. If newer versions of either library are already
  200. present, the library will not be copied.
  201.  
  202.    Once the libraries have been installed, run `AmiQWK' by
  203. double-clicking on it's icon or by typing `AmiQWK' from the `CLI'.
  204.  
  205.    Once `AmiQWK' is running, you will need to configure it to work on
  206. your system. Click on the gadget labeled 'Config `AmiQWK'...' or type
  207. 'C' (1) to bring up the configuration editor window.
  208.  
  209.    The configuration editor window has 9 gadgets, the first 6 of which
  210. when clicked on will bring up a configuration sub-window. The remaining
  211. 3 gadgets are used to save the configuration to disk, use the
  212. configuration without saving, and to cancel changes you have made to
  213. the configuration. The following describes only the most basic
  214. configuration options needed to get `AmiQWK' running, See
  215. Configuration, for a more detailed description of all of the
  216. configuration options.
  217.  
  218. `Operation'
  219.      Change the 'Editor' string gadget to whatever editor you use.
  220.      About the only restrictions on the editor are that it must save
  221.      text in plain ASCII format (with no formatting codes) and that it
  222.      does not detach itself from the CLI process that spawned it. Here
  223.      are some examples:
  224.  
  225.     `CygnusEd'
  226.           `c:ed -sticky' (See CygnusEd Notes.)
  227.  
  228.     `TurboText