home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d09xx / d0946.lha / AmiQWK / AmiQWK.doc < prev    next >
Text File  |  1993-12-20  |  53KB  |  1,563 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 or money order drawn from a
  86. US or Canadian bank. Cash is accepted (US Funds only), however you send
  87. cash at your own risk. Postal money orders are accepted but discouraged
  88. as they take too long to process and it may not be possible to send the
  89. registration form with payment.
  90.  
  91.    AmiQWK users in New Zealand and Australia can register through my
  92. New Zealand distributor. See the registration form (filename
  93. `registration.form' for more details.
  94.  
  95.    The registration key will work with all minor revisions of `AmiQWK
  96. II'. When a new major revision becomes available, registered `AmiQWK
  97. II' users will be eligible for reduced cost updates.
  98.  
  99.    Most registrations are processed within 2 working days.
  100.  
  101.    Group registrations and site licenses are available, Contact the
  102. author for details. See Technical Support.
  103.  
  104. Warranty
  105. ========
  106.  
  107.    THIS PRODUCT IS PROVIDED "AS-IS" WITHOUT WARRANTY OF ANY KIND. ALL
  108. RISKS AND DAMAGES, INCIDENTAL OR OTHERWISE, ARISING FROM THE USE,
  109. MISUSE, OR INABILITY TO USE THIS PROGRAM ARE ENTIRELY THE
  110. RESPONSIBILITY OF THE USER.  THE AUTHOR DOES NOT MAKE ANY GUARANTEES OR
  111. REPRESENTATIONS REGARDING THE CORRECTNESS, RELIABILITY, ACCURACY,
  112. CURRENTNESS, ETC. OF THIS PROGRAM. THE AUTHOR WILL NOT ACCEPT
  113. RESPONSIBILITY FOR ANY DAMAGE OR LOSSES RESULTING FORM THE USE, MISUSE,
  114. OR INABILITY TO USE THIS PRODUCT.
  115.  
  116. Copyright
  117. =========
  118.  
  119.    The `AmiQWK II' software and documentation are copyright (C)
  120. 1992,1993 Jim Dawson. All rights reserved.
  121.  
  122.    `AmigaGuide', `AmigaGuide.info', `amigaguide.library' (C) Copyright
  123. 1992 Commodore-Amiga, Inc. All Rights Reserved. Reproduced and
  124. distributed under license from Commodore.
  125.  
  126.    `ReqTools' and `reqtools.library' are Copyright (C) Nico Franτois.
  127.  
  128.    All product names used in this document are trademarks of their
  129. respective owners.
  130.  
  131. Distribution
  132. ============
  133.  
  134.    Regardless of the method of distribution, `AmiQWK II' is NOT and
  135. never has been public domain.
  136.  
  137.    `AmiQWK II' may be distributed freely, providing the following
  138. criteria are met:
  139.  
  140.    * Distribution is limited to the original shareware distribution
  141.      only. None of the files in the `AmiQWK II' distribution archive
  142.      may be modified or omitted.
  143.  
  144.    * No material gain may be realized from the distribution of `AmiQWK
  145.      II', other than a small amount to cover distribution materials.
  146.  
  147.    * `AmiQWK II' may be included in freely distributable software
  148.      libraries, including the Fred Fish collection.
  149.  
  150.    * `AmiQWK II' may not be bundled with any hardware or software
  151.      product without prior written consent from Jim Dawson.
  152.  
  153.    * Registration numbers for `AmiQWK', and the key file that `AmiQWK
  154.      II' generates from them (`AmiQWK.KEY') may not be distributed.
  155.  
  156. System Requirements
  157. *******************
  158.  
  159. Hardware Requirements
  160. =====================
  161.  
  162.    `AmiQWK' requires the following hardware:
  163.  
  164.    * Amiga computer.
  165.  
  166.    * 512KB RAM. (1MB or more recommended.)
  167.  
  168.    * Floppy drive (Second floppy drive or hard drive highly
  169.      recommended.)
  170.  
  171.    * Printer. (if you want to print messages.)
  172.  
  173. Software Requirements
  174. =====================
  175.  
  176.    `AmiQWK' requires the following software:
  177.  
  178.    * Workbench 2.04 (V37) or higher.
  179.  
  180.    * A text editor that can save ASCII text without any formatting
  181.      info. (ED and MEMACS that come with Workbench are fine.)
  182.  
  183.    * Any archivers you plan to use. (`ZIP', `LHA/LHArc', `ZOO', and
  184.      `ARC' are currently supported)
  185.  
  186.    * `reqtools.library'. (included with `AmiQWK II' distribution
  187.      archive.)
  188.  
  189.    * `amigaguide.library'. (included with `AmiQWK II' distribution
  190.      archive, only required for online help.)
  191.  
  192. Installation and Quick Setup
  193. ****************************
  194.  
  195.    To install `AmiQWK', just double-click on the 'Install_AQ2' icon.
  196. This will copy the `reqtools.library' and `amigaguide.library' to your
  197. `libs:' directory. If newer versions of either library are already
  198. present, the library will not be copied.
  199.  
  200.    Once the libraries have been installed, run `AmiQWK' by
  201. double-clicking on it's icon or by typing `AmiQWK' from the `CLI'.
  202.  
  203.    Once `AmiQWK' is running, you will need to configure it to work on
  204. your system. Click on the gadget labeled 'Config `AmiQWK'...' or type
  205. 'C' (1) to bring up the configuration editor window.
  206.  
  207.    The configuration editor window has 9 gadgets, the first 6 of which
  208. when clicked on will bring up a configuration sub-window. The remaining
  209. 3 gadgets are used to save the configuration to disk, use the
  210. configuration without saving, and to cancel changes you have made to
  211. the configuration. The following describes only the most basic
  212. configuration options needed to get `AmiQWK' running, See
  213. Configuration, for a more detailed description of all of the
  214. configuration options.
  215.  
  216. `Operation'
  217.      Change the 'Editor' string gadget to whatever editor you use.
  218.      About the only restrictions on the editor are that it must save
  219.      text in plain ASCII format (with no formatting codes) and that it
  220.      does not detach itself from the CLI process that spawned it. Here
  221.      are some examples:
  222.  
  223.     `CygnusEd'
  224.           `c:ed -sticky' (See CygnusEd Notes.)
  225.  
  226.     `TurboText'
  227.           `c:ttx WAIT'
  228.  
  229.     `Ed (AmigaDos)'
  230.           `c:ed'
  231.  
  232.     `MEmacs (AmigaDos)'
  233.           `sys:tools/memacs'
  234.  
  235.     `GoldEd'
  236.           `c:ed sticky'
  237.  
  238.      See Operation window, for more information.
  239.  
  240. `Replies'
  241.      The default configuration for replies should not need to be
  242.      changed for most applications. See Replies window, for more
  243.      information.
  244.  
  245. `Paths'
  246.      In the Paths window you tell `AmiQWK' where it should look for and
  247.      store certain files.
  248.  
  249.     `Packet Dir'
  250.           This is where `AmiQWK' should look for mail packets. This is
  251.           normally the same directory your term program uses for
  252.           downloads.
  253.  
  254.     `Reply Dir'
  255.           This is where `AmiQWK' stores replies. This is normally the
  256.           same directory your term program uses for uploads.
  257.  
  258.     `Work Dir'
  259.           This is where `AmiQWK' creates its work directory. If you
  260.           have enough memory, you might want to change this to `RAM:'
  261.           for best performance. If you leave it blank `AmiQWK' will
  262.           create the work directory in the `AmiQWK' program directory.
  263.  
  264.      See Paths window, for more information.
  265.  
  266. `Archivers'
  267.      You will probably not need to change anything in the Archivers
  268.      window.  See Archivers window, for more information.
  269.  
  270. `Graphics'
  271.      You will probably not need to make changes in the Graphics window
  272.      to get `AmiQWK' to work. See Graphics window, for more information.
  273.  
  274. `Register'
  275.      Enter your name in the gadget labeled 'Your Name'. If you have
  276.      registered, enter your registration key number in the
  277.      'Registration Key' gadget, otherwise leave it blank. See Register
  278.      window, for more information.
  279.  
  280.    Once you have your configuration set, click on the 'Save' gadget of
  281. the 'Config' window to save it to disk. If you think you messed up
  282. somewhere and want to start again from scratch, click on 'Cancel'. If
  283. you want to try out your configuration before you save it, click on
  284. 'Use'.
  285.  
  286.    ---------- Footnotes ----------
  287.  
  288.    (1)  Most actions in `AmiQWK' can be accomplished by using either
  289. the mouse or the keyboard. Whenever a keyboard shortcut exists it will
  290. usually have the shortcut key underlined.
  291.  
  292. Using AmiQWK
  293. ************
  294.  
  295. Starting AmiQWK
  296. ===============
  297.  
  298.    Before you use `AmiQWK', You will need to download a QWKMail packet
  299. from your favorite BBS. Consult the online documentation for the BBS
  300. QWK mailer (or, if all else fails, the system operator) for
  301. instructions on how to download a QWKMail packet. `AmiQWK' will run
  302. without any packets, but you won't be able to do much with it.
  303.  
  304.      *TIP:* Do *NOT* use Zmodem Resume mode when downloading QWKMail
  305.      packets.
  306.      
  307.      Since most BBSes use the same filename for packets every time, if you
  308.      already have a QWK packet in your downloads directory your term program will
  309.      think you are trying to resume an aborted transfer, and the new packet will
  310.      be appended to the old one instead of creating a new file.
  311.  
  312.    Once you have a QWKMail packet, start `AmiQWK' by double clicking
  313. the `AmiQWK' icon or typing '`AmiQWK'' from the CLI. `AmiQWK' will open
  314. a custom, public screen (named '`AmiQWK'') with a window titled 'Select
  315. Packet'. (If you haven't registered yet, a window will appear reminding
  316. you to register before the 'Select Packet' window (See Select Packet
  317. window.) appears, as well as several other places in the program.) See
  318. Registration, for more details about registering `AmiQWK'.
  319.  
  320. Select Packet window
  321. ====================
  322.  
  323.    From the Select Packet window, you can open a QWKMail packet for
  324. reading, delete or rename packets, enter the configuration editor, and
  325. get information about the program. The Select Packet window has the
  326. following gadgets:
  327.  
  328. `Registered To'
  329.      Name of the registered user. See Registered To.
  330.  
  331. `Open Packet...'
  332.      Open a packet for reading. See Open Packet....
  333.  
  334. `Config AmiQWK...'
  335.      Open the configuration editor. See Main Configuration Window.
  336.  
  337. `About AmiQWK...'
  338.      Displays version, and copyright information, as well as how to get
  339.      technical support and where to send your registration fees. See
  340.      About AmiQWK....
  341.  
  342. `Rename Packet...'
  343.      Rename or move a packet. See Rename Packet....
  344.  
  345. `HELP!!!...'
  346.      Get online help. See HELP!!!....
  347.  
  348. `Delete Packet...'
  349.      Delete a packet. See Delete Packet....
  350.  
  351. `Quit and Exit...'
  352.      Exit program. See Quit and Exit....
  353.  
  354. Registered To
  355. =============
  356.  
  357.    This read only text gadget displays the name of the person who has
  358. registered this copy of `AmiQWK', or '** UNREGISTERED EVALUATION COPY
  359. **' if `AmiQWK' cannot process the registration key. This gadget is
  360. read-only. See Registration, for more information on registering
  361. `AmiQWK'.
  362.  
  363. Open Packet...
  364. ==============
  365.  
  366.    When the 'Open Packet...' gadget is selected, `AmiQWK' opens a file
  367. requester for you to select the mail packet to be opened. See Opening a
  368. packet, for more information.
  369.  
  370. Config AmiQWK...
  371. ================
  372.  
  373.    Clicking on this gadget opens the configuration editor. See Main
  374. Configuration Window, for more information.
  375.  
  376. About AmiQWK...
  377. ===============
  378.  
  379.    This gadget opens a window containing version and copyright
  380. information, and where to send registrations, bug reports, suggestions,
  381. etc.
  382.  
  383. Rename Packet...
  384. ================
  385.  
  386.    This gadget opens a file requester to select a file to be renamed.
  387. Once a file is selected, another file requester is opened to select the
  388. new file name.
  389.  
  390.    A file can be moved by using the rename function. Just enter a
  391. different path in the 'Rename File As...' file requester. You can even
  392. 'Rename' a file to another volume.
  393.  
  394. HELP!!!...
  395. ==========
  396.  
  397.    This gadget brings up `AmigaGuide' help for the Packet Selection
  398. window. You can get help for most windows by pressing the 'HELP' key.
  399.  
  400. Delete Packet...
  401. ================
  402.  
  403.    This gadget opens a file requester to select a file to be deleted.
  404. Once a file is selected another requester will appear to ask for
  405. confirmation before deleting the file.
  406.  
  407. Quit and Exit...
  408. ================
  409.  
  410.    Click on this gadget to exit the program. Unless 'Ask Before Exit'
  411. in the Operations config window (See Operation window.) is turned off
  412. you will be asked for confirmation before `AmiQWK' closes.
  413.  
  414. Opening a packet
  415. ================
  416.  
  417.    When 'Open Packet...' is selected from the 'Select Packet' window, a
  418. file requester will appear to select the packet to open. Once a packet
  419. is selected, `AmiQWK' closes the 'Select Packet' window, extracts the
  420. mail packet into the work directory (automatically determining what
  421. method was used to compress the packet) as well as the reply packet, if
  422. it exists. The extraction procedure takes place in a CLI window that
  423. appears on the `AmiQWK' screen. (assuming you haven't changed the spawn
  424. window specifications in the Operations configuration window. (See
  425. Operation window.))
  426.  
  427.    Once the packet is extracted, `AmiQWK' will scan the packet,
  428. building lists of conferences and messages. This may take a while if
  429. you are reading a large packet. If index files are not present in the
  430. packet or if the number of messages in the messages.dat file does not
  431. match the number of message indexes, `AmiQWK' will attempt to generate
  432. the indexes itself. (note that the indexes are not saved back to the
  433. packet, as `AmiQWK' can generate the indexes very quickly.) Once the
  434. packet has been processed, the 'Select item to read' window will open.
  435. See Select item to read window.
  436.  
  437. Select item to read window
  438. ==========================
  439.  
  440.    This window gives important information about the packet and the BBS
  441. that it came from, and has several gadgets for selecting various parts
  442. of the mail packet for reading. (note that some of the gadgets may be
  443. disabled if the corresponding item is not available in the packet.)
  444. There is also a menu which can be used to generate requests to add,
  445. drop, or reset conferences (assuming that the QWK packer that generated
  446. the packet can process these requests, otherwise the menu items will be
  447. disabled.)
  448.  
  449.    The following information about the packet and the BBS it came from
  450. is displayed on the left part of the window.
  451.  
  452. `Packet:'
  453.      The filename of the packet (not including path).
  454.  
  455. `BBS:'
  456.      The name of the BBS that the packet came from.
  457.  
  458. `Location:'
  459.      The location of the BBS.
  460.  
  461. `Sysop:'
  462.      The name of the system operator of the BBS.
  463.  
  464. `Phone:'
  465.      Primary phone number of the BBS.
  466.  
  467. `Packet ID:'
  468.      Packet identifier for generating reply packets.
  469.  
  470. `Time:'
  471.      Time that the packet was created.
  472.  
  473. `Date:'
  474.      Date that the packet was created.
  475.  
  476. `User Name:'
  477.      Name of the person who downloaded the packet.
  478.  
  479.    And on the right are the following gadgets. Note that some of them
  480. may be disabled if they are not available.
  481.  
  482. `'Hello' File...'
  483.      Displays welcome text using the internal text viewer. (See Text
  484.      Viewer.) Usually is the login and welcome screen from the BBS, but
  485.      may contain other information.
  486.  
  487. `Bulletins...'
  488.      Display bulletin file(s) using the internal text viewer. (See Text
  489.      Viewer.) A file requester will be opened to select which file to
  490.      read. The bulletin files are named 'BLT-x.y' where 'x' is the
  491.      conference the bulletin came from and 'y' is the actual number of
  492.      the bulletin. (i.e. BLT-3.1 indicates that it is the first
  493.      bulletin in conference 3.) Bulletins are usually only included if
  494.      they have been updated since the last time you called the BBS.
  495.      Select 'Cancel' on the file requester to return to the 'Select
  496.      item to read' window.
  497.  
  498. `News...'
  499.      Display the News file using the internal text viewer. (See Text
  500.      Viewer.) This file can contain anything the sysop chooses. Usually
  501.      this file, like bulletins, is only included if it has been updated
  502.      since the last mail packet was downloaded.
  503.  
  504. `Read Mail...'
  505.      Read messages. (See Reading Messages.)
  506.  
  507. `New Files...'
  508.      Displays a list of files recently posted to the BBS using the
  509.      internal text viewer. (See Text Viewer.)
  510.  
  511. `'Goodbye' Text'
  512.      Displays logout text using the internal text viewer. (See Text
  513.      Viewer.) Usually this is the text that the BBS displays to users
  514.      logging off of the system, however it may contain other
  515.      information.
  516.  
  517. `Close Packet...'
  518.      Closes the packet currently being read and returns to the Select
  519.      Packet window. (See Select Packet window.) If there are any
  520.      replies, they will be packed into a reply packet for uploading.
  521.  
  522. `Exit AmiQWK...'
  523.      Exit program. Unless 'Ask Before Exit' in the Operations config
  524.      window is turned off (See Operation window.) you will be asked for
  525.      confirmation before `AmiQWK' closes. If there are any replies,
  526.      they will be packed into a reply packet for uploading.
  527.  
  528.    And finally, there is a menu named 'Conference'. It will contain the
  529. following menu items, however these items may be disabled if the QWK
  530. packer cannot handle these requests.
  531.  
  532. `Add Conference'
  533.      Add a conference to your list of active conferences. A window will
  534.      appear listing all conferences that don't have any messages in
  535.      them (if they have messages, you must already be subscribed to
  536.      that conference.) once a conference is selected, you will be asked
  537.      for confirmation before the add conference request is generated.
  538.  
  539. `Drop Conference'
  540.      Remove a conference from your list of active conferences. A window
  541.      will appear listing all conferences. Once a conference is
  542.      selected, you will be asked for confirmation before the drop
  543.      conference request is generated.
  544.  
  545. `Reset Pointer'
  546.      Reset last read pointer within a conference. A window will appear
  547.      listing all conferences. Once a conference is selected you will be
  548.      asked to enter a new last read message number. Once a last read
  549.      message number is selected, you will be asked for confirmation
  550.      before the reset request is generated.  See Advanced QWK features,
  551. for more details on Adding, Dropping, and Reseting conferences.
  552.  
  553. Text Viewer
  554. ===========
  555.  
  556.    `AmiQWK' has a built-in text viewer for reading text files included
  557. in the QWKMail packet, such as the Hello, Goodbye, News, Bulletins, and
  558. recent uploads files. ANSI display sequences are filtered out before
  559. the text is displayed. (Note that if the text uses ANSI cursor
  560. positioning codes, the text may be jumbled. However most ANSI text uses
  561. only color codes.)
  562.  
  563.    The following keys control movement in the text and message viewers:
  564.  
  565. Keypad 8, Up Arrow
  566.      Scroll up one line of text.
  567.  
  568. Keypad 2, Down Arrow
  569.      Scroll down one line of text.
  570.  
  571. Keypad 9
  572.      Scroll up one page of text.
  573.  
  574. Keypad 3 Space Bar
  575.      Scroll down one page of text.
  576.  
  577. Keypad 7
  578.      Move to start of text.
  579.  
  580. Keypad 1
  581.      Move to end of text.
  582.  
  583.    In addition to the above keys, you can move through the current text
  584. by using the scroll bar at the bottom of the screen. (unless the scroll
  585. bar is disabled in the Operations configuration window. (See Operation
  586. window.)
  587.  
  588.    The following keys (and their corresponding menu items in the
  589. 'Commands' menu) also perform functions:
  590.  
  591. Q
  592.      Quit reading text and return to the 'Select item to read' window.
  593.      See Select item to read window.
  594.  
  595. P
  596.      Print the current text. See Printing Text and Messages.
  597.  
  598. S
  599.      Save the current text. See Saving Text and Messages.
  600.  
  601. A
  602.      ANSI display of the current message. See ANSI Viewer.
  603.  
  604. ANSI Viewer
  605. ===========
  606.  
  607.    The ANSI viewer will display the current message or text on a virtual
  608. terminal, as if it were being viewed on a terminal screen while
  609. connected to a BBS. ANSI display sequences allow for changing the color
  610. of the text and background, cursor position, etc.
  611.  
  612.    The ANSI viewer will correctly display most IBM-PC ANSI sequences.
  613. ANSI is displayed on it's own custom 16 color screen, the palette is
  614. hard-coded to match the default IBM-PC display.
  615.  
  616.    When in the ANSI viewer the following functions are available:
  617.  
  618. P
  619.      Pause the display. Display will be suspended until another key is
  620.      pressed.
  621.  
  622. Q
  623.      Quit ANSI display and return to message or text reader.
  624.  
  625. A
  626.      Display ANSI text again.
  627.  
  628. 0-9
  629.      Change display speed. 0 is fastest (no delay), 9 is slowest (max.
  630.      delay).
  631.  
  632. Reading and Writing Messages
  633. ****************************
  634.  
  635. Reading Messages
  636. ================
  637.  
  638.    When 'Read Mail...' is selected from the 'Select item to read'
  639. window, (See Select item to read window.) the 'Select item to read'
  640. window is closed and you will enter the message reader.
  641.  
  642.    When you first enter the message reader, the 'Select Conference'
  643. window (See Conference Window.) will appear for you to select the
  644. conference you want to start reading from. It will default to the first
  645. conference with messages other than the 'Replies' conference. When you
  646. have selected a conference, `AmiQWK' will start displaying messages.
  647.  
  648.    The message reader is divided into two sections. The top section
  649. contains header information and several gadgets, and the bottom section
  650. contains the message text.
  651.  
  652.    The following header information is present in the header at the top
  653. of the screen:
  654.  
  655. From:
  656.      Sender of the message.
  657.  
  658. To:
  659.      Person the message is addressed to.
  660.  
  661. Subj:
  662.      Subject of the message.
  663.  
  664. Date:
  665.      Date the message was entered.
  666.  
  667. Time:
  668.      Time the message was entered.
  669.  
  670. Conference:
  671.      Name and number of the conference the message is in.
  672.  
  673. Message:
  674.      Message number, Number of this message out of the total available
  675.      in this conference, and the total number of messages in this
  676.      conference.  this packet.
  677.  
  678. Reply To:
  679.      Number of the message that this message is a reply to. (or blank
  680.      if it isn't a reply to another message.)
  681.  
  682. PRIVATE
  683.      If displayed, this message is tagged as being Private, usually
  684.      readable only by the sender, receiver, and system operator.
  685.  
  686. READ
  687.      If displayed, this message has already been read.
  688.  
  689. PERSONAL
  690.      If displayed, this message is addressed to you personally.
  691.  
  692.    In addition, there are six gadgets in the upper right of the screen.
  693. `Index'
  694.      Opens the Message Index window, to select a message to read. See
  695.      Message Index window.
  696.  
  697. `Conf.'
  698.      Opens the Conference window, to select which conference to read.
  699.      See Conference Window.
  700.  
  701. `Reply'
  702.      Reply to the current message. See Entering and re-editing new
  703.      messages.
  704.  
  705. `Help'
  706.      Call up the `AmigaGuide' help for the message viewer.
  707.  
  708. `<<'
  709.      Read the previous message.
  710.  
  711. `>>'
  712.      Read the next message.
  713.  
  714.    At the bottom of the screen is the message text. There is a scroll
  715. bar at the bottom (unless the scroll bar is disabled in the Operations
  716. configuration window.) which can be used to move through the message
  717. using the mouse. The following keys can also be used to move through
  718. the message.
  719.  
  720. Keypad 8, Up Arrow
  721.      Scroll up one line of message.
  722.  
  723. Keypad 2, Down Arrow
  724.      Scroll down one line of message.
  725.  
  726. Keypad 9
  727.      Scroll up one page of message.
  728.  
  729. Keypad 3, Space Bar
  730.      Scroll down one page of message.
  731.  
  732. Keypad 7
  733.      Move to start of message.
  734.  
  735. Keypad 1
  736.      Move to end of message.
  737.  
  738. Keypad 4, Left Arrow
  739.      Read the previous message in the current conference.
  740.  
  741. Keypad 6, Right Arrow, RETURN
  742.      Read the next message in the current conference.
  743.  
  744. SPACE BAR
  745.      Move forward 1 page. If the end of the message is passed the next
  746.      message is read.
  747.  
  748.    The following keys also perform functions:
  749.  
  750. A
  751.      ANSI display of the current message. See ANSI Viewer.
  752.  
  753. C
  754.      Open Conference window to select a new conference. See Conference
  755.      Window.
  756.  
  757. E
  758.      Re-edit Reply. (only works in 'Replies' conference.) See Entering
  759.      and re-editing new messages.
  760.  
  761. I
  762.      Open Message Index window to select which message to read in the
  763.      current conference. See Message Index window.
  764.  
  765. K
  766.      Kill (delete) the current message. (Only works in 'Replies'
  767.      conference.)
  768.  
  769. N
  770.      Enter a new message. See Entering and re-editing new messages.
  771.  
  772. P
  773.      Print the current message. See Printing Text and Messages.
  774.  
  775. Q, ESC
  776.      Exit message reader and return to the 'Select item to read'
  777.      window. See Select item to read window.
  778.  
  779. R
  780.      Reply to the current message. See Entering and re-editing new
  781.      messages.
  782.  
  783. S
  784.      Save the current message to disk. See Saving Text and Messages.
  785.  
  786. T
  787.      Add a new tagline to the tagline file. See New Tagline window.
  788.  
  789. Entering and re-editing new messages
  790. ====================================
  791.  
  792.    When you select 'Reply' or 'New message' when reading messages, the
  793. 'New Message' window is opened for information about the message. (such
  794. as who it is to, subject, etc.) and your editor is opened for you to
  795. enter your your message. (Note that you can alter the order the order
  796. in which the new message window is opened. You can configure `AmiQWK'
  797. to edit the message first then open the new message window, Open the
  798. new message window then edit the message, or open the new message
  799. window both before and after the message is edited (the default). See
  800. Replies window, for more information.)
  801.  
  802.    If you are replying to an existing message, the original message
  803. will be quoted in the new message text, with the quote prefix you
  804. selected in the Replies configuration window prefixed to each line. See
  805. Replies window.  When re-editing messages the text will be sent to the
  806. editor as-is.
  807.  
  808. `To'
  809.      This is the person the message is addressed to. If you are
  810.      replying to an existing message, this will default to the sender
  811.      of the message you are replying to. If it is a new message, this
  812.      field will be blank. This field is limited to 25 characters.
  813.  
  814. `From'
  815.      This is normally your name. You can change this field, however
  816.      most QWKMail systems will not allow messages to be posted unless
  817.      this field matches your name. This field is limited to 25
  818.      characters due to constraints of the QWKMail format.
  819.  
  820. `Subject'
  821.      This is the subject of the message. If you are replying to an
  822.      existing message this field will default to the subject of the
  823.      original message.  (with an optional 'RE:' prefix, provided that
  824.      'RE: prefix for reply subject' is turned on in the 'Replies'
  825.      configuration window and the subject doesn't already have a 'RE:'
  826.      prefix.) Otherwise this field is left blank so you can enter
  827.      whatever you want here. This field is limited to 25 characters due
  828.      to constraints of the QWKMail format.
  829.  
  830. `Conference'
  831.      This is the conference you want the message to be posted to. It
  832.      defaults to the conference you are currently reading messages in.
  833.      You can enter the conference number in the integer string gadget,
  834.      or you can click on the 'Conference' button and the Conference
  835.      window will appear for you to select a conference. (See Conference
  836.      Window.) The name of the conference will appear to the right of
  837.      the conference number gadget. `AmiQWK' will check the selected
  838.      conference number against a list of conferences to make sure you
  839.      have selected a valid conference.
  840.  
  841. `Public Status'
  842.      This is a cycle gadget that can be either set to 'Public' or
  843.      'Private'. A 'public' message will be visible to everyone, while a
  844.      'Private' message is usually only visible to the sender, the
  845.      person who it is addressed to, and the system operator. Note that
  846.      not all conferences support private messages.
  847.  
  848. `Return Receipt'
  849.      Tells the BBS to generate a return receipt message when this
  850.      message is received. This function is available only if it is
  851.      supported by the QWK mailer. Note that asking for a 'Return
  852.      Receipt' will prefix the Subject field with 'RRR'.
  853.  
  854. `Tagline'
  855.      This is a short one-line message that is appended to the end of
  856.      your message. You can select a tagline from the list gadget, or
  857.      type one into the string gadget below it. (If you enter a new
  858.      tagline, it will be appended to your tagline file for future use.)
  859.      Taglines are disabled when re-editing messages.
  860.  
  861. `Select Another Tagline'
  862.      If you don't like the tagline that `AmiQWK' has selected for you,
  863.      click on this gadget and a new one will be selected.
  864.  
  865. `OK'
  866.      Accept the current settings.
  867.  
  868. `Cancel'
  869.      Cancel the new message.
  870.  
  871. Writing messages and BBS Etiquette
  872. ==================================
  873.  
  874.    When writing a message, Keep in mind that others will have to read
  875. it.  There are certain things that you can do to
  876.  
  877.    * Avoid typing in all caps. Messages that are in all caps can be
  878.      difficult to read on some monitors.
  879.  
  880.    * When entering a reply, quote only the relevant information.
  881.  
  882.    * Try to keep your paragraphs short, and insert a blank line between
  883.      paragraphs.
  884.  
  885.    * Try to keep on the subject and don't post messages to areas where
  886.      they don't belong.
  887.  
  888.    Also remember that many BBSes are connected to BBS networks such as
  889. Fidonet and Usenet. Additional rules may apply to network message
  890. areas, such as high and low ASCII characters (ASCII 0-31 and 128-255)
  891. and ANSI escape sequences may not be permitted, etc. If you are in
  892. doubt as to what is and isn't permitted in a certain conference, ask
  893. the system operator or the network conference moderator for guidelines.
  894.  
  895. Conference Window
  896. =================
  897.  
  898.    The Conference window is used to select a conference. It consists of
  899. a list gadget listing all available conferences, and an OK and a cancel
  900. gadget.
  901.  
  902. `Conference List'
  903.      Lists all available conferences by name and number, with the total
  904.      number of messages in each conference. You can select a conference
  905.      by double-clicking on the desired line of the conference or by
  906.      selecting a conference and clicking on the 'OK' gadget.
  907.  
  908. `OK'
  909.      Accept the currently selected conference and close the Conference
  910.      window.
  911.  
  912. `Cancel'
  913.      Closes the Conference window and discards any conference selection.
  914.  
  915.    You can also control the Conference window with the keyboard.
  916.  
  917. C, Q, ESC
  918.      Closes the Conference window and discards any conference selection.
  919.  
  920. O, ENTER
  921.      Accept the currently selected conference and close the Conference
  922.      window.
  923.  
  924. Keypad 8, Up Arrow
  925.      Scroll up through the conference list.
  926.  
  927. Keypad 2, Down Arrow
  928.      Scroll down through the conference list.
  929.  
  930. Message Index window
  931. ====================
  932.  
  933.    The Message Index window  is used to select a message from within a
  934. conference. It consists of a list gadget listing all available messages,
  935. and an OK and a cancel gadget. The operation of the Message Index
  936. window is nearly identical to the Conference window.
  937.  
  938. `message List'
  939.      Lists all available messages, by the To, From, Subject fields. The
  940.      following flags are present as well:
  941.  
  942.     `*'
  943.           The message is addressed to you personally.
  944.  
  945.     `R'
  946.           This message has been read.
  947.  
  948.     `P'
  949.           This message is marked as being Private.
  950.  
  951.      You can select a message by double-clicking on the desired line of
  952.      the message list, or by picking the desired conference with either
  953.      the mouse or keyboard and then clicking on the 'OK' gadget.
  954.  
  955. `OK'
  956.      Accept the currently selected message and close the Message Index
  957.      window.
  958.  
  959. `Cancel'
  960.      Closes the Message Index window and discards any message selection.
  961.  
  962.    You can also control the message window with the keyboard.
  963.  
  964. C, Q, ESC
  965.      Closes the Message Index window and discards any message selection.
  966.  
  967. O, ENTER
  968.      Accept the currently selected message and close the Message Index
  969.      window.
  970.  
  971. Keypad 8, Up Arrow
  972.      Scroll up through the message list.
  973.  
  974. Keypad 2, Down Arrow
  975.      Scroll down through the message list.
  976.  
  977. Saving Text and Messages
  978. ========================
  979.  
  980.    When you select 'Save', A file requester will open for you to select
  981. the file name to save the text or message to. If the file you selected
  982. already exists the new text or message will be appended to the end of
  983. the existing file. If you are saving a message the contents of the
  984. header will be saved as well.
  985.  
  986.    The default path and/or directory for the saved text can be set in
  987. the 'Paths' window of the config editor. See Paths window.
  988.  
  989. Printing Text and Messages
  990. ==========================
  991.  
  992.    When you select 'Print', the current text or message will be sent to
  993. the printer. If you are printing a message the contents of the header
  994. will be printed as well.
  995.  
  996. New Tagline window
  997. ==================
  998.  
  999.    The New Tagline window is used to enter a new tagline into the
  1000. taglines list file. It consists of three gadgets:
  1001.  
  1002. `Tagline'
  1003.      A string gadget to enter the new tagline into.
  1004.  
  1005. `OK'
  1006.      Close the New Tagline window and save the new tagline to the
  1007.      tagline list file.
  1008.  
  1009. `Cancel'
  1010.      Close the New Tagline window and discard the new tagline.
  1011.  
  1012.    One idea for those of you who like to steal taglines. Use a text
  1013. snapping program such as PowerSnap to cut taglines out of messages
  1014. using the mouse and then paste them into the New Tagline window.
  1015.  
  1016. Configuration
  1017. *************
  1018.  
  1019. Main Configuration Window
  1020. =========================
  1021.  
  1022.    The configuration editor consists of a main configuration window and
  1023. several sub-windows. The main Configuration window has the following
  1024. gadgets:
  1025.  
  1026. `Operation'
  1027.      Opens the Operation configuration window. The Operation window is
  1028.      used to configure the general operation of `AmiQWK'. See Operation
  1029.      window.
  1030.  
  1031. `Replies'
  1032.      Opens the Replies configuration window. The Relies window is used
  1033.      to configure how replies and new messages are processed. See
  1034.      Replies window.
  1035.  
  1036. `Paths'
  1037.      Opens the Paths configuration window. The Paths window is used to
  1038.      tell `AmiQWK' where it should look for and store files. See Paths
  1039.      window.
  1040.  
  1041. `Archivers'
  1042.      Opens the Archivers configuration window. The Archivers window is
  1043.      used to specify which compression programs are used and their
  1044.      command line options.  See Archivers window.
  1045.  
  1046. `Graphics'
  1047.      Opens the Graphics configuration window. The Graphics window is
  1048.      used to specify which screen mode the `AmiQWK' screen should open
  1049.      in, the font that should be used for text displays, the screen
  1050.      palette, etc. See Graphics window.
  1051.  
  1052. `Register'
  1053.      Opens the Registration configuration window. The Register window
  1054.      is used to enter your registration key when you register `AmiQWK'.
  1055.      See Register window.
  1056.  
  1057. `Save'
  1058.      Accepts the current configuration and saves it to disk and return
  1059.      to the 'Select Packet' window. See Select Packet window.
  1060.  
  1061. `Use'
  1062.      Accepts the current configuration and returns you to the 'Select
  1063.      Packet' window See Select Packet window. but does not save the new
  1064.      configuration to disk. If the new configuration is not saved to
  1065.      disk before exiting the program the new configuration will be lost.
  1066.  
  1067. `Cancel'
  1068.      Discard all changes to the configuration and return to the 'Select
  1069.      Packet' window. See Select Packet window.
  1070.  
  1071.    The configuration is saved in a file named 'Config.AQ' in the same
  1072. directory that `AmiQWK' is located in.
  1073.  
  1074. Operation window
  1075. ================
  1076.  
  1077.    The Operation window is used to configure the general operation of
  1078. `AmiQWK'.
  1079.  
  1080. `Scroll bar in text window'
  1081.      If this checkbox gadget is selected, a scroll bar will appear at
  1082.      the bottom of the text and message windows. This scroll bar can be
  1083.      used to move around the displayed text using the mouse.
  1084.  
  1085. `Tab Size'
  1086.      This slider gadget specifies the number of spaces between tab
  1087.      stops.
  1088.  
  1089. `Ask before Exit'
  1090.      If this checkbox is selected, `AmiQWK' will ask for confirmation
  1091.      before exiting. Otherwise it will exit without asking first.
  1092.  
  1093. `After Read'
  1094.      This cycle gadget is used to tell `AmiQWK' what to do with a
  1095.      packet after you read it. It can be set to:
  1096.  
  1097.     `No Action'
  1098.           Nothing is done to the packet after you read it.
  1099.  
  1100.     `Rename Packet'
  1101.           You will be presented with a file requester to change the
  1102.           name of the packet after you read it.
  1103.  
  1104.     `Delete Packet.'
  1105.           You will be asked if you want to delete the packet after you
  1106.           read it.
  1107.  
  1108.     `Ask'
  1109.           You will be presented with a requester asking if you want to
  1110.           Rename, Delete, or take no action at all on the packet after
  1111.           you have read it.
  1112.  
  1113. `Packet Search Pattern Match'
  1114.      This is the pattern that `AmiQWK' should use when looking for mail
  1115.      packets.  It should normally be something like '#?.Q#?' as packet
  1116.      names normally end with '.QWK' and some term programs may change
  1117.      the extension if a duplicate file is downloaded.
  1118.  
  1119. `Editor'
  1120.      This is the command line used to start your editor for editing
  1121.      messages. Be sure to specify any command line switches you need
  1122.      here as well. The file name will be appended to the end of this
  1123.      string.
  1124.  
  1125.      Keep in mind that your text editor must NOT detach itself from the
  1126.      process that started it.
  1127.  
  1128.      Here are some example editor strings for various editors.
  1129.  
  1130.     `CygnusEd'
  1131.           `c:ed -sticky' (See CygnusEd Notes.)
  1132.  
  1133.     `TurboText'
  1134.           `c:ttx WAIT'
  1135.  
  1136.     `Ed'
  1137.           `c:ed'
  1138.  
  1139.     `MEmacs'
  1140.           `sys:tools/memacs'
  1141.  
  1142.     `GoldEd'
  1143.           `c:ed sticky'
  1144.  
  1145.      If you are using `CygnusEd', See CygnusEd Notes.
  1146.  
  1147. `Workbench to front on edit'
  1148.      If this checkbox is selected, `AmiQWK' will pull the workbench
  1149.      screen to front when the editor is started. This is useful if you
  1150.      are using an editor that opens on the workbench screen but does
  1151.      not pull it to the front for you, such as the 'ed' program that
  1152.      comes with Workbench.
  1153.  
  1154. `Spawn Window'
  1155.      This string gadget is used to set the console specifications for
  1156.      the spawn window for extracting packets and packing replies. See
  1157.      your AmigaDos manual for more information on console
  1158.      specifications. If you want the spawn window to open on the
  1159.      `AmiQWK' screen, make sure that 'SCREENAMIQWK' appears somewhere
  1160.      on this line.
  1161.  
  1162. `Requesters'
  1163.      Allows you to choose between ASL and `ReqTools' file, font, and
  1164.      screenmode requesters. (note that `AmiQWK' will use the `ReqTools'
  1165.      screenmode requester if you are using version 37 of ASL.library,
  1166.      because ASL.library v37 does not have a screenmode selector.)
  1167.  
  1168. `Use'
  1169.      Use the current settings and return to the main configuration
  1170.      window. See Main Configuration Window.
  1171.  
  1172. `Cancel'
  1173.      Discard changes and return to the main configuration window. See
  1174.      Main Configuration Window.
  1175.  
  1176. CygnusEd Notes
  1177. ==============
  1178.  
  1179.    If you are using `CygnusEd' version 2.12 or earlier, you may have
  1180. trouble getting `CygnusEd' to open without detaching itself from it's
  1181. parent process due to a bug in the `ED' activator program. If you are
  1182. using `CygnusEd' 2.12, there are three options open to you.
  1183.  
  1184.    * You can upgrade to a newer version of `CygnusEd'.
  1185.  
  1186.    * You can get a third party replacement for the '`ED'' activator
  1187.      program.  There are at least two in the public domain. At least
  1188.      one of them will be available from the `AmiQWK' support BBS at all
  1189.      times. See Technical Support.
  1190.  
  1191.    * You can use the included `CygnusEd' starter script. (filename
  1192.      'StartCed', set the 'Editor' gadget in the 'Operation' window of
  1193.      the config editor to '`StartCed'' if you use this script. You may
  1194.      also need to specify the full path to the `StartCed' script.)
  1195.  
  1196.    For best results, you will probably want to 'hot-start' `CygnusEd'
  1197. from the `s:user-startup' file. See your `CygnusEd' program for details
  1198. on 'hot-starting'.
  1199.  
  1200. Replies window
  1201. ==============
  1202.  
  1203. `Edit Header'
  1204.      This cycle gadget has three settings. It controls when the message
  1205.      editor and the 'New Message' window are opened.
  1206.  
  1207.     `Before Edit'
  1208.           Edit message header in the 'New Message' window before
  1209.           editing the message text.
  1210.  
  1211.     `After Edit'
  1212.           Edit message header in the 'New Message' window after editing
  1213.           the message text.
  1214.  
  1215.     `Before and After Edit'
  1216.           Edit message header in the 'New Message' window both before
  1217.           and after editing the message text.
  1218.  
  1219. `Quote Prefix'
  1220.      This string is prefixed before each line of quoted text when
  1221.      replying to a message.
  1222.  
  1223. `Header Info in replies'
  1224.      If this checkbox is selected, the information in the message
  1225.      header will be included in the message text of a reply. Has no
  1226.      effect on new messages.  (i.e. not a reply to an existing message.)
  1227.  
  1228. `RE: prefix for reply subject'
  1229.      If this checkbox is selected, the subject field of the new message
  1230.      will be prefixed with 'RE:' unless it already has a 'RE:' prefix.
  1231.  
  1232. `Trunc/Wrap reply text'
  1233.      Specifies if quoted text in a reply is to be truncated or word
  1234.      wrapped.
  1235.  
  1236. `Col.'
  1237.      Specifies column that quoted text in a reply is to be truncated or
  1238.      word wrapped at.
  1239.  
  1240. `Use'
  1241.      Use the current settings and return to the main configuration
  1242.      window. See Main Configuration Window.
  1243.  
  1244. `Cancel'
  1245.      Discard changes and return to the main configuration window. See
  1246.      Main Configuration Window.
  1247.  
  1248. Paths window
  1249. ============
  1250.  
  1251.    The paths window is used to tell `AmiQWK' where it should look for
  1252. and store files. To the right of each path string gadget is a
  1253. 'pickfile' button, which will open a file requester to select the
  1254. desired path. You can either type the path into the string gadget or
  1255. select the path from the file requester.
  1256.  
  1257. `Packet Directory'
  1258.      Tells `AmiQWK' where it should look for mail packets. This should
  1259.      be set to the downloads directory your terminal program uses.
  1260.  
  1261. `Reply Directory'
  1262.      Tells `AmiQWK' where it should store reply packets. This should be
  1263.      set to the uploads directory your terminal program uses.
  1264.  
  1265. `Work Directory'
  1266.      Tells `AmiQWK' where it should create it's work directory. If you
  1267.      have enough memory, this should be set to `RAM:' for best
  1268.      performance. If this field is left blank, `AmiQWK' will create
  1269.      it's work directory in the directory in the same directory as the
  1270.      `AmiQWK' executable file.
  1271.  
  1272. `Saved Text'
  1273.      Default path and/or filename for saved text. You can enter a
  1274.      complete path with filename, just a filename (the files will be
  1275.      saved to the `AmiQWK' directory unless you specify a path when you
  1276.      save messages or text files) or just a path (you will need to make
  1277.      sure that the path name ends with a ':' or a '/', otherwise
  1278.      `AmiQWK' will think that the last part of the path is actually a
  1279.      file name.)
  1280.  
  1281. `Use'
  1282.      Use the current settings and return to the main configuration
  1283.      window. See Main Configuration Window.
  1284.  
  1285. `Cancel'
  1286.      Discard changes and return to the main configuration window. See
  1287.      Main Configuration Window.
  1288.  
  1289. Archivers window
  1290. ================
  1291.  
  1292.    The Archivers window is used to specify the command line strings for
  1293. the file compression/extraction programs. Currently `AmiQWK' supports
  1294. `LHA/LHArc', `ZIP', `ZOO', and `ARC' compression. The filename and
  1295. destination directory will be appended to the command line strings.
  1296.  
  1297. `Use'
  1298.      Use the current settings and return to the main configuration
  1299.      window. See Main Configuration Window.
  1300.  
  1301. `Cancel'
  1302.      Discard changes and return to the main configuration window. See
  1303.      Main Configuration Window.
  1304.  
  1305. Graphics window
  1306. ===============
  1307.  
  1308.    The Graphics window is used to specify the general appearance of
  1309. `AmiQWK'.
  1310.  
  1311. `Screen Mode'
  1312.      The name of the screen mode that `AmiQWK' opens on. (Read only,
  1313.      use the 'Select Screen Mode' gadget to select a screen mode.)
  1314.  
  1315. `Width'
  1316.      The width of the `AmiQWK' screen in pixels. (Read only)
  1317.  
  1318. `Height'
  1319.      The height of the `AmiQWK' screen in pixels. (Read only)
  1320.  
  1321. `Select Screen Mode'
  1322.      Select a screen mode for `AmiQWK' using the ASL or `ReqTools'
  1323.      screenmode requester. (If you are using version 37 of ASL.library,
  1324.      the `ReqTools' screenmode requester will be used.) You can also
  1325.      specify the number of colors the `AmiQWK' screen uses. (I
  1326.      recommend using 4 colors. At this time `AmiQWK' does not use more
  1327.      than four colors except for the ANSI display screen, which is hard
  1328.      coded to use a 16 color screen.)
  1329.  
  1330. `Shanghai'
  1331.      If this checkmark is selected, the `AmiQWK' screen will be opened
  1332.      in 'Shanghai' mode.
  1333.  
  1334. `PopPubScreen'
  1335.      If this checkmark is selected, the `AmiQWK' screen will be opened
  1336.      in 'PopPubScreen' mode.
  1337.  
  1338. `Edit Palette'
  1339.      Change the color palette `AmiQWK' uses using the `ReqTools'
  1340.      palette requester.
  1341.  
  1342. `Select Font'
  1343.      Select the font `AmiQWK' uses for message text, using the ASL or
  1344.      `ReqTools' font requester. The selected font and size will appear
  1345.      to the right of the 'Select Font' gadget. I recommend using an
  1346.      IBM-PC style font as many packets will contain characters that
  1347.      only appear properly when viewed with an IBM-PC style font.
  1348.  
  1349. `Use'
  1350.      Use the current settings and return to the main configuration
  1351.      window. See Main Configuration Window.
  1352.  
  1353. `Cancel'
  1354.      Discard changes and return to the main configuration window. See
  1355.      Main Configuration Window.
  1356.  
  1357. Register window
  1358. ===============
  1359.  
  1360.    The Register window is used generate a registration keyfile. When you
  1361. register you will be given a 16 digit registration number which should
  1362. be entered into this window.
  1363.  
  1364. `Your Name'
  1365.      Enter your name into this gadget. It must be entered exactly as it
  1366.      was specified on your registration form as the registration key is
  1367.      matched against this field.
  1368.  
  1369. `Registration Key'
  1370.      Enter your 16 digit registration number in this gadget.
  1371.  
  1372. `Status'
  1373.      Registration status. Will either be a registration serial number
  1374.      or '** UNREGISTERED EVALUATION COPY **' if a valid registration
  1375.      key is not present.
  1376.  
  1377. `Use'
  1378.      Save your registration key to disk and return to the main
  1379.      configuration window. See Main Configuration Window.
  1380.  
  1381. `Cancel'
  1382.      Discard changes and return to the main configuration window. See
  1383.      Main Configuration Window.
  1384.  
  1385. Advanced QWK features
  1386. *********************
  1387.  
  1388.    Some BBSes allow for adding, dropping, and resetting of conferences,
  1389. downloading files attached to messages, and other functions by sending
  1390. messages to the BBS via a QWKmail packet. If the BBS supports these
  1391. features a file named DOOR.ID will be included in the QWKMail packet
  1392. that will tell `AmiQWK' what functions are available and how to process
  1393. a request.
  1394.  
  1395.    For example, if you had a packet from a Wildcat! BBS and had `AmiQWK'
  1396. generate a request to add conference #25, `AmiQWK' would generate a
  1397. message with the following header information:
  1398.  
  1399.    FROM: <your name>
  1400. TO: TOMCAT
  1401. SUBJ: ADD
  1402. CONFERENCE 25
  1403. If you decide to abort the request, just enter the 'Replies' conference
  1404. and 'Kill' the request message. (See Reading Messages.)
  1405.  
  1406. The Future of AmiQWK
  1407. ********************
  1408.  
  1409.    Here is a partial list of things I plan to add to future versions of
  1410. `AmiQWK':
  1411.  
  1412.    * Sorting
  1413.         - Conferences by Name or Number.
  1414.  
  1415.         - Messages by To, From, Subject, Message Number, etc.
  1416.  
  1417.    * String search for message by to:, from:, subject:, message text.
  1418.  
  1419.    * Improvement of quote system.
  1420.         - Optionally include initials of sender of original message in
  1421.           quote prefix. (i.e. quoting a message from Jim Dawson would
  1422.           result in 'JD>' as the quote prefix.)
  1423.  
  1424.    * Tagline manager
  1425.         - Edit, Delete, Sort, Find tagline functions.
  1426.  
  1427.         - multiple tagline files can be maintained. (such as a file
  1428.           containing only Star Trek quotes, etc.)
  1429.  
  1430.         - a 'Steal Tagline' function.
  1431.  
  1432.    * Progress indicator for packet processing
  1433.  
  1434.    * Database of BBS and packet information
  1435.         - Keep a record of which packets have been read, etc.
  1436.  
  1437.         - Keep record of conferences and other information about the
  1438.           packets a BBS generates, so that a reply packet can be
  1439.           generated even if no packet exists for the BBS.
  1440.  
  1441.         - Keep a address book of people you regularly send messages to.
  1442.  
  1443.         - Keep a 'Twit' list. Ignore messages with certain topics or
  1444.           from/to persons listed.
  1445.  
  1446.    * 'Blue Wave' packet support.
  1447.         - Only if someone gives me some information about the Blue Wave
  1448.           packet format.
  1449.  
  1450.    * 'Text Variables' for inserting information into text, such as who
  1451.      the message is to/from, etc.
  1452.  
  1453.    * ARexx Interface
  1454.  
  1455.    * Improved user interface, possibly using Magic User Interface or
  1456.      some other third party user interface toolkit.
  1457.  
  1458.    If there is a feature you would like to see in a future version, let
  1459. me know about it, even if I listed it already. If I get a lot of
  1460. requests I may move it to a higher position on the list.
  1461.  
  1462.    Remember, The future of `AmiQWK' depends on YOU! Send in your
  1463. registration as soon as possible.
  1464.  
  1465. Technical Support
  1466. *****************
  1467.  
  1468.    Technical support for `AmiQWK' is available through the following:
  1469.  
  1470. Electronic Mail
  1471.     INTERNET
  1472.           jim_dawson@hguild.com
  1473.           Note that this is a new address. Please discontinue using the
  1474.           old 'thg2!jimdawson@sycom.mi.org' address.
  1475.  
  1476.           I also monitor the USENET comp.sys.amiga.datacomm and
  1477.           comp.sys.amiga.programmer newsgroups.
  1478.  
  1479.     PORTAL
  1480.           jimdawson (or jimdawson@cup.portal.com via internet.)
  1481.  
  1482.     FIDONET
  1483.           1:2290/42.0
  1484.  
  1485.           Note that at this time I do not monitor any Fidonet echoes
  1486.           that discussions of AmiQWK would be relevant to.
  1487.  
  1488. Postal Mail
  1489.      Jim Dawson
  1490.      509 S. Madison St.
  1491.      Marion, IL. 62959
  1492.      USA
  1493.  
  1494. BBS
  1495.      The Hackers Guild II BBS
  1496.      (618)997-2591 300-14,400 BPS USR HST/v.32/v.32bis.
  1497.      Full Duplex, 8 data bits, 1 stop bit, no parity.
  1498.      24 Hrs, 7 Days. (Ex. Fidonet Zone Mail Hour.) You can download
  1499.      from the AmiQWK file area on your first call.
  1500.  
  1501.    For fastest and most reliable way to get technical support is to
  1502. call The Hackers Guild II BBS directly. I recommend sending email to my
  1503. Portal account only if all other methods fail, as I only call Portal
  1504. once or twice a week.
  1505.  
  1506.    When asking for help, please give as complete description of your
  1507. problem as possible, as well as a complete description of your system
  1508. and any software that might also be running at the same time as
  1509. `AmiQWK'. The more information I have the faster I can suggest a
  1510. solution to your problem.
  1511.  
  1512.    I will personally post new versions of AmiQWK to The Hackers Guild
  1513. II BBS and Portal, and new versions will be submitted to Fred Fish for
  1514. inclusion in his library of freely distributable software. Users of
  1515. Fidonet mailers can FREQ the latest version of AmiQWK by requesting
  1516. 'AMIQWK' from 1:2290/42.0 (or 618-997-2591 if you don't have a Fidonet
  1517. nodelist.) I may also post new versions of AmiQWK to various FTP sites,
  1518. including the Aminet sites.
  1519.  
  1520. Acknowledgments
  1521. ***************
  1522.  
  1523.    Special thanks go to:
  1524.  
  1525. `Jefferey Foy'
  1526.      For information on the QWKMail format and MSBIN-IEEE conversion
  1527.      routines.
  1528.  
  1529. `Greg Hewgill'
  1530.      For specifications of the DOOR.ID file.
  1531.  
  1532. `Patrick Y. Lee'
  1533.      For his excellent document on the QWKMail format.
  1534.  
  1535. `Marcus Trisdale'
  1536.      For his ANSI display code.
  1537.  
  1538. `Jan van den Baard'
  1539.      For his GadToolsBox GUI builder program.
  1540.  
  1541. `Nico Franτois'
  1542.      For `reqtools.library'
  1543.  
  1544. `Commodore Business Machines'
  1545.      for `AmigaGuide.library' and for making the Amiga computer.
  1546.  
  1547. `Robert J Chassell and Richard M. Stallman'
  1548.      for the Texinfo documentation format.
  1549.  
  1550. `Reinhard Spisser and Sebastiano Vigna'
  1551.      for `MakeGuide'.
  1552.  
  1553. `Chris Hurley, Guy Bartoli, Dave Birdsong, Dennis Jann, Mike Soucy,'
  1554. `Kipling Cooper, Steve Stewart, and Matt Weatherford'
  1555.      for Beta Testing `AmiQWK'
  1556.  
  1557.    And of course, everyone who has sent in registrations.
  1558.  
  1559. Index
  1560. *****
  1561.  
  1562.  
  1563.