Usage:                                         `Usage

HANCAP operates on a single golfer's rounds.  The golfer's file
name should be entered on the command line when starting the
program, ex. HANCAP GOOD_GUY.  If a file with that name and an
extension of .HCP exists, that file will be processed.  If that
name does not exist, the user will be prompted for permission to
create a new file with the keyed name.  HANCAP will operate only
on files that exist in the current directory, and newly created
golfer's files will be placed in the current directory.

HANCAP will calculate a golfer's (sloped) handicap index and
(non-slope) handicap, and provide statistical information.

HANCAP consists of a number of screens, all selectable from the
main menu which is displayed upon initially running the program.

Since the information that may be entered in a HANCAP round is
more than is necessary to calculate the golfer's index and non-
slope handicap, these additional fields may be left unused.
However, it is recommended that all information available be
entered to exercise HANCAP's full statistical capability.
Intended Users:                                `Intended Users

HANCAP is not a substitute for a club-maintained handicap
system.  It is designed for personal use, but should agree
in all aspects with such a club-maintained system.

It provides a measure of the ability of the occasional golfer
who is not associated with a club providing such a handicap
service.

In addition, it may be utilized to display statistical
properties of the rounds that may be of interest to the golfer.

It can also be used as a confirmation of a club-maintained
handicap, and to illustrate and further understand the
computations involved in the handicap determination.






HANCAP Functions:                              `Functions

MAIN MENU-  Changes to the golfer's full name and sex.  Display
            of the number of rounds the golfer has played, the
            total number of rounds that may be stored due to the
            amount of memory available, the dates of the first
            and last rounds played, the averages of the raw
            scores, ratings (not using yardage ratings), slopes
            (not using defaults of 113 for non-present slopes),
            and yardages for both the complete file and the last
            20 rounds.   Display of the golfer's current Index
            and Handicap, and a count of the number of rounds
            played by the golfer per year for the last 14 years,

EDIT-  Additions, deletions, and changes to the rounds played.

HANDICAP HISTORY DISPLAY-  Displays round details, the sloped
                           handicap differentials and index, and
                           the pre-slope handicap differentials
                           and handicap.

                                                          More..
HANCAP Functions (continued):

HANDICAP COMPUTATION DISPLAY-  Displays the arithmetic used to
                               determine each handicap index
                               and handicap.

PLAYING HISTORY GRAPH-  Graphically displays the score, handicap
                        index, and handicap for all rounds on
                        file.  See the topic "History Graph".

WRITE HANDICAP HISTORY TO A FILE-  Creates a file with listings
                                   as displayed in the HANDICAP
                                   HISTORY DISPLAY and the
                                   HANDICAP COMPUTATION DISPLAY
                                   above.

RULES-  Lists some rules that apply to maintaining an accurate
        handicap.

HELP-  Lists the help information for the HANCAP system (this
       screen).
                                                          More..
HANCAP Functions (continued):

REGISTER-  Displays requirements to become a legally registered
           HANCAP user.


ABOUT-  Displays impetus for HANCAP's creation, system
        requirements, and revision history.

EXIT HANCAP-  Terminates HANCAP and returns to DOS.

EFFECT OF NEXT ROUND PLAYED-  Lists each course played to date,
                              the course handicap based on the
                              present index, and the round that
                              would be necessary to:
                                lower the present index by .1;
                                raise the present index by .1
                                   (if possible);
                                lower the present handicap by 1;
                                raise the present handicap by 1
                                   (if possible).
                                                          More..
HANCAP Functions (continued):

BEST ROUNDS-  Lists details of each round played in order of
              index differentials, i.e. the "best" round first,
              etc.

COURSE FREQUENCY-  Lists each unique course (unique as to name)
                   played and the number of times played, in
                   order of the most frequently played.

COURSE LENGTHS-  Lists each unique course played in order of
                 their yardages.

COURSE RATINGS-  Lists each unique course played in order of
                 their ratings.

COURSE SLOPES-  Lists each unique course played in order of
                their slopes.



                                                          More..
HANCAP Functions (continued):
COURSE DIFFICULTIES-  Displays each unique course with its
                      slope, rating, course handicap, and
                      the target score required to meet the
                      golfer's current handicap index, in
                      target score order.


OBSTACLE RATINGS BY DATE-  Lists each unique course and the
                           obstacle rating (difference between
                           the course rating and the yardage
                           rating), in the order they were
                           played.

OBSTACLE RATINGS BY RATING-  Same as OBSTACLE RATING BY DATE,
                             except in obstacle rating order.

EFFECT OF SLOPE ON RATING-  Displays a graph of the amounts that
                            a course slope will affect the
                            course rating and subsequently the
                            Handicap Index.

Edit Screen use:                               `Edit Screen use

"DATE" is the calendar date on which the round is played and is
required.  It must be a legal date between 01/01/85 and
12/31/99, both inclusive.

"COURSE NAME" may be any printable characters or all blank.

"YARD" is the course yardage, and must be between 3000 and 7000,
both inclusive, or all blank.

"RAW" is the score of the round as played and must be from 50 -
255, both inclusive, or all blank.

"ADJ" is the adjusted score and must be 50 - 198, both
inclusive.  It must be "Equitable Stroke Controlled", i.e. bad
holes eliminated in accordance with the "Bad Holes" topic in the
Rules Screen.  The specific limits are displayed on the HANDICAP
HISTORY screen for that golfer's handicap.

"RATE" is the course rating and must be 50.0 - 90.0, both
inclusive, or all blank.                                  More..
Edit Screen use (continued):

"SLP" is the slope rating and must be 55 - 155, both inclusive,
or all blank.

"T" is a tournament flag and must be a "T" or blank.

The "YARD" and the "RATE" must not both be blank.

The DATE fields must be in chronological order.  There may be
any number of rounds played on the same date, and they should
be in the order played.

Any field of any existing round may be changed by moving the
cursor and overstriking the data.

The latest round may be entered by keying ALT-F1.  The cursor
will be placed on the first blank line if any, or the existing
rounds will be scrolled up and blank fields placed at the
bottom.  The details of the round may then be entered.

                                                          More..
Edit Screen use (continued):

A round may be entered between any two existing rounds by
placing the cursor on the bottom of the two lines and keying an
ALT-F2.  The lines above the cursor will be scrolled up, and a
blank line displayed for the new round.

A round may be deleted by placing the cursor in any field of the
round to be deleted and keying an ALT-F3.  A confirming ALT-F3
will be requested.  A round may also be deleted by blanking all
fields in that round.

A previous round's course name, yardage, rating, and slope may
be copied to the line containing the cursor by keying an ALT-F4
and a unique number of the course name's initial characters
followed by an ENTER.





                                                          More..
Edit Screen use (continued):

A previous round may be located by keying an ALT-F5 and a unique
number of the course name's initial characters followed by an
ENTER.  The search starts at the line above the cursor and
continues toward the beginning.  The data will be scrolled to
that round and the cursor placed on it.

The next round containing a match after an initial search with
the ALT-F5 function above may be found by keying an ALT-F6.  The
data will be scrolled to that round and the cursor placed on it.

Yesterday's date may be placed in the date field of any round by
placing the cursor in any field of the round (not necessarily
the date field) and keying an ALT-F7.

Today's date may be placed in the date field of any round by
placing the cursor in any field of the round (not necessarily
the date field) and keying an ALT-F8.



Playing History Graph:                         `History Graph

The score, handicap, and index for each round played are shown
in two ways: a summary, and by date.  The summary is displayed
first, and you may switch from one type to the other by keying
an F1.

The summary displays the rounds side-by-side without regard to
the time periods in which they are played.

The display by date will show a small dot for each round played,
and the handicap and index in effect at any time will be shown
with continuous stepped lines.  The index line may obscure the
handicap line if they occupy the same area.  The latest rounds
played will be displayed when this screen is selected, and you
can use the left and right cursor (arrow) keys to view earlier
time periods.  Cursor left will move the time frame one day
earlier, and cursor right will move the time frame one day
later.  Similarly depressing the control key while using the two
cursor keys will move the time frame to the previous or next
January 1st.

Lower Case Text:                               `Lower Case Text

The Name and Sex fields in the Main Menu, and the Course Name
and Tournament fields in the Edit Screen allow only upper case
letters.  Any of the other displayable keyboard characters may
be used, but to keep the Course Names consistent from entry to
entry, only upper case is allowed.  Of course, the Sex on the
Main Menu must be either M or F, and the Tournament on the Edit
screen must be T or Blank.













Slope Usage:                                   `Slope Usage

A slope is optional everywhere in HANCAP, and its inclusion
is used in determining the handicap index only, and does not
affect the non-slope handicap computation.

While the course rating is a measure of the difficulty of a
course when played by a scratch golfer, a slope rating is an
additional value assigned to a course that measures the course's
difficulty for higher handicap golfers.  The slope rating of a
course would have no effect on the scratch golfer.

A slope of 113 is average, and a course with that slope would be
considered equally difficult for golfers of all abilities, i.e.
the course rating applies to golfers of all abilities.

A slope greater than 113 reflects greater difficulty for the
higher handicap golfer.



                                                          More..
Slope Usage (continued):

Slope has the effect of changing the impact of the course
rating, and a high slope indicates greater difficulty for a
higher handicap golfer and this difficulty increases as the
golfer's handicap increases.

The Effect of Slope Graph (ALT-F10 from the main menu) will
illustrate how this has affected any of the rounds played by
the golfer.  Initially, the graph of the most recent round will
be displayed.  The golfer may select any other round by keying
any number of the initial characters of the course name followed
by an Enter.  Starting from the round just prior to the round
presently displayed, the first round that matches the keyed
characters will be selected.  If a round after the presently
displayed round is desired, exit from the screen and re-select
it from the main menu.





Course Handicap:                               `Course Handicap

A Course Handicap is used when the golfer's playing ability is
based on the golfer's index and not the (non-slope) handicap.
It is a result only of the golfer's index and the slope of the
course being played.  It would of course be different for
courses with different slopes.  The golfer's (non-sloped)
handicap has no bearing on the course handicap.  It is simply:

  Course Handicap = Index x Slope / 113.












Yardage Rating:                                `Yardage Rating

A golfer may play a round and not have the course rating.  This
may occur from a few situations, such as:

    The course is not rated.
    The rating is not posted, is not on the score card, and the
        pro shop attendant doesn't know.
    The golfer forgot to look for or ask about the rating.

The yardage and golfer's sex determine a yardage rating.

While not a substitute for a real course rating, the biggest
element making up the course rating is the yardage, and it is a
measure of the course difficulty.

In such cases, the yardage rating will be used as the course
rating.  Where this has taken place, the rating will be suffixed
with a "y".

This is the reason that the yardage is required if the course
rating is not entered.
Obstacle Rating:                               `Obstacle Rating

The most important element of a course rating is the length of
the course, and as explained in the previous screen, this is
the result of the application of a mathematical formula only.

The course rating is determined by the addition (or subtraction)
of difficulty factors derived from other features of the course
such as: landing area sizes, out of bounds, sand traps, water
hazards, etc.

The obstacle rating screens are the result of an attempt to
quantify these difficulty features.

The obstacle rating is simply the course rating minus the
yardage rating.  Thus it is the numeric value of these
difficulty factors, and probably is only meaningful when
comparing two courses.  A course with an obstacle rating greater
than that of another course means that the first course is more
difficult than the second course, without taking the course
lengths into consideration.

Backup File:                                   `Backup File

When a golfer's data has been changed, including the golfer's
full name and/or sex, a new .HCP file is written.  The old file
is renamed with the same filename and an extension of .HCB.  The
previous .HCB file is discarded.

If something happens to the golfer's .HCP file, the .HCB file
may be renamed .HCP and HANCAP run with that as the new file,
although the changes made since the .HCB file was created will
be lost.

Under ordinary usage, this process is invisible to the user, and
no action is necessary.








New Golfer:                                    `New Golfer

To create a file for a new golfer, rerun HANCAP with the new
golfer's file name on the command line.  The golfer's file name
becomes the name of the file with the extension .HCP, so the
name must be a legal DOS filename.  A DOS filename must consist
of 1-8 characters that are letters, numbers, and some other
special characters such as the dash and underscore.

You can not use a blank such as in "GOOD GUY", but you could use
the underscore giving a similar effect as "GOOD_GUY" or
"GUY_GOOD".

When you run HANCAP with a new golfer's file name for the first
time, you will be asked if you want to create a new file.  Key
in a "y" to indicate that you do.  The file will be created and
the main menu will be displayed.  Fill in the golfer's full name
(Any characters that can be generated from the keyboard
including blanks may be used here) and sex (M or F) on this
screen before proceeding to the Edit screen to add rounds.

                                                          more..
New Golfer (continued):

If you key in a file name for which you expect a golfer's file
to already exist, and you get the request to create a new file,
then you probably keyed the name incorrectly, and you should
answer with an "n", verify the golfer's filename and rerun
the program using the correct golfer filename.















Matching Course:                               `Matching Course

The course name may be any characters generated with the
keyboard.  However, specifying a "slightly" different name, or
a different yardage, rating, or slope for different rounds
played on the same course will cause HANCAP to treat rounds
played on the same course as being played on different courses.

In many cases, this may be just a data entry error and should be
corrected.  However, if some course attribute (such as the
yardage, or the rating) has really been changed, and sometimes
this can be drastic, the data must reflect this, and HANCAP will
correctly treat the multiple rounds as rounds played on
different courses.

This will not affect the Index or Handicap calculations, but
certain screens displaying statistical information depend on
rounds played on the same course to be recorded with the same
attributes.  Course Frequency (ALT-F3 from the Main Menu) is
a prime example.  These screens will operate properly, but will
deviate slightly from their intended purpose.

Printing Data:                                 `Printing Data

You may create a file with the golfer's name and an extension of
.HCR from the Main Menu by keying an F5.  The file will consist
of all of the rounds recorded to date as in the (scrollable)
Handicap History screen, and show the current handicap
computations as in the (latest) Computation Screen.  After
exiting HANCAP, this file may then be printed as-is or edited
with a text editor or word processor and then printed from the
text editor, word processor, or from DOS.

For example, to print the golfer GOOD_GUY file from DOS, either
as created by HANCAP, or after editing with a text editor or
word processor, key:

     COPY GOOD_GUY.HCR LPT1

The Print Screen Key may also be used to print any screen while
it is displayed.  You must run the DOS program GRAPHICS prior to
starting HANCAP to print the Playing History Graph and the
Effect of Slope Graph (F4 and ALT-F10 from the Main Menu).  DOS
4.0 or greater is necessary to print these two screens.
