home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / catalogs / mtchplay.zip / MTCHPLAY.DOC < prev    next >
Text File  |  1993-02-14  |  9KB  |  180 lines
  1.  
  2.  
  3.                               MTCHPLAY
  4.  
  5.  
  6.      Probably the most common form of golf competition among ordinary
  7.      golfers is 'match play', in which each hole is a separate contest,
  8.      with the winner of the match being the player winning the most holes.
  9.      To make the contest reasonably fair, in the case of players of
  10.      different abilities, the weaker player is awarded a number of strokes,
  11.      depending on the difference between the two player's handicaps; these
  12.      strokes are awarded on the hardest holes on the course being played.
  13.      In the case of a foursome, there are frequently six such matches being
  14.      played at the same time, with each member of the group competing with
  15.      each other member.
  16.  
  17.      It would seem reasonable to have a tournament along the same lines,
  18.      with each player competing at match play with each other player.
  19.      Unfortunately, the scoring problems are horrendous - if there are 20
  20.      players, for example, there will be 190 separate matches, each requiring
  21.      the comparison of net scores on 10 to 18 holes, with the 'net' values
  22.      variable, depending on the relative handicaps of the players.
  23.  
  24.      While scoring such a tournament would be horrendous for people, it is a
  25.      simple matter for a computer, and MTCHPLAY is a program for doing this.
  26.      (MTCHPLAY will also score the tournament by gross or net scores, or by a
  27.      commonly used point system.)
  28.  
  29.      The program requires an IBM compatible computer with 640K memory, plus
  30.      a printer if hardcopy is desired. A hard disk is not necessary but is
  31.      a real timesaver, since the program does a lot of updating of its
  32.      data files. A color monitor adds a lot to the display.
  33.  
  34.      It is assumed that the tournament field is divided into at most 10
  35.      flights (0,1,...9), with each flight containing at most 24 players.
  36.      These numbers are more or less arbitrary, and could be changed if
  37.      desired (having bigger flights might require doing without some of the
  38.      on-screen displays, simply because the normal PC screen has only 25
  39.      lines). At the maximum size, the computer is called on to score 2760
  40.      separate contests, which would take people several hours but can be
  41.      done in just a few seconds by a reasonably fast PC.
  42.  
  43.      The program requires an entry list file in the following format:
  44.         One or more blank lines, then a tournament title if desired. The
  45.         title must begin with a letter; e.g. 'Feb 19 Tournament' is ok,
  46.         but '19 Feb Tournament' will cause an error.
  47.  
  48.         One or more blank lines, if desired, then the list of par values of
  49.         the holes of the course being played.
  50.  
  51.         One or more blank lines, if desired, then the list of handicap numbers
  52.         of the holes of the course being played.
  53.  
  54.         Exactly one blank line, then the list of tournament entrants.
  55.         Hereafter, blank lines are used only to separate flights, with exactly
  56.         one blank line between every two flights. The entrants should be
  57.         given in the form lastname, comma, first names or initials. Each name
  58.         should be followed, on a separate line, with the player's handicap.
  59.         Each player must have a handicap; if no official handicap is available,
  60.         a temporary handicap should be assigned, indicated by a negative number;
  61.         e.g., if a player guesses that his handicap is 'about 14', list his
  62.         handicap as -14. Temporary handicaps will be replaced, after the scores
  63.         are entered, by handicaps computed under the Calloway system.
  64.  
  65.      The program will produce and continually update a 'results' file,
  66.      in the same format as the entry list file but with the tournament
  67.      scores included for each player who has finished. If the program is
  68.      interrupted for any reason, it may be restarted using this file in
  69.      place of the entry list.
  70.  
  71.  
  72.      When the program starts, you will asked whether of not to use an
  73.      existing old data file, then to give the name of the input file
  74.      and a name for the results file.
  75.  
  76.      You will then be presented with a menu offering the choices:
  77.  
  78.                  Enter
  79.                  Display
  80.                  Print
  81.                  Check
  82.                  Quit
  83.  
  84.      A menu choice, here and elsewhere, may be made either by moving the
  85.      highlight bar (with the up- and down-arrow keys) and pressing Enter
  86.      or by typing the initial letter of the entry.
  87.  
  88.      Enter:
  89.      This is used for entering the scores of the players as they finish.
  90.      Type the name of the player (or as much of the name as necessary to
  91.      uniquely identify him), and then his scores. The scores should be
  92.      entered consecutively, e.g. 454645645435465435. This is quick, but
  93.      but has the side effect that NO HOLE SCORE MAY BE GREATER THAN 9.
  94.      The program automatically formats the scores as xxx-xxx-xxx--xxx-xxx-xxx.
  95.      It is not necessary to enter all data at one time. The program will
  96.      recalculate the tournament results after each Entry session, and the
  97.      current status can be examined through the other menu options before
  98.      entering more data. If the flights are scheduled to play consecutively,
  99.      for example, then the results for each can be printed out as soon as
  100.      the last scores for that flight are entered.
  101.  
  102.      Display:
  103.      This allows on-screen display of current data. You will be offered the
  104.      choices
  105.                  Entries
  106.                  Standings
  107.                  Matches
  108.                  Two X Two
  109.  
  110.            Entries:
  111.              Displays the names, handicaps and scores currently entered.
  112.  
  113.            Standings:
  114.              Displays current standings, choice of:
  115.                Match Play
  116.                Point System
  117.                Gross Score
  118.                Net Score
  119.  
  120.            Matches:
  121.              Displays results of all matches between players in a selected
  122.              flight.
  123.  
  124.            Two X Two:
  125.              Displays details of match between any two selected players.
  126.  
  127.      Print:
  128.        Standings:
  129.          Same as Display/Standings, but sends output to the printer.
  130.        Matches:
  131.           For each player in a selected flight, prints out the results
  132.           of all his matches with others in that flight. (Creates a disk
  133.           file for each flight, which can be used as a permanent record
  134.           if desired, or erased later. These files are named MATCHES.x,
  135.           where x is the flight number, and may be fairly large. This
  136.           is another reason a hard disk is recommended.)
  137.  
  138.      Check:
  139.        Allows entries to be checked one-by-one, and corrected if desired.
  140.        Options:
  141.          Name
  142.          Hcp
  143.          Scores
  144.          Accept
  145.          Delete
  146.  
  147.      Match play points are alloted as in Ryder Cup play: 1 point for each
  148.      match won, 1/2 point for each match halved. Within each flight, the
  149.      winner is the player with the greatest number of points. Clearly ties
  150.      are possible, perhaps likely. If only two players tie, the winner could
  151.      be decided by checking which of them defeated the other in their match,
  152.      unless that match was also a tie. If three or more tie, the problem is
  153.      more complicated, since it might happen that A defeated B, B defeated C,
  154.      and C defeated A, for example. In any event, it is probably not very
  155.      hard to devise a tie-breaking system for each tournament, depending
  156.      on local preferences, and the program does not implement any system,
  157.      just reporting ties if they occur.
  158.  
  159.      Several of the options ask for the name of a player. When this occurs,
  160.      you need enter only as much of the name as necessary to identify the
  161.      player: if Johnson, Sam is the only player named Johnson entered and
  162.      you wish to display some information about him, you need enter only
  163.      the last name; if there is also a Johnson, L. B. in the tournament,
  164.      however, you must enter at least 'Johnson, S' for Sam Johnson. In case
  165.      you enter an ambiguous name, and there are no more than 10 possiblities,
  166.      the program will list them all and ask you to choose one.
  167.  
  168.  
  169.      The source code is included. All of these files are original except
  170.      WINDOW.H and WINDOW.C, which are from Al Stevens column in Doctor
  171.      Dobbs Journal, September, 1988.
  172.  
  173.      ----------------------------------------------------------------------
  174.      There is no charge for this program. I would be delighted to hear from
  175.      anyone who uses it, and of course I hope that any bugs will be reported.
  176.  
  177.           B. J. Ball, 3304 Glen Rose Drive, Austin, Texas 78731
  178.      ----------------------------------------------------------------------
  179.  
  180.