home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD2.bin / bbs / util / mayflower.lha / MayFlower / Beep / Beep.doc < prev    next >
Text File  |  1994-03-17  |  4KB  |  95 lines
  1.                                                  --- ---
  2.                         Beep 5.0 (19940301)      (o) (o)
  3.                                                     ^
  4.                        by Stephen D Childers     \_____/
  5.  
  6. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  7. Program Description:
  8.  
  9.    1) Program will cause an audio beep tone.
  10.  
  11.    2) Runs from CLI or Workbench. Can be made resident.
  12.       Workbench uses default values.
  13.  
  14.    3) The frequency range is from 20 to 14000 hertz.
  15.  
  16.    4) The waveform data contained within this program is shaped as a
  17.       sine wave when generating low frequency tones (20 - 450 hertz).
  18.       The sine wave will cause the tones to sound soft.
  19.  
  20.       The waveform data will tend to become more of a square wave as the
  21.       frequency increases towards its high limit.
  22.  
  23.    5) Program (when run from CLI) will interact with the 'c:Why' command
  24.       after program failures; this command may provide a more detailed
  25.       explanation of why the program failed.
  26.  
  27.       The 'Why' command should be used immediately after a program
  28.       failure to extract the last program's result code, because
  29.       that result code is changed upon the execution of the next CLI
  30.       command.
  31.  
  32.    6) Certain error reports will contain the name of the argument, file,
  33.       device, (etc) that is associated with failure when it occurs.
  34.  
  35. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  36. CLI Usage:
  37.  
  38.     > Beep [!][-Dn] [-Fn] [-Vn] [-Q]
  39.  
  40.        ! - show author info
  41.  
  42.        (-D)uration of sound in tenths of a second.
  43.          n = 0 (infinate) thru 36000 (1 hour), default is 2
  44.  
  45.        (-V)olume; n = (0 thru 64), 0 is unhearable, default is 64
  46.  
  47.        (-F)requency; n = (20 thru 14000 hertz), default is 777
  48.  
  49.        (-Q)uiet; does not print any messages
  50.  
  51.        CTRL-C will interrupt beep
  52.  
  53. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  54. Version History:
  55.  
  56.    The following information briefly describes changes or improvements
  57.    made to each version, and they will be described in descending order;
  58.    meaning latest version information begins first:
  59.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  60.    Version 5.0 (19940301) -
  61.    1) Changed version numbering format. Program can now be used with the
  62.       "Version" command. Date within parenthesis is shown in a somewhat
  63.       international format as (yyyymmdd).
  64.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  65.    Version 19930724 -
  66.    1) Optimized and refined source code thereby making program smaller.
  67.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  68.    Version 19920114 -
  69.    1) Removed a CLI parsing problem.
  70.    2) Can be made resident.
  71.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  72.    Version 19910902 -
  73.    1) Program will now complain if its control arguments are not proper.
  74.    2) Improved program error reporting.
  75.    3) Program (when run from CLI) will now interact with the 'c:Why'
  76.       command after program failures.
  77.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  78.    Version 19910520 - The first version.
  79.  
  80. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  81.       /XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\
  82.      ///\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\\\
  83.     ///                                                          \\\
  84.     \\\      11  God judgeth the righteous, and God is angry     ///
  85.     ///   with the wicked every day.                             \\\
  86.     \\\                                                          ///
  87.     ///           The King James Holy Bible - Psalms 7:11        \\\
  88.     \\\                                                          ///
  89.      \\\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\///
  90.       \XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/
  91.  
  92. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  93.                            End Of Document
  94.  
  95.