home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Shareware 1 2 the Maxx
/
sw_1.zip
/
sw_1
/
DBASE
/
JOGGR105.ZIP
/
JOGGER.DOC
< prev
next >
Wrap
Text File
|
1992-02-12
|
10KB
|
239 lines
JOGGER
by
Mark Hobart
February 1992
Introduction
------------
This file contains instructions on installation and operation of JOGGER.
To install and run JOGGER create a directory called jogger and copy all
files in this posting to it. The manifest is
jogger.exe the binary
runs.dat run database (sample)
courses.dat courses database (sample)
README overview and ShareWare details
CHANGES list of changes made in past versions
CATALOG list of software available from me.
jogger.doc this file
jogger.ico Windows icon
jogger.pif Windows .pif file
Note, licensed users will also receive a file called "license.txt".
You should now change to the jogger directory and type "jogger". For subsequent
use see the installation tip at the end of this file.
JOGGER now displays information on how to become a registered user and will do
so every time you access the main menu screen. To clear the screen and proceed
each time it's displayed simply click the left mouse button or press the space
bar. When you become a registered user I'll send you instructions on how to
stop it by return of post.
Main Menu screen
----------------
This screen is a top level menu and allows you to select the action you wish
to perform. Simply click the left mouse button in the appropriate box or press
the number of the action you desire and you'll see the action become
highlighted (it's best in colour). Repeat the selection or hit RETURN or SPACE
and that action is then processed. Selecting another box will highlight that
option. To exit the program at this point simply click in the "Quit" box or
press the "Esc" key or the letter 'q'.
Hot Keys
--------
As of version 1.03 there is support for hot key sequences. This enables systems
without a mouse to use JOGGER. I'll explain here the simple conventions used.
Throughout the program "Esc" can be used as a hot key for "Quit" if the option
box for "Quit" is displayed. Other hot keys are often the first letter of an
option eg. "Cancel" would be 'c' or the uppercase letter highlighted eg.
"saVe" would be 'v'. However, the exception is "Help". Whenever this option
is displayed the hot key "F1" should be used. Of course if you have a mouse
then you can use that to select any option as well.
Screen 1 - Enter run data
-------------------------
This screen allows you to enter details of a run. Simply type in the details
requested for each boxed field. Clicking on "help" with the mouse or using the
"F1" hot key will display a pop up window that contains a list of courses and
course codes in case you can't remember the code. Once you've entered the
appropriate text you'll automatically be moved to the next field.
Alternatively, typing TAB or RETURN will move you to the next field (once
sufficient data has been entered for the field). Selecting "Quit" at anytime
will abort the data entry and return you to the main screen (via the annoying
box of course unless you're registered). Once all data has been entered you'll
be asked if it's ok. Clicking in the "Ok" box or hitting the RETURN key
accepts the entry and adds it to the database. Clicking "Cancel" (or pressing
the 'c' key) clears the fields and allows you to re-enter the data.
Screen 2 - Display runs
------------------------
This screen allows you to browse through the records of the run database in
forward ( select "Fwd" box) and reverse directions (select "Back" box).
Selecting "1st" will take you to the first screen and "Last" will take you to
the last screenful of data (unless you're already at the end of the data of
course). Selecting the sort box changes the way the records are sorted. You
can choose between "date" i.e. chronological order or "course/time" where
records are sorted in course alphabetical order with the best time at the top
and the worst at the bottom. Selecting "Quit" at anytime returns you to the
main menu screen.
Screen 3 - Display form graph
-----------------------------
This screen displays a plot of form (y-axis) against date (x-axis). Browsing
of the graph is the same as for the screen 2 controls mentioned earlier.
Selecting "Last" will give a graphical view of current form.
Form is calculated as follows
form = 100 - (time - best)
( -------------- ) * 100
(worst - best)
Screen 4 - Remove run data
--------------------------
This screen is similiar to Screen 1 but this time a valid menu entry is used
to delete ALL run database records matching the code and date supplied. The
"Help" box displays a list of courses and dates attempted to help you fill in
the fields.
Screen 5 - Display courses
--------------------------
This screen allows browsing of the courses database. It displays course
information as well as best and worst times for the course. Forward browsing
only is allowed in this option.
Screen 6 - Enter course data
----------------------------
This screen is the screen 1 equivalent for the courses database. You are
invited to enter a name for the course (at most 20 characters) and the distance
of the course in units of your own choosing. However it's important to be
consistent, ie. if you use miles enter the distance in miles for all courses as
differing distance units cause the pace times to be wildly different for each
course. The course comment is an optional field for use if you want to say
something about the course. Eg. "I'm never doing this again!". You've got 25
characters.
Screen 7 - Edit/Delete course data
----------------------------------
This screen allows you to edit or delete data fields for a course database
entry. You're invited to enter a course code and help is provided via the
"help" box. Once the code is entered all the fields are filled in for the
course and you're asked whether you want to "Edit" or "Delete" the
entry. If you select "Delete" then the entry will be cleared and you'll be
able to enter new course data for this code at a later date. (Note the course
data will not be deleted if run database records exist that still use this
codes course data. If this record is to be deleted then you'll need to
remove all runs for the course using screen 4).
Selecting edit moves to the name field where you can either enter a new name or
hit TAB or RETURN to accept the current field value. This happens for
subsequent fields until they're all completed. At this point you'll be asked
to accept what's been entered as the new record ("Ok" box) or reject it
("Cancel" box). As with other screens selecting "Quit" terminates
the screen and returns you to the main menu.
Screen 8 - Report generator
---------------------------
This screen allows you to browse and save to disk reports of the run and
course data. You can generate two reports; one sorted by course/time and one
in chronological order. The latter generates a monthly summary whereas the
former generates a summary for each course. The generated report file
"course.rep" or "date.rep" respectively can then be printed if required using
the MS-DOS print command. The hot key letter for saving to disk is 'v'.
As of version 1.01 there is an enhanced browsing mechanism similiar to that
used in screen 2 for displaying run records.
Screen 9 - Estimate time for a run
----------------------------------
This screen allows you to get JOGGER to calculate an estimated time for a run
in the courses database. You can use two techniques; either enter a sample
number of runs or a form value in the range 1-100. If you use the sample
number of runs field then JOGGER calculates your average form over the last
'n' runs and uses this to calculate the time you'd expect to complete the run
in. If you supply a form value instead, then JOGGER uses this as the average
form value in its calculations. You must enter either a form or a sample, not
both.
The formula used for calculating an estimated time is as follows:-
time = PW + ( average form X ( PB - PW ) )
---------------------------
100
(where PW - Personal worst time for run, PB - Personal best time for run).
Starting your own databases
---------------------------
Included in this posting are sample databases to help you evaluate the package.
If you're interested they're details of my runs! To start your own simply
delete the "courses.dat" and "runs.dat" files and use JOGGER to enter new data.
The ".dat" files are binary files so don't try editing them! Remember to back
up your database files from time to time.
Acknowledgements
----------------
Thanks to Alan Phillips for the mouse routines and interface suggestions. Also
Mark Anichebe for the form idea.
Remember, "There's miles of miles!" so log 'em with JOGGER!
Installation tip
----------------
Create a jogger.bat file containing the following lines and put the file on
your path. You'll then be able to run JOGGER from any directory.
cd <jogger-installation-directory>
jogger
My file contains:
cd \mark\jogger
jogger
Running JOGGER from Windows 3.0
-------------------------------
If you run JOGGER from windows then, as of version 1.04, there is my little
JOGGER man icon that fits nicely on any desktop which is included with the
distribution. There is also a PIF file that you may find useful.
IMPORTANT!!!!
-------------
If you do run JOGGER under windows then never leave it running as an ICON if
you've performed some database update function. The reason being that JOGGER
only updates the databases upon exit of the program. Therefore whilst it's
running as an ICON under windows the databases will not be up-to-date. You've
been warned...