                    ------------------------------------
                    Compu-Sport Sports Statistics System
                    ------------------------------------


Version : 2.41
Date    : 10 October 1999
Author  : P W Kilfoil


1. CONTENTS
-----------

1. Contents
2. Introduction
3. Installation
4. Distribution
5. Support
6. How to ...
7. The Future
8. New Feature History
9. Acknowledgements


2. INTRODUCTION
---------------

Compu-Sport is an MS-DOS based computer system that can record details of
sporting events, and provide statistics of these events at a team and
individual level.  The system is fully multi-user and can be run over any
local area network (LAN) operating system.  For example, it can be installed
on a Windows NT Server and then all users connected to the server can
simultaneously view and/or update the data merely by connecting to the
drive/directory where it is installed.  The same applies to Novell NetWare,
Banyan Vines, etc.  Of course, it can be run as a stand-alone application on
any PC loaded with DOS, Windows 3.x, Windows NT or Windows 95/98.

Currently the following 'team' sports have been catered for :
      Rugby Union
      Soccer (Association Football)
      First class/test cricket
      Limited overs/one day international cricket

In addition, the following 'individual' sports are catered for :
      Formula 1 Motor racing

It is set up in such a way that a particular team's details are recorded.
This is defined as your 'home' team (this does not apply to the 'individual'
sports such as motor racing).  For example, the shareware version of Compu-
Sport that is distributed contains data pertaining to the South African
national team, so 'RSA' is defined as the 'home' team.  The system is geared
towards competition between countries, but if you would like to record
details of a club or provincial team you merely need to regard 'countries'
as clubs or provinces and change the data you capture accordingly.

The system comes with pre-loaded data for the South African national team,
as follows :
      Rugby Union                   : Every test match ever
      Soccer (Association Football) : Every international ever
      First class/test cricket      : Every test match ever
      One day international cricket : Every ODI ever

In addition :
      Formula 1 motor racing        : Every grand prix since 1965

If you are NOT interested in this and want to record your own country/team,
then a set of 'empty' database files is available ; these may have been
included in the installation ZIP file.  If you did not receive them, contact
the author directly - I shall be happy to send them to you.  See section 3
(Installation) for details as to how to set these up.

Each sporting 'event' (or match) is defined at two levels :
- The overall MATCH/RACE level
- The detailed PLAYER/DRIVER level

When you capture details at MATCH level, you provide such information as the
teams that played each other, the score, the date and the venue (stadium or
city or racetrack).

At a PLAYER level you capture all the players from your 'home' team who
played in this particular match and their individual performances (eg.
whether they scored goals, tries, etc, or were substituted or injured).  In
the case of motor racing these will be drivers, who may be from any country.

Statistics per player such as games played, goals scored, batting and
bowling averages are automatically available.

Statistics per the 'home' team giving the overall results against all
opponents are also automatically available.

Each match within a sporting code is identified by a unique 'match code' (an
integer, with a maximum value of 99999).  By default the system will
generate a new unique match code when you insert the details of a new match,
but if you would like to specify your own match codes then you can override
this default in the 'Options' dialog of the 'Tools' menu.  It is sometimes
useful to be able to set match codes, particularly if you plan to capture
EVERY match played by a team/country.  You might then want to ensure that
the very first match becomes match code 1, the second 2, etc, but not be
constrained to capture matches in their exact chronological sequence.  If
you let the system choose match codes (the default), then the first match
you capture becomes match 1, regardless of whether it was historically the
first match or not.

Note that matches will still be displayed in date sequence, no matter what
mechanism of match codes you use ; the match code is merely an internal
'dumb' number used in the database.  The only requirement is that match
codes within a sporting discipline are unique.

[ Technical aside : For those users who have experience in software
  development, you should note that the database is fully normalized to 3'rd
  Normal Form.  If you would like to see the schema, contact the author ; I
  shall be happy to send you details of the entities and data structures ]


3. INSTALLATION
---------------

In order to run this application you will need an IBM-compatible PC running
DOS (version 3.3 or later), Windows 3.x, Windows 95/98 or Windows NT.  It
will even run on certain versions of OS/2, but some tinkering with the
configuration may be necessary.

Unzip the contents of the install ZIP file into a directory.  Do NOT unzip
the NEW-TEAM.ZIP file (if there is one) without reading the notes below.

The above procedure will pre-load data relating to the South African
national team in the Compu-Sport database. If you want an EMPTY database so
that you can track details of your own team, then unzip the file
NEW-TEAM.ZIP that might have been included in the installation ZIP file.
Make sure that you overwrite all existing files when you unzip this file.
However, if you are interested in the South African national team data that
is supplied, do NOT unzip the NEW-TEAM.ZIP file ; it will destroy this data.

NEW-TEAM.ZIP contains a set of empty database files which will allow you to
start from scratch with your own team.  If the installation you received
does NOT include this NEW-TEAM.ZIP file and you would like it, please
contact the author ; I shall send it to you.

Now execute SPORT.EXE.

VERY IMPORTANT :

   DOS, Windows 3.x and Windows 95 users must ensure that their CONFIG.SYS
   file (located in the boot directory) contains a line like this (with a
   value of at least 63 and no spaces) :

       FILES=63

   If you change this setting you will need to re-start your PC.

   Windows 98 users must ensure that their MSDOS.SYS file (search for it ;
   it may be located in various different directories) contains a line like
   this (with a value of at least 63 and no spaces) :

       FILES=63

   If you change this setting you will need to close any open DOS sessions.

   Windows NT users must ensure that their CONFIG.NT file (located in the
   \WINNT\SYSTEM32 directory) contains a line like this (with a value of at
   least 63 and no spaces) :

       FILES=63

   If you change this setting you will need to shut down any NTVDM (NT
   Virtual DOS Machine) processes ; ie. close any open DOS sessions.

   If you do NOT check your CONFIG.SYS/MSDOS.SYS/CONFIG.NT as described
   above, Compu-Sport will not have enough file handles to operate properly,
   and will eventually fail with an unfriendly DOS error message.


4. DISTRIBUTION
---------------

Compu-Sport is SHAREWARE.  It can be distributed freely to anyone in the
world on an unlimited basis with no restriction provided that

- You do not 'hack' SPORT.EXE in any way
- You do not interfere with the credits displayed in the 'About' box
- You do not distribute the C-SPORT.CFG file (if one exists in your
  installation)

However, if you like the system and would like to contribute towards its
future development, you can send 50 South African Rands, OR 10 Pounds
Sterling, OR 15 US Dollars to the author at the address listed in section 5
below (Support).  Cheques or banknotes are acceptable.  Please provide your
name, postal address and E-Mail address (if you have one).

If you do so you will be registered and receive an upgrade to the fully
licensed version of Compu-Sport.  You will also be informed of product
upgrades (and data upgrades for South African and Formula 1 sports fans).

Note however that you are UNDER NO OBLIGATION to send this registration fee.
You are more than welcome to use Compu-Sport any way you see fit, and
distribute it to anybody you like, without sending any registration fee.
The shareware version is EXACTLY the same as the fully licensed version
apart from the following features that are only available in the licensed
version :

(a) There is a unique serial number for the licensee ;
(b) The system can be set up in 'read-only' mode for data protection across
    a LAN, with update mode only available to the supervisor ;
(c) Security in the form of userids and passwords can be applied if data
    secrecy is an issue ;
(d) Automatic data updates will be mailed to the licensee (South African
    national team(s) and Formula 1 Grand Prix results) ;
(e) The licensee will be automatically informed of program upgrades and get
    these if desired.

However, in terms of base functionality the shareware version provides the
same features as the licensed version, is not restricted and has no expiry
date.  I have developed, and still maintain this application as a hobby
(being a sports enthusiast) without the intention of making money out of it.

If you are using Compu-Sport for 'business' rather than 'personal' reasons
(for example, a radio sports announcer or commentator providing statistical
information to his listeners), then an acknowledgement (verbal or written,
as appropriate) of the source of this data would be appreciated by the
author of Compu-Sport.


5. SUPPORT
----------

The author of Compu-Sport can be contacted directly as follows :

    (Mail)     Paul Kilfoil
               P O Box 36221
               Glosderry
               7702
               South Africa

    (E-Mail)   PKilfoil@SAfrica.com
               PKilfoil@Hotmail.com

    (Fax)      (+27) (21) 686 0733

Please report any bugs you find in the product so that they can be
rectified.  The author would also be happy to hear about any enhancements
you would like to see included in future releases, but no guarantee can be
given as to when, or if, these will be implemented.  However, ALL
correspondence is appreciated and WILL be read and considered ; in most
cases replies will also be sent by the author.

Compu-Sport is distributed from a variety of sources, such as the internet
(a number of sites), shareware software bulletin boards, games CDs and
diskettes, etc.  However, any queries you may have should not be directed at
the distributors of the product but rather to the author.


6. HOW TO ...
-------------

A basic manual describing how to use Compu-Sport is included in the file
HELP.TXT.  Either edit this file (eg. with Notepad) or press F1 from any
Compu-Sport screen or dialog.


7. THE FUTURE
-------------

The author keeps the data for the South African national team up to date, as
well as adding new features to Compu-Sport from time to time.  If you want
to be kept appraised of updates and upgrades, you should register your copy
of Compu-Sport as described in section 4.  Note however, that you are under
no obligation to do so.

A Windows version of Compu-Sport is being developed, but will not be
available in first release before 1999.  It will be a 32-bit application
(ie. it will only run on Windows 95/98 or Windows NT, not Windows 3.x).

New features planned for future releases of the DOS version of Compu-Sport
are as follows (note that this could change) :

  2.42 Not planned

Contact the author directly if you would like to receive these upgrades as
they are released.


8. NEW FEATURE HISTORY
----------------------

The following lists the features which have been modified or included in
recent releases of Compu-Sport :

  2.41 Include Formula 1 Constructor race history totals.
       Allow the setting of 'filters' in all team sports.
  2.40 Minor internal modifications.
  2.39 Include 'run outs' in One-Day Cricket results.
  2.38 Allow for Rugby Union scores of 100 or more.
  2.37 Allow sorting of One-Day International cricket player statistics by
       'Catches & Stumpings'.
       Include players' date of birth.
  2.36 Pre-capture 'Home' team when entering data.
  2.35 Show team line-up details (Shift-F7) for soccer matches.
  2.34 Added the full text of the official ICC 'Rules of Cricket' to the
       'Cricket' menu.
       Fixed obscure bug which caused race track names not to appear when
       viewing Formula 1 driver history from Players Maintenance.
       Eliminated the Virtual Memory error which occasionally manifested
       itself when paging through 'browse-style' data.
  2.33 Fixed obscure bug in Cricket Test player details, which occasionally
       resulted in incorrect sorting by bowling average.
  2.32 Implemented online documentation and help (using the menu or F1).
       Also reduced EXE load time on startup.
  2.31 Allow a player to be a substitute and then sent off.
  2.30 Fixed obscure bug which allowed match details to be captured against
       a non-existent match on a totally empty database.
  2.29 Internal generation of new player codes neatened.
  2.28 Allow sorting of Test Cricket player statistics by 'Catches &
       Stumpings'.
  2.27 Show individual One-Day Cricket player history per match (Ctrl-F7).


9. ACKNOWLEDGEMENTS
-------------------

The author would like to thank the following people who assisted in the
rather mundane task of capturing the existing data in Compu-Sport :

       Ms  Lee Burrows              leeb@abraxas365.com
       Mr  Lee Daniels              santecon@iafrica.com
       Mr  Richard Gathercole       rcole@salzburg.co.at
       Mr  Richard Bird             richardzelda@hotmail.com
       Mrs Zelda Bird               richardzelda@hotmail.com

Lee Daniels has a Compu-Sport database of test cricket data for the England
team ; anybody who would like a copy of this is welcome to contact him.
