 Version 4.2 April 7, 1994

 This is a program to calculate the golf handicap of any number of
 individuals who may have played on any number of courses.  It provides
 the ability to add players and courses.  It maintains a file of players
 and a file of courses, plus an individual game file for each player.
 There is also a file "golfdefs" which saves context between runs.

 The Hcp is nn% of the average of the best (lowest) differentials between
 adjusted gross score and course rated par.  The adjusted gross score is
 the score resulting from reducing the score for any given hole in which a
 net score of more than a bogie was recorded (1973 rules). The 1993 rules
 changed this to a maximum of 6 plus hcp/10.  The change is incorporated
 for scores after 1992.	 The percent nn is = 96 by default.  This is
 intended to reflect the standard usage by the USGA.  Golf Digest usually
 uses 100%.  This may be set on entry to the program

 The slope was incorporated in version 4.2.  The calculation is the
 multiplication of the differentials by 113/slope, where 113 represents
 the "average" slope, and the given slope is for the particular course.
 The use or non-use of the slope correction is optional, and may be set
 on entry. The default is NOT to use the slope correction.
 
 It shows the last nn differentials , or all differentials, whichever is less
 (used in actual handicap calculations) with the ones used (Best half)
 highlighted.  A separate highlight shows the midpoint differentials which
 are the ones that are most likely to be replaced by a new one. The number
 of differentials to be used is optional, and may be set on entry.  The
 default is 20, which matches the USGA standards.

 An option to set the number of holes was for the benefit of golfers who
 want to use 9-hole courses, or for such rarities as the Millwood, Mass
 course, which has 14 holes!

 It is constantly under revision, as I think of things I would like to do
 with it...The next version will include adding some printouts.  I would
 have done it in this version, but my printer is not available at the
 present time for testing.

 The adjusted gross scores (Also referred to as Equitable Stroke Control)
 can be calculated by one of three formulae, or not at all, as set on entry.
 The rules are:
  0 - Do no adjustment
  1 - Adjust based on USGA 1973 Equitable Stroke Control
  2 - Adjust based on USGA 1993 rules
  3 - Use rule 0 if date before 1973, rule 1 if date 1973-1992, and
      rule 2 if date after 1992.
		   Rule 1
 The maximum on a given hole is bogie plus (handicap div 18),
 plus another stroke for (handicap mod 18) holes.
 For a handicap of 22, this would mean that the golfer would be allowed
 4 triple bogies, and 14 double bogies, since handicap div 18 = 1, and
 handicap mod 18 = 4.
		   Rule 2
 A maximum on any hole is 6 + handicap div 10. I.e., for a handicap
    of 0 - 9,  maximum is 6
      10 - 19, maximum is 7
      20 - 29, maximum is 8

 If anyone wants to know what the "anti" handicap reported means, it
 is the same as a handicap calculation, but using the highest half of
 the scores, instead of the lowest half.  It shows how bad your bad
 games are!  The difference between the handicap and anti-handicap is
 a measure of the variability in your play.

 The syntax for starting the program has been expanded to take parameters
 for the above improvments in version 4.2.  It is as follows:
     golf [hnn] [%nnn] [gnn] [an] [s+|s-]  
 where the square brackets shows the optional parameters.  Within the brackets,
 the first character gives the type of parameter, and the second gives the
 value.
 The defaults are equivalent to:
     golf h18 %96 g20 a3 s-
 This translates to:  Calculate for 18 hole courses.
                      Use 96% of differentials (adjusted gross - rated par)
		      Use last 20 games for handicapping
                      Use "Rule 3" for adjusting gross scores
                      Do NOT use slope in calculating handicaps.
 The limits on the numerical values are h18, %100, g20, a3.  And, of course,
 the s+ means to USE slope in the calculations.



		      History
 3.0 First version to be made available as Shareware.

 3.1 Removed 80x87 library functions, saving 12k memory.
     Corrected return to option box after using left/right arrows.
     Fixed the monochrome response to look decent.  (It was
     originally	written for mono, but changed to color when I got an 
     SVGA monitor).  Now its is OK on either.     

 4.0 Put in the 'View' capabilities to allow the selection of players
     and courses to be from original lists or by sorted lists of
     various kinds. (Currently: By original entry, alphabetically, 
     alphabetic by surname or by handicap for player; original entry,
     alphabetic, or by rated par for courses).

 4.1 Set up larger maximum windows, and increased the maximum number
     of players and courses to 255 each (which could be easily raised
     higher if that is found desirable.

 4.2 Optional inclusion of the "slope" in calculating of handicap.
      (Not available in earlier versions)
     Optional choice of number of holes per golf course.  This allows
      the program to be used for 9-hole leagues, and for strange courses	
      like Millwood in Mass. which has 14 holes.
     Optional choice of number of holes to be used in calculating Handicaps.
      The default number (20) is USGA standard, while 12 is used by Golf
      Digest.
     Optional choice of adjustment of scores by various rules (see above)  
      The default is rule 3, which was used on the version 4.1.
     Optional choice of Percent to modify differentials.  The default
      is 96% which matches USGA handicaps.  100% matches Golf Digest.
     Improvement on score entering.  Now a back-arrow during the entry
      of the hole-by-hole scores will back off to previous hole, for
      correction of erroneous entries (must be done before completing)
  
 If you become a registered user, I will send you the latest update, 
 and will include the source code (in Turbo Pascal).

 If you have any suggestions, or complaints (Heaven forbid!) I would
 appreciate a note.  I may be reached via Compuserve, (70673,3070), but
 I confess to not checking the mail there as regularly as I should.
 Or, you may write to the address below.

 The program itself is NOT cluttered with reminders, nudges, etc. to send it
 in, so if you choose not to do it, I will probably never know, and you will
 not be bothered.  If, however, you feel it appropriate to register, I will
 send you (along with latest version), some of the auxiliary programs I have
 used in developing this, along with their source codes. 
  
 There are a number of files that will be generated.  GOLFDEFS keeps
 track of the last course and golfer, so that upon program entry,they will
 become the defaults.  COURSES keeps all the courses, along with the pars
 and the rated par for the course.  GOLFERS keeps the list of golfers, 
 together with their last (up to 20) games, and their current handicap.
 There is also a GOLFRx file for each golfer, which has ALL his games
 that have been recorded, on any course that he played (And entered in the
 program, of course). Because of the generated files, the user would
 be well advised to create a separate directory for the golf programs
 (Any name will do, but GOLF or GOLFHCP seem like good choices).  Then
 if you ever want to start over, or simply get rid of the whole thing,
 you can just delete everything in the directory. 

 To run the program, simply copy the executable file to an appropriate
 (empty?) directory and execute it.  It will generate the appropriate
 default files and await your entry of golf courses, and players.  After
 such entries, it will prompt for hole by hole scores for selected courses
 and players. On completion of a score, it will compute a handicap
 for the player.  It will use the single score for the first computation
 and the lowest half (of up to 20 scores) for the rest.  It will display
 the differentials used, with the low half in red, the medians in blue
 and the high ones in black.  You will note the scores per hole will use
 a similar scheme to show under par, par and over par scores.

 Shortcuts, and options are shown at the bottom of the screen.
 These principally include the option of <Escape> during the entry of data
 such as names or scores to exit the particular operation. The use of
 <Enter> will accept a default value for integer entries.

 The default values for dates match the current date, while the default
 for hole-by-hole scores are the pars for the current holes.  When
 entering pars for a new course, the default value is 4. The default
 value may be accepted (by <Enter>) or may be increased (by 1) by a
 press of up-arrow, or decreased by pressing down-arrow.

 Registered users will receive a diskette with the latest version,
 including the Pascal source files, as well as any new utilities that
 I find useful in generating the program.  Thes include things like
 changing files such as 'courses' from the format prior to 4.2 to the
 4.2 format, which now includes the slope rating.
 
 Included in the present 4.2 ZIP file is the G_FILES.exe program
 which  can convert the golfers, courses and game files from the
 random access (for speed and compactness) to text files (for
 editing?) and back.

 You may register by sending a payment of the amount of one
 Greens fee at your home course. (Minimum of $5.00...to cover costs of 
 reproduction, and mailing.  Thought I better add that, in case a bunch
 of people have VERY cheap greens fees! Otherwise I could go broke on
 the cost of diskettes and postage!)

 
  Send your registration request, and check to
	James W. Butler
	90 Appleyard Lane
	Holliston, Mass 01746-2539
 Copyright (c) 1993,1994 by James W. Butler


 
