home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / new / comm / mail / amiqwk / amiqwk.doc < prev    next >
Text File  |  1994-11-25  |  56KB  |  1,617 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', and
  16. TeX 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 cannot accept personal checks drawn from
  87. Canadian banks due to costs of processing.) Cash is accepted (US Funds
  88. only), however you send cash at your own risk.
  89.  
  90.    AmiQWK users in New Zealand, Australia, and Europe can register
  91. through my overseas distributors. 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, version 3.0) When a
  96. new major revision becomes available, registered `AmiQWK II' users will
  97. be 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. I can also send the registration key via FAX
  102. in the U.S.  and Canada.
  103.  
  104.    Group registrations (for Users Groups, BBSes, etc.) and site
  105. licenses are available. Current pricing is $12.50 each for 5-9
  106. registration keys, and $10.00 each for 10 or more registration keys
  107. when purchased at the same time. After the initial order, individual
  108. orders may be placed at the group price. Contact the author for
  109. details. See Technical Support.
  110.  
  111. Warranty
  112. ========
  113.  
  114.    THIS PRODUCT IS PROVIDED "AS-IS" WITHOUT WARRANTY OF ANY KIND. ALL
  115. RISKS AND DAMAGES, INCIDENTAL OR OTHERWISE, ARISING FROM THE USE,
  116. MISUSE, OR INABILITY TO USE THIS PROGRAM ARE ENTIRELY THE
  117. RESPONSIBILITY OF THE USER.  THE AUTHOR DOES NOT MAKE ANY GUARANTEES OR
  118. REPRESENTATIONS REGARDING THE CORRECTNESS, RELIABILITY, ACCURACY,
  119. CURRENTNESS, ETC. OF THIS PROGRAM. THE AUTHOR WILL NOT ACCEPT
  120. RESPONSIBILITY FOR ANY DAMAGE OR LOSSES RESULTING FORM THE USE, MISUSE,
  121. OR INABILITY TO USE THIS PRODUCT.
  122.  
  123. Copyright
  124. =========
  125.  
  126.    The `AmiQWK II' software and documentation are copyright (C)
  127. 1992,1993,1994 Jim Dawson. All rights reserved.
  128.  
  129.    `AmigaGuide', `AmigaGuide.info', `amigaguide.library' (C) Copyright
  130. 1992 Commodore-Amiga, Inc. All Rights Reserved. Reproduced and
  131. distributed under license from Commodore.
  132.  
  133.    `ReqTools' and `reqtools.library' are Copyright (C) Nico François.
  134.  
  135.    All product names used in this document are trademarks of their
  136. respective owners.
  137.  
  138. Distribution
  139. ============
  140.  
  141.    Regardless of the method of distribution, `AmiQWK II' is NOT and
  142. never has been public domain.
  143.  
  144.    `AmiQWK II' may be distributed freely, providing the following
  145. criteria are met:
  146.  
  147.    * Distribution is limited to the original shareware distribution
  148.      only. None of the files in the `AmiQWK II' distribution archive
  149.      may be modified or omitted.
  150.  
  151.    * No material gain may be realized from the distribution of `AmiQWK
  152.      II', other than a small amount to cover distribution materials.
  153.  
  154.    * `AmiQWK II' may be included in freely distributable software
  155.      libraries, including the Fred Fish collection and CD-ROM
  156.      distributions of the Aminet FTP site contents.
  157.  
  158.    * `AmiQWK II' may not be bundled with any hardware or software
  159.      product without prior written consent from the author.
  160.  
  161.    * Registration numbers for `AmiQWK', and the key file that `AmiQWK
  162.      II' generates from them (`AmiQWK.KEY') may not be distributed.
  163.  
  164. System Requirements
  165. *******************
  166.  
  167. Hardware Requirements
  168. =====================
  169.  
  170.    `AmiQWK' requires the following hardware:
  171.  
  172.    * Amiga computer.
  173.  
  174.    * 512KB RAM. (1MB or more recommended.)
  175.  
  176.    * Floppy drive (Second floppy drive or hard drive highly
  177.      recommended.)
  178.  
  179.    * Printer. (if you want to print messages.)
  180.  
  181. Software Requirements
  182. =====================
  183.  
  184.    `AmiQWK' requires the following software:
  185.  
  186.    * Workbench 2.04 (V37) or higher.
  187.  
  188.    * A text editor that can save ASCII text without any formatting info,
  189.      and can be configured so that it does not detach itself from it's
  190.      parent task. (ED and MEMACS that come with Workbench are fine.)
  191.  
  192.    * Any archivers you plan to use. (`ZIP', `LHA/LHArc', `ZOO', and
  193.      `ARC' are currently supported)
  194.  
  195.    * `reqtools.library'. (included with `AmiQWK II' distribution
  196.      archive.)
  197.  
  198.    * `amigaguide.library'. (included with `AmiQWK II' distribution
  199.      archive, only required for online help.)
  200.  
  201. Installation and Quick Setup
  202. ****************************
  203.  
  204.    To install `AmiQWK', just double-click on the 'Install_AQ2' icon.
  205. This will copy the `reqtools.library' and `amigaguide.library' to your
  206. `libs:' directory. If newer versions of either library are already
  207. present, the library will not be copied.
  208.  
  209.    Once the libraries have been installed, run `AmiQWK' by
  210. double-clicking on it's icon or by typing `AmiQWK' from the `CLI'.
  211.  
  212.    Once `AmiQWK' is running, you will need to configure it to work on
  213. your system. Click on the gadget labeled 'Config `AmiQWK'...' or type
  214. 'C' (1) to bring up the configuration editor window.
  215.  
  216.    The configuration editor window has 9 gadgets, the first 6 of which
  217. when clicked on will bring up a configuration sub-window. The remaining
  218. 3 gadgets are used to save the configuration to disk, use the
  219. configuration without saving, and to cancel changes you have made to
  220. the configuration. The following describes only the most basic
  221. configuration options needed to get `AmiQWK' running, See
  222. Configuration,