home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 647.lha / Bridge_1.04 / Bridge.doc.pp / Bridge.doc
Encoding:
Text File  |  1992-06-26  |  9.8 KB  |  254 lines
  1. ========================================================================
  2. =----------------------- Amiga Bridge v 1.04 --------------------------=
  3. =----------------------------------------------------------------------=
  4. =------------------------ (C) Erik Bergersjö --------------------------=
  5. =----------------------------------------------------------------------=
  6. =-------------------------- Documentation -----------------------------=
  7. =----------------------------------------------------------------------=
  8. =--------------------------- 06 May 1992 ------------------------------=
  9. ========================================================================
  10.  
  11. What is Amiga Bridge v 1.04?
  12. ----------------------------
  13.  
  14. As you might have guessed, Amiga Bridge is an Amiga program that plays
  15. the game bridge. It supports a subset of the bidding system described
  16. by Eric Jannersten in his books "Bridge från grunden" and "Systemet i
  17. ett nötskal" (I don't know their english titles, if any).
  18. As far as I know, this is the first non-commercial bridge program
  19. available for the Amiga. In my opinion it compares well with the
  20. commercial ones :-) , especially when the user interface is concerned.
  21. I admit the documentation might be a bit sparse, but who reads lengthy
  22. documentation files anyway?
  23.  
  24.  
  25. Included files
  26. --------------
  27.  
  28. Bridge.doc        This very file.
  29. Bridge.doc.info        Icon to this file.
  30. Normal_Version        Directory for normal (MC68000) version.
  31. -  Bridge        The executable file.
  32. -  Bridge.info        A beautiful icon (guess who made it?).
  33. -  Bridge.prefs        Default settings (not required, save your own).
  34. Normal_Version.info    Icon for directory.
  35. Turbo_Version        Directory for turbo (MC68020) version.
  36. -  Bridge        The executable file, turbo version.
  37. -  Bridge.info        Nice icon for executable.
  38. -  Bridge.prefs        Default settings (not required, save your own).
  39. Turbo_Version.info    Icon for directory.
  40.  
  41. The files below are © Nico François:
  42. ------------------------------------
  43.  
  44. Install            Installation script, reqtools.library.
  45. Install.info        Icon for installation script.
  46. Install.script        Installation script, continued.
  47. kick20            Directory for reqtools, kick 2.0 version.
  48. -  reqtools.library    The library file.
  49. kick13            Directory for reqtools, kick 1.3 version.
  50. -  reqtools.library    The library file.
  51.  
  52. Distribution
  53. ------------
  54.  
  55. Amiga Bridge v 1.04 is shareware, NOT public domain.
  56.                       ~~~~~~~~~
  57. It may be freely distributed (as long as all files except Bridge.prefs
  58. are included as is) for non-commercial purposes. However, if you decide
  59. to keep it you really should make a contribution.
  60. Write to:    Erik  Bergersjö
  61.         Fornminnesv. 20
  62.         446 00 Älvängen
  63.         Sweden
  64.  
  65. If possible, send bug-reports to (e-mail) d9erikb@dtek.chalmers.se.
  66.  
  67. Acknowledgements
  68. ----------------
  69.  
  70. I'd like to thank some people for making life easier to live:
  71.  
  72. o Martin Ewaldz        Pascal source to PC bridge (the basics
  73.             for the bidding system).
  74. o Nico François        This version of Amiga Bridge uses reqtools.library
  75.             (© Nico François) for almost all requesters.
  76. o Markus Wild        Not that it affects Amiga Bridge in any way
  77.             whatsoever, but GCC is surely one of the best
  78.             things that has happened to the Amiga community
  79.             for a long time...
  80.  
  81. How hands are valued
  82. --------------------
  83.  
  84. o Honor points (hp).
  85.   ACE => 4 hp, KING => 3 hp, QUEEN => 2 hp, KNIGHT => 1 hp.
  86.   There are a lot of special cases where other values should be
  87.   used. However, for simplicity the special cases are ignored.
  88.  
  89. o Distribution points (dp).
  90.   The calculation of distribution points (as described in the books
  91.   I've read) is complicated. It gives a different number of points
  92.   depending on the progress of the bidding.
  93.   I have chosen a simple approximation:
  94.   All suits with less than 3 cards => (3 - number of cards) dp.
  95.  
  96. o Points (also refered to as "normal points").
  97.   This is the sum of the honor points and the distribution points.
  98.  
  99. o Trick points (tp).
  100.   The number of trick points for a hand depends on the selected trump.
  101.   It represents how many tricks we should be able to secure with
  102.   the specified trump (8 tp <=> 8 probable tricks).
  103.   A table is used to find the offensive value of the honors.
  104.   Suits with more than 3 cards give 0.5 (1 for trump) tp for each
  105.   additional card. Only the integer part is used.
  106.  
  107.   o---------------------o-----------------------o
  108.   | 3        E-K-Q    | 1 1/4        E-Kn-x    |  "x" represents any
  109.   |            |        K-Q-x    |  card less than 10.
  110.   | 2 1/2    E-K-Kn    |            |
  111.   |        E-Q-Kn    | 1        E    |
  112.   |            |        K-Q    |
  113.   | 2 1/4    E-K-10    |        K-Kn-x    |
  114.   |            |        Q-Kn-10    |
  115.   | 2        E-K    |            |
  116.   |        E-Q-10    | 3/4        K-Kn    |
  117.   |        K-Q-Kn    |        K-10-9    |
  118.   |            |            |
  119.   | 1 3/4    E-Kn-10    | 1/2        K-x    |
  120.   |            |        Q-Kn-x    |
  121.   | 1 1/2    E-Q    |        Q-10-9    |
  122.   |        K-Q-10    |            |
  123.   |        K-Kn-10    | 1/4        Q-x    |
  124.   |            |        Kn-10-x    |
  125.   o---------------------o-----------------------o
  126.  
  127.  
  128. The bidding system
  129. ------------------
  130.  
  131. The bidding system is probably the most complex part of Amiga Bridge.
  132. I'm not going to describe it here.
  133. There are two menu items in the "Game" menu ("Opening bids" and
  134. "Response bids") that will help you with details about the implemented
  135. opening & response bids possible.
  136. However, there are other bid classes.
  137.  
  138. o Blackwood (4 NT, 4 NT - ? - 5 NT).
  139.   The first blackwood question asks partner for number of aces,
  140.   the second for number of kings. The second question gives the
  141.   additional information that all the aces are accounted for.
  142.   Amiga Bridge doesn't treat trump king (queen) as an ace (king).
  143.   The responses are:
  144.   4 NT:  5 C <=> 0 or 4 aces, 5 D <=> 1 ace, 5 H <=> 2 aces,
  145.          5 S <=> 3 aces.
  146.   5 NT:  6 C <=> 0 or 4 kings, 6 D <=> 1 king, 6 H <=> 2 kings,
  147.          6 S <=> 3 kings.
  148.  
  149. o Normal bids. A bid that doesn't fit any convention is normal.
  150.  
  151. o Illegal bids. All unsupported bids are illegal. They don't give
  152.   any information whatsoever. The computer never makes illegal bids.
  153.  
  154. To find the correct bid (and to learn the system), experiment!
  155. Make a bid, then select "Display info" from the "Game" menu.
  156. If you made the wrong bid you can always select "Restart" (or
  157. "Restart game" from the "Game" menu) and try again.
  158. You can also select "Auto bidding" from the "Preferences" menu and
  159. bidding will be handled automatically.
  160.  
  161. Preferences
  162. -----------
  163.  
  164. o Computer cheating    When selected, the computer will cheat & look
  165.             at your cards. This results in faster (and
  166.             sometimes better) moves. Normally the computer
  167.             calculates simulated distributions, based on the
  168.             information obtained from bidding.
  169. o Auto bidding        The computer handles the bidding automagically.
  170. o Award honor bonus    In the good old days, bonus points were awarded
  171.             for having all the honors (or all honors in
  172.             trump).
  173. o Delay obvious moves    When an opponent (or your partner, when your
  174.             opponents have claimed a contract) has but one
  175.             card in a suit, the computer doesn't have to
  176.             think, the move is obvious. When this item is
  177.             selected the computer will pretend to think,
  178.             keeping the actual distribution a secret.
  179. o Alternate colors    How do you want your cards to be sorted?
  180.             The hands are not redrawn at once.
  181. o Change colors        Now why would you want to do that?
  182. o Evaluation
  183.   - Number of deals    The number of simulated distributions that should
  184.             be tried. Low values will result in some rash
  185.             moves, but (much) faster evaluation.
  186.             Default setting: 3.
  187.             Personally I use a value of 9. A 25 MHz A3000
  188.             has some benefits...
  189.   - Weight, heuristics    The weight for the heuristic part of the evaluation.
  190.               Amiga Bridge makes a (clever?) guess about the
  191.               best card to play. Default setting: 3.
  192.   - Weight, search    The weight for the search part of the evaluation.
  193.               Each card is tried in turn, the max/min number
  194.               of won tricks is calculated. Default setting: 9.
  195.  
  196. History
  197. -------
  198.  
  199. 09 Dec 1991    First released version (1.0 ß) uploaded to ab20.
  200.  
  201. 27 Dec 1991    Changed from req.library to reqtools.library. Added
  202.         some opening conventions (highest of sequence, rule 11,
  203.         ...). Some bugs in bidding system fixed.
  204.  
  205. 03 Jan 1992    Added code to handle NTSC machines. Unless a PAL screen
  206.         can be opened (with kickstart 1.x I don't know how to
  207.         do that on an NTSC machine) the program will abort.
  208.         Added options 'Delay obvious moves' and
  209.         'Alternate colors'. Version 1.01, uploaded to ab20.
  210.  
  211. 06 Jan 1992    Added support for NTSC machines.
  212.         Kickstart 2.0: If the required hardware is present and
  213.                    a PAL monitor driver is installed, a
  214.                    PAL screen is opened.
  215.                    Note: a PAL monitor driver MUST be present,
  216.                    place PAL in WBStartup!
  217.         Kickstart 1.3: If the required hardware is present Amiga
  218.                    Bridge will ask the user if a PAL or an
  219.                    NTSC screen should be opened.
  220.         Some bugs fixed.
  221.  
  222. 16 Jan 1992    Some code optimizations. Added options to load / save
  223.         distributions. Version 1.02, uploaded to ab20.
  224.  
  225. 20 Jan 1992    Removed the option to switch to PAL on NTSC machines
  226.         running kickstart 1.3. A reset seems to be required to
  227.         make it work properly on all machines.
  228.         I don't like the idea of user-software making resets -
  229.         use a stand-alone PAL converter instead.
  230.         Also, the "normal" version should work with an MC68000
  231.         this time. The last one didn't (due to an error in my
  232.         makefile; one file was optimized for MC68020 => GURU).
  233.         Stupid mistake.    Version 1.03, uploaded to ab20.
  234.  
  235. 06 May 1992    Fixed some minor bugs. I have been working with other
  236.         things lately and I don't think I'll find any time
  237.         for Amiga Bridge for quite a while.
  238.         That's why I choose to upload this version, even if
  239.         there are only minor improvements.
  240.         Perhaps if some people registered... (hint, hint :-) ).
  241.         Version 1.04.
  242.  
  243. Comments:
  244. ---------
  245.  
  246. o In NTSC mode, only the upper half of the cards is displayed.
  247.   This makes it difficult to recognise some cards.
  248.   I don't intend to fix this. The risk for playing the wrong card is
  249.   small and there is always the Undo function.
  250. o Extensively tested with enforcer and mungwall (still no results).
  251.  
  252.  
  253. ========================================================================
  254.