
                        JogglerPlus Version 3.1	

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

JogglerPlus primarily consists of two components:

1. A main (MDI) window in which 
2. the windows (MDI child) of individual timers are displayed.
   
Using JogglerPlus, you can:

- Create a timer simply by clicking on a toolbar icon. Each timer
  is added to JogglerPlus' main (MDI) window. The number of timers
  you can have is limited only by the availability of system 
  resources. 
- Control all current timers through menu, hot-key or toolbar
  icons.
- Save and restore a group of timers in a 'group setting file'
  (J2g). This allows one to establish the number of and settings
  for a group of timers, save the group, and reestablish it at
  a later time.
- Through optional command line arguments, specify the timer group
  to be loaded upon startup. The timers in this group can 
  additionally be automatically started. 
- Control whether JogglerPlus' main window will remain on top of 
  other program's windows or not.
- Specify your preferences to control the tiling of timer windows,
  and how an added timer will initially act. The 'Auto Size'
  preference, when set, will cause JogglerPlus' main window to be
  sized automatically as timers are added, closed, minimized or 
  normalized. 
- Specify your preferences to start and/or stop all ready/running 
  timers at a specific time. 

TIME INTERVAL SPECIFICATION

JogglerPlus' 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 an 
individual 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 (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, non-animated GIF or JPG 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 options, once customized to your preferences, can be
saved in a 'timer settings file' (J2t) for later retrieval. More 
than one settings file may exist. 

SETTINGS FILES

JogglerPlus normally uses two default settings files:

1. 'JogPlus.J2g' which establishes the timer group when JogglerPlus
   is started (unless a group name is specified as an argument). As
   distributed, this group will create one timer using the timer 
   settings file 'JogPlus.J2t'.  	 
2. 'JogPlus.J2t' which provides the default timer settings for any
   newly added timer.

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

Group Settings File:

   MyTimers.J2g    When opened this group file will start three 
                   timers- a repeating 20 minute interval count-
                   down, an elapsed time (count-up), and a count-
                   down timer anchored to 5 PM.  

Timer Settings Files:

   BreakTime.J2t   A repeating 20 minute interval count-down timer.
   Elapsed.J2t     An elapsed time (count-up) timer.
   ShutDown J2t    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.J2t         A countdown timer anchored to 5 PM.

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

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

JogglerPlus will attempt to compensate for interval drift, but it can 
only do so if given control within a limited time period.
  
-------
CAUTION
-------
If JogglerPlus does not complete an orderly shutdown, a fragment of 
it may continue to run. This having occurred is made obvious by 
displaying the task list (by pressing the Control, Alternate and 
Delete keys simultaneously), and noting the presence of JogglerPlus 
in the list after it had been closed. Simply end this fragment.

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

-----------------------------
What's new in Version 3.1
-----------------------------
The settings window has undergone major restructuring of its controls-
gone is the tab strip, and all controls now appear on the window. This
was done to reduce the effort (and confusion) in setting the timer's 
properties.

-----------------------------
What's new in Version 2.1
-----------------------------
- New group preference 'Auto Size'.
- Corrected 'can't find picture file' error when action excludes 
  'message'. 
- Supported picture file types now include non-animated GIF and JPG.
- New sound files (beep.wav and beepbeepbeep.wav).
- New picture files.
- Clicking 'stop all running timers' now sets running 'run minimized' 
  timers window state to normal.

------------------------------
What's new in Version1.4b
------------------------------
- Corrected an obscure problem where JogglerPlus inadvertently hides its 
  main window.

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

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

-----------------------------
What's new in Version 1.3
-----------------------------
- Added a new Group Preference to enable starting and/or stopping all
  ready/running timers at a specific time. 
- Changed the interval display to a simulated seven segment digital 
  LED display.

-----------------------------
What's new in Version 1.1a
-----------------------------
- The '/s' program argument may be specified by itself (without a 
  group name). If specified, the default timer group will be 
  automatically started .
- BAT file extension was added to the Browse for Launch Program File
  dialog.

-------------
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 JogglerPlus:
--------------------
Run the program by clicking on its icon in the folder specified 
during install (the default folder name is 'Leepoware JogglerPlus').

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

* Target

 "C:\Program Files\Leepoware\JogglerPlus\JogPlus.exe" MyTimers.J2g

* Start In

 "C:\Program Files\Leepoware\JogglerPlus"

A shortcut to start JogglerPlus, load a group settings file, and 
automatically start the group's timer(s) could have the following 
properties:

* Target

 "C:\Program Files\Leepoware\JogglerPlus\JogPlus.exe" /s MyTimers.J2g

* Start In

 "C:\Program Files\Leepoware\JogglerPlus"

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

to the path where you have installed JogglerPlus, and MyTimers.J2g to 
the name of the group settings file that you want to open and run.
 
---------
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

