home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR4 / QWKTALK1.ZIP / QWKTALK.DOC < prev    next >
Text File  |  1994-02-01  |  21KB  |  471 lines

  1. ┌────────────────────────────────────────────────────────────────────────────╗
  2. │                                                                            ║
  3. │       PEGASUS SOFTWARE'S  * QWKTALK (TM) *  ROBOTIC MAIL READER 1.1ß       ║
  4. │                                                                            ║
  5. │                    Copyright (c) 1993,94 Chris Michaels                    ║
  6. │                                                                            ║
  7. │                         Another Fine Program From:                         ║
  8. │                                                                            ║
  9. │          The PEGASUS PROJECT...the Next Generation (813) 481-5575          ║
  10. │                                                                            ║
  11. └════════════════════════════════════════════════════════════════════════════╝
  12.  | Indicates New Additions to Docs since last update
  13.  
  14.      ┌────────────────┤SPECIAL NOTE ON BETA TESTING!!├───────────────────┐
  15.      │                                                                   │
  16.      │  QWKTALK is currently in WIDE AREA BETA TEST. This means the      │
  17.      │  program is being circulated for evaluation *AND* to see what,   │
  18.      │  if any, bugs will creep up, so that they may be eliminate in the │
  19.      │  final release. To do this effectively, it is necessary to include │
  20.      │  in the code certain DEBUGGING routines that will enable me to    │
  21.      │  identify problems that *MAY* show up. NOW TO THE POINT... I have │
  22.      │  received a few calls from users saying "Could you make QWKTALK   │
  23.      │  run any faster"...the answer is "OF COURSE!". Once all of the    │
  24.      │  debugging code has been removed, the program will operate        │
  25.      │  considerably faster. I AM GRADUALLY REMOVING THE DEBUGGING CODES │
  26.      │  AS THE BETA CYCLE PROGRESSES. EACH RELEASE WILL HAVE LESS OF THE │
  27.      │  DEBUGGING CODE, SO EACH RELEASE WILL SHOW IMPROVED PERFORMANCE.  │
  28.      │  Please *PLEASE* understand this when you evaluate this program.  │
  29.      │  QWKTALK, in its final release, WILL perform at acceptable        │
  30.      │  speeds.                                                          │
  31.      └───────────────────────────────────────────────────────────────────┘
  32.  
  33.        THANK YOU FOR TAKING THE TIME TO EVALUATE THIS INNOVATIVE PROGRAM!
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  OVERVIEW
  40.  ════════
  41.         WOW! You Have Never Seen Anything Like this!!!!!
  42.  
  43.         PEGASUS SOFTWARE'S * QWKTALK (TM) * is a QWK Mail reader with a
  44.         little twist....IT TALKS!!!!
  45.  
  46.         That's right, QWKTALK will open your mail packet, sort it, and
  47.         READ THE MAIL TO YOU!!!!!!!
  48.  
  49.         Now you don't have to be chained to your CPU while reading mail,
  50.         you can be up and about, and still HEAR your mail.
  51.  
  52.  
  53. FEATURES
  54. ════════
  55.         Here is a short list of just SOME of the FANTASTIC FEATURES OF
  56.         PEGASUS SOFTWARE'S QWKTALK (TM)
  57.  
  58.         - Automatic Creation of Configuration File with default settings
  59.           for QWK path, Auto Cycle, and Headers Toggle
  60.  
  61.         - Cursor Arrow driven file list, which enables you to choose the
  62.           QWK packet you want to read
  63.  
  64.         - Sorting by any field you wish....You can:
  65.  
  66.                        Sort by TO Name
  67.                        Sort by FROM Name
  68.                        Sort by Conference Number
  69.  
  70.                     OR ANY COMBINATION OF THE ABOVE!!!
  71.  
  72.                        Sort by TO Name and From Name
  73.                        Sort by TO Name and Conference Number
  74.                        Sort by FROM Name and Conference Number
  75.                        Sort by TO Name, FROM Name & Conference Number
  76.  
  77.         - Message Indexing with cursor key driven highlight bar which
  78.           enables you to choose any individual message from any
  79.           conference within the QWK packet
  80.  
  81.         - Pleasant Sounding Tone when Packet Users Name Encountered
  82.  
  83.         - Automatic Message Cycle
  84.               When Enabled, will Automatically Cycle To Next Message
  85.               after 5 seconds
  86.  
  87.          - Silent Or Spoken Headers
  88.               Allows you to Choose if you wish to HEAR the Message
  89.               Number, Date, etc. Headers are ALWAYS displayed.
  90.  
  91.          - Full Screen Message Display
  92.  
  93.          - Continuous Count of Messages Read
  94.  
  95.          - Full Reply Capabilities
  96.            <AVAILABLE ONLY IN REGISTERED VERSION>
  97.  
  98.          - Neat...Cleans up after itself leaving no temp files behind
  99.  
  100.          - Complete Control Panel Menu on Each Message Screen, allowing
  101.            you to Skip Messages, or Choose New Names or Conferences
  102.  
  103.          - On the fly voice control of Pitch, Volume, Tone and Speed
  104.  
  105. |        - Message Capture to an ASCII text file
  106.  
  107. |        - Messages Read Indicator
  108.  
  109.          - AND BEST OF ALL ... IT TALKS!!!!!!!!!
  110.  
  111.  
  112.  FILE LIST
  113.  ═════════
  114.  
  115.          The archive you received should contain the following files:
  116.  
  117.  
  118.                        QWKTALK.EXE <=== The Main Executable Program
  119.         ┌───────────>  SETUPQT.EXE <=== The SetUp Program
  120. ┌───────┴─────────┐   PEGATALK.EXE <=== Pegasus Software's Voice Engine
  121. │THESE ARE THE    │                     <Called by QWKTALK>
  122. │ONLY TWO FILES   │   PEGAREAD.EXE <=== Pegasus Software's Reader
  123. │YOU EXECUTE      │                     <Called by QWKTALK>
  124. │DIRECTLY...ALL   │       TALK.DRV <=== The Speech Driver
  125. │OTHERS ARE CALLED│                     <Called by PEGATALK.EXE>
  126. │FROM WITHIN THE  │       CTTS.DRV <=== Creative Lab's Reader Driver
  127. │PROGRAM, BUT ALL │                     <Called by PEGAREAD.EXE>
  128. │MUST BE PRESENT!!│   QUECLEAN.EXE <=== A TSR Remover
  129. └──────┬──────────┘                     <Called By ALL Above EXEs>
  130.        └────────────>     TALK.COM <=== The Start-Up file for running
  131.                                         QWKTALK
  132.                        QWKTALK.DOC <=== This File
  133.                       PEGAVOCU.EXE <=== Pegasus Software's Voice Utilities
  134.                                         <Called By QWKTALK>
  135.  
  136.          ALL of these files *MUST* be present for QWKTALK to work. If
  137.          you are missing *ANY* of the above files, call The PEGASUS
  138.          PROJECT BBS at (813) 481-5575 and download the latest version
  139.          of QWKTALK. DO NOT ATTEMPT TO RUN QWKTALK IF ANY OF THE ABOVE
  140.          FILES ARE MISSING!!!
  141.  
  142.  SETUP
  143.  ═════
  144.     *** QWKTALK REQUIRES 500K OF CONVENTIONAL MEMORY TO RUN PROPERLY ***
  145.  
  146.  
  147. NOTE>>> PEGASUS SOFTWARE'S QWKTALK has been designed to run on any
  148.         SoundBlaster Compatible Sound Card. Testing has been done on
  149.         various cards. The following examples of environment settings
  150.         are for the Sound Blaster PRO card. Check your sound card's
  151.         manual for the correct settings for your card.
  152.  
  153.         Before you begin your setup, you must make sure your environment
  154.         is correctly set for your sound card. You should have a line
  155.         *SIMILAR* to this in your AUTOEXEC.BAT:
  156.  
  157.          SET BLASTER=A220 I5 D1 T4   <=== Sets the Sound Card ENVIRONMENT
  158.  
  159.         You should also use whatever utilities you have to set the
  160.         volume on you card to MAX. <Such as SBP-SET.EXE for SoundBlaster
  161.         PRO>. Doing this will allow you to control the volume of the
  162.         QWKTALK's voice with your speaker volume control, and the voice
  163.         utilities built into QWKTALK.
  164.  
  165.         Check your sound card manual for more information on the
  166.         ENVIRONMENT setting, and how to set the volume to MAX.
  167.  
  168.         Now On To The Setup:
  169.  
  170.         1. Create a directory Called QWKTALK <MD \QWKTALK>
  171.  
  172.         2. Unzip the *ENTIRE* contents of the archive into
  173.            the QWKTALK directory
  174.  
  175.         3. Type <SETUPQT> at the prompt and answer the questions
  176.            Telling QWKTALK your QWK file Path, and your choices
  177.            for default settings. You will be prompted for the <T>one,
  178.            <V>olume, <P>itch and <S>peed of the voice. These features
  179.            allow you to adjust and adapt QWKTALK's voice to suit your
  180.            taste. Here is a good starting point:
  181.  
  182.                                  TONE: 1
  183.                                VOLUME: 3
  184.                                 PITCH: 2
  185.                                 SPEED: 5
  186.  
  187.            QWKTALK's voice will speak to you at this point, giving you a
  188.            sample of the settings, and instructions on how to change
  189.            them if they are not what you want.
  190.  
  191.            Remember: you can adjust them on the fly at any time from
  192.            within QWKTALK by entering a <V> at the menu line.
  193.  
  194.  
  195.  NOTE>»»»» You never have to run the SETUPQT program again, unless you
  196.            need to change the QWK file Path, or you wish to change the
  197.            Default choices.
  198.  
  199.      THAT'S IT!!!! YOU ARE NOW READY TO RUN PEGASUS SOFTWARE'S QWKTALK!
  200.  
  201.  
  202.  
  203. IMPORTANT!!!!!!!
  204. IMPORTANT!!!!!!!  QWKTALK IS CURRENTLY DESIGNED TO HANDLE QWK PACKETS
  205. IMPORTANT!!!!!!!  MADE WITH PKZIP.EXE ONLY. FUTURE RELEASES *MAY* SUPPORT OTHER
  206. IMPORTANT!!!!!!!  COMPRESSION TYPES BUT WITH THIS BETA RELEASE MAKE SURE YOUR
  207. IMPORTANT!!!!!!!  QWK PACKET IS ZIPPED.
  208. IMPORTANT!!!!!!!  PKUNZIP AND PKZIP *MUST* BE IN YOUR DOS PATH OR IN
  209. IMPORTANT!!!!!!!  THE DIRECTORY WHERE * QWKTALK * IS RUNNING  OR IT WILL
  210. IMPORTANT!!!!!!!  NOT OPERATE!!!!!!!
  211. IMPORTANT!!!!!!!
  212.  
  213.  
  214.  RUNNING QWKTALK
  215.  ═══════════════
  216.  
  217.         You are now ready to run PEGASUS SOFTWARE'S QWKTALK (TM).
  218.  
  219.         At the Main Prompt, type <TALK>.
  220.  
  221.         QWKTALK will now go though a series of automated events,
  222.         including checking your setup file for default values, finding
  223.         the directory where your files are, and setting up it's work
  224.         space and temporary directory.
  225.  
  226.         In SECONDS, you will see a list of QWK files in front of you,
  227.         the first one will be highlighted in light blue. Using the
  228.         arrow keys <on un-enhanced keyboards, make sure your number lock
  229.         is OFF>, you can move the selection bar over the file QWK you
  230.         wish to hear/read. Once you have done this, press enter.
  231.  
  232.         QWKTALK will then UNPACK the selected file, analyze it, count the
  233.         number of messages, view the message base itself, <to see if there
  234.         are any juicy messages IT may want to read <g>>, and sort the
  235.         packet.
  236.  
  237.         To keep you amused during this task, QWKTALK will display the
  238.         HEADER information at a startling speed. This display is here
  239.         only to keep your interest and serves no other purpose
  240.         whatsoever!
  241.  
  242.         Soon you will see the following appear on the screen:
  243.  
  244.                       Search (T)o or (F)rom Field or
  245.               View (I)ndex of Message in Selected Conference
  246.  
  247.         Here you can choose (T) or (F) to determine which field you want to
  248.         search by. If you intend to search all messages in any or all
  249.         conferences <not recommended see note below>, just choose (T) here.
  250.  
  251.         About the (I)ndex feature....
  252.  
  253.         One of the most remarkable things about QWKTALK is it's ability
  254.         to narrow down the mail to just the messages you wish to read.
  255.         The powerful (I)ndex feature gives you the opportunity to select
  256.         INDIVIDUAL messages from any conference and just read/listen to
  257.         that particular message. Pressing (I) at this prompt will
  258.         immediately take you the the conference selection menu. Here you
  259.         can choose the conference from which you will pick the
  260.         individual message you want to read. Then QWKTALK will display
  261.         a list of Message Number, To, From, and Subject for all of the
  262.         messages in the selected conference.
  263. |       An "*" in the Index listing indicates that you have already read
  264. |       this message.
  265.         By using the cursor keys, you can move the highlight bar to
  266.         the message you wish to read, then press enter and QWKTALK will
  267.         display and read you that message. You will then be returned to
  268.         the main menu for you next choice.
  269.  
  270.         The (T)o, (F)rom, (I)ndex selection prompt can be reached by
  271.         typing (N)ame or (N)ew Index at any Menu.
  272.  
  273.         The next screen will give you a chance to enter the TO NAME,
  274.         FROM NAME, and CONFERENCE NUMBER of your choice, to help narrow
  275.         down the mail to just what you want to hear/read. The Menu is Color-
  276.         coordinated to the status box below, to make it easy to see what
  277.         field you are work on, and what the previous choices have been.
  278.         Any time you wish to RETAIN the choice in the Status Box, simply
  279.         enter <=> EQUALS for that choice and the current selection will
  280.         be retained. Pressing <ENTER> alone will default to ALL. <See
  281.         Note Below>
  282.  
  283.          Once you have selected all three fields, QWKTALK will begin to
  284.          retrieve those messages and translate them for screen display
  285.          and for speech synthesization.
  286.  
  287. NOTE>»»» PREPARATION OF MESSAGES FOR SPEECH SYNTHESIZATION IS NOT A
  288.          SIMPLE PROCESS. THE FASTEST WAY TO ACHIEVE THIS IS TO USE THE
  289.          SORT FEATURES TO MINIMIZE THE NUMBER OF MESSAGES FOR EACH
  290.          SEARCH. AT ANY TIME YOU CAN RETURN TO THE CHOICE MENU <USING
  291.          THE <N>ame, <N>ew Index or <C>onference COMMAND AND SELECT DIFFERENT
  292.          PARAMETERS FOR YOUR SEARCH. A SELECTION OF  <TO> ALL ; <FROM>
  293.          ALL; <CONFERENCES> ALL; WILL TAKE A LITTLE WHILE, SO TRY TO BE
  294.          A BIT SPECIFIC IN YOUR CHOICES, <TO> ALL; <FROM> ALL;
  295.          <CONFERENCE> 0; IS A MUCH BETTER CHOICE AND WILL TAKE A LOT
  296.          LESS TIME! YOU CAN THEN DO THE SAME FOR CONFERENCE 1, 2 ETC.
  297.          AND QWKTALK WILL BE MUCH HAPPIER.
  298.  
  299.          During the Message Retrieval/Translation process, QWKTALK will
  300.          display the Status Box, the Name of the Current Directory it is
  301.          searching, and the number of messages it finds that meet your
  302.          sort parameters. It will also, at this time, display a fancy
  303.          little animated star pattern to keep you amused during this
  304.          procedure.
  305.  
  306.          Once completed, QWKTALK will display a screen with the Stats on
  307.          the Packet it is currently working on. You will see this screen
  308.          only once, just before the first message you have chosen to
  309.          hear/read. The information includes, the BBS name, Packet
  310.          Name, Door ID, Time and Date of the Packet, User Name etc.
  311.  
  312.  
  313.          ****************** NOW THE MAGIC BEGINS ************************
  314.  
  315.          With the information displayed on the screen, QWKTALK will
  316.          begin to TALK. It will READ YOU every word on the screen, in a
  317.          PLEASANT, robotic voice. In the upper right hand corner of the
  318.          screen, you will see the word <SPOKEN> or <SILENT>, reminding
  319.          you of the current Header Setting you have chosen. Also, if you
  320.          have CHOSEN AUTOMATIC CYCLING, you will see the word <AUTO> in
  321.          the corner.
  322.  
  323.          Once QWKTALK has READ the entire screen to you, you will be
  324.          given a prompt. You can either <ENTER> to go to the Next
  325.          Message, or change <C>onferences, <N>ames, <N>ew Index etc.
  326.          Change the Toggle for <A>uto cycling, enter the (V)oice Utilities
  327.          sub program or <Q>uit. If you are currently in the AUTO mode,
  328.          five seconds after the message is read, QWKTALK will move on to the
  329.          next message and read it. This will continue until all of the
  330.          selected messages have been read, at which time you will have
  331.          the option of choosing a new name, conference etc. If you wish
  332.          to interrupt QWKTALK while it is speaking, press any key and
  333.          QWKTALK will finish the phrase in its que, then return you to
  334.          the menu prompt.
  335.  
  336. |        As will remember each message you read and put an "*" before
  337. |        it in the Index listing.
  338.  
  339.          In the UNREGISTERED VERSION, you will be allowed to hear/read 7
  340.          messages, then an annoying reminder to register will be read
  341.          to you. You will also be UNABLE to REPLY in the Unregistered
  342.          Version.
  343.  
  344.  
  345.  VOICE UTILITIES
  346.  ══════════════
  347.  
  348.           Typing (V) a the menu line will bring you to the voice utility
  349.           menu. From here you can adjust the Tone, Volume, Pitch and
  350.           Speed of QWKTALK's voice. <Sorry gender is not available in
  351.           this Beta release>. Simply respond to each question with the
  352.           appropriate number. The following is a good starting point,
  353.           however you may choose any settings you wish:
  354.  
  355.                                  TONE: 1
  356.                                VOLUME: 3
  357.                                 PITCH: 2
  358.                                 SPEED: 5
  359.  
  360.           QWKTALK will automatically update your configuration file to
  361.           the new settings each time you enter the voice utility menu.
  362.  
  363.  
  364. PARTING NOTES
  365. ═════════════
  366.  
  367.             QWKTALK represents HUNDREDS of HOURS of work, and although
  368.             it is annoying to have restrictions built into a program, it
  369.             is far more annoying to see you work being used and not paid
  370.             for.
  371.  
  372.             Support the Shareware Concept and REGISTER QWKTALK (tm).
  373.  
  374.             The technology behind QWKTALK is new, and this is a BETA
  375.             release, that is why we are offering REGISTRATION at a
  376.             modest $35.00 fee during the BETA Period. Once completed, it
  377.             will cost over $50.00 to Register...but as a bonus to
  378.             everyone who registers during the BETA Period, you will be
  379.             upgrade to the complete version at NO ADDITIONAL CHARGE! So
  380.             register now and save $$$$.
  381.  
  382.  
  383. DEDICATION
  384. ══════════
  385.  
  386.             This program is dedicated to MIRIAM CADY, who said, "WHAT
  387.             IF", and whose countless hours of testing helped me find and
  388.             eliminate the many bugs that creep up when developing a new
  389.             idea. Oh, and she picked out the menu colors too.
  390.             Thanks Miriam!
  391.  
  392.  
  393.  
  394.  REGISTRATION
  395.  ════════════
  396.  
  397.       PEGASUS * QWKTALK (tm) * IS NOT FREE IT IS SHAREWARE. If you use the
  398.       program, you MUST register it. Registration will eliminate the 7
  399.       message limit, and enable REPLIES. ALSO IF YOU REGISTER NOW,
  400.       DURING THE BETA PERIOD, YOU WILL BE ENTITLED TO THE FINAL VERSION
  401.       UPON COMPLETION AT NO ADDITIONAL CHARGE! REGISTRATION DURING THE
  402.       BETA PERIOD IS ONLY $35.00 - FINAL RELEASE REGISTRATION WILL
  403.       EXCEED $50.00!
  404.  
  405.       FAILURE TO REGISTER IS A VIOLATION OF THE COPYRIGHT LAWS!
  406.  
  407.       To register complete the form below, and mail it, along with
  408.       a Check/Money Order for $35.00 to:
  409.  
  410.                          CHRIS MICHAELS
  411.                          6237 PRESIDENTIAL COURT #125
  412.                          FORT MYERS, FL 33919
  413.  
  414.        You will receive a registered copy of PEGASUS * QWKTALK (tm) * on 5 1/2
  415.        or 3 1/2 disk, or you can choose to download your registered copy
  416.        from The PEGASUS PROJECT. UPDATES, DURING THE BETA PERIOD, WILL
  417.        BE DISTRIBUTED BY WAY OF THE PEGASUS PROJECT BBS, WHERE
  418.        REGISTERED USERS CAN DOWNLOAD A REGISTERED UPDATED COPY OF THE
  419.        CODE.
  420.  
  421.        If you have any comments, suggestions, beta reports, wish list
  422.                          etc. you can contact me at
  423.  
  424.           THE PEGASUS PROJECT...the Next GeneratioN (813) 481-5575
  425.  
  426.  
  427.       ---------------------------------------------------------------------
  428.  
  429.             Enclosed is my Check/Money Order for $35.00 as registration
  430.             fee for PEGASUS * QWKTALK (tm) * 1.0ß
  431.  
  432.             I would like:
  433.  
  434.                 [ ] to download it from The PEGASUS PROJECT
  435.  
  436.                 [ ] 5 1/2 DD or [ ] 3 1/2 DD disk mailed to me
  437.  
  438.  
  439.              NAME_________________________________________________________
  440.  
  441.            * BBS NAME ____________________________________________________
  442.  
  443.              ADDRESS_______________________________________________________
  444.  
  445.              ______________________________________________________________
  446.  
  447.              CITY___________________________ST____________ZIP_______________
  448.  
  449.              VOICE PHONE [_______] ___________________
  450.  
  451.              DATA PHONE [_______] ____________________
  452.  
  453.            * Version of PCBOARD you are currently running ________
  454.  
  455.  
  456.            * if applicable
  457.       ----------------------------------------------------------------------
  458.  
  459.  
  460.  
  461.    DISCLAIMER
  462.    ══════════
  463.  
  464.          PEGASUS * QWKTALK * has been tested thoroughly, however, as with all
  465.          shareware, we cannot be held responsible for any damage or loss
  466.          resulting from this program, and will not be liable for
  467.          anything. The program is offered as is, and the user accepts
  468.          all responsibility. Plain and simple, we are not responsible
  469.          for anything, however, if you have a problem, we will do our
  470.          best to help you solve it.
  471.