CD-ROM Magic 1995 #1/CDM_5.ISO/shell/utils/general/classol1.arj/CLASSIC.DOC

Text File | 1994-09-01 | 20.6 KB | 525 lines

█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Classic Solitaire- BBS door game   █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█

Version number:          1.0

Release date:            September 1, 1994

Programmed by:           Tim L Winkfein- McKinney, Texas

Copyright:               (c) 1994 by Tim L Winkfein, All rights reserved.

Registration fee:        $20.00, includes S/H!

Supported drop files:    DOOR.SYS
                         DORINFO1.DEF
                         PCBOARD.SYS
                         CHAIN.TXT

Select  your  drop file in this order, if your system supports DOOR.SYS  then
use  it as first choice. A problem could arise if you select PCBOARD.SYS  for
your  drop file when your system also uses DOOR.SYS, Classic Solitaire  looks
for  DOOR.SYS first, so if it finds it, it will use it, even if it is not the
one your BBS set-up for Classic Solitaire!

If your BBS uses a drop file other than one directly supported, you will need
to use some type of conversion utility to convert it to a supported format.


█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Acknowledgments                     █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█

Thanks to the guys at Triumph Software, they have THE best comm driver going.

TriDoor Communications and on-line Door Driver
(c)1992,1993 Triumph Software, All Rights Reserved.
[phone] / [phone]


Thanks to the three  best BBS SysOp's on the planet,  for ALL of their  time,
patience, and help  during development and  Beta testing of Classic Solitaire
on their systems.

(in order of appearance)

Jim Green
Castle Rock BBS
[phone]

Sonny Grissom
The Old Poop's World BBS
[phone]

Stan Gunn
Blue Event Horizon BBS
[phone]


A special thank  you to all of the wonderful  players on  Castle Rock BBS for
their patience during the "NO CARRIER" phase of development!


█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Licensing agreement                 █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█

By  registering Classic Solitaire you are granted a users license that  gives
you  the  right  to use the Classic Solitaire door game under  the  following
conditions:

You are granted rights to use Classic Solitaire on a single BBS System.

You do not  become an owner of Classic Solitaire, you become a licensed user.
TiJaSoft and Tim L Winkfein retains all rights to the software, copies of the
software, and all materials pertaining to this product.

You  must  agree  to  protect the registered copy of Classic  Solitaire  from
unauthorized use, reproduction, and distribution to a reasonable degree.

Failure  to  comply with this license agreement will result in suspension  of
your License to Classic Solitaire without refund.


█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Warranty                            █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█

This  software product is provided "as is" and without warranty of any  kind.
The risk of using this program is completely assumed by you. I, the author of
this  Classic Solitaire door game, disclaim any and all responsibilities  for
any  undesirable  results  caused by the use,  or  misuse  of  this  product,
including system damage, loss of profit, or anything else that may occur.


█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Shareware                           █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█

Classic Solitaire is being marketed under the SHAREWARE concept. you may  use
the  Shareware version free for a period of time not to exceed  thirty  days.
Thirty  days  is  more  than ample time to evaluate the  usefulness  of  this
product.  After this trial period, you must either register Classic Solitaire
and  obtain  your  license, or discontinue usage of  the  game.  Please  help
support the Shareware concept and register this program!


█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Game Features                       █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█

Easy set-up and configuration.

Make-up days. (Registered version only)

Automatic daily and monthly maintenance.

Configuration file editor for easy and complete game control.

Customizable by changing colors of game and adding initials to card back.

Redraw option for line noise, etc.

Automatically tracks last months champion and all-time champion.

Full ANSI support.

Optionally keep log file of game activity.

Chat window.

Page user that may have left the keyboard with a function key.

DOS shell.

Add or decrease time allowed in door with function key.

Force user back to BBS with function key.

Carrier drop detection.

5 Minute time out detection.

Printed manual. (Registered version only)

Discounted prices on future upgrades. (Registered version only)


█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ How to register                     █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█

TiJaSoft will accept cash, check, or money orders drawn in U.S. funds.

Please see the file ORDER.FRM included in this package for an order form that
you  can  print-out  or  copy.  Fill it out  completely  with  all  requested
information and send it along with payment to the address on the form.

If possible, edit that file with all requested information with a text editor
before printing, doing this will help avoid confusion's in penmanship.


█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Installation                        █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█

Installation is simple, even if you have never set-up a door program  before.

First:  create a  sub-directory for the door game and  copy  all  of  Classic
Solitaire's files into it.

Next:  you should run the configuration file editor "EDIT_CFG.EXE"  to set up
the path to your BBS drop file,  and the other configuration options, Classic
Solitaire must be able to find your BBS's drop file to run.

Then:  Execute the "CLASSIC.EXE" file to run, it will automatically detect if
you are running remote or local, and display the necessary information in the
status bar at the bottom of the screen.


*** Classic Solitaire's  directory  must be current to  run,  you may need to
create a batch file to change the directory to  run the game,  then change it
back afterwards, if your BBS requires its directory to be current.


--- The first time Classic Solitaire is executed, it will create three files:

CLASSIC.CFG-
This is the configuration file. It is a DOS text file that contains alterable
items that change the way the game functions. Discussed in detail below.
*  This  file  will  be  created  if you don't  create  it  first  using  the
configuration file editor.

CLASSIC.DF1-
This  is  the  main  binary data file that holds all player  information  and
scores for the entire month.

CLASSIC.DF2-
This  binary  file stores last months champ, all time champ, current  leaders
and a few other items necessary for the program to have.

If, for some reason, any of these files become corrupt, you can simply delete
them and allow the program to re-create them upon execution.

** If you delete the data files, ALL PREVIOUS RECORDS WILL BE LOST!


additional note: Classic Solitaire has not been extensively tested on  multi-
node systems.  It should  work on multi-nodes but may require  some  creative
configuring on your part.


█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ EDIT_CFG.EXE- config file editor    █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█

This  configuration file editor is a very handy device. It will allow you  to
easily  edit Classic Solitaire's configuration file "CLASSIC.CFG". Start  the
editor  by executing  EDIT_CFG.EXE,  once  the  main  (and  only)  screen  is
displayed, you can TAB, press ALT + highlighted letter, or click on the  item
of choice with your mouse to activate it. Once the line that you want to edit
is highlighted, simply  type in the new value for that line to change it.

The current configuration values are loaded in as the  defaults, so you don't
have to re-enter the configuration items that you don't need to change.

When  all of the information is entered as you want it, you can select "Save"
to  save  the  new information to the configuration file, or you  may  select
"Abort" to quit the editor without saving your changes.

You  can  run  the editor as often as you like, and whenever  you  want.  The
changes you make will take effect the next time Classic Solitaire is run.


█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ About the CLASSIC.CFG file          █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█

Before  running Classic Solitaire, the configuration file should be  created.
This can be done two different ways, the best way is to use the configuration
file  editor included with this package, using this you can set the  Path  to
the  BBS  drop file along with other items. The other way is with  the  first
execution  of Classic Solitaire, it will create the configuration  file  with
the  start-up defaults. If your BBS drop file is in your DOS PATH  statement,
this will work, if not, you will have to run EDIT_CFG.EXE to set-up your drop
file path.
A  file named CLASSIC.CFG will be created. This ASCII text file contains  the
configurable aspects of the game, listed below.

Listed  below  are the actual defaults of the configuration  file,  the  line
numbers have been added for detailed instructions.

     1) C:\BBS\
     2) 2
     3) 10
     4) 5
     5) 2
     6) 4
     7) 1
     8) SOL
     9) N


Line # and Description

1) The first line is for the path to your BBS drop file.
          DEFAULT: C:\BBS\

2) This is the number of regular games that you will allow your users to play
   each day, this is not including free games.
          DEFAULT: 2 games per day.

3) This  line holds the MAXIMUM number of games your users will be allowed to
   play each day, this is including free games.
          DEFAULT: 10 games maximum per day.

4) This  number  controls the number of times your users are  allowed  to  go
   through the deck each game.
          DEFAULT: 5 rounds per game.

5) This  line controls  the number of make-up days your users are allowed  to
   play each day. This is in addition to their current days play.
          DEFAULT: 2 make-up days allowed per day.

6) This number controls the main display color of the game. This includes the
   main frame, the upper & the lower status bars, and the View Scores screen.
     Valid colors are:   1- blue
                         2- green
                         3- cyan
                         4- red
                         5- magenta
                         6- brown
                         7- gray
          DEFAULT: 4- red.

7) This  number controls the color of the card's back. The same color choices
   as above are active.
          DEFAULT: 1- blue.

8) This  is  the 3  character message that is displayed on the  back  of  the
   cards, it can be any 3 ASCII characters.
          DEFAULT: 'SOL'.

9) This line is a simple Y/N option that tells the program whether to keep  a
   log file of game activity or not. A "Y" here will instruct Classic to keep
   a log file named "USER.LOG" in the current directory, anything else and it
   will not keep a log file.
          DEFAULT:  'N', no log file kept.


█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Automatic daily and monthly reset   █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█

Classic Solitaire  will automatically reset all  of the daily statistics with
the first player of each day.

Classic Solitaire will also reset for the month with the first caller of each
month.  The  player file will be re-initialized with no players, the  records
file  will  be updated with a new Last Months Champion and All Time  Champion
(if applicable), and all players, scores, and other data from last month will
be  exported to a file named "LASTMNTH.TOP" in Classic Solitaire's directory.
This  is  the file that is displayed when a user elects to view last  month's
scores  from  the start-up or exit menu and is a DOS text file that  you  can
edit if necessary, or if you want to add your own comments for your users  to
see.  This  file is over-written each month with the new scores, simply  copy
this file under a new name each month if you want to keep all scores.

* Classic Solitaire will look for a file named "LASTMNTH.TOP" to display last
months scores, so do not just rename it.


█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ How To Play Classic Solitaire       █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█

There are many different ways to play Solitaire. It seams like everyone plays
at  least,  a little differently. The rules I used in writing this game  are,
for the most part, the rules established in the book "The new complete Hoyle,
revised" published by Doubleday, with a couple of minor modifications to help
improve your chances of winning.


--- Object of the Game ---

The object of the Classic Solitaire game is to use all of the 52 cards in the
deck to build up all four suit stacks from Ace to King.


--- Cursor and card movement ---

This  game is best played using the number keypad on the right side  of  your
keyboard.  The  keystrokes  used are laid out  in  as  simple  a  pattern  as
possible, plus these keys are the standard for most card games.

[Key]     Reaction

[ENTER]   Spreads a new set of play cards from the stock pile, if any. If all
cards have been spread, this will replace the cards to the stock pile, if you
have  any rounds remaining. ENTER will automatically place the cursor on  the
next playable card on the talon.

[5]        The "5" key is the card movement key. Position the cursor over the
row  of the card you want to move (or over the talon) and press "5" to select
that card, then move the cursor to the row where you want to move the card to
and press the "5" key again to place the card. The game will not allow you to
make an illegal move.

[4,6]           Press "4" to move to the row to the left, or "6" to  move  to
the  row to the right. If the cursor is on one of the end rows, it will  wrap
to  the other side. These keys have no effect when the cursor is on the talon
unless  a card is selected, if a card is selected, press "4" to jump  to  the
right row, "6" to jump to the left row.

[2]        Press the "2" key when you want to move between the rows  and  the
talon. pressing "2" while on one of the top rows will place the cursor on the
next  playable card on the talon, pressing "2" while on the talon will  place
the cursor on the row you were last on before moving there.

[8]        Press  the "8" key to play a card on its suit stack. Position  the
cursor  over  the row (or on the talon) of the card you want to move  to  its
suit  stack  and  press "8". This will automatically move that  card  to  the
correct suit pile and credit your account 100 points.


--- Rules of the Game ---

Solitaire has four game areas:

Stock  pile- Located at the lower left of the playing area, these  cards  are
always face down while in stock.

The  Talon- This is the play stack located next to the stock. These  are  the
cards spread from stock, and only the top most card is playable.

Suit stacks- Located at the upper left of the screen, this is where you build
the  suits from Ace to King. The suit stacks start out empty, and once a card
has been played here, it cannot be moved.

The Tableau- This is the main play field consisting of seven rows. The number
of cards in each row increases from one to seven, from left to right. The top
card  of  each  row is face up, and is playable, the rest are face  down  and
cannot be played.

You draw cards from stock three at a time and move the top "playable" card to
its suit stack or to a row if you can. The number of cards remaining in stock
is displayed to the left of the stock pile.

When  you have used all the cards from the stock pile, you can "turn the deck
over" and continue to draw cards, the number of times you can go through  the
deck is set by the SysOp, but defaults to 5.

You  build  the rows in descending order, alternating between red  and  black
cards.  For example: a red 7 can only be played on a black 8. Suit  does  not
make  a difference unless playing to the suit stacks. All face-up cards on  a
row must be moved as a single unit.

You  can  move  a  card in a row to another row or to a suit  stack.  If  you
uncover  a  face-down card in a row, the program will turn the card  face-up.
You can only move a King to an empty row.

You  build the suit stacks in ascending order, starting with the Ace. You may
only  move an Ace to an empty suit stack. You win the game when you have used
all cards in the deck to build the four suit stacks up to the King.


--- Scoring ---

You are awarded 100 points each time you play a card to its suit stack, for a
total of 5200 points for winning the game.

You  receive a 500 point bonus each time you move all four of the same  value
card  to  their  suit stacks, for example, play all four Aces to  their  suit
stacks,  all four twos, all four threes, etc. through the Queen, for a  total
of 6000 points for winning the game.

When you move all four Kings, i.e. win a game, you get a free game and a 5000
point bonus!

The grand total for winning the game is 16200 points.


█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Included files                      █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█

This  list of files are the files found in the archive, and does not  include
those created during program execution.

     CLASSIC.EXE    - Main executable program.

     CLASSIC.HLP    - On-line help file used in the program.

     CLASSIC.DOC    - Your reading it!

     EDIT_CFG.EXE   - Stand alone configuration file editor.

     FILE_ID.DIZ    - Description file used by some BBS's.

     ORDER.FRM      - Registration form for Classic Solitaire.

     README.TXT     - Quick-start and last minute info text file.


█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Distribution                        █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█

You  are allowed, and even encouraged to distribute the Shareware version  of
Classic  Solitaire,  provided  that  all  files  contained  in  the  original
CL_SOL10.ZIP  archive are packed in their original, unmodified state.  Please
give this to all of your friends and upload it to all of your favorite BBS's.

The  registered  version of Classic Solitaire MAY NOT be distributed  in  any
way, shape, or form. See license agreement above.


█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ The CLUB character                  █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█

One  problem  that plagues most card based door games is the  Club  character
failing to appear on the cards.

This can be controlled by the user. Some communication programs default to ON
for CompuServe quick B file transfers, (sometimes called CIS-B), if it is set
to ON, the communication program will strip the  ASCII  Code  5, which is the
CLUB character used on the card. And could  cause the  program to hang.  Have
your users set this to OFF if the Club character does not appear on the cards
or if the user has problems staying connected.  This configuration option can
generally be found in their communication program's Terminal Set-up area.


█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Technical Support/Who to contact    █
█▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█

I  do  support, and will continue to support all door games that I write.  If
you  have any problems with Classic Solitaire, or any TiJaSoft door game  you
can  contact  me, via US Mail, by voice phone, or by contacting  one  of  the
BBS's  as listed below. Registered users will be notified of any new releases
of  my software, and will receive a very good discount for upgrading, usually
just cover shipping and handling!

Any  comments  or suggestions may also be forwarded to one of  the  following
addresses. Unregistered users must enclose a self addressed, stamped envelope
for any replies to be mailed back to you.


     Mailing Address:    TiJaSoft
                         P.O. Box 313
                         McKinney, Texas
                         75070-0313

     Voice phone:        (214) 562-TiJa (8452)

You may also leave me mail on one of these fine BBS's, I usually check in
daily, so your message will be answered promptly. You can also find all the
latest versions of my software here.

     BBS                      SysOp                     Phone

     Castle Rock              Jim Green                 [phone]
     Blue Event Horizon       Stan Gunn                 [phone]
     The Old Poop's World     Sonny Grissom             [phone]