

			 how to use dpgnbel0



	what's it for?

	this program will beep forever until any key hit.  it's called
	from a batch program or from the dos command line	

;----------------------------------------------------------------------

	any restrictions on this program?

	ms-dos/windows/xp operating systems
	386 cpu or better

;----------------------------------------------------------------------
	how do i call it from a ms-dos batch file?
	
	the batch code lines should read:

	echo hit any key to continue   	[or some similar message]
	call dpgnbel0

;----------------------------------------------------------------------

	what happens when i call it?

	it beeps forever until you hit any key.  the beeps should be 
	about 2 per second regardless of your cpu clock speed.  
	if you hit ctrl-c it returns errorlevel 255.  if you hit 
	any other key, it returns errorlevel 0.  then it returns to 
	the next line in the batch program that called it.

;----------------------------------------------------------------------

	how can i use the ctrl-c key with this program?

	ctrl-c is typically used to abort a batch program.  
	see (and run) demo0.bat, included in this package, to illustrate 
	the use of ctrl-c in dpgnbel0
;----------------------------------------------------------------------

	any warnings about this program?

	1)  DO NOT USE THIS PROGRAM WHERE OTHERS CAN HEAR IT.  USE 
	    THIS PROGRAM ONLY AT HOME OR IN EMERGENCY SITUATIONS 
	    WHEN YOU **MUST** HEAR A BEEP.

	    the reason why is illustrated by the following scenario:

	    1)  you run a batch program containing this program, and
	    2)  you leave for a meeting.  then
	    3)  your batch program calls dpgnbel0, which
	    4)  beeps 4000 times, and
	    5)  just before it gets to beep 4001,
	    6)  the guy in the next cubicle destroys your computer 
	        with a large axe.

	    constant beeping drives people CRAZY.  [don't ask me how i 
	    found this out.]

	    for the office, use dpgnbel2 which is part of this package.  
	    see readme.1st to find the docs for dpgnbel2.


	2)  THE BEEP IS NOT VERY LOUD.  you may not hear it if tv or radio
	    is playing loudly.

;----------------------------------------------------------------------

	can i control the sound volume?

	no.  the hardware does not support control of sound volume

;----------------------------------------------------------------------
