home *** CD-ROM | disk | FTP | other *** search
- --- ---
- Beep 5.0 (19940301) (o) (o)
- ^
- by Stephen D Childers \_____/
-
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- Program Description:
-
- 1) Program will cause an audio beep tone.
-
- 2) Runs from CLI or Workbench. Can be made resident.
- Workbench uses default values.
-
- 3) The frequency range is from 20 to 14000 hertz.
-
- 4) The waveform data contained within this program is shaped as a
- sine wave when generating low frequency tones (20 - 450 hertz).
- The sine wave will cause the tones to sound soft.
-
- The waveform data will tend to become more of a square wave as the
- frequency increases towards its high limit.
-
- 5) Program (when run from CLI) will interact with the 'c:Why' command
- after program failures; this command may provide a more detailed
- explanation of why the program failed.
-
- The 'Why' command should be used immediately after a program
- failure to extract the last program's result code, because
- that result code is changed upon the execution of the next CLI
- command.
-
- 6) Certain error reports will contain the name of the argument, file,
- device, (etc) that is associated with failure when it occurs.
-
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- CLI Usage:
-
- > Beep [!][-Dn] [-Fn] [-Vn] [-Q]
-
- ! - show author info
-
- (-D)uration of sound in tenths of a second.
- n = 0 (infinate) thru 36000 (1 hour), default is 2
-
- (-V)olume; n = (0 thru 64), 0 is unhearable, default is 64
-
- (-F)requency; n = (20 thru 14000 hertz), default is 777
-
- (-Q)uiet; does not print any messages
-
- CTRL-C will interrupt beep
-
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- Version History:
-
- The following information briefly describes changes or improvements
- made to each version, and they will be described in descending order;
- meaning latest version information begins first:
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Version 5.0 (19940301) -
- 1) Changed version numbering format. Program can now be used with the
- "Version" command. Date within parenthesis is shown in a somewhat
- international format as (yyyymmdd).
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Version 19930724 -
- 1) Optimized and refined source code thereby making program smaller.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Version 19920114 -
- 1) Removed a CLI parsing problem.
- 2) Can be made resident.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Version 19910902 -
- 1) Program will now complain if its control arguments are not proper.
- 2) Improved program error reporting.
- 3) Program (when run from CLI) will now interact with the 'c:Why'
- command after program failures.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Version 19910520 - The first version.
-
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- /XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\
- ///\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\\\
- /// \\\
- \\\ 11 God judgeth the righteous, and God is angry ///
- /// with the wicked every day. \\\
- \\\ ///
- /// The King James Holy Bible - Psalms 7:11 \\\
- \\\ ///
- \\\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\/XX\///
- \XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/\XX/
-
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- End Of Document
-
-