home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD2.bin / bbs / util / mayflower.lha / MayFlower / ASR / ASR.doc < prev    next >
Text File  |  1994-05-12  |  27KB  |  596 lines
  1.  
  2.                         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.                            Announce System Requests
  4.  
  5.                         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  6.                                   Alias: ASR
  7.  
  8.                      Copyright © 1991 Stephen D. Childers
  9.  
  10.                     Version Number: 19940301  (1 Mar 1994)
  11.  
  12. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  13.  
  14.    Announce System Requests                                Page i-01
  15.  
  16.                            Table of Contents
  17.                         -----------------------
  18.       Chapters:
  19.  
  20.          Program Author ................................ Page  A-01
  21.          Program Description ........................... Page  A-02
  22.          CLI Usage ..................................... Page  A-03
  23.          CLI Examples .................................. Page  A-04
  24.          Workbench Usage ............................... Page  A-05
  25.          Program Messages and Errors ................... Page  A-06
  26.          How To Make Extra PROJECT Icons................ Page  A-07
  27.          Operational Notes ............................. Page  A-08
  28.          Programmer's Notes ............................ Page  A-09
  29.          Version History................................ Page  A-10
  30.  
  31. <XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX>
  32.  
  33.    Program Author:                                         Page A-01
  34.  
  35.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  36.    Address:
  37.                                                 --- ---
  38.           Stephen D. Childers                   (o) (o)
  39.           2302 West Vesper Street                  ^
  40.           Blue Springs, Missouri 64015          \_____/
  41.  
  42.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  43.        /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  44.       /                                                            \
  45.      /                                                              \
  46.     /      12  Therefore all things whatsoever ye would that men     \
  47.    /   should do to you, do ye even so to them: for this is the law   \
  48.    \   and the prophets.                                              /
  49.     \                                                                /
  50.      \                 The King James Holy Bible - Matthew 7:12     /
  51.       \                                                            /
  52.        \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/
  53.        //\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\
  54.       /X__XX__XX__XX__XX__XX__XX__XX__XX__XX__XX__XX__XX__XX__XX__X\
  55.      //                                                            \\
  56.     //                                                              \\
  57.     X       23  For the wages of sin is death; but the gift of God   X
  58.     X    is eternal life through Jesus Christ our Lord.              X
  59.     X                                                                X
  60.     \\                The King James Holy Bible - Romans 6:23       //
  61.      \\ __  __  __  __  __  __  __  __  __  __  __  __  __  __  __ //
  62.       \X  XX  XX  XX  XX  XX  XX  XX  XX  XX  XX  XX  XX  XX  XX  X/
  63.        \\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//\\//
  64.        /\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\
  65.       /                                                            \
  66.      /                                                              \
  67.     /       16  For I am not ashamed of the gospel of Christ: for    \
  68.    /     it is the power of God unto salvation to every one that      \
  69.    \     believeth; to the Jew first, and also to the Greek.          /
  70.     \                                                                /
  71.      \                The King James Holy Bible - Romans 1:16       /
  72.       \                                                            /
  73.        \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/
  74.  
  75. <XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX>
  76.  
  77.    Program Description:                                    Page A-02
  78.  
  79.    1) The main purpose of this program is to cause an audible noise
  80.       to be made when a System Request (henceforth referenced as SR)
  81.       pops up on the screen. This is useful if you plan to be away,
  82.       but not very far, from your computer system.
  83.  
  84.       This will then allow you to do other things like read and
  85.       study your software books (or snooze) while your Amiga works.
  86.       And should a certain type of SR happen you will then be alerted
  87.       by an audible noise generated by your Amiga.
  88.  
  89.       A good example of a possible SR event could be:
  90.         Your Amiga gets a transient Read/Write error with your Hard Drive
  91.         while compiling hundreds of 'C' source code files... <HORRORS> !!
  92.         (Lattice C by the way)
  93.  
  94.       This is better than having your Amiga idle QUIETLY while it waits
  95.       for you to notice an SR event that needed a decision an HOUR AGO !
  96.  
  97.    2) Can be used from CLI or Workbench. Can be made resident, but the
  98.       only benefit of making it resident is to bypass loading time when
  99.       program is invoked.
  100.  
  101.    3) Process will increase its own priority by 7.
  102.  
  103.    4) The program title "Announce System Requests" will be shortened
  104.       to an acronym and henceforth referenced as "ASR".
  105.  
  106.    5) After ASR is installed it will WAIT in an idle state until
  107.       activated by any program that causes a SR to pop up on the
  108.       screen. After ASR activates it will then cause some type of
  109.       audible noise to be made which will then bring your attention
  110.       back to the computer.
  111.  
  112.       The noise that ASR generates will depend upon the options you
  113.       set. The noise may be generated by the SPEAK DEVICE mode, or by
  114.       the COMMAND LINE mode. These modes are explained in detail
  115.       elsewhere in this document.
  116.  
  117.    6) ASR needs the SPEAK: device mounted for announcing its startup
  118.       and its ending. The SPEAK: device will look for the
  119.       "translator.library" and the "narrator.device".
  120.  
  121.    7) It is alright for you to respond to any SR before the announcement
  122.       ends without disrupting the system, but this will also depend upon
  123.       the type of noise program that you give ASR to launch. ASR may not
  124.       announce all of the SR text if you respond rather quickly to an SR.
  125.  
  126.       It may be possible for the ASR program to miss an announcement
  127.       if more than one SR pops up within moments of each other. The
  128.       text that you hear from SPEAK: may also sound strange.
  129.  
  130.    8) ASR can be used with the "Cancel System Requests" (CSR) program.
  131.       This will allow you to hear any SR as it is automatically canceled.
  132.  
  133.    9) ASR will install itself only once.
  134.  
  135.    10) Invoking ASR with option -i from CLI will cause ASR to completely
  136.        detach from the CLI and run as a background process.
  137.  
  138.        If the background process should fail then it will attempt to
  139.        notify you of that fact with a SR.
  140.  
  141. <XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX>
  142.  
  143.    CLI Usage:                                              Page A-03
  144.  
  145.       > ASR !|?|-options ["COMMAND LINE string or SPEAK DEVICE options"]
  146.  
  147.    Description of -options:
  148.  
  149.       Option 'G'  (Gadgets text announced)
  150.  
  151.          1) This will cause the text within the SR gadgets to be
  152.             announced. This only works in SPEAK DEVICE mode.
  153.  
  154.          2) The announcement of gadgets will sound something like this:
  155.                   "Positive choice is " + <text of left gadget>
  156.                   "Negative choice is " + <text of right gadget>
  157.  
  158.             All System Requests will have at least one gadget.
  159.  
  160.       Option 'I'  (Install)
  161.  
  162.          1) This installs the ASR code. If used alone (ie "ASR -i")
  163.             it will cause internal SPEAK DEVICE mode and string to be
  164.             used. This option causes ASR to detach from CLI.
  165.             ASR will announce the following when installing:
  166.  
  167.                   "Installing Announce System Requests"
  168.  
  169.       Option 'C'  (COMMAND LINE mode)
  170.  
  171.          1) This may be used in conjunction with the 'I' option and
  172.             this puts ASR into the COMMAND LINE mode.
  173.  
  174.          2)