==========================================================================

                       H  U  S  K  E  R     D  U

                           by  Stephen Ross

                            copyright 1991

 ==========================================================================

 Notice:  This program is copyrighted by Stephen Ross, but may be freely
 distributed, providing that the following rules are respected.

 1.  No changes may be made to the program or to its accompanying
     documentation.
 2.  The package is always distributed in its complete form, consisting of
     4 files: "HuskerDu", "HuskerDu.info", "HDscores" and "HuskerDu.doc".
 3.  Every form of distribution is allowed and encouraged, but no fee can
     be charged for this program except for the cost of duplication.
 4.  Inclusion in PD software libraries is allowed, as long as the fees
     charged for these disks are comparable to the fees charged by Fred
     Fish.
 5.  The program cannot be distributed in any commercial product without
     the written consent of the author.

     By copying, distributing, or using this program, you are indicating
     your acceptance of the above rules.

 ==========================================================================

 The Game:

    May be run from the Workbench or from the CLI.  Click on the icon or
    type "huskerdu" from the CLI.

 The Object:

    Is to complete five levels of play within the time allotted.

 The Rules:

    Are very simple.  Each level, or board, has eight columns.  Your goal
    is to stack different colored bricks on each column.  The only
    restriction is that no two bricks can exist in the same column.  If you 
    try to place two bricks of the same color in the same column, all
    previously placed bricks in the column will disappear and you will have 
    to start that column all over again.

    There are ten different blocks for each level.  Once you place all ten
    bricks in a column, in any order, the column is 'finished' and no
    further bricks can be added to the column.  If you 'finish' all eight
    columns within the alloted time, then you have completed the board and
    you will advance to the next level, or board.  Completing five levels
    wins the game.

 Brick Selection:

    Is done via the three bricks placed at the top of the screen.  You have
    your choice of either of the three.  Use the keyboard controls to
    highlight the brick you want.  If none of the three are acceptable, you
    may change the color of all three by pressing the appropriate key.  Use
    this option judiciously as you have a limited number of changes.  Once
    you use up all of your changes, you must select one of the three
    bricks, even if it means putting two bricks of the same color in the
    same column.  Of course, this will wipe out the column.

 Brick Placement:

    Is done by moving the arrow below the columns and pressing the
    appropriate key.  The brick selected from the three at the top of the
    screen will then be placed in the column you have selected.  

 Scoring:

    Depends on the skill level chosen.  The higher your skill level, the
    more points you get for each brick properly placed in the column.
    Points are deducted for placing two of the same bricks in the same
    column.  If you complete the board with time remaining, then you are
    given bonus points for each unused second.  The higher your skill
    level, the more bonus points you get.

 High Scores:

    Are loaded in from disk when the game is first started.  If you make
    the top ten, your score will be saved to disk.  Keep all of the Husker
    Du files in the same directory to avoid problems saving or loading.

 Skill Levels:

    Determine both the scoring and the time available for you to complete
    each board.  The higher the skill level, the less time you have to fill
    up all eight columns.   Skill levels also determine how many times you
    can change the colors of the three bricks at the top of the screen.
    The higher the skill level, the fewer changes you can make.

 The Menus:

    Are pretty much self-explanatory.  Sound effects may be toggled on or
    off.  Skill levels can be chosen.  The game can be paused or stopped.
    A shortened version of this documentation file can be accessed online.

 The Keys:

    Control the selection of the brick from the three at the top of the
    screen and the placement of the selected brick in the column you
    choose.  In recognizing that people have different opinions regarding
    which keys are the most comfortable to use, I have set up the game to
    allow two separate keyboard combinations, one using the numeric keypad
    and the other using keys at the bottom of the keyboard.  The key
    selections listed below can be used independently or in combination
    with each other.   

   
                                  KEYPAD        KEYBOARD 
   
    Move Arrow Left:             1      or      Z
    Move Arrow Right             3      or      /
    Place Brick in Column:       2      or      space bar

    Select Top Brick (left):     4      or      A
    Select Top Brick (right):    6      or      ' (apostrophe)
    Change Top Bricks:           5      or      <Enter>

 In Conclusion:

    Have fun.  If you have any questions, comments, or reports of bugs,
    I can be contacted on GEnie.  Send E-mail to: S.ROSS4

    This program was written in F-Basic v3.0 (Delphi Noetic Systems)