CTOS  Chess
                                 -----------

Version: 3.5
Released: October 1992.


Installation:  Use Installation Manager or Software Installation commands.


  CTOS Chess is a public domain program originally written in Fortran.


  Two Font files are released with CTOS Chess:

      Chess.26.Font  - for B24, B26, B28, B38, B39
      Chess.27.Font  - for B27 only

  The file "Chess.Config", which will be installed into the 
  directory, permits renaming of the Font file and the optional Audit and
  Save files.  It also allows for setting some of the hard-coded game defaults.
  List or Type "Chess.Config" for further details.


    Known bugs and restrictions:
    ----------------------------

  1.  CTOS Chess releases 3.3 and up will not run on CPU's lower than B24's,
      i.e B21, B22.
  2.  Problems may occur if Chess is run using the Classic operating
      system.  The game was written and tested using the BTOS II and
      CTOS I operating system.
  3.  Different skill levels are not implemented.
  4.  The game cannot play against itself (demo mode).


    Changes in Release 3.5:
    -----------------------

  1.  The 'Setup' command has been implemented for setting up game positions.
  2.  Pawns may be promoted to pieces other than Queens.


    Changes in Release 3.4:
    -----------------------

  1.  Chess now works correctly on B39 systems (thanks to Kris Van Bogaert
      for supplying the patches).


    Changes in Release 3.3:
    -----------------------

  1.  Code for older CTOS hardware, e.g. B21, B22, has been removed.
      Chess will only run on systems that support soft font files.
  2.  The Restore function now allows 'Pause' and 'Resume' by use of
      the  and  keys - see under commands below.
  3.  Chess will now accept moves without a delimeter between the 'from'
      portion and the 'to' portion, e.g. "D2D4" is legal.
  4.  A bug where Chess would allow castling when an opposition pawn was
      on the King's Pawn square and the king would have to pass through
      check to complete the castling move has been fixed.
  5.  If a game where CTOS was playing White was Saved, then Restored, and
      then Saved again, the Restore of the second Saved game would not work.
      This has now been resolved.



    Chess Commands:
    ---------------

      AUDIT    - Toggles the Audit Trail option.
      BEEP     - Toggles the Beep flag.
      DRAW     - Ask for a draw. (not implemented).
      HELP     - Displays help information.
      QUIT     - Stops the game.
      RESIGN   - Give up a lost position.
      RESTORE  - Restore a saved position.
      SAVE     - Save current position.
      SETUP    - Setup game position.
      O-O      - Castle Kingside.
      O-O-O    - Castle Queenside.

    Commands may be abbreviated to the shortest form that still
    allows the command to be recognized,
    e.g. RESIGN can be abbreviated to 'RESI' but not to 'RES' as
         this will be confused with the RESTORE command.

    To move a chessman, enter the location the piece is moving from,
    a hyphen (optional) and the location the piece is moving to.
    An example is a pawn move from location E2 to E4.
    Your command would be entered as: E2-E4 (or: e2-e4).
    CTOS might counter with a move of E7-E5.
    When CTOS takes a man it will change the hyphen to an 'x'.
         Example:  E5xD6

    When a pawn reaches the 8th rank, CTOS will automatically promote
    it to a Queen.  If you want to promote your pawn to a piece other
    than a Queen, specify the required piece in parenthesis immediately
    following the move that places the pawn on the 8th rank, e.g.

            D7-D8(K)

    this will promote the pawn to a Knight.
    The mnemonics to use when promoting pawns are:
        B = Bishop
        K = Knight
        R = Rook
        Q = Queen

    All keyboard input can be in upper or lowercase.

    No matter what colour you select the board will always display your
    pieces facing you.


    Keyboard Entry
    --------------

        Key        Action
        ---        ------

        GO         Any one of these three keys can be used to
        NEXT         terminate a move or command entry.
        RETURN

        BACKSPACE  These two keys are used to delete one character
        DELETE       at a time.

        CANCEL     Deletes current entry.
        FINISH     Same as Quit.
        HELP       Displays help information.

        CANCEL     Used to terminate Restore early.
        MARK       Used to pause the Restore function.
        BOUND      Used to resume the Restore function.


       Commands in detail
       ------------------

    AUDIT
    -----

    This is used to toggle the Audit Trail flag.
    The chess program stores each move in an array in memory regardless
    of the setting of the Audit flag.
    If the Audit option is not set at the start of the game but is set
    at some point during the game, all the moves up to that point in the
    game will be written to the Audit Trail from this memory array.
    Once the Audit flag is set all subsequent moves will be written
    to the Audit Trail until the option is reset.

    If the Audit flag is reset after Auditing has started, all following
    moves will be lost.

    If the Audit flag is set, entering this command will stop the
    auditing of moves to the Audit file, but will not close the file.

    The Audit flag can be set via an option in the Chess.Config file.
    Read the documentation in this file for further information about
    the available Audit options.


    BEEP
    ----

    If the Beep option is set, a Beep will sound each time that CTOS
    makes a move.
    Entering the BEEP command at any time during the game will toggle
    the current setting of the option.

    This option can be set via an entry in the Chess.Config file.
    Also refer to the "RestoreBeep" option in the Config file.


    RESTORE
    -------

    The Restore command is used to restore a position that has been
    saved in the Save file using the SAVE command.

    The Restore command must be entered at the beginning of the game,
    before you select the colour to play (it is invalid at any other
    time during the game).

    When the Restore command is entered, a Menu screen will be displayed
    listing the game positions available in the current Save file.

    You select the position that you want restored by entering the Slot
    number and pressing , , or .

    The saved position will be restored by replaying each move from the
    beginning of the game until the saved position is reached.

    The Restore function will pause before replaying each human move to
    allow you to halt the game at any time by pressing the  key.
    To pause the Restore function temporarily press the  key.
    To resume the Restore function press the  key.


    SAVE
    ----

    The Save command will store the moves making up the current position
    in a Save file.
    These moves can then be replayed at a later time and the current game
    position restored.

    A move can be 'taken back' by Saving the game, initiating a Restore,
    and pressing the  key before the 'bad' move is restored.

    The name of the Save file is specified in the Chess.Config file.

    The maximum number of moves that can be stored by the Save command is 120.

    The maximum number of positions that can be stored in a single Save file
    is 35.  If a Save file fills up you can either re-use one of the current
    Save positions, or rename the Save file and start a new Save file.

    A position that has been setup via the "Setup" command cannot be saved.


  Release Disk contents:
  ----------------------

  Due to the size of the source files, CTOS Chess is released on two disks.
  One disk contains only the files required to run Chess plus the release
  notes.  The other disk contains all the files required to recompile Chess.


            Disk: ChessRun-35
                  -----------

    Name                        Description
    ----                        -----------

    Chess.Release.Notes    This document.

    Chess.26.Font          Font file for B24, B26, B28, B38, B39
    Chess.27.Font          Font file for B27
    Chess.Config           Configuration file used by Chess.Run.
    Chess.Run              Chess run file.


            Disk: ChessSrc-35
                  -----------

    Name                        Description
    ----                        -----------

    Chess.Release.Notes    This document.

    BPL.h                  Include files.
    ChessD.h
    ChessE.h               These files are used when recompiling
    ChessV.h               the Chess game.
    Config.h
    CttimerX.h

    Chess.c                'C' source - main module.
    CMod1.c                'C' source - video handling routines.
    CMod2.c                'C' source - Audit and Save file handling
                                             routines.
    CMsg.c                 'C' source - keyboard and message handling
                                             routines.

    Common.Libm            Object library file containing modules
                                required by the CMod2 chess module.
                                Required for linking the Chess run file.

    Common.c               'C' source used for generating Common.Libm.

    Chess.Link             Example submit file and associated @files
    Chess.Objects          used for relinking the Chess run file.
    Chess.Libraries

    Chess.CFG              Example CFG file used when compiling the
                                Chess modules.

    Note: The 3.5 version of Chess was compiled using the "medium" model.

    Source: geocities.com/siliconvalley/pines/4011/software

               ( geocities.com/siliconvalley/pines/4011)                   ( geocities.com/siliconvalley/pines)                   ( geocities.com/siliconvalley)