home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / games / mo.zip / MO.DOC < prev    next >
Text File  |  1990-12-19  |  14KB  |  397 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                   Midnight Oil
  10.  
  11.                                   Version 2.00
  12.  
  13.                               Copyright 1989-90 By
  14.                                    Randy Rasa
  15.                                   18215 Troost
  16.                                 Olathe, KS 66062
  17.  
  18.  
  19.  
  20.      What Is It?     ___________
  21.  
  22.         Midnight Oil, also known as "La Belle Lucie" and "Three Shuffles
  23.         and a Draw", is one of the few solitaire card games that offers
  24.         both challenging play and a reasonable chance to win.  It is also
  25.         highly addictive; once you get into it, you'll be "burning the
  26.         midnight oil" more often than not.
  27.  
  28.  
  29.      Program Requirements     ____________________
  30.  
  31.         Midnight Oil requires 256K of memory, EGA or higher graphics
  32.         capability, and a Microsoft-compatible mouse.  If you are not sure
  33.         you have the right hardware, just run the program.  If there's a
  34.         problem, the program will let you know.  Incidentally, the text-
  35.         mode-only version of Midnight Oil is still available on request,
  36.         for those of you without EGA graphics.
  37.  
  38.  
  39.      Using The Mouse     _______________
  40.  
  41.         The mouse pointer will appear as a white arrow with black edges.
  42.         In general, the left button is used to select the object being
  43.         pointed to (a card or a button), while the right button is used to
  44.         exit menus or prompts.
  45.  
  46.         If you have a three-button mouse, the middle button will blank the
  47.         screen.  This can also be accomplished by pressing the left and
  48.         right buttons simultaneously.
  49.  
  50.      How To Play     ___________
  51.  
  52.         Midnight Oil uses a standard 52-card deck (no jokers).  To begin
  53.         the game the deck is shuffled, then dealt face-up, one card at a
  54.         time, into seventeen piles of three cards each.  The last card is
  55.         placed by itself as an eighteenth pile.  These piles are also known
  56.         as "fans".
  57.  
  58.         The object of the game is to move all of the cards from the
  59.         eighteen fans into four new piles, arranged by suit, in order from
  60.         Ace (low) to King (high).  These four destination piles are known
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.      Midnight Oil Documentation                                      Page 2
  72.  
  73.  
  74.         as the "foundations".  Only the top card of each fan is available
  75.         for play.
  76.  
  77.         In addition to moving cards from fans to foundations, cards can
  78.         also be moved from one fan to another, building down in suit.  In
  79.         this way submerged cards can be freed up for play to the
  80.         foundations or to other fans.  Once a fan becomes empty (which will
  81.         be represented my a dashed line where the fan was), no moves can be
  82.         made to that fan.
  83.  
  84.         When you have made all the moves you can, from the fans to the
  85.         foundations and from fan to fan, the remaining cards in all the
  86.         fans may be reshuffled and re-dealt in the same manner as at the
  87.         beginning of the game (three cards to a fan).  In all, the deck may
  88.         be shuffled three times (once to begin the game, and twice more
  89.         during the game).
  90.  
  91.         At some point during the game, you may draw one submerged card from
  92.         a fan and play it on any valid foundation or fan.  It is generally
  93.         better to save this draw for as long as possible.
  94.  
  95.  
  96.      Buttons     _______
  97.  
  98.         Along the right side of the screen are a number of "buttons", which
  99.         may be selected by pointing and clicking with the mouse.  The
  100.         buttons are:
  101.  
  102.            Shuffle: This button will initiate a shuffling of the deck, in
  103.               which all of the cards in the fans are picked up, shuffled,
  104.               and then re-dealt.  If no shuffles are left, the program will
  105.               display the message "No shuffles left".
  106.  
  107.            Draw: When you select this button, you will be asked to select a
  108.               pile (fan) to draw from.  When you select a fan, it will be
  109.               displayed in the lower right corner of the screen, and you
  110.               will be allowed to select one card from that fan to draw.  If
  111.               you change your mind and decide that you don't want to draw a
  112.               card after all, press the right button to exit draw mode.  If
  113.               you select a card, it will be removed from the fan and
  114.               displayed in the lower right corner of the screen, and you
  115.               will be prompted to select a destination.  Point to the
  116.               desired fan or foundation and press the left mouse button to
  117.               move the drawn card to the selected fan or foundation.
  118.  
  119.            Peek: This is similar to a draw, in that an entire fan will be
  120.               displayed in the lower left corner of the screen, but you are
  121.               only allowed to look, not touch.  To exit peek mode press the
  122.               right mouse button twice.
  123.  
  124.            Options: This button brings up the options menu, which you can
  125.               use to set your preferences for the following:
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.      Midnight Oil Documentation                                      Page 3
  138.  
  139.  
  140.               Sound: Select "Off" to disable the beeps, click, and various
  141.                  other noises the program makes.  Select "On" to enable the
  142.                  sounds.
  143.  
  144.               Auto Mode: When this is set to "On", the program will attempt
  145.                  to move cards from the fans to the foundations
  146.                  automatically.  This will relieve you from having to worry
  147.                  about missing obvious moves, so that you can concentrate
  148.                  on strategy.  When this is set to "Off", the game is
  149.                  essentially in manual mode, and you will need to make all
  150.                  moves to the foundations by yourself.  This option is
  151.                  provided for those traditional-minded souls who might
  152.                  consider auto mode to be cheating.
  153.  
  154.               Background Color: Click on the up-arrow and down-arrow to
  155.                  step through the available background colors, until you
  156.                  find one that suits your tastes.
  157.  
  158.               Once you've set things to your liking, you may click on the
  159.               "OK" button to save your preferences to disk, or on the
  160.               "Cancel" button to exit the Options menu without changing
  161.               anything.
  162.  
  163.            Undo: This button allows you to undo the last inter-fan move,
  164.               that is, the last move from one fan to another.  You cannot
  165.               undo moves to the foundation, a shuffle, or a draw.
  166.  
  167.            Help: This button will bring up several pages of help screens,
  168.               which you can view by clicking on the "Next" or "Prev"
  169.               buttons to move from page to page.  When you are finished
  170.               reading the help, click on the "Done" button to exit.
  171.  
  172.            New Game: This button will end the current game, update your
  173.               statistics, and start a new game.  Note that the stats will
  174.               only be updated if you have a score greater than zero.  This
  175.               allows you to evaluate the layout of the cards and, if you
  176.               don't like what you see, to begin a new game without having
  177.               it count against you.
  178.  
  179.            Quit: Click on this button to exit the program.  If you have a
  180.               score greater than zero, your statistics will be updated and
  181.               displayed briefly before returning you to DOS.
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.      Midnight Oil Documentation                                      Page 4
  204.  
  205.  
  206.      Statistics     __________
  207.  
  208.         Midnight Oil keeps track of the score (the number of cards you've
  209.         moved to foundations) and the number of shuffles and draws you have
  210.         left during the course of the game.  Also displayed are the total
  211.         number of games you've played, the number of games you've won
  212.         (expressed as both a number and a percentage, and your average
  213.         score.  At the end of each game, the statistics are written to
  214.         disk, either in the default MO.DAT or in the data file specified on
  215.         the command line.  The data file also contains the preferences you
  216.         set in the options menu (sound on/off, auto mode on/off, and
  217.         background color).
  218.  
  219.         To specify a data file on the command line, start up Midnight Oil
  220.         with the following syntax:
  221.  
  222.                                   MO filename.ext
  223.  
  224.         This allows several different people to use the same copy of
  225.         Midnight Oil on the same machine, yet keep separate statistics for
  226.         each person.  For example, suppose three people (Tom, Dick, and
  227.         Harry) played the game at various times on the same machine.  They
  228.         could each easily keep personalized data files, containing their
  229.         scores and preferences for sound, auto mode, and background color.
  230.         Tom would use his data file by typing:
  231.  
  232.                                     MO TOM.DAT
  233.  
  234.         Likewise, Dick and Harry could have data files called DICK.DAT and
  235.         HARRY.DAT.  Note that the "DAT" extension could be "SCR" or "HGH",
  236.         or whatever, as long as it is three letters or less.
  237.  
  238.         Admittedly, this method is not the most elegant, but it is
  239.         workable, and perhaps a future version of the game will provide an
  240.         easier and robust approach.
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.      Midnight Oil Documentation                                      Page 5
  270.  
  271.  
  272.      Legalese     ________
  273.  
  274.         Midnight Oil is shareware.  As such, you can play it, copy it, and
  275.         give it away as you wish.  In fact, you are encouraged to
  276.         distribute the program to friends, family, and strangers alike.
  277.         This includes distribution via electronic bulletin board systems
  278.         (BBS), user's groups, and disk-distribution services.  All that I
  279.         ask is that the program remain in an archive consisting of:
  280.  
  281.            MO.EXE ............. the program
  282.            MO.CD1 ............. card definition file #1
  283.            MO.CD2 ............. card definition file #2
  284.            MO.DOC ............. documentation
  285.            REGISTER.PRN ....... registration form
  286.  
  287.  
  288.      Registration     ____________
  289.  
  290.         Midnight Oil is shareware.  If you enjoy the game, please support
  291.         it.  Registration is only $5, for which you will receive the latest
  292.         version of the program (without the shareware "reminder" message).
  293.         As a bonus, the balance of the distribution disk will contain
  294.         "goodies" (other games and utilities I've written that you may
  295.         enjoy).  Some of these products are:
  296.  
  297.            Poker Squares: A text-mode card game that is also known as Poker
  298.               Solitaire.  In this game you pull cards one at a time from
  299.               the deck, placing them on a 5 x 5 matrix, trying to form the
  300.               best poker hands in the five rows and five columns.  The game
  301.               can be played on color or monochrome systems, and will use a
  302.               mouse if one is available.  The top ten scores are kept on
  303.               disk.
  304.  
  305.            Strategy: This is a solitaire card game that requires skill,
  306.               luck, and concentration.  It runs in color or monochrome, and
  307.               requires a mouse.
  308.  
  309.            Concentration: A text-mode version of the classic memory-
  310.               stretching solitaire.  It features 8 selectable card backs,
  311.               mouse support, runs on any monitor, and keeps the top ten
  312.               scores on disk.
  313.  
  314.            Barrel Dodge: A simple, fun arcade game that tests your skill in
  315.               avoiding the plague of rush-hour traffic: those nasty orange
  316.               barrels.  The program runs on any monitor and keeps a list of
  317.               best scores on disk.
  318.  
  319.            Advance Notice: A handy utility to help you keep track of family
  320.               birthdays, anniversaries, and special occasions.  It is meant
  321.               to be included in your AUTOEXEC.BAT file, to let you know
  322.               ahead of time what events are coming up.
  323.  
  324.            Mah Jongg Tile File Manager (MahMan): This is a utility program
  325.               for the shareware program Mah Jongg by Nels Anderson.  It is
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.      Midnight Oil Documentation                                      Page 6
  336.  
  337.  
  338.               a "front end" for Mah Jongg, allowing you to select a tile
  339.               set from a list of available tile files.  Makes it easy to
  340.               manage a large collection of tile sets.
  341.  
  342.         I am adding new programs all the time, so I'll probably send along
  343.         whatever I can fit on one disk, using the newest programs first.
  344.         As you can see, you get a lot of fun and useful software for just a
  345.         little dough.  Please consider registering.
  346.  
  347.         You may print out the registration form by entering the following
  348.         command from the DOS prompt (with your printer connected and
  349.         ready):
  350.  
  351.                                COPY REGISTER.PRN PRN
  352.  
  353.         Then just fill out the form and send it, along with cash, check or
  354.         money order, to:
  355.  
  356.                                     Randy Rasa
  357.                                    18215 Troost
  358.                                  Olathe, KS 66062
  359.  
  360.      Upgrading To Version 2     ______________________
  361.  
  362.         For those of you upgrading from an earlier version of Midnight Oil,
  363.         the transition should be simple.  The only major new requirement is
  364.         EGA graphics.  The data file (MO.DAT) created by version 1.XX
  365.         should work with the new version without any problems.  The program
  366.         has been substantially rewritten for version 2, and a few features
  367.         have been dropped, a few changed, and a few added.  All in all, you
  368.         should feel right at home.
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.