Java(TM) 2 Alarm Clock Version 4
 
Installation instructions: 
=========================  
 
1) Be sure that you have a Java Runtime Environment (JRE) installed.   
 
2) Download Alarm4.zip or .tgz and place it anywhere on your system.
 
3) Un-ZIP Alarm4.zip, or:  
 
	tar xvzf Alarm4.tgz 
 
4) This will create a sub-folder called Alarm4 which contains:
 
	- *.au sound files 
 
	- *.bat files used for test execution (3) 
 
	- *.java: source code files (3). 
 
	- Alarm4.html, a web page to run the applet. 
 
	- Alarm4.jar, a Java archive file containing the .au and .class files. 
 
	- Alarm4-nojar.html, a web page to run the applet without the .jar file.  
 
	- README.txt (this file) 
 
	- css2.css, a stylesheet for the web page. 
	
	- various other files, which should be self-explanatory. 
 
Execution instructions: 
======================  
 
5) To run the applet:

	- Load one of the two .html files directly in your web browser, for example on a UNIX-like system enter "file:///home/username/Alarm4/Alarm4.html" in your web browser's address bar, or on a Windows system use "file://c:\Documents and Settings\username\Alarm4\Alarm4.html".

	- Run either of the go-applet* .bat files in a Terminal or Command Prompt window. On a UNIX-like system you might need to "chmod 755 *.bat" first. 
 
You can also copy the folder to your Web server directory and run it from there. 
 
If you wish to, you can make a shortcut to, say, Alarm4.html or go-applet.bat, and place this on your Desktop.  This way you can start the alarm clock directly. 
 
6) To set the alarm, use the keypad to enter the countdown time in HH:MM:SS format, and then click on "Set" to begin the countdown.  The alarm will play the selected sound clip when the countdown is completed.  The default countdown period is 6 seconds. 
 
7) Click on "Reset" to stop the countdown and/or turn off playback of the sound clip.  Sound clips play at different lengths. 
 
8) You can select any sound clip and click on "Play" at any time. 

Known bugs as of 2008-02-21
===========================

  - Deprecated API calls since JDK 1.3 or so (see deprecation.messages.txt from "java version 1.5.0_13").  
  - main() does not run (Null Pointer Exception) also since JDK 1.3 or so. See Java Bug ID 4456393.

Possible future developments:  (as of 2008-02-21) 
============================ 
 - fix deprecated API calls  
 - fine-tune sound clip timings (for example that.hurts.au is only 2 seconds long.). 
 - verify number tones
 - add online help 
 - fix runnable as main(); 
 - configurable skins 
 - configuration file.  	 
 
Enjoy!   
 
Java(TM) 2 Alarm Clock Version 4 by Michael Cook, Skyline Services Inc., http://www.skyprod.com.  Copyright © Michael Cook 1998-2008.  All rights reserved. 
This application is freeware, and the source code is yours to modify if you wish.   
 
Java is a trademark of Sun Microsystems Inc. 
 
All the sound files are believed to be in the public domain except for slim.pickens.au, which is a clip from the Stanley Kubrick movie "Dr.Strangelove". 
 
Last updated for Version 4 2008-02-22 
Updated for Version 3 2002-12-28 
Updated for Version 2 2001-02-20.