home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / GA / GA052.ZIP / LABELLE.DOC < prev    next >
Text File  |  1989-09-16  |  16KB  |  334 lines
  1.  
  2.  
  3.  
  4.                               LA BELLE LUCIE
  5.  
  6.                              A Solitaire Game
  7.  
  8.  
  9.                       Release 3.00    September 1989
  10.  
  11.                              Gellman Software
  12.                           431 Fifth Street, S.E.
  13.                            Washington, DC 20003
  14.  
  15.              Programming by George Leotti and Robert Gellman.
  16.    The program and accompanying source codes are in the public domain.
  17.  
  18.  
  19.      La Belle Lucie is a simple but interesting game of solitaire.
  20. Although the game appears to be easy to win, it requires considerable
  21. thought and planning (and some luck) in order to be successful.  The game
  22. is much more engaging than the more familiar Klondike solitaire.  One
  23. reference describes La Belle Lucie as a "fascinating game that pays
  24. handsome dividends to intelligent planning."  All of the program testers
  25. became addicted to the game very quickly.
  26.  
  27.      La Belle Lucie is especially well suited for playing on a computer.
  28. The game requires repeated shuffling and positioning cards, and the
  29. computer handles these mechanical tasks readily.
  30.  
  31.      La Belle Lucie is also known as Clover Leaf, Midnight Oil, and Three
  32. Shuffles and a Draw.
  33.  
  34.  
  35.  
  36. **************************************************************************
  37. *                            PLAYING THE GAME                            *
  38. **************************************************************************
  39.  
  40.      To start the program, just enter LABELLE at the DOS prompt.  If
  41. the file is on a floppy disk, enter A:LABELLE if appropriate.  After the
  42. opening screen, there will be a prompt.  Select the H (help) option and
  43. read the screen.  Play the game for a few minutes, and any uncertainty about
  44. the rules will disappear.  It will take a little longer to become a good
  45. player.
  46.  
  47.      The program will run under DOS 2.0 or better.  The program requires
  48. less than 256K and is compatible with both color and monochrome monitors.
  49. A graphics card is not needed.  If you have a color monitor, but prefer
  50. to play the game in black and white, enter LABELLE/B at the DOS prompt.
  51. A reminder of this switch is provided if you play on a color monitor.
  52. This new feature with Release 3.0 was added in response to a problem
  53. reported by a user.
  54.  
  55.      If you want to start playing, go ahead.  Nothing in this short DOC
  56. file is vital.  Read it once, but the documentation is not worth printing.
  57. The file was created with margins at 5 and 75.  There are form feeds
  58. approximately every 60 lines.
  59.  
  60.  
  61.  
  62.  
  63. **************************************************************************
  64. *                                  RULES                                 *
  65. **************************************************************************
  66.  
  67.      The layout consists of a tableau and a foundation.  When the game
  68. begins, all 52 cards are shuffled and dealt into 17 piles of three cards
  69. each and one pile with 1 card.  This is the tableau.  Four foundation piles
  70. appear above the tableau as the game progresses.  The object of the game
  71. is to move all the cards from the tableau piles to the foundation piles.
  72.  
  73.      Only the top, or right-most, card in each tableau pile is available
  74. for play.  Any available card may be played either to a foundation pile,
  75. or moved within the tableau.
  76.  
  77.      Foundation piles start with Aces and build in ascending order (two,
  78. three, four, etc.), according to suit.
  79.  
  80.      Cards moved within the tableau may only be played to the top card of
  81. another tableau pile in descending order, according to suit.  Thus, the
  82. seven of spades goes on the eight of spades, the six on the seven, and so
  83. forth.  Kings may only be played to their respective foundation piles.
  84. Kings cannot be moved among the tableau piles.
  85.  
  86.      When no more moves are possible or moves would be fruitless, you may
  87. reshuffle the cards in the tableau.  You are allowed two re-shuffles.
  88.  
  89.      After the second re-shuffle, you are allowed a one-time option.  On
  90. the first move, you may draw any card from the tableau and move it to any
  91. legal space in the foundation or the tableau.  This is the only time you
  92. can move a card that is not on the top of a pile in the tableau.
  93.  
  94.  
  95.  
  96. **************************************************************************
  97. *                            HOW TO MOVE CARDS                           *
  98. **************************************************************************
  99.  
  100.      The card to be moved is designated by a two character notation.
  101. The ace of clubs is AC.  The two of spades is 2S.  The ten of hearts
  102. is TH.  The jack of diamonds is JD.  The queen of hearts is QH.  The
  103. king of clubs is KC.  You must hit the ENTER key at the end of the input.
  104. You may use the backspace key to erase.
  105.  
  106.      When you select a card, the computer will first attempt to move it to
  107. a foundation.  If this is not possible, the computer will then search the
  108. tableau for a legal move.  If no move is possible, the computer will let
  109. you know you have made a mistake.
  110.  
  111.      For example, if you enter TC and the ten of clubs is available for
  112. play, the computer will first check the clubs pile in the foundation.  If
  113. the nine of clubs is the top card, the ten will be moved on the nine.  If
  114. the nine of clubs is not on the foundation pile, the computer will search
  115. the top card of the tableau piles.  If the jack of clubs is on top of a
  116. pile, the ten will be moved there.
  117.  
  118.  
  119.  
  120.  
  121.      If a card can be moved to a foundation pile, the computer will scan
  122. the tableau looking for the next eligible card in that suit.  Thus, if 
  123. the ten of clubs can be placed on the nine in the foundation, the computer
  124. will look for the jack of clubs.  If the jack is available (i.e. on the 
  125. top of a tableau pile), the jack will also be moved to the foundation.  
  126. The computer will keep searching for and moving cards in sequence until 
  127. the next card is no longer available.
  128.  
  129.      The automatic move feature has been provided because there is no
  130. reason to leave a card in the tableau if the card can be moved to the
  131. foundation.  The automatic move feature saves many keystrokes during the
  132. course of play.
  133.  
  134.  
  135.  
  136. **************************************************************************
  137. *                            HOW TO FIND CARDS                           *
  138. **************************************************************************
  139.  
  140.      A new feature has been added with Release 3.0.  If you designate a
  141. card in the tableau to be moved, and the card cannot be moved anywhere,
  142. the card will be highlighted on the screen by a small arrow appearing
  143. above the card for a second or so.  
  144.  
  145.      This feature was included because the game calls for a considerable 
  146. amount of searching for cards.  When there are a lot of cards on the 
  147. screen, it can be difficult to spot the card you want.  The computer will 
  148. now find the card for you.
  149.  
  150.      But you must be careful.  If you enter a card that can be moved, the
  151. computer will move it.  If you are still thinking and haven't made up your
  152. strategy yet, this can be a big mistake.  Since it is relatively simply to
  153. see the cards on the top of a pile, you should scan the piles before using 
  154. the highlight feature.  This will be easier than it sounds once you have 
  155. played the game a few times.  You may, of course, ignore the card finding 
  156. feature if you find it to be confusing or disruptive.
  157.  
  158.  
  159.  
  160.  
  161.  
  162. **************************************************************************
  163. *                             OTHER COMMANDS                             *
  164. ************************************************************************** 
  165.  
  166.      To shuffle the deck, enter S at the prompt.  For help, enter H at the
  167. prompt.  To quit the game, enter Q.  The Q command will bring up another
  168. menu that allows you to exit to DOS, start a new hand, or return to the
  169. existing game.
  170.  
  171.      All entries can be in upper or lower case.  Illegal keystrokes are not
  172. recognized by the program.  If you make an illegal entry, the program will
  173. let you know with a light click and an error message.  The message
  174. disappears on its own after a second and a fraction.
  175.  
  176.  
  177.  
  178.  
  179. **************************************************************************
  180. *                                STRATEGY                                *
  181. **************************************************************************
  182.  
  183.      Move all available cards to the foundations immediately.  When moving
  184. a card within the tableau, consider how the move might block other
  185. important cards.  The basic strategy is to THINK and PLAN AHEAD.
  186.  
  187.      Remember that you can't move kings except to a foundation.  Thus, a
  188. card under a king is generally blocked, at least for a while.  Identify
  189. blocked cards and learn how to use them to some advantage.
  190.  
  191.      The free move after the last re-shuffle must be selected with great
  192. care.  Any card blocked by a king of the same suit must be moved or the
  193. game cannot be won.  If two such cards are blocked, then failure is
  194. assured.  
  195.  
  196.      The original documentation suggests that a good player will win about
  197. ten percent of the time.  I haven't kept track of my results, but you
  198. should be able to do that well after you get the hang of the game.   
  199.  
  200.      The scoring for each hand is totally artificial.  The highest score
  201. possible is 100.  It was added in order to provide an incentive to play
  202. after the last shuffle reveals that winning is not possible.  Some players
  203. report that they like to maintain a particular average score.
  204.  
  205.      When you win a game, the computer also offers an audible cheer.  If
  206. you are able to win without using one or both of the available shuffles, an
  207. extra cheer or two is provided.
  208.  
  209.  
  210.  
  211. **************************************************************************
  212. *                         HISTORY OF THE PROGRAM                         *
  213. ************************************************************************** 
  214.  
  215.      This program started its existence as an interpreted BASIC program. 
  216. The original author (George Leotti) rewrote the interpreted program using
  217. QuickBASIC 4.0.  Because of the speed of the compiled version, it no longer
  218. needed an assist from machine language to display the cards quickly, (as
  219. did the interpreted version).  The original compiled version was released
  220. in July 1988, along with the source code.
  221.  
  222.      I found LABELLE.ARC on a Washington, DC, bulletin board in October,
  223. 1988.  I liked the game so much that I decided to rewrite it to make it
  224. easier to play.  I reduced the required keystrokes for input by half,
  225. made the program a bit more efficient, rewrote the opening and help
  226. screens, and eliminated the need for color graphics.  This allows the
  227. game to be played on just about any monitor.
  228.  
  229.      I also added an audible prompt at the second re-shuffle.  This will
  230. remind you that a special option is available.  There is also a visual
  231. prompt, but it is easily overlooked.  The audible prompt is more noticeable.
  232.  
  233.  
  234.  
  235.  
  236.      In making the revisions, I used the PROBAS library of QuickBASIC
  237. programming tools.  PROBAS is a product of Hammerly Computer Services in
  238. Laurel, Maryland.  If you don't have PROBAS, you will not be able to
  239. recompile the revised version (LABELLE3.BAS).  LABELLE3.BAS was compiled
  240. under QuickBASIC 4.5.  I am not sure if it can still be compiled under
  241. QB 4.0.
  242.  
  243.      The original "pure" QuickBASIC source code (LABELLE1.BAS) has been
  244. included to allow everyone the same chance I had to rewrite the program
  245. to suit his or her own needs.  Those who have neither the interest nor
  246. capability to write programs in QuickBASIC can discard both source codes
  247. and save the disk space.
  248.  
  249.      The original author distributed a document file with his program.
  250. This file is based in part on his document.  I am responsible for any
  251. errors or omissions in this document or in the revised program.
  252.  
  253.      Gellman Software does not normally release the source code of its
  254. programs.  But since George apparently released his program into the public
  255. domain, I have followed in his footsteps and released my version as well.
  256.  
  257.      I want to make it clear that the algorithm is entirely George's.  I
  258. took his code and played with it.  He did all of the creative work.  I
  259. never heard of La Belle Lucie before I found his program.  Both versions
  260. follow the same, standard rules for La Belle Lucie.  See Moyse, "150 Ways
  261. to Play Solitaire" 41-42 (1950) (United States Playing Card Company).  I
  262. have not changed any of the rules.  I just added (and subtracted) a few
  263. bells and whistles to George's algorithm.
  264.  
  265.      The program has minimal documentation.  It took me quite a while to
  266. decipher the original algorithm.  George's approach to programming the
  267. game is compact, obscure, and very clever.
  268.  
  269.  
  270.  
  271. **************************************************************************
  272. *                     OTHER GELLMAN SOFTWARE PROGRAMS                    *
  273. **************************************************************************
  274.  
  275.      As of the date of this file, Gellman Software has released five
  276. programs.  They are:
  277.  
  278. POKER565 - Head to Head Draw Poker    (freeware)
  279. 1POKER13 - Poker Solitaire            (freeware)
  280. CALC12   - Calculation Solitaire      (freeware)
  281. LABELLE3 - La Belle Lucie Solitaire   (public domain, with QB source)
  282. SIXLTR30 - Six Letter Word Game       (shareware)
  283.  
  284. The last two programs were coauthored by other programmers.
  285.  
  286.      These programs are available from the Public (Software) Library, P.O.
  287. Box 35705, Houston, TX 77235.  The latest versions are normally sent to PSL
  288. as soon as they are released.  I recommend PSL to anyone interested in
  289. shareware or freeware.
  290.  
  291.  
  292.  
  293.  
  294. ***************************************************************************
  295. *                               FEEDBACK                                  *
  296. ***************************************************************************
  297.  
  298.      If you find any errors in the program or the documentation, please 
  299. let me know.  Please be as specific as possible in describing the problem.
  300. I would also appreciate any other comments -- favorable or unfavorable --
  301. from users.  All suggestions will be considered.  Authors of public domain
  302. programs do not ask you to pay for their work.  A little feedback would be
  303. nice.  If you find a bug or make a suggestion that I adopt, I will send
  304. you a copy of the new version.
  305.  
  306.  
  307.  
  308.  
  309. **************************************************************************
  310. *                               LEGAL STUFF                              *
  311. **************************************************************************
  312.  
  313.      This program and accompanying documentation are provided "as is"
  314. without warranty of any kind.  The entire risk of using the program is
  315. assumed by the user.  Gellman Software disclaims all warranties, either
  316. express or implied.  In no event shall Gellman Software be liable for
  317. any damages whatsoever arising out of the use of or inability to use 
  318. this program.
  319.  
  320.      The program is placed in the public domain.  Therefore, it may be
  321. used or modified without any restriction.  Please upload the program
  322. along with this documentation on computer bulletin boards anywhere.
  323. No registration or other fee is owed to the authors.
  324.  
  325.      Other Gellman Software products are freeware but are copyrighted.
  326. These other programs may be distributed by software clubs, computer
  327. bulletin boards, and shareware/freeware libraries at a standard charge
  328. for media and distribution.  The maximum charge permitted without written
  329. permission from Gellman Software is $6.00.  This restriction does not
  330. apply to La Belle Lucie because it is in the public domain.
  331.  
  332.      Gellman Software asks that software distributors comply with the
  333. same restrictions regardless.
  334.