home *** CD-ROM | disk | FTP | other *** search
/ Aminet 10 / aminetcdnumber101996.iso / Aminet / game / board / VChess35.lha / VChess / VChess.doc < prev    next >
Text File  |  1995-12-18  |  62KB  |  1,317 lines
  1.  
  2.           VChess 3.5 - A Chess game for Amiga-Computers (OS 2.0+)
  3.                        © 1993-1995 by Stefan Salewski
  4.                             All Rights Reserved
  5.  
  6. Copyright and other legal stuff
  7.    
  8.   VChess is NOT a PD-Program, but Shareware! VChess and most other files  of
  9.   this package are Copyright © 1993-1995 by Stefan Salewski.
  10.  
  11.   In spite of several tests, no warranty is made that there are no errors in
  12.   VChess. YOU USE THIS PROGRAM AT YOUR OWN RISK. In no case I will be liable
  13.   for any damage, direct or indirect, resulting by the use of VChess.
  14.  
  15.   The complete VChess 3.5-Package contains the following files:
  16.  
  17.   File or directory       Size   Meaning
  18.   ------------------------------------------------------------------------
  19.   VChess                115308   Mainprogram, V3.5, © S.Salewski
  20.   VChess.doc             61646   English documentation
  21.   VChess.dok             80702   German  documentation
  22.   VChessOpenings         24088   150 Chessopenings
  23.   Product-Info            1973   For KingFisher 2.0 or similar tools.
  24.   ReqToolsLibrary          Dir   ReqTools.library V38.1266 © N. Francois
  25.   Games                    Dir   Saved games.
  26.   Text                     Dir   Game, saved as text file.
  27.   Icons                    Dir   Icons for games, text and configurations
  28.   Catalogs                 Dir   Catalogs for german, french, swedish
  29.   Configs                  Dir   Example-Configurations
  30.   Checkmates               Dir   Some Chckmates ( mate in 2, 3 or 4 moves)
  31.   Chesstasks               Dir   Some Chesstasks(find the best move)
  32.   Catalog-Translations     Dir   English, deutsch, svenska, francais,empty
  33.                                  svenska.ct, produced & © Rikard Bosnjakovic
  34.                                  français.ct, produced and © Denis Gounelle
  35.  
  36.   Distribution of VChess is only allowed if  the  following  conditions  are
  37.   fulfilled:
  38.  
  39.   All these files must  remain  unmodified.  None  of  these  files  may  be
  40.   distributed on its own, the entire package must be  distributed  together.
  41.   (It is  allowed  to  distribute  this  package  without  ReqTools.library,
  42.   because I think nearly everybody will have it already, or to replace  this
  43.   library with a never release.)
  44.  
  45.   (It is allowed to archive these files  with  archiving-programs  like  LHA
  46.   (© Stefan Boberg) if it is possible to retrieve the files from the archive
  47.   in their original state.)
  48.  
  49.   Permission  is  granted  to  include   this   package   in   Public-Domain
  50.   collections, especially in Fred Fish's Amiga FD-Disk Library (including CD
  51.   ROM versions of it).
  52.  
  53.   The complete package may be (in archived form) uploaded to Bulletin  Board
  54.   Systems or FTP servers.
  55.  
  56.   PD-dealers and other people who want to distribute VChess are only allowed
  57.   to take money for the floppy disk and copying  efforts.  Nobody  may  take
  58.   more than $5(US) or DM 5 for the disk with VChess. This is also  valid  if
  59.   there is other software besides VChess on the Disk.
  60.  
  61.   The distribution of VChess in "Software Packages"  (more  than  one  disk)
  62.   together with other Software is only allowed with my written permission if
  63.   the package cost more than US$ 5 or DM 5.
  64.  
  65.   The distribution of VChess  on  CD-ROM  is  only  allowed  if  the  CD-ROM
  66.   contains the contents of FD-Disks (for example Fish 500-1000)  or  if  the
  67.   price of the CD-ROM in not greater than US$0.5 per megabyte.  This  means,
  68.   that nobody may sell a CD-ROM containing VChess and 100 Megabytes of other
  69.   software for a price greater than US$50.
  70.  
  71.   Distribution of VChess together with commercial software is forbidden.
  72.  
  73.   Distribution of VChess 3.5 on "Coverdisk" of Computer  magazines  is  only
  74.   allowed if the following three conditions are met:
  75.  
  76.    -The price of magazine (including the coverdisk) may not be greater  than
  77.     $7(US).
  78.  
  79.    -The disk must be freely distributable, so that everybody who bought  the
  80.     magazine can copy the disk for his friends.
  81.  
  82.    -And the magazine must tell all of the  purchasers  that  the  author  of
  83.     VChess got no money from the magazine. 
  84.    
  85.   (The reason why I make such strong restrictions  about  Coverdisks  is  as
  86.   following: Some magazines copied VChess 2.0  on  their  coverdisk  without
  87.   asking me for permission or informing me about it. The same did the german
  88.   magazine "Amiga-Plus" with release 3.1 of VChess! I think,  that  somebody
  89.   who got VChess from such Coverdisk may think, that I got some  money  from
  90.   the magazine, and he may suppose that it is not so important  to  pay  the
  91.   shareware-donation. But  of  course  this  is  not  true.  None  of  these
  92.   magazines gave me anything for it. So even people, who got VChess from  an
  93.   expensive Coverdisk, have to pay their contribution.)
  94.  
  95.   Of course it is reserved for me to forbid single companies or persons  the
  96.   distribution of VChess.
  97.  
  98.   User of VChess should regard this: An empty Floppy-Disk  costs  less  than
  99.   US$1, and copying VChess takes less than two minutes.  If  you  paid  more
  100.   than US$3 for the disk with VChess, then this was quite expensive. But  if
  101.   you have paid more than US$5, this was too much. Try  to  get  your  money
  102.   back, and tell me about it.
  103.  
  104. What is new in release 3.5 ?
  105.    
  106.   The playing strength should be better again. In release 3.4  there  was  a
  107.   little problem: If the human player did his move at once without thinking,
  108.   it occurred sometimes, that the computer told: "This is not a legal move".
  109.   So it was necessary for the human player to wait some seconds and then  to
  110.   do the move again. This is  fixed  now.  Additional  there  is  a  greater
  111.   Opening-Library created by Uwe Zedtler in this package. This  big  library
  112.   is copyright by Uwe Zedtler, and Shareware.  For  more  information  about
  113.   this     library     see     the     german     documentation,      called
  114.   "VchessOpeningsV1.0.liesmich". Til now I have not used this large library,
  115.   but I guess that it may be useful  for  good  players.  Unfortunally  this
  116.   library needs much memory. To use it, just replace my small  library  with
  117.   that large one. To say it again: This large library is © by Uwe Zedtler, I
  118.   have only included it (with permission of Uwe Zedtler) in this package.
  119.  
  120. What is new in release 3.4 ?
  121.    
  122.   The playing strength should be much better now! Please don't be  surprised
  123.   if you see that the calculating-power of the computer (moves  per  second,
  124.   Mps) is smaller now! Now the computer  calculates  capture-sequences  more
  125.   deep, and is more intelligent, but needs more time per calculated move!  I
  126.   think the result is a better playing strength. The solving  of  chesstasks
  127.   is also much better now, all tasks in  the  drawer  Checkmates/Solved  are
  128.   solved on my A3000 in less than 20 minutes. I think this is not bad.  (But
  129.   there are some task in the drawer Checkmates/Unsolved which my  A3000  can
  130.   not solve in 10 minutes.) Additional, the computer is  better  in  endgame
  131.   now. In most cases, the computer can force a  checkmate  if  playing  with
  132.   king+bishop+bishop or with king+bishop+knight versus a single king in less
  133.   than 50 moves now. Beside this, there are some other  small  improvements,
  134.   but there are no big changes from release 3.3 or 3.4 to 3.5. So if you are
  135.   familiar with release 3.3 or 3.4, then it is not necessary  to  read  this
  136.   documentation again. (It should be possible to  use  old  3.3/4-datafiles,
  137.   like  configuration  files,  saved  games  or  the  opening-library   with
  138.   VChess 3.5.)
  139.  
  140. Introduction
  141.    
  142.   VChess is written fully in Oberon language, and was developed on an  Amiga
  143.   3000 using Amiga Oberon V 3.11d (© Fridtjof Siebert).  With  the  help  of
  144.   OS 2.0, ReqTools.library and Amiga-Oberon,  I  have  produced  a  compact,
  145.   powerful and easy to use program. To run this program, you need  an  Amiga
  146.   with   OS 2.0   or   greater,   and   additional   the    ReqTools.library
  147.   (© Nico Francois). If the ReqTools.library is not part  of  this  package,
  148.   you can find it for example in  the  "March/April  1994  FreshFish  CDROM"
  149.   (New/util/libs Version 2.2), on the AmigaLibDisk 794 (version 2.1a) and of
  150.   course in AmiNet. Please note that there exists a  Preferences-Editor  for
  151.   ReqTools.library. You can use this Editor (not part of  this  package)  to
  152.   modify the behaviour of the ReqTools.library. VChess needs not  very  much
  153.   memory. Without the use of the Opening-library, it may be possible to  use
  154.   VChess on an Amiga with only 512 K. The  normal  stacksize  of  4096  Byte
  155.   should be enough too for normal playing, but with 8192 Byte stack you  can
  156.   be sure that no stack-overflow can occur.
  157.  
  158. Installation
  159.    
  160.   Copy, if not already installed, the ReqTools.library  to  LIBS:.  This  is
  161.   all. Now you can start VChess from Workbench  with  Double-Click.  If  you
  162.   want to install VChess on your hard disk, it is best  to  copy  the  whole
  163.   VChess-Drawer  to  hard   disk,   because   this   drawer   contains   the
  164.   Opening-Library and other things. VChess can use  Catalog-files  to  adapt
  165.   itself  to  other  languages  than  English.  VChess  searches  for  these
  166.   catalogfiles in PROGDIR:Catalogs/language. Where PROGDIR: is the directory
  167.   in which VChess resides. If, for example, your  preferred  system-language
  168.   is        "deutsch",         then         VChess         will         load
  169.   "PROGDIR:Catalogs/deutsch/VChess.catalog". You can copy the catalogfile to
  170.   LOCALE:catalogs/language, VChess will find it there too, but I think  it's
  171.   better to leave the catalogfiles in the VChess-Drawer. (You can use VChess
  172.   without its VChess-Drawer,  but  this  is  not  recommended  because  many
  173.   additional files like the opening-library, saved games, Icons  and  so  on
  174.   belong to VChess.)
  175.  
  176. Starting VChess
  177.    
  178.   The easiest way to start VChess is with a Double-Click on its Icon. But of
  179.   course you can start it from Shell by typing its name  and  then  pressing
  180.   the <Return>-Key. (VChess needs no  parameters.)  If  there  is  the  file
  181.   VChess.config or Configs/VChess.config in the Drawer of VChess,  then  the
  182.   program uses this file for the startup-configuration,  otherwise  defaults
  183.   are used. It is possible to make VChess resident  with  the  shell-command
  184.   RESIDENT. This can be useful for a few people,  who  need  more  than  one
  185.   board. For example type in the shell
  186.  
  187.   CD VChess
  188.   RESIDENT VChess
  189.   RUN VChess
  190.   RUN VChess
  191.    
  192.   to get two boards without wasting  of  memory.  This  is  not  very  nice,
  193.   because both boards appear at the same position, and you have to save  and
  194.   load a game to exchange games, but it is possible. And most  players  will
  195.   only need one board!
  196.  
  197. First Steps
  198.    
  199.   Before you go on reading this text, it is better to start VChess  now  and
  200.   try it out. When the program has started, you can see  four  windows.  The
  201.   big one with the chessboard is the main-window. The other windows are only
  202.   help-windows for showing some information. If one of these four windows is
  203.   active, then you can press the right mousebutton to take  a  look  on  the
  204.   Pulldown-Menu. (Don't be sad if the display looks ugly at this time.  Many
  205.   things like colours, fonts and  screen-resolution  can  be  changed.)  Now
  206.   select the menuitem "Config/Reset to defaults" to reset all adjustments to
  207.   defaults. Start the game by selecting "Project/NewGame". Now you play with
  208.   the white pieces against the computer. To move a piece, simply click on it
  209.   with the left mousebutton. (To click means:  Move  the  pointer  over  the
  210.   chessman, and then press and release the left mousebutton.) Now this piece
  211.   is marked. Now click on the destination-square. If this was a legal  move,
  212.   the piece will move from source to  destination,  and  the  computer  will
  213.   answer with its move. Now it's again your turn, and so on. Don't  hesitate
  214.   to test some of the menu-functions. The meaning of most of them should  be
  215.   clear, just try it out. Of course you can re-size the  windows,  or  close
  216.   the helpwindows.
  217.  
  218. Shareware-Contribution
  219.    
  220.   I started the development of VChess in summer 1992, and  now  in  December
  221.   1995 version 3.5 is finally (nearly) finished. I guess, that this  program
  222.   took more than 2000 hours of work till now. I think you  can  imagine  how
  223.   much  money  the  development  of  this  program   would   have   cost   a
  224.   software-company, or how much money I could have earned  if  I  had  spent
  225.   this  time  somewhere  else.  And  last  not  least  the  costs  that  the
  226.   development of software causes are not negligeable.
  227.  
  228.   At the beginning I planed to sell VChess in a commercial way. But  because
  229.   even with a commercial distribution it is not secure that the author  gets
  230.   a justified amount of money for his work, I decided to  distribute  VChess
  231.   as Shareware. Shareware means, that the program can be freely  copied,  so
  232.   that everyone can get it (nearly) free of charge from friends,  PD-Dealers
  233.   or by BBS-Systems. But when you like the program, and you want  to  go  on
  234.   using it, you have to send a donation to the author.
  235.  
  236.   VChess 3.5  is  true  shareware  again.  This  means  that  there  are  no
  237.   restrictions in this version. I emphasize this, because many authors  have
  238.   decided to release only restricted versions of their software  for  freely
  239.   distribution. But there are no restrictions in VChess 3.5. This means that
  240.   you can test all functions of VChess, and you  don't  have  to  wait  many
  241.   weeks after paying the contribution to get the  fully  functional  version
  242.   from the author. And I have the advantage that I  save  some  mailing-work
  243.   and postage.
  244.  
  245.   So if you like VChess and want to go on using it,  please  send  US$15  or
  246.   DM20 to the following address:
  247.  
  248.                                Stefan Salewski
  249.                                 Stolper Weg 3
  250.  
  251.                            D-21680 Stade (Germany)
  252.  
  253.   Please compare this address with the text that you can see if  you  select
  254.   the  menuitem  "Project/About".  If  there  are  any  differences  in  the
  255.   addresses, this means that somebody has  made  illegal  modifications.  In
  256.   this case try to get a clean, unmodified version of VChess. If you live in
  257.   Germany, you can send me a "Verrechnungsscheck" or make  an  "Überweisung"
  258.   to:
  259.  
  260.                             Stadt-Sparkasse Stade
  261.                             Bankleitzahl 24151005
  262.                               Kontonummer 823864
  263.  
  264.   Otherwise I think the best way is if you send me the money in cash. It may
  265.   be possible to send an EuroCheck (only in DM !) or to send me the money by
  266.   postal money order. (But it is  impossible  for  me  to  cash  in  foreign
  267.   checks, even if the amount is in DM. I got an check from an  English  bank
  268.   (DM 20), but I had to send it back because the banks in Stade charge DM 27
  269.   to cash it in.)
  270.  
  271.   All people, who send me the contribution, will get a  postcard  or  letter
  272.   from me, so that they know that I really got the money. If you should  not
  273.   get this notification after six weeks, then something went wrong.  (Please
  274.   don't forget to give me your FULL postal address.)
  275.  
  276. Playing-Strength
  277.    
  278.   Of  course  it  is  a  big  difference  if  you  play  with  a  68000-  or
  279.   68040-processor. On my A3000 I lose most games against the computer, if  I
  280.   play with fair conditions. Fair conditions means, that I don't  take  back
  281.   moves, and that I don't use more thinking-time than the computer. I  can't
  282.   make precise statements about it, because I have too many possibilities to
  283.   compare VChess with. The playing-strength of  version  2.0  was  not  very
  284.   great, but I think that in Version 3.5 the playing-strength  is  not  bad.
  285.   The playing-algorithm is completely a  development  of  my  own,  I  spent
  286.   approximately 1000 hours on it. I guess that  other  people  thought  more
  287.   about it. The best way is if you test  the  playing-strength  yourself.  I
  288.   think, if you lose more than 50% of all games, then  the  playing-strength
  289.   is big enough for you. Note: If you lost nearly every game,  it  would  be
  290.   very frustrating. Of course, if the playing-strength  was  very  high,  it
  291.   would be possible to degrade it artificially. But if you won  against  the
  292.   computer, you know that the computer  have  played  intentional  bad,  you
  293.   would  not  be  so  glad  about  your  win.  If   you   think   that   the
  294.   playing-strength is too low, you can tell me. If many people think  so,  I
  295.   will try to  increase  it.  For  my  own  games  the  playing-strength  is
  296.   currently big enough. (Sometimes it may occur that the  computer  make  an
  297.   obviously bad move. This can happen for example, if the  thinking-time  is
  298.   short, so that the computer can't see an imminent attack of his  opponent.
  299.   In this case you can do this: Select a longer thinking-time (for this move
  300.   only), and then select Extras/Undo last Move from menu. Now  the  computer
  301.   will take back his bad move. Using a longer thinking-time, he will find  a
  302.   better move in most cases. Now you can use the  smaller  time  again.  For
  303.   example, I use 30 seconds thinking-time on my A3000. If I notice, that the
  304.   computer has done a very bad move, I select 3 Minutes  thinking-time,  and
  305.   Undo. Now I fetch a cup of tea, and when I come  back,  the  computer  has
  306.   found  a  better  move  in  most  cases.  Now  I  select  again  the   old
  307.   thinking-time of  30  seconds.  A  other  way  is  this:  You  can  select
  308.   Playmode/Human-Human, use Undo, and do a better move yourself. Now  select
  309.   Playmode/Human-Amiga again.
  310.  
  311. The Use of VChess
  312.    
  313.   After starting VChess, you will see the mainwindow, and perhaps the  three
  314.   other windows. The behaviour of the windows is like  the  windows  of  the
  315.   Workbench. You can  move,  re-size  and  close  them.  If  you  close  the
  316.   mainwindow, the program will terminate. To move a chessman,  simple  click
  317.   on it and then on the destination square. (To make a rochade, simple  move
  318.   the king. The rook is moved automatically.) If you clicked on a piece, and
  319.   this click was a mistake, just click again on it to delete the  selection.
  320.    
  321.   In the window titled "All Moves" you can see  all  moves  of  the  current
  322.   game. The algebraic notation is used. "2.Bf1-b5   e7-e5" means, that  this
  323.   is the second move, White moved the Bishop from square f1  to  square  b5,
  324.   and Black moved a pawn from e7 to e5. The letters  behind  the  movenumber
  325.   (2.) have the following meanings:
  326.  
  327.   P  Pawn
  328.   N  Knight
  329.   B  Bishop
  330.   R  Rook
  331.   Q  Queen
  332.   K  King
  333.  
  334.   The "P" for a move of a pawn is  usually  substituted  by  a  space.  Some
  335.   special characters are used for special moves: "O - O"  or  "O-O-O"  means
  336.   the small or big rochade. "e.p."  indicates  the  special  pawn  move  "En
  337.   passant". "+" and "#" are used  to  indicate  check  and  checkmate.  "#W"
  338.   means, that White is checkmate, "#B3" means, that Black will be  checkmate
  339.   in 3 half-moves. "*W" or "*B" is my own notation  if  White  or  Black  is
  340.   stalemate.
  341.  
  342.   The other window titled "Thinking..." shows the valuation of all currently
  343.   possible moves. The numbers on the right side are the  valuation  of  this
  344.   move. The number 100 is equal to the gain of a pawn, -25 is equal  to  the
  345.   lost of a quarter pawn and so on.
  346.  
  347.   "3-3 Be4xd5 50" means the following: If the Bishop on square e4 would  hit
  348.   the chessman on square d5, this would result in the active player  gaining
  349.   of one half pawn. The characters "3-3" describe the deep of  thinking,  in
  350.   this example three half-moves. (A half-move is a move  of  a  white  or  a
  351.   black piece.) In  this  example  the  computer  has  calculated  for  each
  352.   possible move of the active player a move of its opponent, and for each of
  353.   these moves of the opponent again a move of  its  own.  From  these  three
  354.   half-moves the total gain of this move is  calculated,  and  the  computer
  355.   will select the move with the highest total gain. Note that in the average
  356.   a player can make one of 30 possible  moves.  And  for  all  of  these  30
  357.   possible moves there are again 30 moves as a response,  and  so  on.  This
  358.   means, if the computer calculates 3 half-moves  deep,  the  computer  must
  359.   process 30^3=30*30*30=27000 half-moves. You can  think  about  it  as  the
  360.   computer building a tree for each possible move. The  first  half-move  is
  361.   the root of a tree, and from this root there are 30 branches to a opposite
  362.   move, and from each opposite move there  are  again  30  branches  to  the
  363.   opposite-opposite-moves and so on. Of course such a tree doesn't  have  to
  364.   be totally symmetric, some branches can be longer (more nodes) and  others
  365.   shorter. If an entry begins for example with "3-4", then this  means  that
  366.   the basic depth of this tree is 3 nodes, but this branch is 4 nodes  deep.
  367.   Or sometimes you can see entries like "5-3". This  means  that  the  basic
  368.   depth of this tree is 5 nodes, but this branch is  cut  because  it  looks
  369.   like a bad move, or a checkmate will occur in 3 half-moves.
  370.  
  371.   The fourth window is called "Move-Chain". If you click on an entry in  the
  372.   "Thinking..."-Window, then the movechain of this move is displayed in this
  373.   window. This will help you to understand why the computer  thinks  that  a
  374.   single move is a good or a bad move. The display of this window looks like
  375.   this: 
  376.   ------------
  377.   Gain:  40 +3
  378.   Nb8-c6    50
  379.   e4xd5    240
  380.   Qd8xd5   300
  381.   Nf3xe5    70
  382.   ------------
  383.   This means: If the active player made  the  move  "Nb8-c6",  his  opponent
  384.   would react with e4xd5 and so on. The real gain of the  move  "Nb8-c6"  is
  385.   50-240+300-70=40. The +3 is a random-number added to the gain, so  in  the
  386.   "Thinking..."-window the displayed gain is 40+3=43. (The displayed gain in
  387.   the "Thinking..."-window may differ a little  bit  from  the  sum  of  the
  388.   movechain. This is not a bug, but occur because moves at the  end  of  the
  389.   chain are less weighted.)
  390.  
  391. Playing- and Buildup-Mode
  392.    
  393.   There are two modes: Playing-Mode, and Buildup-Mode. In  the  Buildup-Mode
  394.   you can move pieces without any restrictions. In Playing-Mode you  can  do
  395.   only legal moves, and the  chess  clocks  are  running.  The  Buildup-Mode
  396.   contains a special sub-mode, called Replay-Mode. Replay-mode  means,  that
  397.   there is a game in memory (just played or loaded). In this  case  you  can
  398.   use the menu items "Next Move", "Previous Move" etc. to replay it, and you
  399.   can save the game. If you are in  Replay-Mode  and  modify  the  board  by
  400.   moving pieces, you will go to the plain Buildup-Mode. If you  are  in  the
  401.   plain Buildup-Mode, then you can save  only  the  contents  of  the  board
  402.   without any moves.
  403.  
  404. Titleline of the Mainwindow
  405.    
  406.   The windowtitle is used for displaying various  information,  for  example
  407.   error-reports or the last move. If the computer has done a move,  you  can
  408.   see in () which opening the computer uses, or the computing-power  of  the
  409.   computer in moves per second, Mps (really Half-moves).
  410.  
  411. Chess clocks
  412.    
  413.   At the top of the board window you can see three chess clocks.  The  clock
  414.   on the left displays the total time for the white player, and the clock on
  415.   the right the time for the black player. The clock in the middle shows the
  416.   time for the active player.
  417.  
  418. The Menu
  419.    
  420.   If one of the four windows is active, then  you  can  select  one  of  the
  421.   following functions with the right mousebutton:
  422.  
  423.   Project
  424.   -------
  425.     "New Game"
  426.        
  427.       With this item you start a new game. All pieces are built up on  their
  428.       initial position, and it is white's turn.
  429.  
  430.     "Start Game"
  431.        
  432.       With this item you also start playing, but the pieces  stay  at  there
  433.       former places.
  434.  
  435.     "Solve for Mate"
  436.        
  437.       With this item you can activate a special playing-mode:  The  computer
  438.       will go on thinking until the computer sees a  mate  or  stalemate.  A
  439.       Requester will ask you "How many moves to mate ?". Mate  in  one  move
  440.       means, that the active player makes a move, and then his  opponent  is
  441.       checkmate. This is trivial. Mate in 2 Moves  means,  that  the  active
  442.       player makes a move, then his opponent makes any move, and then  after
  443.       the second move of the active player the  opponent  is  checkmate.  If
  444.       Extras/Playmode/Extend is activated in menu, then  the  computer  will
  445.       extend some brances of  the  tree,  for  example  branches  with  many
  446.       check-offers. In most cases this is useful, so  Extras/Playmode/Extend
  447.       should be activated in the general case. First the computer  will  try
  448.       to find a mate without depth-extension, then, if no mate is found,  he
  449.       will try to find a mate with depth-extension. If you click for example
  450.       on "2", this means that the computer will start searching for  a  mate
  451.       in 2 moves, then he will extend some branches. If he can  not  find  a
  452.       mate, he will  go  on  searching  for  a  mate  in  3,  first  without
  453.       extension, then with extension. If you are sure that the mate is not a
  454.       result  of  some  checks,  then  it  may  be  useful   to   deaktivate
  455.       depth-extension. But in general case, Extras/Playmode/Extend should be
  456.       activated, and you should click on "2" to start searching.
  457.  
  458.       You can stop the solving for mate, if you select "Stop Game" in  menu.
  459.       This can be necessary,  because  there  exists  many  chesstask  which
  460.       VChess can not solve in short time. If there are  no  changes  in  the
  461.       Thinking-window for long time, then this  task  is  to  difficult  for
  462.       VChess, and you should select  "Stop Game"  in  menu.  (All  tasks  in
  463.       drawer Checkmates/Solved are solved in less  than  20  minutes  on  my
  464.       A3000. But the task in the drawer Unsolved my A3000 can not  solve  in
  465.       some minutes.)
  466.  
  467.       When the computer has found the way to checkmate, he makes  the  first
  468.       move and stops the game.  You  can  see  all  moves  to  mate  in  the
  469.       MoveChain-Window. In general case, the next move  is  not  clear,  the
  470.       opponent can react with more than one single move. This is the  reason
  471.       why the computer will not do all moves to mate. But if you think  that
  472.       it is useful to save a special way to  mate  then  you  can  do  this:
  473.       Select Thinklist/Update Movechain/No Update  and  Playmode/Human-Human
  474.       from menu. Now start the game with  Project/Start-Game  and  play  the
  475.       moves which you can see in the Move-Chain-Window. Then  you  can  save
  476.       this way to checkmate by selecting Project/Save Game.
  477.  
  478.     "Stop Game"
  479.        
  480.       Terminates the current game (or solving for mate).
  481.  
  482.     "Save Game"
  483.        
  484.       With this function you can save a game, to go on playing it  later  or
  485.       to  analyse  it  later.  You  can  save  it  in  Buildup-Mode  and  in
  486.       Playing-Mode. If there is no game in memory, or the board is modified,
  487.       then only the board is saved. Please note the following: Whenever  you
  488.       make a saving-operation, like "Save Game" or "Print Movelist", or when
  489.       you add a game to the Opening-Library, then the game is saved only  to
  490.       the current position in the game. This means, if you have take back  a
  491.       move with "Extras/Undo", then this move is not saved. (This is  not  a
  492.       restriction, but a feature. So you can prevent  saving  the  last  bad
  493.       move of a game. If you wants to  save  the  whole  game,  just  select
  494.       "Setup/Last Move" or "Extras/Redo" from menu before saving.)
  495.  
  496.     "Save Movelist"
  497.        
  498.       The actual game is saved as a text file in algebraic notation.
  499.  
  500.     "Print Movelist"
  501.        
  502.       The actual game is printed as a text file in algebraic notation.
  503.  
  504.     "Give Up"
  505.        
  506.       A Requester will ask you if you really wants to give up. If  so,  then
  507.       the game will stop, and the default  comment  to  this  game  will  be
  508.       "White/Black gave up".
  509.  
  510.     "Offer Draw"
  511.        
  512.       Use this to propose a draw. In release 3.5 a draw is always  accepted,
  513.       if    the     current     position     has     occured     3     times
  514.       (Position-repeatition-rule) or if there was no progress in the last 50
  515.       moves (50-moves-rule). (The game ended in a draw, neigther  side  won.
  516.       In german we use the word Remis, I think it's a french word.)
  517.  
  518.     "About"
  519.        
  520.       This item displays the address of the author of VChess.
  521.  
  522.     "Quit"
  523.        
  524.       Terminates the program.
  525.  
  526.   Players
  527.   -------
  528.     "Human-Human"
  529.        
  530.       Two human players play against each other.
  531.  
  532.     "Human-Amiga"
  533.        
  534.       A human player plays with the white pieces against the computer.
  535.  
  536.     "Amiga-Human"
  537.        
  538.       The computer plays with the white pieces against a human player.
  539.  
  540.     "Amiga-Amiga"
  541.        
  542.       Computer plays against computer.
  543.  
  544.   Time
  545.   ----
  546.     With this menu you can change the thinking-time of the computer:
  547.  
  548.     "10 Secs, 20 Secs, 30 Secs"
  549.        
  550.       Thinking-time is 10, 20 or 30 seconds.
  551.  
  552.     "1 Min, 2 Mins, 3 Mins, 5 Mins, 10 Mins, 30 Mins"
  553.        
  554.       Thinking-time is 1, 2, 3, 5, 10 or 30 minutes.
  555.  
  556.     "1 Hour, 3 Hours, 8 Hours, 12 Hours, 24 Hours"
  557.        
  558.       Thinking-time is 1, 3, 8, 12 or 24 hours.
  559.  
  560.     "Infinite"
  561.        
  562.       The computer calculates until a mate is found,  or  until  you  select
  563.       "Extras/Break" to force the computer to make his move.
  564.  
  565.     "Custom"
  566.        
  567.       With this function you can enter a custom thinking-time. With the four
  568.       gadgets you can determine if your input  is  in  seconds,  minutes  or
  569.       hours. If you only press <Return>, then your input is assumed to be in
  570.       seconds. 
  571.  
  572.     "Equal ?"
  573.        
  574.       If this item is marked, then the computer will adapt its thinking time
  575.       to the thinking time of the human player.
  576.  
  577.     "Full ?"
  578.        
  579.       If this item is marked, then the computer will use the  full  thinking
  580.       time. Otherwise he will sometimes make his move a little bit  earlier.
  581.       (In most cases activating this item means wasting of time.)
  582.  
  583.   Thinklist
  584.   ---------
  585.     "Refresh"
  586.        
  587.       The computer is always thinking for the active  player,  even  if  the
  588.       active player is a human player. If you select  this  item,  then  the
  589.       list of all currently possible moves together with their valuation  is
  590.       displayed. Of course the valuation may change with time,  because  the
  591.       computer is thinking deeper and deeper. So if  you  select  this  item
  592.       after some time again, the valuation will be not  the  same.  You  can
  593.       also select this item if the computer is the active player, to see how
  594.       the computer evaluates the different moves. (In release 2.0 this  item
  595.       was called "Help", because usually a human player would use it  if  he
  596.       didn't know what move he should make.)
  597.  
  598.     "Refresh & Sort"
  599.        
  600.       Like "Refresh", but the moves are displayed sorted, best move  at  the
  601.       top.
  602.  
  603.     "Show old List"
  604.        
  605.       This item is similar to "Refresh", but it  displays  not  the  current
  606.       (active) list, but the old list containing the last move. Sometimes it
  607.       is necessary to take a look on  the  old  list,  for  example  if  the
  608.       computer makes a strange move, and you want to find out  why  he  made
  609.       such a move. If the list containing this strange,  last  move  is  not
  610.       visible, then select this item to display it again.
  611.  
  612.     "Show old List sorted"
  613.        
  614.       Like "Show old List", but the moves are displayer sorted, best move at
  615.       the top.
  616.  
  617.     "Show Best Chain"
  618.        
  619.       Displays the Movechain of the currently best move. (You can  use  this
  620.       item or "Refresh & Sort" to get help from the computer.) Please  note:
  621.       The best move is not always the one with the  highest  valuation!  The
  622.       computer may prefer a move  with  a  smaller  valuation,  but  with  a
  623.       greater depth!
  624.  
  625.     "Beep if updated ?"
  626.        
  627.       If this item is marked, then the computer makes an audible beep if the
  628.       Thinklist- or MoveChain-Window is updated.
  629.  
  630.     "Show sorted ?"
  631.        
  632.       If this item is marked, then the Thinklist is displayed sorted.
  633.  
  634.     "Update Display"
  635.        
  636.       "If changed ?"
  637.          
  638.         Update Thinklist and Move-Chain whenever there are changes. This may
  639.         slow down the calculating  power,  because  in  early  states  of  a
  640.         thinking- process (the first seconds) there  are  many  changes  per
  641.         time interval.
  642.  
  643.       "Automatic ?"
  644.          
  645.         Update Thinklist and Move-Chain if it is useful, for  example  after
  646.         2, 5, 10, 20, 30, 60 seconds, and then whenever there are changes.
  647.  
  648.       "No Update ?"
  649.          
  650.         Only    update    the    display,    when    the     user     select
  651.         "Thinklist/Refresh & Sort" or an equal item. The "Move-Chain"-window
  652.         is updated, if the user clicks on an entry in the Thinklist.
  653.  
  654.     "Refresh if"
  655.        
  656.       "It's Computer's turn ?"
  657.          
  658.         Refresh Thinklist and Move-Chain, if  the  computer  is  the  active
  659.         player.   
  660.       "It's Your turn ?"
  661.          
  662.         Refresh Thinklist and Move-Chain, if a human is the active player.
  663.  
  664.     "Update MoveChain"
  665.        
  666.       "Best Move ?"
  667.          
  668.         Display in the Movechain-Window the best move.
  669.  
  670.       "Current Move ?"
  671.          
  672.         Display in the Movechain-Window the current (last calculated)  move.
  673.          
  674.       "No Update ?"
  675.          
  676.         Don't update the Move-Chain-Window automatically. The  "Move-Chain"-
  677.         window is updated, if the user clicks on an entry in the  Thinklist.
  678.          
  679.   Display
  680.   -------
  681.     "Show Movelist"
  682.        
  683.       The helpwindow, which shows the moves of the current game,  is  opened
  684.       or brought to the front.
  685.  
  686.     "Show Thinking"
  687.        
  688.       This function will open the window, which shows the valuation  of  all
  689.       currently possible moves, or brings this  window  in  front  of  other
  690.       windows.
  691.  
  692.     "Show MoveChain"
  693.        
  694.       If you select this item, then the window, which displays the movechain
  695.       of a special move, is opened or brought to the front.
  696.  
  697.     "Rotate"
  698.        
  699.       "90+, 180, 90-"
  700.          
  701.         With these items you can rotate the board.
  702.  
  703.     "Change Colors"
  704.        
  705.       If you select one  of  the  following  eleven  items,  then  a  Colour
  706.       requester is opened. Click on the colour, which should be used for the
  707.       drawing. If you use a custom-screen, you can use the sliders to change
  708.       the colour-values. But if you play on a public-screen, it's better  to
  709.       select only one colour. You can only select one colour at a  time.  If
  710.       you click on "Ok", then the board is drawn with the  selected  colour.
  711.       For pieces and squares you can select two colours, A and B.  Colour  B
  712.       is used for the border of the pieces, and although if the squares  are
  713.       not monochrome (pattern).
  714.  
  715.       "White Pieces A"
  716.          
  717.         Colour A (inner) of white pieces.
  718.  
  719.       "White Pieces B"
  720.          
  721.         Colour B (border and pattern) of white pieces.
  722.  
  723.       "Black Pieces A"
  724.          
  725.         Colour A (inner) of black pieces.
  726.  
  727.       "Black Pieces B"
  728.          
  729.         Colour B (border and pattern) of black pieces.
  730.  
  731.       "White Squares A"
  732.          
  733.         Colour A of white squares
  734.  
  735.       "White Squares B"
  736.          
  737.         Colour B of white squares
  738.  
  739.       "Black Squares A"
  740.          
  741.         Colour A of black squares
  742.  
  743.       "Black Squares B"
  744.          
  745.         Colour B of black squares
  746.  
  747.       "Board-Border"
  748.          
  749.         Colour of the border of the board.
  750.  
  751.       "Board-Text"
  752.          
  753.         Colour of the text of the board. (1..8, a..h, and chess clocks )
  754.  
  755.       "Rectangle"
  756.          
  757.         Colour of the rectangle, which is drawn around a selected  piece  or
  758.         square.
  759.  
  760.     "Change Patterns"
  761.        
  762.       You can select between four different patterns  for  the  squares  and
  763.       pieces: Mono (only colour A), points, lines up and lines down.
  764.  
  765.       "White Pieces"
  766.          
  767.         Pattern for white pieces
  768.  
  769.       "Black Pieces"
  770.          
  771.         Pattern for black pieces
  772.  
  773.       "White Squares"
  774.          
  775.         Pattern for white squares
  776.  
  777.       "Black Squares"
  778.          
  779.         Pattern for black squares
  780.  
  781.       If the display looks ugly on your screen, you should try other colours
  782.       and patterns. The defaults look nice on an hires-interlace-screen with
  783.       OS2.0-colours, but if  you  have  to  play  on  a  screen  with  lower
  784.       resolution or different colours, then it's a good idea  to  try  other
  785.       colour-selections and patterns.
  786.  
  787.     "Setup Mode ?"
  788.        
  789.       The board gets a border on the left and right  side.  On  this  border
  790.       rest some chessmen. In the Buildup-Mode, you can select  these  pieces
  791.       and use them to build up a position. Also you can move pieces  on  the
  792.       border to throw them away. In playing-mode the border has no function.
  793.        
  794.     "Coordinates ?"
  795.        
  796.       If you turn off coordinates, you have more room for the pieces. But  I
  797.       think this is only necessary if you have to play on a screen with very
  798.       low resolution.
  799.  
  800.     "Chess Clock ?"
  801.        
  802.       You can turn off the clock. If you have turned off coordinates,  clock
  803.       is always turned of too.
  804.  
  805.     "Squareframes"
  806.        
  807.       "White ?"
  808.          
  809.         Draw a frame in colour A around white squares
  810.  
  811.       "Black ?"
  812.          
  813.         Draw a frame in colour A around black squares
  814.  
  815.     "Change Screen"
  816.        
  817.       With this item you can select if you  want  to  play  on  the  default
  818.       public screen, on a public screen or on a custom screen. If  you  want
  819.       to play on a public screen, you have to type in its name. If you  want
  820.       to play on a custom screen, it is recommended to  use  a  screen  with
  821.       four or eight colours. It is possible to use a screen  with  only  two
  822.       colours, but this will not look very nice. More than eight colours are
  823.       not recommended, because VChess currently doesn't use more than eleven
  824.       different colours. Please keep in mind,  that  screen  resolution  and
  825.       number of colours may affect the calculating speed of  your  computer.
  826.       For example on my A3000 calculating speed is degraded about 50%  if  I
  827.       use a hires-16-color-screen or Productivity-Mode. Note that  parts  of
  828.       the pulldown-menu may be invisible if you use a large screenfont and a
  829.       screen with a low horizontal resolution.
  830.  
  831.     "Screenfont"
  832.        
  833.       If you play on a custom screen, then you can select a  font  which  is
  834.       used for menus and windowtitles.
  835.  
  836.     "Textfont"
  837.        
  838.       With this function you can select a font which is used in  the  active
  839.       window. First click in the desired window to make it the  active  one,
  840.       then select this item. So you can  select  different  fonts  for  each
  841.       window. (Selection of a proportional font may give strange results.)
  842.  
  843.   Set Up
  844.   ------
  845.     You can access this menu only if you are in Buildup-Mode, maybe you have
  846.     to select "Project/StopGame" before.
  847.  
  848.     "Load Game"
  849.        
  850.       With this function you can load a game, to analyse it or go on playing
  851.       it. For example you can select the item "Next Move" multiple times  to
  852.       go  to   a   desired   position   in   a   game,   and   then   select
  853.       "Project/StartGame" to start playing from this position. If  you  have
  854.       loaded a game, then the position is at the beginning of this game.  So
  855.       if you want to continue a loaded  game,  it  is  necessary  to  select
  856.       "Last Move" before starting the game. There is a good  reason  why  we
  857.       don't jump to the last move automatically:  Maybe  you  got  a  solved
  858.       Chesstask on disk, for example  a  "mate  in  3".  If  you  load  this
  859.       chesstask, you probably will try to  find  the  solution  by  yourself
  860.       first. Only if you can't see it, you will use "Next Move" from menu to
  861.       display it.
  862.  
  863.     "First Move"
  864.        
  865.       Jumps to the first (really the one before) move of the actual game.
  866.  
  867.     "Next Move"
  868.        
  869.       The next move is performed.
  870.  
  871.     "Previous Move"
  872.        
  873.       Takes back the last move.
  874.  
  875.     "Last Move"
  876.        
  877.       Jumps to the last move of the actual game.
  878.  
  879.     "Replay Game"
  880.        
  881.       Replays the actual game from the current position to the last move  of
  882.       this game. To replay from the beginning, it may be necessary to select
  883.       "First Move" before. The speed of replay depends on  "Extras/Blinken",
  884.       see below. If you  make  any  user-input  in  the  boardwindow  during
  885.       replaying, like mouseclick or  menu  operation,  then  the  replay  is
  886.       terminated.
  887.  
  888.     "Clear Board"
  889.        
  890.       All pieces are removed from the board.
  891.  
  892.     "Build Up"
  893.        
  894.       All pieces are moved to their start-position.
  895.  
  896.     "Reset"
  897.        
  898.       Resets a modified board. This is useful, if there is a game in  memory
  899.       (just played or loaded), and you have modified  the  board  by  moving
  900.       pieces (or changed the active colour with the following two items). In
  901.       this case it is not possible to  go  on  playing  this  game,  to  use
  902.       "Next Move", "Previous Move" etc. Instead of pushing  back  all  moved
  903.       pieces, you can use this item to reset the board and active colour.
  904.  
  905.     "White's turn"
  906.        
  907.       The white player has to do the next move.
  908.  
  909.     "Black's turn"
  910.        
  911.       The black player has to do the next move.
  912.  
  913.   Config
  914.   ------
  915.     You can save all settings in a configuration-file.
  916.  
  917.     "Load"
  918.        
  919.       Loads a configuration and activates it.
  920.  
  921.     "Save"
  922.        
  923.       Saves the actual settings as defaults.  The  program  will  use  these
  924.       settings at the next start.  The  settings  are  stored  in  the  file
  925.       VChess.config, or if the drawer Configs exists, in this drawer.
  926.  
  927.     "Save As"
  928.        
  929.       With this function you can save additional configurations,  which  you
  930.       can load and activate again with "Config/Load" .
  931.  
  932.     "Last Saved"
  933.        
  934.       This function activates the configuration which was used at the  start
  935.       of the program, or which was saved with "Save". This is the file named
  936.       Configs/VChess.config or VChess.config.
  937.  
  938.     "Reset to defaults"
  939.        
  940.       Resets all settings to defaults.
  941.  
  942.   Extras
  943.   ------
  944.     "Store this Pos."
  945.        
  946.       Stores the current position. You can use this function in Playing- and
  947.       Buildup-Mode. This is very useful, if you try to solve a  chess  task,
  948.       or to develop  new  openings  or  if  you  are  playing  letter  chess
  949.       (exchanging single moves with a friend by letters, EMail or phone.)
  950.  
  951.     "Restore old Pos."
  952.        
  953.       Restores the stored position.
  954.  
  955.     "Set White's Aggr., Set Black's Aggr."
  956.        
  957.       With these two items you can change the aggression of the computer. If
  958.       you enter the number N, then this means that the computer will  assign
  959.       the pieces of his opponent a new value: 
  960.       NewValue:=(RealValue + (RealValue*N/100).
  961.       The values of his own pieces remain unchanged. So, if  you  entered  a
  962.       positive value, then the computer will  give  the  opposite  pieces  a
  963.       greater value than his own pieces, and will  play  a  more  aggressive
  964.       game, maybe he will try to exchange a pawn of his own with a  pawn  of
  965.       his opponent. If you enter a negative value, then  the  computer  will
  966.       play a less aggressive game, he will try to prevent  the  exchange  of
  967.       equal pieces.
  968.  
  969.       White's aggression is only important if the computers plays  with  the
  970.       white pieces. If the computer plays with the black pieces, you have to
  971.       use "Set Black's Aggr.". You will only have to use both items, if  the
  972.       computer plays with white and black pieces (Playmode Amiga-Amiga).  So
  973.       you can see what happens, if a aggressive computer player plays  again
  974.       an un-aggressive computer player.
  975.  
  976.     "Valuation"
  977.        
  978.       The computer will evaluate the current position. But this valuation is
  979.       only an  approximation,  only  the  pieces  on  the  board  and  their
  980.       strategic positions are taken into account. It is not regarded if  one
  981.       chessman can capture an other chessman, or if a mate will occur  after
  982.       some moves.
  983.  
  984.     "Break"
  985.        
  986.       With this function you can force the computer to make his move. Useful
  987.       if you are not very patient.
  988.  
  989.     "Undo last Move"
  990.        
  991.       With this function you can take back the last  move.  The  chess-rules
  992.       don't allows this, but I think some  people  will  use  this  function
  993.       sometimes. Of course you can take back many moves  by  selecting  this
  994.       function again and again.
  995.  
  996.     "Redo the Move"
  997.        
  998.       The move which you have taken back is again performed.
  999.  
  1000.     "Pause"
  1001.        
  1002.       This function stops the chess clocks, and sets the thinking-process to
  1003.       a very low priority, so no  computing-power  is  consumed.  The  break
  1004.       automatically ends, if an user input is registered.
  1005.  
  1006.     "Set Task Pri."
  1007.        
  1008.       With this function you  can  modify  the  priority  of  this  program.
  1009.       Generally you  will  not  need  this  function.  Because  a  permanent
  1010.       modification  of  priority  is  not  useful,  it  is  not  stored   in
  1011.       configuration files. At the next start of VChess, the priority will be
  1012.       again zero (if started from workbench) or equal to the priority of the
  1013.       shell-process  (if  started  from  shell).   The   priority   of   the
  1014.       thinking-process is always one point lower than the  priority  of  the
  1015.       main process. So user input is always processed in real-time.
  1016.  
  1017.     "Create Icons ?"
  1018.        
  1019.       With this item you can select if the program  shall  create  icon  for
  1020.       saved files. If the program  has  to  make  Icons,  then  one  of  the
  1021.       following icons is copied if it exist, or defaults are used.
  1022.  
  1023.       Filetype          Used Icon (if it exists)
  1024.       ------------------------------------------
  1025.       Game              "Icons/GameIcon", "GameIcon", "Games/Game1", "Game1"
  1026.       Configuration     "Icons/ConfigIcon", "ConfigIcon",
  1027.                         "Configs/VChess.config", "VChess.config";
  1028.       Textfile          "Icons/TextIcon", "TextIcon", "Text/Text1", "Text1"
  1029.  
  1030.       Additional, if using Locale.library, for each filetype there  are  two
  1031.       language-dependant Iconnames. For "deutsch" these are:
  1032.  
  1033.       Filetype          Icons for deutsch language (if it exists)
  1034.       ------------------------------------------
  1035.       Game              "Spiele/Spiel1", "Spiel1"
  1036.       Configuration     "Configs/VChess.config", "VChess.config";
  1037.       Textfile          "Texte/Text1", "Text1"
  1038.  
  1039.        
  1040.     "Use Openings ?"
  1041.        
  1042.       If  this  item  is  marked,   then   the   computer   will   use   the
  1043.       Opening-library. (Please don't be confused, the Opening-library is not
  1044.       a Library like ReqTools.library, but just a collection  of  openings.)
  1045.       The filename of this library is VChessOpenings. This file must  reside
  1046.       in the same directory as the program VChess (PROGDIR:). (I think there
  1047.       is no reason to hide it in sub-directories, or to use  more  than  one
  1048.       Opening-library.) Using this library means that the computer needs  no
  1049.       thinking time for the first moves, and  the  playing-strength  of  the
  1050.       computer is greater. Of course the library can only be  used,  if  the
  1051.       game starts from initial position with white  as  the  active  player.
  1052.       Note that the opening-library is loaded if playing starts. This means,
  1053.       if you deactivate this item before you start playing, the library will
  1054.       not be loaded in memory. This will save some memory, so that it may be
  1055.       possible to use VChess on Amigas with only 512 K.
  1056.  
  1057.     "Teaching ?"
  1058.        
  1059.       With this function you can switch  on  a  teaching-mode.  If  you  are
  1060.       playing and it is your turn, and  you  click  on  a  piece,  then  all
  1061.       squares on which the chessman can be moved are marked.  This  is  very
  1062.       useful for children learning chess.
  1063.  
  1064.     "Sound ?"
  1065.        
  1066.       If this item is activated, then a sound is generated when the computer
  1067.       makes its move.
  1068.  
  1069.     "PlayMode"
  1070.        
  1071.       With the following four items you can modify the  thinking-process  of
  1072.       the computer. In the actual release 3.5 of  VChess  only  the  subitem
  1073.       "Extend"  has  a  function,  the  other  three  items  are  internally
  1074.       deactivated. I have not removed them, because it is possible that they
  1075.       will get a function in a new release of VChess again.
  1076.  
  1077.       "Reduce ?"
  1078.          
  1079.         If this item is marked,  then  the  computer  will  cut  some  (bad)
  1080.         branches of the chess tree to save time. For solving for  mate  this
  1081.         may be harmful, so if  you  select  "Project/SolveForMate"  then  no
  1082.         branches are cut. If  you  play  letter  chess,  and  you  give  the
  1083.         computer some hours for thinking, then it may be useful to de-select
  1084.         this item.
  1085.  
  1086.         Attention: Currently, in release 3.5 this item has no function!
  1087.  
  1088.       "Extend ?"
  1089.          
  1090.         If this item is marked, then the computer will extend some  branches
  1091.         of the chess tree, especially capture-sequences and check-offers. In
  1092.         normal playing, such a depth-extension is  always  useful,  so  this
  1093.         function is always  activated  internally  in  normal  playmode.  If
  1094.         solving for mate, depth-extension is useful too in  most  cases,  so
  1095.         this item should be activated too. But in special cases, if you  are
  1096.         sure that the checkmate is not a result of many  check-offers,  then
  1097.         it may be useful to deactivate this item.
  1098.  
  1099.       "Estimate ?"
  1100.          
  1101.         If this item is marked, then the computer will try  to  estimate  if
  1102.         the last nodes in the tree are good or bad moves. (In a  given  time
  1103.         period, the computer can only calculate some half  moves  deep,  for
  1104.         example five half moves. In the last half move it  may  be  possible
  1105.         for a player to capture a Rook with a Queen. To decide, if this is a
  1106.         very good move (win a Rook) or a very bad move (win a rook, but lose
  1107.         the queen) the computer has to calculate the next half move  of  the
  1108.         opponent. But there is not enough time to do this, and in  the  next
  1109.         half move there will be with great probability a similar problem. So
  1110.         the computer have to cut  the  movechain,  and  can  only  guess  or
  1111.         estimate if the last move in the chain is a good or bad move.)
  1112.  
  1113.         Attention: Currently, in release 3.5 this item has no function!
  1114.  
  1115.       "Strategy ?"
  1116.          
  1117.         If this item is marked, then the computer  will  take  into  account
  1118.         strategy, for example it is generally better if the  Knight  resides
  1119.         in the centre of the board.  This  item  should  always  be  marked,
  1120.         because  playing  without  strategy  will  result  in  a  very   low
  1121.         playing-strength.
  1122.  
  1123.         Attention: Currently, in release 3.5 this item has no function!
  1124.  
  1125.     "Random"
  1126.        
  1127.       With this item you can make the play of the computer more interesting.
  1128.       Principle the computer would do always  the  same  move  in  the  same
  1129.       situation, because he calculates the best move. But to the  result  of
  1130.       the calculation a random number is added. With this function  you  can
  1131.       select the upper border of this number. 100 points are  equal  to  the
  1132.       (virtual) win of a pawn.
  1133.  
  1134.       "0, 25, 50, 100"
  1135.          
  1136.         The random value is in the range between zero and 0, 25, 50 or  100.
  1137.         If you select "0", then the computer always will do the same move in
  1138.         the same situation. If you select "50", then to each calculated gain
  1139.         a random number between 0 and 50 is added.
  1140.  
  1141.         In late endgame,  i.e.  King  vs  (King+Bishop+Knight),  it  may  be
  1142.         usefull to  select  a  smaller  Random-Value,  i.e.  less  than  16.
  1143.         Otherwise, with Random-Value >=25, it may occur  that  the  Computer
  1144.         can not force a mate in less than 50 moves. Large  Random-Values  in
  1145.         conjunction with small  thinking-time  in  Endgame  sometimes  gives
  1146.         strange results, because the computer will always try to  prevent  a
  1147.         repetition of a position.
  1148.  
  1149.       "Custom"
  1150.          
  1151.         With this function you can enter a custom  upper  boundary  for  the
  1152.         random number. If the boundary is high, then the playing-strength of
  1153.         the computer will decrease. But maybe this is what you want.
  1154.  
  1155.     "Blinken"
  1156.        
  1157.       "0, 1, 3, 5"
  1158.          
  1159.         If pieces are moved, they blink a few times. So you better  can  see
  1160.         which move the computer makes. You can select between 0 to 5 blinks.
  1161.         This blinking is also used if you have loaded a game and replays  it
  1162.         with "Replay" or "Next Move".
  1163.  
  1164.   Openings
  1165.   --------
  1166.     With this menu you can  modify  the  opening-library.  Most  people  can
  1167.     ignore this menu.
  1168.  
  1169.     "Add this Game"
  1170.        
  1171.       If you select this item,  then  the  current  game  is  added  to  the
  1172.       opening-library.   With   this   function   you   can    expand    the
  1173.       opening-library.  (To  create  a  new  one,  just  delete   the   file
  1174.       VChessOpenings before starting VChess.) There  is  room  for  48  half
  1175.       moves of a game in the opening-library. If the current game  has  more
  1176.       moves, the remainder is ignored. Of course you can  add  only  regular
  1177.       games, this means games started from their initial position and  white
  1178.       as active player. If you will add an opening from a chess book, it  is
  1179.       recommended to do it in this way: Select "Players/Human-Human" and now
  1180.       "Project/NewGame". Now you can play the opening  from  the  book,  and
  1181.       then select this item to add it to the library. You have to enter  the
  1182.       name of this opening, the name may not have more than  32  characters.
  1183.       If this name already exists,  you  will  get  an  error  message.  Try
  1184.       another name. (Currently all names of openings are German  names.  The
  1185.       reason is that I have only German chess books, and it's  difficult  to
  1186.       find good translations for the names.)
  1187.  
  1188.       If an opening, which you  add  to  the  library  is  already  in  this
  1189.       library, but with another name, then  there  are  two  cases:  If  the
  1190.       opening in the library contains more moves, then an error  message  is
  1191.       displayed and your opening is  not  saved.  But  if  your  opening  is
  1192.       bigger, then your opening will over write the old one.
  1193.  
  1194.       You should only add your own openings (games) to the  library  if  you
  1195.       are a very strong player, because an opening should contain only  very
  1196.       strong moves. If there is only one weak move, then the computer may do
  1197.       this weak move and the playing-strength decreases.
  1198.  
  1199.       Please note the following: If you want  to  add  new  entries  to  the
  1200.       Opening-Library, it is necessary  to  load  the  existing  library  in
  1201.       memory before you add new  entries.  So  ensure  that  the  menu  item
  1202.       "Extras/Use Openings" is on before you  select  "Project/New Game"  to
  1203.       enter a new Opening. In this  case  the  existing  Opening-Library  is
  1204.       loaded automatically.
  1205.  
  1206.     "Delete actual"
  1207.        
  1208.       With this function you can delete the actual opening, this means  this
  1209.       one which is just used by the computer. This can be useful, if you are
  1210.       playing against the computer and notice that the computer uses a wrong
  1211.       or weak opening.
  1212.  
  1213.     "Delete by name"
  1214.        
  1215.       With this function you can delete an opening by name.
  1216.  
  1217.     "Dump to File"
  1218.        
  1219.       This function writes all openings to a file in algebraic notation. You
  1220.       can look at this file with a text viewer, or print it out.
  1221.  
  1222.     "Save all Entries"
  1223.        
  1224.       If you select this item, then the opening-library  is  saved.  If  you
  1225.       forgot this, all modifications are lost. 
  1226.  
  1227.  
  1228. Now, at the end of this text, some general remarks:
  1229.  
  1230. Errors or bugs in VChess
  1231.    
  1232.   I'm sure that there are some small bugs in this version of  VChess.  Don't
  1233.   hesitate to write to me if you find bugs or have  comments  about  VChess.
  1234.   But please don't expect a (long) response to each of your short letters. I
  1235.   am studying physics, so I  don't  have  much  free  time  to  answer  your
  1236.   letters.
  1237.  
  1238. New releases of VChess
  1239.    
  1240.   There are still  some  things  which  may  be  improved.  Transfering  the
  1241.   thinking-algorithm  from  Oberon   to   Assembler   would   increase   the
  1242.   calculating-power by a factor 3. And a bigger Opening-library, (with a new
  1243.   data-structure to save space) would be nice, a large  Chess-Database  too.
  1244.   And an ARexx-port may be useful too. But I am not sure if  there  will  be
  1245.   new releases  of  VChess  on  the  Amiga.  Til  now  (1.12.1995)  only  58
  1246.   VChess-user paid there contribution.  This  is  not  enough.  Perhaps  the
  1247.   playing-strength was too low in former releases of VChess, this may be the
  1248.   reason why only so few people paid there contribution.  But  if  not  much
  1249.   more people will pay for this release, then I think that I must  stop  the
  1250.   furher development on the Amiga. Maybe there will be a  transformation  of
  1251.   VChess on a Pentium- or RISC-CPU in the far away future. But that  release
  1252.   will not be Shareware again!
  1253.  
  1254. VChess and other languages
  1255.    
  1256.   It is allowed to make verbatim translations of this  documentation  or  to
  1257.   produce new catalog files for other languages. You  can  distribute  these
  1258.   translations (together  with  the  VChess-package)  in  your  own  country
  1259.   without asking me for permission, but please don't make free, shortened or
  1260.   buggy translations. You should only make translations, if you  are  really
  1261.   using VChess, so that you can verify your work. (I think no translation is
  1262.   better than a bad one.) Making a translation is a lot of work, so  it  may
  1263.   be useful to contact me before starting with the translation. Maybe  there
  1264.   is already a new release of VChess, or someone else has already  made  the
  1265.   desired translation. If you have produced a really good translation,  then
  1266.   you can send it to me. Maybe I will add it to the VChess-package.
  1267.  
  1268.   By using the Locale.library, VChess can adapt itself to other languages if
  1269.   running under OS2.1+. Currently english, deutsch, français and svenska are
  1270.   supported. But the file VChess.cd is part of this package. So if you  have
  1271.   the program CatComp (© CBM) (or a FD-Program which works like CatComp) and
  1272.   you know how to use CatComp, then you can produce  Catalogfiles  for  your
  1273.   preferred language. Although English is the built-in language  of  VChess,
  1274.   there exists an English VChess.ct-file. You can use  this  (together  with
  1275.   CatComp and locale.library) to adapt the English text to your own  desire.
  1276.   (Modify the VChess.ct-file, use CatComp to create the  VChess.catalog-file
  1277.   (Usage: CatComp VChess.cd TRANSLATION  VChess.ct  CATALOG  VChess.catalog)
  1278.   and then copy the VChess.catalog-file to  Catalogs/english/VChess.catalog.
  1279.   If you now start VChess again (after a reset or "avail flush"), you should
  1280.   get the new text.)
  1281.  
  1282.   If  you   modify   Catalog-translations   (VChess.ct),   or   create   new
  1283.   translations, please note this: If a menu item  should  get  a  short-cut,
  1284.   insert at the beginning of the text string the letter  for  the  short-cut
  1285.   and the characters "\x00". For example, to create a short-cut for the menu
  1286.   item "New Game", create this string: "P\x00Fresh Game". This will give the
  1287.   item text "Fresh Game" with the short-cut "P" (Play). (This  is  the  way,
  1288.   which Nico Francois uses to  create  short-cuts  for  ReqToolsPrefs.)  The
  1289.   advantage is, that you can create Short-cuts for any number of items.  But
  1290.   be careful, only insert Short-cut-Characters  in  Item  text  or  Sub-item
  1291.   text, but not in other strings! (Unfortunately, there is a little problem:
  1292.   If a menu item has no short-cut, and the text is only one character  long,
  1293.   this may look like an item with a short-cut but no text. To prevent  this,
  1294.   you can insert an additional space, or append an additional "\x00". So  to
  1295.   create an item without a short-cut and with the text "1" you  can  type  "
  1296.   1", "1 " or "1\x00". (If the item has a  short-  cut,  then  there  is  no
  1297.   problem, you can type for example "1\x001". This will result  to  an  item
  1298.   with text "1" and short-cut "1".)) In the Catalog-translations, there  are
  1299.   some strings which contains vertical bars, "|". These  characters  have  a
  1300.   special meaning for ReqTools.library. They divide the text  for  different
  1301.   response-gadgets, so don't delete  these  characters.  If  such  a  string
  1302.   contains any number of these characters, the number must remain  constant.
  1303.   Some strings may contain the characters "%ld". This is used  to  insert  a
  1304.   number, so don't delete this. Some strings contain "\x20". This is only  a
  1305.   space, you may delete it, but this is not recommended. Some  strings  must
  1306.   have a special length, look at the file VChess.cd  to  read  this  length.
  1307.   (/6/8) for example means, that the minimum length  is  6  characters,  and
  1308.   maximum length is 8 characters. Some strings contain a "\n". This is  only
  1309.   to write  the  following  text  on  a  new  line.  Most  strings  have  no
  1310.   limitations in length, but if you create too long  strings,  it  may  look
  1311.   ugly.
  1312.  
  1313.   And now I hope that you enjoy this game.
  1314.  
  1315.   Stefan Salewski, December 1995
  1316.  
  1317.