	This  is  a  popular  version  of  Canfield Solitaire.  Canfield Solitaire is named after the proprietor  of a  famous gambling dive in Saratoga.   This  version is  a cross between Canfield Solitaire and Klondike Solitaire.  The game play is similar too Klondike, but the betting  follows the guidelines of Canfield.  The original game required buying a deck of  cards  for  fifty  (50)  dollars.   This version only costs ten dollars.

The Rules of the Game
Vegas
	The top  28 cards  are dealt  to seven columns--one in the first column, two in the second, and so on,  up to  seven in  the seventh column.   The top  card in  each column  is face up.  The remaining cards in each column are face down.  The last 24 cards  in the deck become the stock pile. The columns  are built  in descending order, alternating between suits (ie. red on black or black on red).  For example,  either the Queen of  Hearts or the Queen of Diamonds can be played on the King of Clubs.  All the face up cards  in a  column must  be moved  as a unit.  Once a column becomes empty, only a King can be played in an empty column. Each time an Ace is uncovered, it should be put on a pile on the right hand  side of the screen.  This is called "foundationing" the card, and the piles are known as the foundation piles.  These piles are built  in ascending  order for each suit.  For example, suppose the Ace of Spades is played on the foundation pile.  The next Spade playable on  this pile  is the Deuce or Two of Spades.  Once a card is played on the foundation pile,  it cannot  be used  later in the game to help move other cards. The cards  from the  stock pile are used when there are no legal plays left to be  made within  the columns.   Stock  pile cards are turned over  one at a time, playing individual cards and columns of cards whenever possible.  Playing a card off the stock pile results in the  preceding card returning to the top of the pile.  The stock pile may only be used once. The object of the game is  eventually to  move all  the cards to the  appropriate  foundation  piles.   After all possible plays are made, and each card in the stock pile has been played or flipped, a dollar is given for each card on the foundation piles.

Classic
	The Classic  game is played the same as Vegas with the following exceptions:
		1.  Cards from the stock pile are flipped 3 at a time.
		2.  When all the cards in the stock pile have been flipped, the stock pile is turned over and may be used again.

Playing the Game
	After Solitaire is loaded, you are prompted to  enter your name. Only upper-case alphabetic characters can be entered, and names are allowed to be a maximum length of 8 characters.  Press RETURN after you have entered your name. Next, you  are asked to enter the game type.  Select 1 for Vegas or 2 for Classic  (See above  for the  differences between  the two game types.) The screen  clears, and  the game  screen is now set up.

	At the top of the screen there are seven cards  face up  in seven columns. The columns  are numbered from left to right.  There is one card in column one, two cards in column two, and so on,  up to  seven cards in the  seventh column.   There is a dividing bar on the right hand side of the screen.  This bar separates  the foundation  piles from the playing columns.  The card displayed at the lower right of the screen is the top card of the stock pile.

	The command  menu is at the bottom  of the  screen.  In the upper right-hand portion of the command menu, "CARDS=" is displayed in  inverse video.   The number on the  right indicates how many cards are left to be played in the column that the cursor is under. At the top of the command  menu, there  is a  small hand  with a pointing finger.   This  is the cursor.  If the cursor is moved off one side of the screen, it will reappear  on the  other side.   The cursor is  used to select individual cards or columns of cards that you wish to play.  The cursor changes to a small card  when you are holding a  card.   Moving the cursor is accomplished using either a keyboard or a joystick.   The  joystick must  be plugged  into port one.

	The current score is displayed in the top rightmost position in the command menu. If using the keyboard, press the left arrow key (+  key) to move left, and the right arrow key (* key) to move the cursor right.  Do not use the control or shift keys when  moving the  cursor with the keyboard.   When using  a joystick, press the joystick left to move left, or right to move right.

	The command menu contains five commands.  The  commands are PICK UP, DROP,  FOUNDATION, NEXT  CARD, and END.  Each of these commands is also performed from either a keyboard or joystick. When picking up a card or a column of cards, position the cursor beneath the  card you are picking up, then press 'P'.  If using the joystick, push up on the stick.  Move the cursor to the column that you wish  to play  the cards.   Press 'D' if using the keyboard, or push the stick  down  if  using  the  joystick.    If  you  wish to foundation a  card, position the cursor beneath the card, and press 'F'.  To foundation a card from the  joystick, position  the cursor beneath the  card, and  push down  on the  stick.  To flip the next card on the stock  pile, press  'N' on  the keyboard,  or press the fire button  on the  joystick.   Finally, pressing 'E' will end the current game.  Note:  Ending  a  game  must  be  executed  from the keyboard.  There is no way to end a game from the joystick.  When a  game is  ended, the  player receives one dollar added to their account for every card played on the  foundation piles.   The ten dollars  for playing  the game are subtracted from the player's account before the game  screen is  set up.   If  you end  the game before the stock pile is exhausted, valuable dollars may be lost. After ENDing  a game,  the screen  is cleared, and the player's weekly and total scores are displayed.

	Beneath  this display, the player is given six options--Play again, Change player, Change game type, Player summary, Point summary, Author Info, and Quit. Pressing 'A' for play  again, results  in playing  another game. You do not need to enter your name again.  This option is used when one player wants to play  consecutive  games.    Pressing  'C', for change player,  results in  another game  being played, but the new player must  enter their  name.   This option  is only  used when a different player wishes to play.  To change the game type, press G. The next option is 'S' for Player summary,  which produces  a table of statistics  for all the players on the disk for the current game type (Vegas or Classic).  The table is  sorted in  descending order by the  player's overall averages.  Dividing the total score by the total games played to  find  the  average.    The  sort  routine is designed in  a manner  that requires  at least  ten games be played before the player is ranked  by  their  true  average.   Therefore, persons playing  only a  few games  are prevented from being ranked higher than those who have played many games. Pressing 'P'  for the  Point summary  also displays  a screen of statistics for  every player on the disk for the current game type. The Point  summary screen  indicates how  many games  a player wins dollars (+),  loses dollars (-), the number of solitaires achieved, and the number of games on average a player plays  before getting a solitaire.  A solitaire occurs when a player successfully plays all the cards from the  stock pile  and game  screen on  the foundation piles.  The screen is also sorted by the total dollar average, even though the average doesn't appear on this screen.  Option  'I', for Author  info,  displays  my  name  and  other titles available from Aussemware. The last option is 'Q', for  quit.    This  option  ends  a game session.    It  is  very  important  to  end you sessions with this option.   When 'Q'  is selected,  it creates  a backup  copy of the player data  file.

	Because this  game writes  to the disk a large number of times, occasionally, the data file may  become corrupted. If there  is a backup data file, the data can be recovered by using the Solitaire file editor.  The  use  of  the  editor  is explained later.   Before ending  a session,  always remember  to view one of the summary screens.  If the data file is corrupted, do not use the Quit option until the data is restored.

	Solitaire recognizes  three special  names; SUMMARY, CLEAR,  and EDIT.  These names are actually  special commands.   If  SUMMARY is entered  for  the  player  name,  the  program  jumps to the player summary screen.  When the player  returns from  the summary screen, he is at the same menu as if he just ended a game.  Pressing 'A' at this menu results  in  the  Change  player  command  being executed because SUMMARY  is a  special name  and cannot be used as a player name.  The other options work in the usual way. The next special command name is CLEAR.  It is used to clear all the player's  weekly games and scores, but this does not affect any of the total games or scores.  Entering CLEAR for  the player names prompts you  to confirm this action.  If 'Y' is entered, the weekly games and weekly scores are reset  to zero  for all  the players on the  disk.    The  program  has  no  way of knowing when a week has passed, so it is the responsibility of a player to CLEAR the scores each week.

	The  Solitaire  File  Editor  is  an integrated program designed specifically for the maintenance of the  Solitaire Date  file.  The program gives  you the  ability to  modify any or all the fields in the data file, and therefore, is  a very  powerful editing program. Because of  its power, a password is required to gain access to the editor.  Initially the password for the editor is "SOLITAIRE". To use the editor,  enter EDIT  at the  name prompt  in the main program  (Solitaire  game).    After  the  program  loads,  you are prompted to enter  the  password.    Enter  "SOLITAIRE",  and press RETURN.    This  grants  you  access  to  the editor.  If access is denied,  carefully  check  your  spelling.    The  program  is very ruthless.  If you have typed the password correctly, you are now at the main  editor menu.   If  you misspell  the password,  or if the password is changed, this message will appear:               Access denied to EDIT thru M$DOUG.

	What does  this message  mean?   To be honest, not much, it just indicates that the password entered, is  not the  password that the editor currently  recognizes.  Some users out there might find that message familiar.  During my college years, I worked on a Honeywell Main Frame  running the  CP-6 operating system.  Any time you would try to access something that you did not  have the  privileges for, CP-6  (as  most  students  called the computer) would reply "Access denied to _____ thru M$____".  Throughout my  college years,  I saw this message  more than  my share  of times.  It is for this reason that I felt compelled to include  this infamous  line in SOLITAIRE. Needless to say, it always gives my friends a chuckle when they see it!

	The file editor screen  is divided  in two  parts.   At the top, there is  a menu  of commands, and on the left side of each command is a number.  To execute a command,  enter the  appropriate number, and press RETURN.  At the bottom of the screen, every player's name in the  Solitaire data  file is  displayed.   Each name  also has a number  to  it's  left.    This  is  the number you always use when referring to a player's record.

	The main editor menu consists of  six options:   Edit  a record, Delete a  record, Toggle  game type,  Change Password, Recover data file, and Quit.  There is no provision for adding  a record  to the data file.   If  you should  ever have  the need to do this, simply play one game under the name  you wish  to add.   After  ending the game,  go  into  the  editor,  and  modify the rest of the player's information. The first command, Edit a record, allows you to modify any field in  a  player's  record.    Press  1 followed by RETURN to use this command.  Once this command  is  selected,  the  main  menu command screen is cleared.  Enter the number of the player you wish to edit at the prompt.  If a valid player  number is  entered, the player's name and first four fields in the record are seen.  At each prompt, the current value of the field that is being modified is shown.  If you wish to change the entry, simply enter the new value, and press RETURN.  If you are changing an entry, the old value is erased from the  screen  as  soon  as  a  valid  key is pressed.  After all the entries are entered, you are asked  if the  record is  now correct. If it  is not,  enter 'N'.   This allows you to re-enter any or all the fields.  When the record is correct, press 'Y'.   The  new data file is saved, and you are returned to the main editor menu.

	The second  option in  the menu is Delete a record.  Use this to erase players from the summary screens.  I like to  keep my summary screens to  one screen  length.   When this option is selected, you are asked to enter  the number  of the  record you  wish to delete. Enter the  number displayed  on the  left hand side of the player's name.  The first five fields of the  players record  are displayed. If you  are sure  this is the record you wish to delete, press 'Y'. Note:   When  a  record  is  deleted,  there  is  no  way  for this information to  be recovered.  Be extremely careful when using this command. Toggle game type allows you  to  toggle  between  the  type data files, one  for Vegas style and one for Classic style.  The current mode is displayed to the right of this command.  Make sure  you are in the right mode before you attempt to edit any data.

	The next command is Change password.  This command allows you to change  the  password  required  to  gain  access  to  the  editor. Passwords must  be at  least 1, and no longer than 10 characters in length.  After typing a password and pressing RETURN, you are asked to verify  the password.   Type  the same password again, and press RETURN.  If the passwords don't match, you must enter  the password again.   When both passwords entered are the same, the new password is written to the editor program.   After  the password  is changed successfully, you are returned to the main editor menu.

	The Recover data option allows you to restore the Solitaire data file.  Because Solitaire writes  to  the  disk  a  large  number of times, occasionally,  the data file crashes.  Every time you 'Quit' the main Solitaire game,  the program  creates a  backup data file. The editor  program uses  this file  to restore the data.  When you quit the main program, Solitaire  only  creates  a  backup  file if there is  more than one record in the file.  If you do not quit the Solitaire game properly, the data is not recoverable. 

	The last option is Quit.  Use this  when you  are finished using the  editor.    This  option  allows you to return to the Solitaire game.  You are returned to the Enter Name prompt.

About the Author

	I am a 25 year old geek and  former Computer  Science student at Indiana University  of Pennsylvania.  Currently, I am spending time at FMC Corporation as a paper weight.  I have no friends, so I have been  programming  on  Atari  computers  for the last 4 years (I am really slow.)  The original version of Solitaire  was written three months after  I bought  my 800xl.  This was my first major program, and it is my pride and joy (you can see that I am still  working on it.)

	Currently I  have a  library of  over 500  programs.  Out of these, Solitaire is still the most played game.  I  have 22 players on my  disk, and  their cumulative  games are  well over 10,000.  I have spent countless hours working  and  perfecting  Solitaire.   I hope you  find it as enjoyable as I have.  If you have and problems with Solitaire, or if you would  like to  see any  modifications, I would like to hear from you.  My address is:

			Douglas B. Fletcher
			14 Windsor Street
			Indiana, PA  15701 

I am looking forward to hearing any comments that you might have.