

			 how to use dpgnbel2



	what's it for?

	this program will 

	1)  beep a user-specified number of times and then cycle 
	    silently until any key hit, or

	2)  cycle silently until any key hit

	    ctrl-c returns errorlevel = 255
	    any other key returns errorlevel = 0

	it's called from a batch program or from the dos command line

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

	any restrictions on this program?

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

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

	how do i call it from a ms-dos batch file?
	


	to beep 15 times and then cycle silently until any key hit, 
        see demo2.bat for an example.  the batch code lines should read:


	echo hit any key to continue	[or some similar message]
	echo 15|dpgnbel2		[the | is the long vertical bar]
	if errorlevel 255 goto ctrl-c_key_hit_section_of_your_batch_program
	if errorlevel 1 goto end_of_your_batch_program




	to cycle silently [beep 0 times] until any key hit, 
        see demo22.bat for an example.  the batch code lines should read:


	echo hit any key to continue	[or some similar message]
	echo 0|dpgnbel2			[the | is the long vertical bar]
	if errorlevel 255 goto ctrl-c_key_hit_section_of_your_batch_program
	if errorlevel 1 goto end_of_your_batch_program


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

	what happens when i call it?

	it beeps a user-specified number of times, then cycles 
	silently 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.  after you hit any key, it goes 
	to the next line in the batch program

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

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

	ctrl-c is typically used to abort a batch program.  
	see (and run) demo2.bat, included in this package, for an illustration
	on how to use ctrl-c with this program
;----------------------------------------------------------------------

	how can i use dpgnbel2 like the ms-dos pause command and still
	display my custom message instead of 'press any key to continue ...'

	see (and run) dem022.bat, included in this package
;----------------------------------------------------------------------

	any warnings about this program?

	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 allow it

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