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


Version : 2.21
Date    : 20 July 1997
Author  : P W Kilfoil


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

1. Contents
2. Introduction
3. Installation
4. Distribution
5. Support
6. How to ...
7. The Future


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.  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.  If you are NOT interested in this and want to record your own
country/team, then a set of 'empty' database files is included in the
installation ZIP file.  See section 3 (Installation) for details as to
how to set these up.

Each sporting 'event' (or match) is be defined at two levels :
- The overall MATCH level
- The detailed PLAYER 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.


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 or
Windows NT.  It will even run on OS/2, but some tinkering with the
configuration may be necessary.

Unzip the contents of the install ZIP file into a directory.

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 was included in the installation ZIP file.  Make sure
that you overwrite all existing files when you unzip this file.

NEW-TEAM.ZIP contains a set of empty database files which will allow you
to start from scratch with your own team.

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 59 ; more is acceptable) :

       FILES=59

   If you change this setting in CONFIG.SYS you will need to re-start
   your PC. Note that there must be NO SPACES in this statement.

   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 59 ; more is acceptable) :

       FILES=59

   If you change this setting in CONFIG.NT you will need to shut down any
   NTVDM (NT Virtual DOS Machine) processes ; ie. close any open DOS
   boxes.  You do not need to re-start your PC.

   If you do NOT check your CONFIG.SYS or CONFIG.NT as described above,
   Compu-Sport will not have enough file handles to operate properly, and
   will eventually 'fall over' 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, please 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).  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 sports fans).


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)   paulk@mda.co.za

    (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.


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

This section serves as a basic manual on how to use Compu-Sport.  Not
much detail is given, because the menus are intuitive and extremely easy
to use.  Some important 'hot keys' that are worth remembering are the
following :

  Press      To
  -----      --
  Esc        Exit from the current screen/dialog
  Home       Move to the top of a 'browse' list
  End        Move to the bottom of a 'browse' list
  PageUp     Move up a 'browse' list one page at a time
  PageDown   Move down a 'browse' list one page at a time
  Arrow Up   Move up a 'browse' list one row at a time
  - Down     Move down a 'browse' list one row at a time
  - Left     Move to the left around a pull-down menu
  - Right    Move to the right around a pull-down menu
  Tab        Switch between two vertical 'panes' on the screen

  Ins        Insert ONE new item (eg. player, match, venue, etc)
  F5         Insert MANY new items (not applicable everywhere)
  Del        Delete the currently selected item
  Enter      Amend the details of the currently selected item

  Alt F7     Show the selected player's SUMMARY statistics
  Ctrl F7    Show the selected player's DETAILED statistics
  Shift F7   Show summary statistics for all players in the selected TEAM

  F3         Recreate overall player statistics history
  F8         Change date range for overall team history

  Gray '+'   Select file for re-indexing
  Gray '-'   De-select file for re-indexing
  F10        Re-index selected files


The remainder of this section gives a brief overview on the operations
most frequently used.


6.1 Navigate around the menus

    Compu-Sport has a separate menu for each sporting code.  Each sport's
    menu typically contains 3 sub-menus as follows :
       - Match details
       - Player summary
       - Country summary

    The first sub-menu (match details) lists all matches that have been
    recorded in 2 windows (or panes) on the screen.  The left pane shows
    each match result, with one line per match.  The right pane shows the
    players from your 'home' team that took part in the currently
    selected match in the left pane.

    You use the arrow keys to navigate up and down the left pane.  As you
    move, the contents of the right pane (the players) will change to
    reflect the currently selected match.  To switch to the right pane,
    press the 'Tab' key ; to switch back to the left pane, press the
    'Tab' key again.

    The second sub-menu lists all the players in this sport with all-time
    statistics for each player ; these statistics differ for each sport.
    This information is NOT updated automatically when a new match is
    defined.  It must be updated after entering or changing any match
    details by going to the 'Edit' menu (press Alt-E), then choosing
    'Re-Create History' (or simply pressing 'F3').  The date that the
    history was last calculated will be shown in the title bar.

    In this screen you can use the 'View' menu to change the order in
    which data is displayed.  For example, if you want to see all rugby
    players listed in descending order of tries scored you can do so
    by choosing the first option under 'View' (or simply press Alt-1).

    The figure for number of matches played (or 'caps') may contain a
    figure to the right of it in brackets.  This second number
    represents the number of appearances that were as a
    substitute or replacement.  The number of substitute appearances is
    INCLUDED in the total number of matches played.

    The third sub-menu lists all the countries against which your 'home'
    team has played, and your 'home' team's record against each.  This
    information is calculated on the fly from the match details, so it is
    always automatically up to date even when you are entering or
    changing match details.  You can change the date range for this
    summary by going to the 'Edit' menu (press Alt-E), then choosing
    'Date Range' (or simply pressing 'F8').

    Compu-Sport also has menus for the various 'tables' that are used to
    define a sporting event.  These include Venues (eg. Twickenham,
    London), Competitions (eg. World Cup Finals), Countries (eg. New
    Zealand) and Players which are all generic across all sports.
    Formula 1 motor racing has two tables specifically for it (driver
    retirement codes and constructors).

6.2 Find codes when prompted for them

    Many of the dialogs require the entry of pre-defined codes.  Some of
    these are player codes, venue codes and country codes.  When you are
    presented with such a code prompt and you do not know what to put in,
    leave the code BLANK and press 'Enter'.  A 'lookup' list of existing
    codes will appear, and you can select the one you want by using the
    arrow keys to move up and down the list.  When you have found the one
    you want, press 'Enter' and it will be returned to the original code
    prompt with it's description or name as well.

    If the list does NOT
    contain the code you are looking for (it might be a player who is
    playing in his first match and is not on file), press 'Ins' and you
    will be presented with a dialog which will allow you to capture the
    details of (say) the new player.

    Many of these lookup lists will
    also search for an item if you type in the first few letters of the
    item's name.  For example, if you have a list of hundreds of players
    and you are looking for 'Wilson', just type 'WI' and the system will
    position the light-bar on the first player whose name matches what
    you have typed.  Some lists which contain only small quantities of
    data do not support the 'search typing' function.

6.3 Insert a new match

    Go to the menu for the sport you are interested in.  Bring up the
    'Edit' menu (by pressing Alt-E), then choose 'Insert'.  Alternatively
    just press the 'Ins' key.  A dialog will appear prompting for the
    entry of details needed to describe a match (eg. date, score, etc).

6.4 Amend a match

    Go to the menu for the sport you are interested in.  Move the light-
    bar up or down until it is positioned over the match you want to
    change, then bring up the
    'Edit' menu (by pressing Alt-E) and choose 'Amend'.  Alternatively
    just press 'Enter'.  A dialog will appear prompting for the
    entry of details needed to describe a match (eg. date, score, etc).

6.5 Delete a match

    Go to the menu for the sport you are interested in.  Move the light-
    bar up or down until it is positioned over the match you want to
    delete, then bring up the
    'Edit' menu (by pressing Alt-E) and choose 'Delete'.  Alternatively
    just press 'Del'.  The match and ALL the players who took part in it
    will be deleted.

6.6 Insert players within a match

    Go to the menu for the sport you are interested in.  Move the light-
    bar up or down until it is positioned over the match for which you
    want to specify players.  Press 'Tab' to move to the right pane, then
    bring up the 'Edit' menu (by pressing Alt-E).  You can now either
    insert a single player at a time (by choosing 'Insert'), or many
    players (by choosing 'Multi-Insert').  The 'Multi-Insert' option is
    very useful when you want to capture an entire team in one go.
    You will be presented with a dialog prompting for the entry of player
    details.

6.7 Amend a player within a match

    Go to the menu for the sport you are interested in.  Move the light-
    bar up or down until it is positioned over the match for which you
    want to specify players.  Press 'Tab' to move to the right pane and
    move the light-bar on the right up or down until it is positioned
    over the player you want to amend.  Bring up
    the 'Edit' menu (by pressing Alt-E) and choose 'Amend'.
    You will be presented with a dialog prompting for the entry of player
    details.

6.8 Delete a player within a match

    Go to the menu for the sport you are interested in.  Move the light-
    bar up or down until it is positioned over the match for which you
    want to specify players.  Press 'Tab' to move to the right pane and
    move the light-bar on the right up or down until it is positioned
    over the player you want to amend.  Bring up
    the 'Edit' menu (by pressing Alt-E) and choose 'Delete'.  The
    selected player will be removed from this match.

6.9 Get individual statistics for a player

    Position the light-bar over a player's name (on any screen where a
    player's name appears ; for example, in the list of players within
    a match) then bring up the 'Statistics' menu by pressing Alt-S and
    choose 'Specific Player (Summary)'.  Alternatively you can press
    Alt-F7.  A window showing statistics pertinant to the sport in which
    this player participates will be shown.  Note that this option will
    only work if a specific player is chosen (ie. you must be in the
    RIGHT pane of the match browse screen).

    When the number of matches played (or 'caps') is listed, the figure
    in brackets represents the number of appearances that were as a
    substitute or replacement.  The number of substitute appearances is
    INCLUDED in the total number of matches played.

6.10 Get match statistics for a player

    Position the light-bar over a player's name (on any screen where a
    player's name appears ; for example, in the list of players within
    a match) then bring up the 'Statistics' menu by pressing Alt-S and
    choose 'Specific Player (Matches)'.  Alternatively you can press
    Ctrl-F7.  A window showing every match in which this player has
    participated, with his performance in each match, will be shown.
    Note that this option will only work if a specific player is chosen
    (ie. you must be in the RIGHT pane of the match browse screen).

6.11 Get overall statistics for all players in a certain match

    Position the light-bar over a specific match then bring up the
    'Statistics' menu by pressing Alt-S and choose 'This team line-up'.
    Alternatively you can press Shift-F7.  A window showing summary
    statistics for all players in this match will be shown.  Note that
    this option is not yet available for all sporting codes.

6.12 Get overall statistics for ALL players

    Go to the 'Player Statistics' sub-menu within each sport's main menu.
    A list of all players in this sport and their overall statistics will
    appear.  The individual statistics for a specific player in this list
    can be obtained from the 'Statistics' menu on this screen.  These
    statistics are the same as those described in sections 6.9 and 6.10.

6.13 Insert a new player

    There are two ways to do this.  The first is to go to the 'Players'
    option from the main 'File' menu.  Choose the sporting code in which
    the new player competes from the list in the left pane, then press
    'Tab' to switch to the right pane which shows all existing players in
    the selected sporting code.  Bring up the 'Edit' menu by pressing
    Alt-E and choose either 'Single Insert' to insert one player, or
    'Multi Insert' to insert many players.  A dialog will appear
    prompting for player details.

    Another way to define new players is to bring up the player list
    when capturing players within a match.  When the list of existing
    players appears press 'Ins' and you will be presented with the same
    dialog as described above prompting for player details.

6.14 Amend a player

    Go to the 'Players'
    option from the main 'File' menu.  Choose the sporting code in which
    the player competes from the list in the left pane, then press
    'Tab' to switch to the right pane which shows all existing players in
    the selected sporting code.  Find the player by using the arrow keys
    to move up and down.  If you type the first few letters of his
    surname the system will do an instant search for the player and
    position the light-bar accordingly.  When you found the player you
    want to amend, bring up the 'Edit' menu by pressing Alt-E and choose
    'Amend'.  A dialog will appear prompting for player details.

6.15 Insert/Amend a Venue

    The technique for doing this is the same as that described for
    'Players', but using the 'Venues' sub-menu.  There is also only one
    pane rather than two.

6.16 Insert/Amend a Country

    The technique for doing this is the same as that described for
    'Players', but using the 'Countries' sub-menu.  There is also only
    one pane rather than two.

6.17 Insert/Amend a Competition

    The technique for doing this is the same as that described for
    'Players', but using the 'Competitions' sub-menu.  There is also only
    one pane rather than two.

6.18 Insert/Amend a Formula 1 Constructor

    The technique for doing this is the same as that described for
    'Players', but using the 'Constructors' sub-menu within 'Formula 1'.
    There is also only one pane rather than two.

6.19 Insert/Amend a Formula 1 Retirement Code

    The technique for doing this is the same as that described for
    'Players', but using the 'Retirement Codes' sub-menu within
    'Formula 1'.  There is also only one pane rather than two.

6.20 General House-keeping

    It is advisable on a regular basis to re-index the Compu-Sport
    database.  To do this, go to the 'Utils' main menu and choose
    'Re-Index Data Files'.  Select the file(s) you want to re-index by
    pressing the '+' key, then press F10.  It is recommended that you
    select ALL files by holding down the '+' key.  F10 will begin the
    re-indexing procedure which should take only a few minutes.

    Note that if you have installed the system on a network and other
    people are running Compu-Sport this action may not work, as it needs
    exclusive use of all the files to re-index.  It can only be done when
    no users are running Compu-Sport.


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

The author keeps the data for the South African national team up to date
all the time, 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 decsribed 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 mid-1998.  It will be 32-bit only (ie.
it will only run on Windows 95 or Windows NT).
