
                          Joggler Version 2.6	

                    Copyright 1997-1999 by Leepoware
                          All Rights Reserved
			             
-----------
Description 
-----------
Joggler is a timer utility program for Windows 95, 98 and NT. 
It is similar in use to a kitchen timer, but contains many more 
features.

TIME INTERVAL SPECIFICATION

Joggler's features allow you to easily specify the time interval.
The interval:

- Is specified in hours and minutes. 
- Is set from a 'time string' that you enter (e.g. '8 :25 AM').
- Can be 'anchored' to the 'time string'.

INDEPENDENT ACTIONS

One to three independent actions can be selected to occur when the 
timer's interval expires:

1. Play a sound.
2. Issue a message in an alarm window.
3. Launch a program.


Further control of each action is provided as listed below:

1. Play a sound. 

   You can specify the sound file (MID, RMI or WAV) to be played.

2. Issue a message.

   Associated with issuing a message, you can specify:

   - The text of the alarm's message (which automatically scrolls
     if necessary).
   - A picture (BMP file) to be displayed in the alarm's message
     window.
   - Whether the alarm requires acknowledgment (clicking of a 
     command button to continue).
   - When the alarm's window is present and if acknowledgment is 
     required, you can defer the alarm for 1-5 minutes.

3. Launch a program.

   Associated with launching a program, you can specify the program
   to be launched and its arguments. Several programs are provided:

   - LogOff.exe 
   - ReBoot.exe 
   - ShutDown.exe

   The purpose of each is as its name implies. 

   LogOff.exe and ShutDown.exe have an optional argument of:

	/f	force

   These programs should be tested to insure that they work as 
   expected before one comes to rely on them.

ADDITIONAL TIMER OPTIONS:

Additional timer options allow you to specify whether:

- The timer is to automatically close at interval expiration.
- The timer is to count down or count up.
- The timer is to run once and stop, or repeat.
- The timer should run minimized or not.
- A status bar (which reveals the current settings at a glance) 
  should be displayed.
- The timer's window is to remain on top or not.

The timer's options, once customized to your preferences, can be
saved in a 'timer settings file' (Jog) for later retrieval. More 
than one settings file may exist. 

SETTINGS FILES

Joggler normally uses a default settings file named 'Joggler.Jog'
which provides the default timer settings when Joggler is started.

In addition to the above file, the following settings files are 
provided to serve as models:

   BreakTime.Jog   A repeating 20 minute interval count-down timer.
   Elapsed.Jog     An elapsed time (count-up) timer.
   ShutDown.Jog    A count-down timer anchored to 10 PM which will
                   launch the ShutDown.exe after the alarm's message
                   is acknowledged. Note the use of the checked 
                   option 'Close At Interval Expiration' (which 
                   closes the timer) and unchecked option 'Repeat' 
                   (since the timer is being closed you do not want
                   it to repeat).
   5PM.Jog         A countdown timer anchored to 5 PM.

----
HELP
----
Joggler provides help in the form of fly-over tool tips. 

--------
BE AWARE
--------
If the action to be taken at interval expiration includes playing a 
sound file, and the sound playing device is already busy, it cannot 
play another. If this condition occurs, Joggler will attempt to play
an alternate sound, however, this too may fail.

Keep in mind:

- This condition occurs when two or more alarms occur near the same
  time (the playing of sound files overlap).
- The problem is minimized by utilizing sound files that are short in
  duration.
- If the message requires acknowledgment, the sound file will be
  replayed periodically until the alarm is acknowledged. The busy 
  condition may not exist the next time it is played.

----------
DISCLAIMER
----------
The accuracy of the timers is dependent upon the accuracy of the 
hardware being utilized and multitasking capability of the execution 
platform.

Joggler will attempt to compensate for interval drift, but it can 
only do so if given control within a limited time period.

-----------------------------
Special Hardware Requirements
-----------------------------
A functioning sound board is required if audible alarms are expected 
(the 'Silent' option is inactive).

-------------------------
What's new in Version 2.6
-------------------------
- Corrected the problem of Joggler pushing itself to the foreground.
- Corrected blank anchor time being incorrectly interpreted as error.

-------------------------
What's new in Version 2.5
-------------------------
- Corrected timer's window displayed height with and without status bar. 
- Corrected interval's tooltip text to display the alarm's message.
- Added a command button to access Leepoware's web home page.
- Added 'Whitehaven Beach.bmp' for use as alarm's picture. 

-------------------------
What's new in Version 2.4
-------------------------
- Support was implemented for additional sound file types of MID and RMI.
- The interval display now utilizes simulated 7 segment LEDs.

-------------------------
What's new in Version 2.2
-------------------------
- An error during file locate incorrectly surfaced, and is now masked.
- Several windows are centered immediately before settings file 
  processing in the event of an error. 
- 'comcat.dll' dropped from distribution.
- The file association for extension "Jog" was corrected.

----------------------------------------------
W A R N I N G: Pre-installation Considerations
----------------------------------------------
If you have a Version 1 level of Joggler installed, be warned that 
the setting files for Version 1 are incompatible with Version 2, and 
cannot be used.

-------------
Installation:
-------------
If the program is to be installed from diskettes, run the SETUP 
program on the first diskette to install the program on your system. 
If the program is to be installed from a single large file (i.e., 
Setup.exe downloaded from the web), execute the file itself after 
unzipping it from the distribution zip file.
  
----------------
Running Joggler:
----------------
Run the program by clicking on its icon in the folder specified 
during install (the default folder name is 'Leepoware Joggler').

--------------------------------------------------------
Automatically Starting Jogger With A Named Settings File 
--------------------------------------------------------
A shortcut placed in your startup folder can be used to both run 
Joggler and to have it start running using the settings from a 
named settings file.
 
A shortcut to start Joggler and load a settings file could have the 
following properties:

* Target

 "C:\Program Files\Leepoware\Joggler\Joggler.exe" Elapsed.Jog

* Start In

 "C:\Program Files\Leepoware\Joggler"

A shortcut to start Joggler, load a settings file, and automatically 
start the timer could have the following properties:

* Target

 "C:\Program Files\Leepoware\Joggler\Joggler.exe" /s Elapsed.Jog

* Start In

 "C:\Program Files\Leepoware\Joggler"

Note that you can change:
 
  C:\Program Files\Leepoware\Joggler

to the path where you have installed Joggler, and Elapsed.Jog to 
the name of the settings file that you want to open and run.

Note that the '/s' program argument may be specified by itself 
(without a settings file name). If specified, the default settings 
file ('Joggler.jog') will be opened and automatically started.
 
---------
Uninstall
---------
Use the Add/Remove Programs facility to uninstall the program. 

--------------------
Contacting Leepoware
--------------------
Postal Address:	      Leepoware 
                        PO Box 20066                                   
                        San Jose, CA 95160-0066
                        USA
Web site:               http://www.leepoware.com 
E-mail:                 support@leepoware.com


