home *** CD-ROM | disk | FTP | other *** search
/ AMOS PD CD / amospdcd.iso / sourcecode / routines / golfscore.doc < prev    next >
Text File  |  1990-08-11  |  8KB  |  230 lines
  1. =============================================================================
  2.                  ____                                                   ____
  3.                 / / /                                                  / / /
  4.                / / /       GOLFSCORE  ANALYSER V1.1                   / / /
  5.               / / /                                                  / / /
  6.    ____      / / /                  BY                    ____      / / /
  7.    \ \ \    / / /                                         \ \ \    / / /
  8.     \ \ \  / / /                ROSS CLEARY                \ \ \  / / /
  9.      \ \ \/ / /                                             \ \ \/ / /
  10.       \ \/ / /                   FEB 1990                    \ \/ / /
  11.        \/_/_/                                                 \/_/_/
  12.  
  13. ===========================================================================    
  14.  
  15. WHAT IS GOLFSCORE ANALYSER?
  16.  
  17.     Golfscore is a program to record and analyse golfscores! 
  18.  
  19. Nah, geddaway.......
  20.  
  21. Its purpose is to record each round you play, store it,make up an eclectic 
  22. score from the latest round & previous rounds, compare each round against
  23. your personal best and update if required.
  24.  
  25. It also works out average scores, totals up birdies, pars, bogeys etc. on
  26. a per hole & a per round basis & keeps a running total.
  27.  
  28. You can also print an individual score if you really want to.
  29.  
  30. I wrote this program using the wonderful  AMOS basic.
  31.  
  32. Golfscore was written to fulfill my own requirement for a program of this 
  33. type & also as an exercise to get me used to using AMOS.
  34.  
  35. This is the first working version of golfscore, it is an alpha release
  36. so it is probably full of bugs.
  37.  
  38. if you find any bugs, or have any suggestions or comments to make, please 
  39. let me know.
  40.  
  41.  
  42. You can write to me at:
  43.  
  44.                   Ross Cleary
  45.           9, Storking lane,
  46.           Wilberfoss
  47.           YORK
  48.           YO4 5PH
  49.  
  50. Or you can phone (after six please) on
  51.  
  52.           07595 357
  53.  
  54. This program is WORTHWARE. i.e. if you intend to use it regularly please 
  55. send me whatever you think it is worth, TO YOU.
  56.  
  57. If you do send me any money, jelly babies or tins of biscuits 
  58. you will automatically go on the list to receive upgrades, bug fixes & 
  59. my eternal gratitude.
  60.  
  61. This program is not P.D. but it is freely redistributable, provided you
  62. keep this doc.file with it & you don't make an unreasonable amount of    
  63. money from it.
  64.  
  65. Oh, and don't change the name of the disk, because all the load/save
  66. operations require a volume called Golfscore:
  67.  
  68.  
  69.  
  70. HOW DO YOU USE IT?
  71. ------------------
  72.  
  73. LOADING:
  74.  
  75.     You can run Golfscore from workbench or you can boot from the 
  76. golfscore disk on power-up, depending on memory avaliability.
  77.  
  78.  
  79. GETTING STARTED:
  80.  
  81.     On loading you will be presented with a blank-screen. "Oh yes, very
  82. user friendly" I hear you shout. DON'T PANIC, Golfscore is completely menu
  83. driven, (Hot keys as well in next release).
  84.  
  85. The first thing to do is to configure your course(s). to do this you go to
  86. the project menu and select...wait for it....Configure a course!, get the 
  87. idea? Good. OK Golfscore will then display a scorecard & prompt you for
  88. the details of your course (it is a good idea to have the scorecard of your
  89. course handy before you do this), it will require the yardage & par for
  90. each hole.
  91.  
  92. When you have input the course details, a file will automatically be
  93. created for the course on the disk.
  94.  
  95. INPUTTING A SCORE:
  96.  
  97.     The next thing you will need to do is input a score. To do this go
  98. to the scores menu & select, ...yes, you've guessed it... Input a score.
  99. Once again, everthing is prompted for on screen so you can't really go
  100. wrong.
  101.  
  102. Once the score has been input, it is compared to the eclectic & best scores
  103. which are updated as needed (I can't spell nessessssery). relevent bits will
  104. also have sums done on them (I can't spell calculations, either), to be
  105. used in the statistics (more on stats later).
  106.  
  107. If you're like me, you have probably had a play with Golfscore already so 
  108. you will have noticed that it doesn't really do much untill you have a
  109. score on file.
  110.  
  111.     B E W A R E !
  112.  
  113. Any score input will affect the statistics for all future calculations so
  114.  
  115.      MAKE SURE ANY SCORE IS CORRECT BEFORE YOU SAVE IT TO DISK!!!!!!
  116.   
  117. You may delete a score but the statistics will already have been added to 
  118. the overall analysis file, which you cannot at present alter (future!).
  119.  
  120.  
  121. SHOW A SCORE:
  122.  
  123.     To show a score, go to the scores menu and select "Show a score".
  124. Yes, I know, you're way ahead of me. If you have already opened a course
  125. you will be given a file selector asking you which score to show.(each
  126. score has a date & course attached to its filename). You will only be 
  127. offered scores from the current course.
  128.  
  129. If you have not already opened a course, you will be prompted to open one
  130. by a file selector
  131.  
  132. If you wish to see scores from a different course you will first have to
  133. open a course. 
  134.  
  135. OPEN A COURSE:
  136.  
  137.     To open a course go to the project menu and select......yeah, you
  138. know the rest. you will only need to do this if you are using two courses &
  139. want to change to another. All other functions automaticaly prompt for a
  140. a course if one is not already in memory.
  141.  
  142. DELETE A SCORE:
  143.  
  144.     Fairly obvious one this, go to the scores menu and..........
  145.  
  146.           (  DELETING OLD SCORES DOES NOT AFFECT STATISTICS )
  147.  
  148. SHOW BEST SCORE:
  149.  
  150.     Go to the analysis menu and select "Show Best Score" (shock horror
  151. probe !) this will show you your best ever round (whether or not you've
  152. deleted it on a previous occasion).
  153.  
  154.  
  155. SHOW ECLECTIC SCORE:
  156.  
  157.     For those of you who don't know what an eclectic score is, it is
  158. the best ever score on a HOLE BY HOLE basis, each individual best score on
  159. each hole being gathered together into one seriously good round. This is
  160. compared & if required, updated every time a new score is input.
  161.  
  162. To show an eclectic score go to the analysis menu and etc....etc.....
  163.  
  164. SHOW STATISTICS:
  165.  
  166.     Every time a score is input, the stats file for that course is
  167. updated. SO MAKE SURE EVERY SCORE IS CORRECT BEFORE SAVING.
  168.  
  169. The best way to see what the stats are is to input a score & Then go to
  170. the analysis menu and ....... well, you know the drill.
  171.  
  172. PRINT SCORE:
  173.  
  174.     Confession time.
  175.  
  176. The print function in Golfscore is very primitive. this is for two reasons:
  177.  
  178.     1.  My printer is very primitive
  179.  
  180.     2.  My knowledge of such things is also very primative.
  181.  
  182. However, it does work as long as you have a printer connected to the
  183. paralell? parallel? anyway,the port that isn't the serial port.(you know
  184. what I mean.)
  185.  
  186. I am currently working on this & I promise to seriously improve it for the
  187. next version.
  188.  
  189. To print a score, go to the hardcopy menu, wear a silly hat, place your
  190. hand inside your jacket and shout "I am Napoleon, I tell you, I am!"
  191.  
  192.  
  193. RESETTING STATS:
  194.  
  195. In this version the only way to re-set your stats to zero is to delete 
  196. all scores, go to the CLI 
  197.  delete scores/<course name>.stats
  198.  delete scores/<course name>.best  
  199.  delete scores/<course name>.eclectic
  200.  
  201. there will be a vast improvement on this in future versions
  202.  
  203.  
  204.  
  205.  
  206.     I know this is a minority program, in that users will need to own
  207. an Amiga AND play Golf, but I hope it may be usefull to someone.
  208.  
  209. Even if you don't make any worthware contribution, please get in touch &
  210. let me know what you think of it, as it is the first piece of software I 
  211. have inflicted on an unsuspectimg world.
  212.  
  213.  
  214.  
  215. Thanx to:
  216.  
  217.      Francois Lionet & Mandarin for AMOS
  218.     
  219.      Paul, Tina & all at N.B.S. for being cheap & reliable 
  220.  
  221.  
  222.  
  223.                   Ross 
  224.             
  225.             Feb 91
  226.  
  227. ============================================================================
  228.  
  229.  
  230.