Super Games/visualcdgame.iso/dosgames/cmread50/cmreader.doc

Text File | 1992-10-20 | 11.5 KB | 414 lines

           ██▒▒██▒▒██▒▒██▒▒██▒▒             CMReader 5.0
           ▒▒██▒▒██▒▒██▒▒██▒▒██           copyright 1991-92
           ██▒▒██▒▒██▒▒██▒▒██▒▒        Knightware/Bud Bradley
           ▒▒██▒▒██▒▒██▒▒██▒▒██
           ██▒▒██▒▒██▒▒██▒▒██▒▒     ChessMAGIC! Offline Game Viewer
           ▒▒██▒▒██▒▒██▒▒██▒▒██
           ██▒▒██▒▒██▒▒██▒▒██▒▒
           ▒▒██▒▒██▒▒██▒▒██▒▒██




                REFERENCE MANUAL









                 Distributed by

                   KnightWare
                 P.O. Box 464711
                Lawrenceville, GA   30246
                BBS [phone]
                   24 hrs  14.4





















            Copyright (c)1991-1992 Bud Bradley/KnightWare
                All Rights Reserved


                   INTRODUCTION


    The ChessMAGIC! Offline Game Reader (e.g. CMReader) is being distributed
    as shareware and is completely functional. If you find this product
    useful you are encouraged to register it. It not only provides the
    author renumeration for his efforts, but insures continued support of
    the product(s). Upon registering, the beg screen(s) will be removed.

    CMReader archive may be freely distributed as long as the contents remain
    intact and without modification.

    CMReader provides the means to play back and study any chess game from a
    simple text format file.  The main benefits of CMReader, though, are
    derived when used in conjunction the BBS door ChessMAGIC! (registered
    versions).  Registered ChessMAGIC! versions enable users to download
    games matching many and varied criteria for later offline study at their
    leisure.


                 W A R R A N T Y

    Users of the ChessMAGIC! Offline Game Reader (e.g. CMReader) must accept
    this disclaimer of warranty:

    "CMReader is supplied as is.  The author disclaims all warranties,
    expressed or implied, including, without limitation, the warranties of
    merchantability and of fitness for any purpose. The author assumes no
    liability for damages, direct or consequential, which may result from the
    use of CMReader.

    "In no event shall KnightWare be liable for any damages, including lost
    profits, lost savings or other incidental or consequential damages
    arising out of your use or inability to use CMReader, or for any claim by
    any other party.


             T a b l e    o f    C o n t e n t s

       Section    Title

     1.0      SYSTEM REQUIREMENTS

     2.0      INITIALIZATION

     3.0      COMMAND OPTIONS

     4.0      GAME FILE FORMAT
     4.1        Rules & Guidelines

     5.0      PRODUCT SUPPORT
     5.1        Product Distribution

     6.0      REGISTRATION FORM

       ╒═══════════════════════════════════════════════════════════════════╕
       │   1.0   CMReader - SYSTEM REQUIREMENTS                            │
       ╘═══════════════════════════════════════════════════════════════════╛

       PC/MS-DOS 2.11 or higher
       360k Floppy Drive
       200k RAM Minimum
       Monitor with minimum EGA graphics capabilities

       ╒═══════════════════════════════════════════════════════════════════╕
       │   2.0   CMReader - INITIALIZATION                                 │
       ╘═══════════════════════════════════════════════════════════════════╛

       To override the mouse, if you have one and don't care to
       use it, the following switch will turn it off.

      cmr -m


       ╒═══════════════════════════════════════════════════════════════════╕
       │   3.0   CMReader - Menu COMMAND OPTIONS                           │
       ╘═══════════════════════════════════════════════════════════════════╛

       Function Keys-

       <F1> = HELP Screen

       Cursor Keys-

    Up    Arrow    = Highlights menu item
    Down  Arrow    = Highlights menu item

       Mouse-

    Right Button   = Single Click highlights selection
             Double Click processes selection

       Miscellaneous-

      <ENTER>      = Selects highlighted item
       <ESC>       = Exits program.


       ╒═══════════════════════════════════════════════════════════════════╕
       │   3.1   CMReader - Path/File Selection COMMAND OPTIONS            │
       ╘═══════════════════════════════════════════════════════════════════╛

       On the "Path:" line, enter the path where the games are located.
       Do not enter any file specs, such as *.*. CMReader will auto
       detect any game files in the path.

       Function Keys-

      <F1>         = HELP Screen
      <F10>        = Selects highlighted file for viewing

       Cursor Keys-

    Up    Arrow    = Highlights file
    Down  Arrow    = Highlights file
    Right Arrow    = Highlights file
    Left  Arrow    = Highlights file

       Mouse-

    Right Button   = Single Click highlights selection
             Double Click selects file for viewing

       Miscellaneous-

      <ENTER>      = Changes to selected PATH
       <ESC>       = Exits to menu
      <HOME>       = Positions cursor to beginning of PATH
       <END>       = Positions cursor to end of PATH

       ╒═══════════════════════════════════════════════════════════════════╕
       │   3.2   CMReader - Viewing COMMAND OPTIONS                        │
       ╘═══════════════════════════════════════════════════════════════════╛

       Function Keys-

       <F1> = HELP Screen
       <F2> = Invert Board
       <F3> = Auto-Play ON (approximately 1 move per second)
          Pressing any key will turn off auto-play.

       Cursor Keys-

    Right Arrow    = Next Move
    Left  Arrow    = Take Back Move
       <HOME>      = Reset board to 1st move, clearing all Marked moves
       <END>       = Goes to the end of the move list, and displays
             board position as of the last move.


       Mouse

       Click on the Selection at the bottom of the screen

       Miscellaneous-

       <ESC>       = Exit current screen
       < - >       = Minus Key slows down auto play
       < + >       = Plus Key speeds up auto play

     * Denotes holding down the <Alt> key and pressing the associated
       letter.

       ╒═══════════════════════════════════════════════════════════════════╕
       │   4.0   CMReader - GAME FILE FORMAT                               │
       ╘═══════════════════════════════════════════════════════════════════╛

       The file MUST be in standard ASCII text form and contain NO embedded
       control codes, extended ASCII characters, etc.  Refer to your word
       processor or text editor documentation on how to generate this type of
       file.

       Only ONE game per file and the contents would be similar to the
       following example of a partial game:

       #White:BUD BRADLEY          (1711)
       #Black:FREDDY FISH      L1  (1305)
       #These are the game headers and can be up to 3 lines.
       1. f2-f4  b8-c6
       @This is a non-displayed comment.
       2. g1-f3  g8-f6
       <This is a Black-Side comment
       <and can be up to
       <3 lines of 79 characters each.
       3. b2-b3  f6-d5
       >This is a White-side comment
       >and can be up to
       >3 lines of 79 characters each.

       ╒═══════════════════════════════════════════════════════════════════╕
       │   4.1   CMReader - Game File Format Rules & Guidelines            │
       ╘═══════════════════════════════════════════════════════════════════╛

       Comment Lines-

           # = Game headers. Always 1st 3 lines in the game file.
           line 1 = white player
           line 2 = black player
           line 3 = dates, location, etc.
           @ = invisible (never displays)
           > = Display After White-side Move
           < = Display After Black-side Move

       Comments may be up to 79 characters per line with a maximum of 3
       contiguous lines prior to a move entry.  A comment character must
       be placed in the first column for it to be recognized as such by
       CMReader.

    Notation-

           Long  Algebraic       :   e2-e4
           Short Algebraic       :   e4, Nf3, Nbd2, R1a2 etc..


    Move Separator-

       These can be any of the following:

           e2-e4   e2;e4   e2xe4

       The x is normally only used to designate captures.

    Move Numbers-

       Each White/Black move pair MUST have a line to themselves and
       preceeded with a move number.

           Correct-

             1 e2-e4  g7-g6
          or
             1. e2-e4  g7-g6

       ╒═══════════════════════════════════════════════════════════════════╕
       │   4.1   CMReaader - Game File Format Rules & Guidelines           │
       ╘═══════════════════════════════════════════════════════════════════╛

           Incorrect-

             1 e2-e4
             g7-g6
          or
             e2-e4
             g7-g6
          or
             23.

       The last incorrect example shows a move number that lacks a
       corresponding move entry.

       Note: The "." (i.e. period) is ignored by CMReader, so can either
       be included or excluded, whichever you prefer.


    Result Designation-

           Draw         =   draw
           Resignation  =   1-0 or 0-1 or resigns
           Mate         =   mate

       Examples:

           23. c1-e1 draw
           23  c1-e1 resig  or   23 c1-e1 1-0  or  23 c1-e1 0-1
           23. c1-e1 mate

    Pawn Promotion-

           =Q   Queen
           =R   Rook
           =N   Knight
           =B   Bishop

       The promotion is designated immediately following the move.
       Example, promoting a Pawn to a Queen:

           23. g7-g8=Q

    Exclamatory Signs-

           +    !    ?

       White and Black moves can contain up to 2 signs each, as shown:

           15 c2-c4!?  f8-b4+


       ╒═══════════════════════════════════════════════════════════════════╕
       │   5.0   PRODUCT SUPPORT                                           │
       ╘═══════════════════════════════════════════════════════════════════╛

       Questions or inquiries can be directed to us through any of the
       following sources:

                  * E-MAIL CONTACTS *
                      and
               All BBS-Related Questions

                  KnightWare BBS
                  (Atlanta, GA)
               [phone]  1200/2400


                   * US MAIL *

                   KnightWare
                P.O. Box 464711
                Lawrenceville, GA   30246


    ╒════════════════════════════════════════════════════════════════════╕
    │   5.1   Distribution Hubs for ChessMAGIC!                          │
    ╘════════════════════════════════════════════════════════════════════╛

    1)   TDS International Network (Eugene, OR)
     Worldwide distributor of PCBoard Doors & Utilities
     [phone] (HST  14.4k,  8/n/1)
     [phone] (Supra v.32,  8/n/1)

    2)   Atlanta Chess BBS (Atlanta, GA)
     [phone] (14.4k 24 hours)


       ╒═══════════════════════════════════════════════════════════════════╕
       │   6.0   MAIL-IN ORDER FORM   (check or money orders)              │
       ╘═══════════════════════════════════════════════════════════════════╛

 Make Checks Payable to:  KnightWare
              P.O Box 464711
              Lawrenceville, GA   30246


 Your Name    ________________________________

      Phone   ________________________________  (Voice)

      Address ________________________________

      Address ________________________________

      City    ________________  State ____  ZIP ______________


     PRODUCT                          QUANTITY  PRICE EA.   TOTAL PRICE
 ---------------------------          --------  ---------   -----------

 CMReader - Offline Game Viewer       ________ x  $ 10.00 = ___________


                        Sub-Total       ___________

            Shipping & Handling                   $  1.50

                        TOTAL
                                ===========