home *** CD-ROM | disk | FTP | other *** search
/ Amiga ACS 1997 #3 / amigaacscoverdisc / games / shareware / vchess / vchess.doc < prev    next >
Text File  |  1996-12-28  |  75KB  |  1,683 lines
  1.  
  2.          VChess 4.1 - A Chess game for Amiga-Computers (OS 2.0-3.1)
  3.                        © 1993-1996 by Stefan Salewski
  4.                             All Rights Reserved
  5.  
  6. Copyright and other legal stuff
  7. ===============================
  8.    
  9.   VChess is NOT a PD-Program, but fully functional (non crippled) Shareware!
  10.   VChess and most other files of this package are Copyright ©  1993-1996  by
  11.   Stefan Salewski.
  12.  
  13.   In spite of several tests, no warranty is made that there are no errors in
  14.   VChess. YOU USE THIS PROGRAM AT YOUR OWN RISK. In no case I will be liable
  15.   for any damage, direct or indirect, resulting by the use of VChess.
  16.  
  17.   The complete VChess 4.1-Package contains the following files:
  18.  
  19.   File or directory       Size   Meaning
  20.   ------------------------------------------------------------------------
  21.   VChess                138804   Mainprogram, V4.1, © S.Salewski
  22.   VChess.doc             75477   English documentation
  23.   VChessOpenings          3280   1630 Halfmoves
  24.   Product-Info            1883   For KingFisher 2.0 or similar tools.
  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   English Catalog
  29.   Configs                  Dir   Example-Configurations
  30.   Checkmates               Dir   Some Checkmates (mate in 2, 3 or 4 moves)
  31.   Chesstasks               Dir   Some Chesstasks(find the best move)
  32.   Catalog-Translations     Dir   Only English
  33.  
  34.   This release of  VChess  is  again  freely  distributable.  Permission  is
  35.   granted to include this package in free "Public-Domain"- collections, like
  36.   the good old Fred  Fish's  Amiga  FD-Disk  Library  or  the  great  german
  37.   "Berliner Spielekiste". The prefered way of distribution is by AmiNet  and
  38.   other free FTP-Servers!
  39.  
  40.   Distribution of VChess is only allowed if  the  following  conditions  are
  41.   fulfilled:
  42.  
  43.   All these files must  remain  unmodified.  None  of  these  files  may  be
  44.   distributed on its own, the entire package must be distributed together.
  45.  
  46.   (It is allowed to archive these files  with  archiving-programs  like  LHA
  47.   (© Stefan Boberg) if it is possible to retrieve the files from the archive
  48.   in their original state.)
  49.  
  50.   The complete package may be (in archived form) uploaded to Bulletin  Board
  51.   Systems or FTP servers.
  52.  
  53.   PD-dealers and other people who want to distribute VChess are only allowed
  54.   to take money for the floppy disk and copying  efforts.  Nobody  may  take
  55.   more than $3(US) or DM 4 for the disk with VChess. This is also  valid  if
  56.   there is other software besides VChess on the Disk.
  57.  
  58.   The distribution of VChess in "Software Packages"  (more  than  one  disk)
  59.   together with other Software is only allowed with my written permission.
  60.  
  61.   The distribution of VChess on CD-ROM is only allowed if the price  of  the
  62.   CD-ROM in not greater than US$0.2 per megabyte. This  means,  that  nobody
  63.   may sell a CD-ROM containing VChess and 100 Megabytes  of  other  software
  64.   for a price greater than US$20.
  65.  
  66.   Distribution of VChess together with commercial software is forbidden.
  67.  
  68.   Distribution of VChess 4.1 on "Coverdisk" of Computer  magazines  is only
  69.   allowed with my written permission!
  70.  
  71.   (Some Computer-Magazines put older releases of VChess on their  coverdisc,
  72.   without  asking me for permission. And they don't gave me anything for it.
  73.   I will not tolerate any more, that magazines make so much  money  with  my
  74.   work.  I know that they make much money, because some weeks ago a magazine
  75.   called me and offered 2000 DM for using release 4.0  on  their  Coverdisc.
  76.   But  please  regard  this:  If  you  should  get  release  4.1 from such a
  77.   coverdisk, you can suppose that they gave me some money for it.  But  this
  78.   means  not  that  release  4.1  is  commercial software now! VChess 4.1 is
  79.   freely distributable, it is your decision if you take it from a coverdisk,
  80.   or  free  of charge from AmiNet or friends! So even people, who got VChess
  81.   from an expensive Coverdisk, have to pay their shareware-contribution.)
  82.  
  83.   Of course it is reserved for me to forbid single companies or persons  the
  84.   distribution of VChess.
  85.  
  86.   Starting with release 4.0 it is forbidden for  the  following  persons  or
  87.   companies to sell or distribute VChess:
  88.  
  89.   A.P.S. - electronic -
  90.   Sonnelind Lange
  91.   Alex Lange
  92.    
  93.   They put my VChess 3.5 on their Time 493 disk.
  94.   On their disk is following text:
  95.   -------------------------------------------------------------------------
  96.   Diese TIME kostet DM 5.--. Verschiedene Autoren/Programmierer sind/werden
  97.   finanziell beteiligt,  so daß andere Händler bitte ebenfalls diesen Preis
  98.   berücksichtigen mögen.
  99.   Eine Kopiergebühr unter DM 5.- (incl. Disk) ist zwar aus Wettbewerbssicht
  100.   sicherlich überlegenswert,  doch damit werden die Autoren um Ihren Anteil
  101.   betrogen ..., während ein Preis über DM 5.- die Bezahlung etwaiger Share-
  102.   ware-Gebühren an die Autoren beeinträchtigen dürfte.
  103.   -------------------------------------------------------------------------
  104.   Some people read this  text  and  thought  that  I  got  money  from  this
  105.   company! This is not true, they just sended me 4 disk of their time-disks.
  106.    
  107.   User of VChess should regard this: An empty Floppy-Disk  costs  less  than
  108.   US$1, and copying VChess takes less than two minutes.  If  you  paid  more
  109.   than US$2 for the disk with VChess, then this was quite expensive. But  if
  110.   you have paid more than US$3, this was too much. Try  to  get  your  money
  111.   back, and tell me about it.
  112.  
  113. What is new in release 4.1 ?
  114. ============================
  115.  
  116.   Release 4.1 is a bugfix for  release  4.0  and  4.0a.  With  V4.0  it  was
  117.   possible  to  load  old  V3.5  games, and to save the game in the new V4.0
  118.   format. But then it was impossible to load the game again. This  is  fixed
  119.   now.  Additional,  there  was  an  very ugly bug in all former releases of
  120.   VChess. I discovered this bug in late November 1996 for  the  first  time.
  121.   This  bug  causes  a memory-corruption after termination of VChess in very
  122.   rare and special cases. It was very difficul to fix this bug, but  now  it
  123.   is fixed. The reason for this bug was this: While termination of VChess, I
  124.   called DeleteLayer() to free an used layer, and direct after this I called
  125.   FreeRaster()  to deallocate the BitPlanes of this layer. But DeleteLayer()
  126.   V40.1 uses the blitter to clear the planes of the layer. So it occured  in
  127.   very  special  cases,  that  the  CPU deallocates the BitPlanes, while the
  128.   blitter was clearing it. This can give memory-problems,  lost  of  chipmem
  129.   and  GURU  0100000C  (Sanity check on memory list failed during AvailMem).
  130.   There must be a WaitBlit() between DeleteLayer() and FreeRaster()!
  131.  
  132.   There are no other differences between V4.0 and V4.1.
  133.  
  134. What is new in release 4.0 ?
  135. ============================
  136.    
  137.   There are a lot of improvements: Opening-Library and saving  of  Games  is
  138.   fully rewritten. Now the Opening-library takes less space on Disk  and  in
  139.   RAM, and is more powerful. You can assign a quality (!!,!,!? and ?) and  a
  140.   textual comment to single moves. You can use a new String-Window  to  type
  141.   in moves instead using the mouse.  Computer  can  take  advantage  of  the
  142.   thinking-time of the human player, so often the computer may do  his  move
  143.   at once. Pieces are beamed (© by Scotty) from one  square  to  the  other.
  144.   Custom sounds can be played if datatype-library is  available.  Games  are
  145.   saved in a new,  more  compact  format,  which  needs  only  2  bytes  per
  146.   halfmove. This means, that most games takes not more  than  400  Bytes  on
  147.   disk, and are stored on one  single  disk-sector.  There  are  again  some
  148.   modifications in the  playing-algorithm,  I  hope  playing-strength  is  a
  149.   little bit improved, but I am not sure.
  150.  
  151.   But there are some disadvantages in this  release  too:  In  the  last  12
  152.   months I got only 8 new registrations.  This  is  too  many  to  cover  my
  153.   expenses. So I wrote this release more for myself and some friends of mine
  154.   than for the public. To not waste too much time, I have produced  only  an
  155.   english  documentation  and  english  program-text.  (And   this   english
  156.   documentation may contain very strange sentences!) Locale-library is still
  157.   supported, but I have not updated the german catalog, and I have not asked
  158.   the authors of the other catalogs to adapt their  catalogs.  Further  this
  159.   release in not tested very well. I was not ready to waste a dozen of hours
  160.   for testing it, and I have distributed only a few  betarelease  of  Vchess
  161.   4.1 to waste not too much postage. This release has many new features,  it
  162.   takes much time to test all of them. Now the  sourcecode  has  a  size  of
  163.   600k, and the structure of the source-code is not very  simple.  There  is
  164.   much room for bugs to hide! If you find bugs, and you want that this  bugs
  165.   will be fixed, than you should send me a note.
  166.  
  167.   Opening-library, Games and Configurations have  a  new  format  now.  This
  168.   release can load  Games  stored  with  releaee  3.5,  and  can  import  an
  169.   Opening-library stored with VChess 3.5. This  release  can  not  load  old
  170.   configurations - but it is really not much work to create a new  one.  (In
  171.   release 3.5 there was a little bug: When saving a game, an  empty  comment
  172.   was not accepted. This gave trouble, when a game was saved and loaded many
  173.   times. This is fixed now, release 4.1 can load these games again.)
  174.  
  175.   Additional there may be again a greater  Opening-Library  created  by  Uwe
  176.   Zedtler in this package. This big library is copyright by Uwe Zedtler, and
  177.   Shareware. For more information about this library see  the  documentation
  178.   of that package. Till now I have not used this large library, but I  guess
  179.   that it may be useful for strong players. To use it, just replace my small
  180.   library with that large one. To say it again: This large library is  ©  by
  181.   Uwe Zedtler, I may have only included it (with permission of Uwe  Zedtler)
  182.   in this package. If this library is not part of  this  package,  then  you
  183.   should find it in AmiNet,I guess the name is game/board/VChessOpenings.lha.
  184.  
  185. Introduction
  186. ============
  187.    
  188.   VChess   is   written   fully   in   Oberon   language   (with    a    few
  189.   Assembler-routines), and was developed on an Amiga 3000 using Amiga Oberon
  190.   V 3.11d   (© Fridtjof Siebert).   With   the   help   of   OS 2.0   (3.1),
  191.   ReqTools.library and Amiga-Oberon, I have produced a compact, powerful and
  192.   easy to use program. To run this program, you need an Amiga with OS 2.0 or
  193.   greater,   and   additional   the    ReqTools.library.    ReqTools.library
  194.   (© Nico Francois,Magnus Holmgren) is  not  part  of  this  package,  every
  195.   serious Amiga user should possess it. If  not,  take  a  look  to  AmiNet.
  196.   Please note that there exists a Preferences-Editor  for  ReqTools.library.
  197.   You can use this Editor (not part of this package) to modify the behaviour
  198.   of the ReqTools.library. VChess needs not very much memory. With  a  small
  199.   Opening-Library it should be possible to use VChess on an Amiga with  only
  200.   1MB. The stacksize should be at least 8k, but if you  have  any  problems,
  201.   try a larger stack. The Opening-library uses recursion, so a large library
  202.   may need a larger stack.
  203.  
  204. Installation
  205. ============
  206.    
  207.   Copy, if not already installed, the ReqTools.library  to  LIBS:.  This  is
  208.   all. Now you can start VChess from Workbench  with  Double-Click.  If  you
  209.   want to install VChess on your hard disk, it is best  to  copy  the  whole
  210.   VChess-Drawer  to  hard   disk,   because   this   drawer   contains   the
  211.   Opening-Library and other things. VChess can use  Catalog-files  to  adapt
  212.   itself  to  other  languages  than  English.  VChess  searches  for  these
  213.   catalogfiles in PROGDIR:Catalogs/language. Where PROGDIR: is the directory
  214.   in which VChess resides. If, for example, your  preferred  system-language
  215.   is        "deutsch",         then         VChess         will         load
  216.   "PROGDIR:Catalogs/deutsch/VChess.catalog". You can copy the catalogfile to
  217.   LOCALE:catalogs/language, VChess will find it there too, but I think  it's
  218.   better to leave the catalogfiles in the VChess-Drawer. (You can use VChess
  219.   without its VChess-Drawer,  but  this  is  not  recommended  because  many
  220.   additional files like the opening-library, saved games, Icons  and  so  on
  221.   belong to VChess.)
  222.  
  223. Starting VChess
  224. ===============
  225.    
  226.   The easiest way to start VChess is with a Double-Click on its Icon. But of
  227.   course you can start it from Shell by typing its name  and  then  pressing
  228.   the <Return>-Key. (VChess needs no  parameters.)  If  there  is  the  file
  229.   VChess.config or Configs/VChess.config in the Drawer of VChess,  then  the
  230.   program uses this file for the startup-configuration,  otherwise  defaults
  231.   are used. It is possible to make VChess resident  with  the  shell-command
  232.   RESIDENT. This can be useful for a few people,  who  need  more  than  one
  233.   board. For example type in the shell
  234.  
  235.   STACK 12000
  236.   CD VChess
  237.   RESIDENT VChess
  238.   RUN VChess
  239.   RUN VChess
  240.    
  241.   to get two boards without wasting too much memory. This is not very  nice,
  242.   because both boards appear at the same position, and you have to save  and
  243.   load a game to exchange games, but it is possible. And most  players  will
  244.   only need one board!
  245.  
  246. First Steps
  247. ===========
  248.    
  249.   Before you go on reading this text, it is better to start VChess  now  and
  250.   try it out. When the program has started, you can see  five  windows.  The
  251.   big one with the chessboard is the main-window. The other windows are only
  252.   help-windows for showing some information. If one of these five windows is
  253.   active, then you can press the right mousebutton to take  a  look  on  the
  254.   Pulldown-Menu. (Don't be sad if the display looks ugly at this time.  Many
  255.   things like colors, fonts  and  screen-resolution  can  be  changed.)  Now
  256.   select the menuitem "Config/Reset to defaults" to reset all adjustments to
  257.   defaults. Start the game by selecting "Project/NewGame". Now you play with
  258.   the white pieces against the computer. To move a piece, simply click on it
  259.   with the left mousebutton. (To click means:  Move  the  pointer  over  the
  260.   chessman, and then press and release the left mousebutton.) Now this piece
  261.   is marked. Now click on the destination-square. If this was a legal  move,
  262.   the piece will move from source to  destination,  and  the  computer  will
  263.   answer with its move. Now it's again your turn, and so on. Don't  hesitate
  264.   to test some of the menu-functions. The meaning of most of them should  be
  265.   clear, just try it out. Of course you can re-size the  windows,  or  close
  266.   the helpwindows.
  267.  
  268. Shareware-Contribution
  269. ======================
  270.    
  271.   I started the development of VChess in summer 1992, and  now  in  December
  272.   1996 version 4.1 is finally (nearly) finished. I guess, that this  program
  273.   took more than 2000 hours of work till now. I think you  can  imagine  how
  274.   much  money  the  development  of  this  program   would   have   cost   a
  275.   software-company, or how much money I could have earned  if  I  had  spent
  276.   this  time  somewhere  else.  And  last  not  least  the  costs  that  the
  277.   development of software causes are not negligeable.
  278.  
  279.   At the beginning I planed to sell VChess in a commercial way. But  because
  280.   even with a commercial distribution it is not secure that the author  gets
  281.   a justified amount of money for his work, I decided to  distribute  VChess
  282.   as Shareware. Shareware means, that the program can be freely  copied,  so
  283.   that everyone can get it (nearly) free of charge from friends,  PD-Dealers
  284.   or by BBS-Systems. But when you like the program, and you want  to  go  on
  285.   using it, you have to send a donation to the  author.(  Some  people  call
  286.   this sort of software giftware)
  287.  
  288.   VChess 4.1  is  true  shareware  again.  This  means  that  there  are  no
  289.   restrictions in this version. I emphasize this, because many authors  have
  290.   decided to release only restricted versions of their software  for  freely
  291.   distribution. But there are no restrictions in VChess 4.1. This means that
  292.   you can test all functions of VChess, and you  don't  have  to  wait  many
  293.   weeks after paying the contribution to get the  fully  functional  version
  294.   from the author. And I have the advantage that I  save  some  mailing-work
  295.   and postage.
  296.  
  297.   So if you like VChess and want to go on using it,  please  send  US$15  or
  298.   DM20 to the following address:
  299.  
  300.                                Stefan Salewski
  301.                                 Stolper Weg 3
  302.  
  303.                            D-21680 Stade (Germany)
  304.  
  305.   Please compare this address with the text that you can see if  you  select
  306.   the  menuitem  "Project/About".  If  there  are  any  differences  in  the
  307.   addresses, this means that somebody has  made  illegal  modifications.  In
  308.   this case try to get a clean, unmodified version of VChess. If you live in
  309.   Germany, you can send me a "Verrechnungsscheck" or make  an  "Überweisung"
  310.   to:
  311.  
  312.                             Stadt-Sparkasse Stade
  313.                             Bankleitzahl 24151005
  314.                               Kontonummer 823864
  315.  
  316.   Otherwise I think the best way is if you send me the money in cash. It may
  317.   be possible to send an EuroCheck (only in DM !) or to send me the money by
  318.   postal money order. (But it is  impossible  for  me  to  cash  in  foreign
  319.   checks, even if the amount is in DM. I got a check from  an  English  bank
  320.   (DM 20), but I had to send it back because the banks in Stade charge DM 27
  321.   to cash it in.)
  322.  
  323.   All people, who send me the contribution, will get a postcard,  letter  or
  324.   EMail from me, so that they know that I  really  got  the  money.  If  you
  325.   should not get this notification after  six  weeks,  then  something  went
  326.   wrong. (Please don't forget to give me your FULL postal address.)
  327.  
  328. Playing-Strength
  329. ================
  330.    
  331.   Of  course  it  is  a  big  difference  if  you  play  with  a  68000-  or
  332.   68060-processor. On my A3000 I lose most games against the computer, if  I
  333.   play with fair conditions. Fair conditions means, that I don't  take  back
  334.   moves, and that I don't use more thinking-time than the computer. I  can't
  335.   make precise statements about it, because I have too many possibilities to
  336.   compare VChess with. The playing-strength of  version  2.0  was  not  very
  337.   great, but I think that in Version 4.1 the playing-strength  is  not  bad.
  338.   The playing-algorithm is completely a  development  of  my  own,  I  spent
  339.   approximately 1000 hours on it. I guess that  other  people  thought  more
  340.   about it. The best way is if you test  the  playing-strength  yourself.  I
  341.   think, if you lose more than 50% of all games, then  the  playing-strength
  342.   is big enough for you. Note: If you lost nearly every game,  it  would  be
  343.   very frustrating. Of course, if the playing-strength  was  very  high,  it
  344.   would be possible to degrade it artificially. But if you won  against  the
  345.   computer, you know that the computer  have  played  intentional  bad,  you
  346.   would  not  be  so  glad  about  your  win.  If   you   think   that   the
  347.   playing-strength is too low, you can tell me. If many people think  so,  I
  348.   will try to  increase  it.  For  my  own  games  the  playing-strength  is
  349.   currently big enough. (Sometimes it may occur that the  computer  make  an
  350.   obviously bad move. This can happen for example, if the  thinking-time  is
  351.   short, so that the computer can't see an imminent attack of his  opponent.
  352.   In this case you can do this: Select a longer thinking-time (for this move
  353.   only), and then select Extras/Undo last Move from menu. Now  the  computer
  354.   will take back his bad move. Using a longer thinking-time, he will find  a
  355.   better move in most cases. Now you can use the  smaller  time  again.  For
  356.   example, I use 30 seconds thinking-time on my A3000. If I notice, that the
  357.   computer has done a very bad move, I select 3 Minutes  thinking-time,  and
  358.   Undo. Now I fetch a cup of tea, and when I come  back,  the  computer  has
  359.   found  a  better  move  in  most  cases.  Now  I  select  again  the   old
  360.   thinking-time of  30  seconds.  A  other  way  is  this:  You  can  select
  361.   Playmode/Human-Human, use Undo, and do a better move yourself. Now  select
  362.   Playmode/Human-Amiga again.
  363.  
  364.   Please don't try to compare VChess running on an A1200 with  an  expensive
  365.   program like "Fritz" on a Penium150. This is not fair. VChess is  designed
  366.   for people like me, who want to play some  chess  sometimes,  who  want  a
  367.   nice, cheap, easy to use program which is not impossible to beat.
  368.  
  369. The Use of VChess
  370. =================
  371.    
  372.   After starting VChess, you will see the mainwindow, and perhaps  the  four
  373.   other windows. The behaviour of the windows is like  the  windows  of  the
  374.   Workbench. You can  move,  re-size  and  close  them.  If  you  close  the
  375.   mainwindow, the program will terminate. To move a chessman,  simple  click
  376.   on it and then on the destination  square.  (To  make  a  rochade(castle),
  377.   simple move the king. The rook is moved automatically.) If you clicked  on
  378.   a piece, and this click was a mistake, just click again on  it  to  delete
  379.   the selection.
  380.  
  381.   In the window titled "All Moves" you can see  all  moves  of  the  current
  382.   game. The last performed move is marked with a ">", this is not very nice,
  383.   highlighting would look better, but GadTools-ListView-Gadgets  only  allow
  384.   highlighting  of  a  complete  line.  The  algebraic  notation  is   used.
  385.   "2.Bf1-b5   e7-e5" means, that this is the second move,  White  moved  the
  386.   Bishop from square f1 to square b5, and Black moved a pawn from e7 to  e5.
  387.   The letters behind the movenumber (2.) have the following meanings:
  388.  
  389.   P  Pawn
  390.   N  Knight
  391.   B  Bishop
  392.   R  Rook
  393.   Q  Queen
  394.   K  King
  395.  
  396.   The "P" for a move of a pawn is  usually  substituted  by  a  space.  Some
  397.   special characters are used for special moves: "O - O"  or  "O-O-O"  means
  398.   the small or big rochade. "e.p."  indicates  the  special  pawn  move  "En
  399.   passant". "+" and "#" are used  to  indicate  check  and  checkmate.  "#W"
  400.   means, that White is checkmate, "#B3" means, that Black will be  checkmate
  401.   in 3 half-moves. "*W" or "*B" is my own notation  if  White  or  Black  is
  402.   stalemate.
  403.  
  404.   The third window titled "Thinking..." shows the valuation of all currently
  405.   possible moves. The numbers on the right side are the  valuation  of  this
  406.   move. The number 100 is equal to the gain of a pawn, -25 is equal  to  the
  407.   lost of a quarter pawn and so on.
  408.  
  409.   "3-3 Be4xd5 50" means the following: If the Bishop on square e4 would  hit
  410.   the chessman on square d5, this would result in the active player  gaining
  411.   of one half pawn. The characters "3-3" describe the deep of  thinking,  in
  412.   this example three half-moves. (A half-move is a move  of  a  white  or  a
  413.   black piece.) In  this  example  the  computer  has  calculated  for  each
  414.   possible move of the active player a move of its opponent, and for each of
  415.   these moves of the opponent again a move of  its  own.  From  these  three
  416.   half-moves the total gain of this move is  calculated,  and  the  computer
  417.   will select the move with the highest total gain. Note that in the average
  418.   a player can make one of 30 possible  moves.  And  for  all  of  these  30
  419.   possible moves there are again 30 moves as a response,  and  so  on.  This
  420.   means, if the computer calculates 3 half-moves  deep,  the  computer  must
  421.   process 30^3=30*30*30=27000 half-moves. You can  think  about  it  as  the
  422.   computer building a tree for each possible move. The  first  half-move  is
  423.   the root of a tree, and from this root there are 30 branches to a opposite
  424.   move, and from each opposite move there  are  again  30  branches  to  the
  425.   opposite-opposite-moves and so on. Of course such a tree doesn't  have  to
  426.   be totally symmetric, some branches can be longer (more nodes) and  others
  427.   shorter. If an entry begins for example with "3-4", then this  means  that
  428.   the basic depth of this tree is 3 nodes, but this branch is 4 nodes  deep.
  429.   Or sometimes you can see entries like "5-3". This  means  that  the  basic
  430.   depth of this tree is 5 nodes, but this branch is  cut  because  it  looks
  431.   like a bad move, or a checkmate will occur in 3 half-moves.
  432.  
  433.   The fourth window is called "Move-Chain". If you click on an entry in  the
  434.   "Thinking..."-Window, then the movechain of this move is displayed in this
  435.   window. This will help you to understand why the computer  thinks  that  a
  436.   single move is a good or a bad move. The display of this window looks like
  437.   this: 
  438.   ------------
  439.   Gain:  40 +3
  440.   Nb8-c6    50
  441.   e4xd5    240
  442.   Qd8xd5   300
  443.   Nf3xe5    70
  444.   ------------
  445.   This means: If the active player made  the  move  "Nb8-c6",  his  opponent
  446.   would react with e4xd5 and so on. The real gain of the  move  "Nb8-c6"  is
  447.   50-240+300-70=40. The +3 is a random-number added to the gain, so  in  the
  448.   "Thinking..."-window the displayed gain is 40+3=43. (The displayed gain in
  449.   the "Thinking..."-window may differ a little  bit  from  the  sum  of  the
  450.   movechain. This is not a bug, but occur because moves at the  end  of  the
  451.   chain are less weighted.)
  452.  
  453.   The last window titled "String-Input" can be used to set  or  move  pieces
  454.   instead of using the mouse. This can be very useful if you want to type in
  455.   a game, opening or position from a book or newspaper. In playing-mode (see
  456.   below) you can type in moves in algebraic notation to do  your  move.  You
  457.   can use the abreviated algebraic (PGN-like) notation too.  Here  are  some
  458.   examples:
  459.  
  460.   Pe2-e4 or e2e4 or ee4 or 2e4 or e4 or e or 4 may move the pawn.
  461.  
  462.   Use  lowercase  letters   for   positions!   And   capital   letters   for
  463.   chessman-identifiers.  It  may  be   ok   to   enter   only   source-   or
  464.   destination-coordinate, if this is a definite move. (If there is only  one
  465.   legal move with this coordinate.)
  466.  
  467.   Don't type O-O or O-O-O to do a rochade (castle), just move the king  like
  468.   "Ke1g1". For an "En Passant" move just move your pawn, and for  converting
  469.   a pawn to a queen just move the pawn.
  470.  
  471.   After the move-coordinates  you  can  enter  a  quality.  There  are  four
  472.   qualities, !!, !, !? and ?. !? and ?! are identically,  and  you  can  use
  473.   simple numbers too, !!=1, !=2, !?=3, ?=4. If you don't  enter  a  quality,
  474.   then the default quality (see below) is used. Please note, that only moves
  475.   with quality !! or ! can be added to the opening-library.
  476.  
  477.   Additional, you can enter a textual comment behind  each  move.  Here  are
  478.   again some examples:
  479.  
  480.   Re4xh4   !!   This is a very good move
  481.   ef3!!
  482.   e2e4A usual opening
  483.   Qh ? It was not a good idea to move the queen to h
  484.    
  485.   I hope this is clear, try it out.
  486.    
  487.   In Buildup-mode, you can use this window to set up a position. First  type
  488.   one single letter to indicate the color, for english language type "W"  to
  489.   select white pieces, or "B" to select black pieces.
  490.  
  491.   Now type just a coordinate  to  set  a  pawn,  or  a  chessman  identifier
  492.   followed be a coordinate to set a chessman.
  493.  
  494.   "e4" or "Pe4" will set a pawn on square e4.
  495.   "Ka1" will set a King on square a1.
  496.    
  497.   You can use a coordinate with a capital letter to  clear  a  square.  "G5"
  498.   will clear g5.
  499.  
  500.   In setup-mode, spaces are not allowed. You have to type  in  one,  two  or
  501.   three characters, no spaces.
  502.  
  503.   You can deactivate the String-Gadget, if you just type Return without  any
  504.   input. This can be useful,  if  you  want  to  do  a  Menu-Operation  with
  505.   Menu-Shortcuts.  (If  the  String-Gadget   is   active,   you   can't   do
  506.   Menu-Operations with Shortcuts.)
  507.  
  508. Playing- and Buildup-Mode
  509. =========================
  510.    
  511.   There are two modes: Playing-Mode, and Buildup-Mode. In  the  Buildup-Mode
  512.   you can move pieces without any restrictions. In Playing-Mode you  can  do
  513.   only legal moves, and the  chess  clocks  are  running.  The  Buildup-Mode
  514.   contains a special sub-mode, called Replay-Mode. Replay-mode  means,  that
  515.   there is a game in memory (just played or loaded). In this  case  you  can
  516.   use the menu items "Next Move", "Previous Move" etc. to replay it, and you
  517.   can save the game. If you are in  Replay-Mode  and  modify  the  board  by
  518.   moving pieces, you will go to the plain Buildup-Mode. If you  are  in  the
  519.   plain Buildup-Mode, then you can save  only  the  contents  of  the  board
  520.   without any moves.
  521.  
  522. Titleline of the Mainwindow
  523. ===========================
  524.    
  525.   The windowtitle is used for displaying various  information,  for  example
  526.   error-reports or the last move. If the computer has done a move,  you  can
  527.   see in () the computing-power of the computer in  moves  per  second,  Mps
  528.   (really Half-moves). Additional, at the beginning of a game  the  name  of
  529.   the used opening is displayed.
  530.  
  531. Chess clocks
  532. ============
  533.    
  534.   At the top of the board window you can see three chess clocks.  The  clock
  535.   on the left displays the total time for the white player, and the clock on
  536.   the right the time for the black player. The clock in the middle shows the
  537.   time for the active player.
  538.  
  539. The Menu
  540. ========
  541.    
  542.   If one of the five windows is active, then  you  can  select  one  of  the
  543.   following functions with the right mousebutton:
  544.  
  545.   Project
  546.   -------
  547.      
  548.     "New Game"
  549.        
  550.       With this item you start a new game. All pieces are built up on  their
  551.       initial position, and it is white's turn.
  552.  
  553.     "Start Game"
  554.        
  555.       With this item you also start playing, but the pieces  stay  at  there
  556.       former places.
  557.  
  558.     "Solve for Mate"
  559.        
  560.       With this item you can activate a special playing-mode:  The  computer
  561.       will  go  on  thinking  until  the  computer  sees  a  checkmate. Mate
  562.       in one move means, that the active player makes a move, and  then  his
  563.       opponent is checkmate. This is trivial. Mate in 2  Moves  means,  that
  564.       the active player makes a move, then his opponent makes any move,  and
  565.       then after the second move  of  the  active  player  the  opponent  is
  566.       checkmate. The Computer will start calculating all moves one move deep
  567.       searching for a mate in 1, then he will extend some interesting  moves
  568.       to a greater depth. If no mate is found, he  will  calculate  2  moves
  569.       deep, first without depth-extension, then  with  depth-extension.  You
  570.       can monitor the progress in the Thinking-Window.
  571.  
  572.       You can stop the solving for mate, if you select "Stop Game" in  menu.
  573.       This can be necessary,  because  there  exists  many  chesstask  which
  574.       VChess can not solve in short time. If there are  no  changes  in  the
  575.       Thinking-window for long time, then this  task  is  to  difficult  for
  576.       VChess, and you should select  "Stop Game"  in  menu.  (All  tasks  in
  577.       drawer Checkmates/Solved are solved in less  than  20  minutes  on  my
  578.       A3000. But the tasks in the drawer Unsolved my A3000 can not solve  in
  579.       some minutes.)
  580.  
  581.       When the computer has found the way to checkmate, he makes  the  first
  582.       move and stops the game. (If  the  computer  has  found  a  mate  with
  583.       depth-extension, then he will go on with the next level. There may  be
  584.       a shorter way to mate, or there may be more ways to mate.) You can see
  585.       all moves to mate in the MoveChain-Window. In general case,  the  next
  586.       move is not clear, the opponent can react with more  than  one  single
  587.       move. This is the reason why the computer will not  do  all  moves  to
  588.       mate. But if you think that it is useful to save a special way to mate
  589.       then you can do  this:  Select  "Thinklist/Update Movechain/No Update"
  590.       and  "Playmode/Human-Human"  from  menu.  Now  start  the  game   with
  591.       "Project/Start Game" and play the moves  which  you  can  see  in  the
  592.       Move-Chain-Window.  Then  you  can  save  this  way  to  checkmate  by
  593.       selecting "Project/Save Game".
  594.  
  595.     "Stop Game"
  596.        
  597.       Terminates the current game (or solving for mate).
  598.  
  599.     "Load Game... (or Set Up/Load Game...)"
  600.        
  601.       With this function you can load a game, to analyse it or go on playing
  602.       it. For example you can select the menuitem "Setup/Next Move" multiple
  603.       times to go  to  a  desired  position  in  a  game,  and  then  select
  604.       "Project/StartGame" to start playing from this position. If  you  have
  605.       loaded a game, then the position is at the beginning of this game.  So
  606.       if you want to continue a loaded  game,  it  is  necessary  to  select
  607.       "SetUp/Last Move" before starting the game.There is a good reason  why
  608.       we don't jump to the last move automatically: Maybe you got  a  solved
  609.       Chesstask on disk, for example  a  "mate  in  3".  If  you  load  this
  610.       chesstask, you probably will try to  find  the  solution  by  yourself
  611.       first. Only if you can't see it, you will use "Next Move" from menu to
  612.       display it. (It may be a good idea to  close  the  "All  Moves"-Window
  613.       before  loading  a  solved  Chesstask,  otherwise  you  will  see  the
  614.       solution.)
  615.  
  616.     "Load quick"
  617.        
  618.       This function will load the last saved game. This may  be  useful  for
  619.       people who save and load the same game many time. (Playing letter-  or
  620.       email-chess.) The name of the last game (and  the  directory-name)  is
  621.       saved in the configuration-file. You may proceed like this. Save  your
  622.       game with "Project/Save Game..."  for example with name "MyGame".  Now
  623.       select "Config/Save" from menu. Now "MyGame" is the default game-name.
  624.       When you start VChess the next time, you can select this item to  load
  625.       this game. This is very fast.
  626.  
  627.     "Save Game..."
  628.        
  629.       With this function you can save a game, to go on playing it later,  to
  630.       analyse it  later,  or  just  to  archive  it.  You  can  save  it  in
  631.       Buildup-Mode and in Playing-Mode. If there is no game  in  memory,  or
  632.       the board is modified, then only the board is saved. If  you  want  to
  633.       save not the complete game, for example not the last bad move, then do
  634.       this: Go to the move, which is the last move which  should  be  saved.
  635.       Now select "Extras/Delete Successors" from  menu.  Now  the  following
  636.       moves are erased, and you can save the game. For  each  game  you  can
  637.       enter a textual comment. This comment can be up to 79 characters long.
  638.       I use  Dos.SetComment()  to  store  this  comment,  so  no  additional
  639.       diskspace is used, and you can see this comment, if you type  LIST  in
  640.       the SHELL.
  641.  
  642.     "Save quick"
  643.        
  644.       Saves the game with the default name, see  "Project/Load Quick".  Will
  645.       work only if there is a default name.
  646.  
  647.     "Save Movelist..."
  648.        
  649.       The actual game is saved as a text file in algebraic notation.
  650.  
  651.     "Print Movelist"
  652.        
  653.       The actual game is printed as a text file in algebraic notation.
  654.  
  655.     "Give Up..."
  656.        
  657.       A Requester will ask you if you really wants to give up. If  so,  then
  658.       the game will stop, and the default  comment  to  this  game  will  be
  659.       "White/Black gave up".
  660.  
  661.     "Offer Draw..."
  662.        
  663.       Use this to propose a draw. In release 4.1 a draw is always  accepted,
  664.       if    the     current     position     has     occured     3     times
  665.       (Position-repeatition-rule) or if there was no progress in the last 50
  666.       moves (50-moves-rule). (The game ended in a draw, neigther  side  won.
  667.       In german we use the word Remis, I think it's a french word.)
  668.  
  669.     "About..."
  670.        
  671.       This item displays the address of the author of VChess.
  672.  
  673.     "Quit"
  674.        
  675.       Terminates the program.
  676.  
  677.   Players
  678.   -------
  679.      
  680.     "Human-Human"
  681.        
  682.       Two human players play against each other.
  683.  
  684.     "Human-Amiga"
  685.        
  686.       A human player plays with the white pieces against the computer.
  687.  
  688.     "Amiga-Human"
  689.        
  690.       The computer plays with the white pieces against a human player.
  691.  
  692.     "Amiga-Amiga"
  693.        
  694.       Computer plays against computer.
  695.  
  696.   Time
  697.   ----
  698.      
  699.     With this menu you can change the thinking-time of the computer:
  700.  
  701.     "10 Secs, 20 Secs, 30 Secs"
  702.        
  703.       Thinking-time is 10, 20 or 30 seconds.
  704.  
  705.     "1 Min, 2 Mins, 3 Mins, 5 Mins, 10 Mins, 30 Mins"
  706.        
  707.       Thinking-time is 1, 2, 3, 5, 10 or 30 minutes.
  708.  
  709.     "1 Hour, 3 Hours, 8 Hours"
  710.        
  711.       Thinking-time is 1, 3, or 8 hours.
  712.  
  713.     "Infinite"
  714.        
  715.       The computer calculates until a mate is found,  or  until  you  select
  716.       "Extras/Break" to force the computer to make his move.
  717.  
  718.     "Custom"
  719.        
  720.       With this function you can enter a custom thinking-time. With the four
  721.       gadgets you can determine if your input  is  in  seconds,  minutes  or
  722.       hours. If you only press <Return>, then your input is assumed to be in
  723.       seconds. 
  724.  
  725.     "Equal ?"
  726.        
  727.       If this item is marked, then the computer will adapt its thinking time
  728.       to the thinking time of the human player.
  729.  
  730.     "For 1  Move"
  731.        
  732.       The above time is used for a single move
  733.  
  734.     "For 30 Moves"
  735.        
  736.       The above time is used for 30 moves
  737.  
  738.     "For Game"
  739.        
  740.       The computer will try to finish the the whole  game  in  the  selected
  741.       time.
  742.  
  743.     "Reset"
  744.        
  745.       Resets the chessclocks to zero
  746.  
  747.   Thinklist
  748.   ---------
  749.      
  750.     "Refresh"
  751.        
  752.       The computer is always thinking for the active  player,  even  if  the
  753.       active player is a human player. If you select  this  item,  then  the
  754.       list of all currently possible moves together with their valuation  is
  755.       displayed. Of course the valuation may change with time,  because  the
  756.       computer is thinking deeper and deeper. So if  you  select  this  item
  757.       after some time again, the valuation will be not  the  same.  You  can
  758.       also select this item if the computer is the active player, to see how
  759.       the computer evaluates the different moves.
  760.  
  761.     "Refresh & Sort"
  762.        
  763.       Like "Refresh", but the moves are displayed sorted by gain, best  move
  764.       at the top.
  765.  
  766.     "Show old List"
  767.        
  768.       This item is similar to "Refresh", but it  displays  not  the  current
  769.       (active) list, but the old list containing the last move. Sometimes it
  770.       is necessary to take a look on  the  old  list,  for  example  if  the
  771.       computer makes a strange move, and you want to find out  why  he  made
  772.       such a move. If the list containing this strange,  last  move  is  not
  773.       visible, then select this item to display it again.
  774.  
  775.     "Show old List sorted"
  776.        
  777.       Like "Show old List", but the moves are displayed sorted by gain, best
  778.       move at the top.
  779.  
  780.     "Show best Chain"
  781.        
  782.       Displays the Movechain of the currently best move. (You can  use  this
  783.       item or "Refresh & Sort" to get help from the computer.) Please  note:
  784.       The best move is not always the one with the  highest  valuation!  The
  785.       computer may prefer a move  with  a  smaller  valuation,  but  with  a
  786.       greater depth!
  787.  
  788.     "Beep if updated ?"
  789.        
  790.       If this item is marked, then the computer makes an audible beep if the
  791.       Thinklist- or MoveChain-Window is updated.
  792.  
  793.     "Show sorted ?"
  794.        
  795.       If this item is marked, then the  Thinklist  is  displayed  sorted  by
  796.       gain, otherwise sorted alphabetically.
  797.  
  798.     "Update Display"
  799.        
  800.       "If changed"
  801.          
  802.         Update Thinklist and Move-Chain whenever there are changes. This may
  803.         slow down the calculating  power,  because  in  early  states  of  a
  804.         thinking- process (the first seconds) there  are  many  changes  per
  805.         time interval.
  806.  
  807.       "Automatic"
  808.          
  809.         Update Thinklist and Move-Chain if it is useful, for  example  after
  810.         2, 5, 10, 20, 30, 60 seconds, and then whenever there are changes.
  811.  
  812.       "No Update"
  813.          
  814.         Only    update    the    display,    when    the     user     select
  815.         "Thinklist/Refresh & Sort" or an equal item. The "Move-Chain"-window
  816.         is updated, if the user clicks on an entry in the Thinklist.
  817.  
  818.     "Refresh if"
  819.        
  820.       "It's Computer's turn"
  821.          
  822.         Refresh Thinklist and Move-Chain, if  the  computer  is  the  active
  823.         player.
  824.  
  825.       "It's Your turn"
  826.          
  827.         Refresh Thinklist and Move-Chain, if a human is the active player.
  828.  
  829.     "Update MoveChain"
  830.        
  831.       "Best Move"
  832.          
  833.         Display in the Movechain-Window the best move.
  834.  
  835.       "Current Move"
  836.          
  837.         Display in the Movechain-Window the current (last calculated)  move.
  838.          
  839.       "No Update"
  840.          
  841.         Don't update the Move-Chain-Window automatically. The  "Move-Chain"-
  842.         window is updated, if the user clicks on an entry in the  Thinklist.
  843.          
  844.   Display
  845.   -------
  846.      
  847.     "Show Movelist"
  848.        
  849.       The helpwindow, which shows the moves of the current game,  is  opened
  850.       or brought to the front.
  851.  
  852.     "Show Thinking"
  853.        
  854.       This function will open the window, which shows the valuation  of  all
  855.       currently possible moves, or brings this  window  in  front  of  other
  856.       windows.
  857.  
  858.     "Show MoveChain"
  859.        
  860.       If you select this item, then the window, which displays the movechain
  861.       of a special move, is opened or brought to the front.
  862.  
  863.     "Open String-Window"
  864.        
  865.       Opens the  window  for  string-input,  or  brings  it  to  front.  The
  866.       String-Gadget should become active too. This can be  useful,  if  this
  867.       Menu-Item has a Shortcut. So you can activate  the  Input-Window  with
  868.       the keyboard. I am  not  sure,  if  this  really  works  ever.  I  use
  869.       ActivateWindow() and ActivateGadget(), maybe more code is necessary.
  870.  
  871.     "Rotate"
  872.        
  873.       "90+, 180, 90-"
  874.          
  875.         With these items you can rotate the board.
  876.  
  877.     "Change Colors"
  878.        
  879.       If you select  one  of  the  following  eleven  items,  then  a  Color
  880.       requester is opened. Click on the color, which should be used for  the
  881.       drawing. If you use a custom-screen, you can use the sliders to change
  882.       the color-values. But if you play on a public-screen, it's  better  to
  883.       only select a color instead of changing the value. You can only select
  884.       one color at a time. If you click on "Ok", then  the  board  is  drawn
  885.       with the selected color. For pieces and squares  you  can  select  two
  886.       colors, A and B. Color B is used for the border  of  the  pieces,  and
  887.       although if the squares are not monochrome (pattern).
  888.  
  889.       "White Pieces A"
  890.          
  891.         Color A (inner) of white pieces.
  892.  
  893.       "White Pieces B"
  894.          
  895.         Color B (border and pattern) of white pieces.
  896.  
  897.       "Black Pieces A"
  898.          
  899.         Color A (inner) of black pieces.
  900.  
  901.       "Black Pieces B"
  902.          
  903.         Color B (border and pattern) of black pieces.
  904.  
  905.       "White Squares A"
  906.          
  907.         Color A of white squares
  908.  
  909.       "White Squares B"
  910.          
  911.         Color B of white squares
  912.  
  913.       "Black Squares A"
  914.          
  915.         Color A of black squares
  916.  
  917.       "Black Squares B"
  918.          
  919.         Color B of black squares
  920.  
  921.       "Board-Border"
  922.          
  923.         Color of the border of the board.
  924.  
  925.       "Board-Text"
  926.          
  927.         Color of the text of the board. (1..8, a..h, and chess clocks )
  928.  
  929.       "Rectangle"
  930.          
  931.         Color of the rectangle, which is drawn around a  selected  piece  or
  932.         square.
  933.  
  934.     "Change Patterns"
  935.        
  936.       You can select between four different patterns  for  the  squares  and
  937.       pieces: Mono (only color A), points, lines up and lines down.
  938.  
  939.       "White Pieces"
  940.          
  941.         Pattern for white pieces
  942.  
  943.       "Black Pieces"
  944.          
  945.         Pattern for black pieces
  946.  
  947.       "White Squares"
  948.          
  949.         Pattern for white squares
  950.  
  951.       "Black Squares"
  952.          
  953.         Pattern for black squares
  954.  
  955.       If the display looks ugly on your screen, you should try other  colors
  956.       and patterns. The defaults look nice on an hires-interlace-screen with
  957.       OS2.0-colors, but  if  you  have  to  play  on  a  screen  with  lower
  958.       resolution or different colors, then it's a good  idea  to  try  other
  959.       color-selections and patterns.
  960.  
  961.     "Beam time"
  962.        
  963.       With these items you can control the speed with which the  pieces  are
  964.       moved from one square to an other square.
  965.  
  966.       "0"
  967.          
  968.         Pieces are moved at once.
  969.  
  970.       "1"
  971.          
  972.         Pieces are moved very fast
  973.  
  974.       "2"
  975.          
  976.         Pieces are moved fast.
  977.  
  978.       "3, 4, 5"
  979.          
  980.         Moving takes about 3, 4 or 5 seconds
  981.  
  982.     "Setup Mode ?"
  983.        
  984.       The board gets a border on the left and right  side.  On  this  border
  985.       rest some chessmen. In the Buildup-Mode, you can select  these  pieces
  986.       and use them to build up a position. Also you can move pieces  on  the
  987.       border to throw them away. In playing-mode the border has no function.
  988.        
  989.     "Coordinates ?"
  990.        
  991.       If you turn off coordinates, you have more room for the pieces. But  I
  992.       think this is only necessary if you have to play on a screen with very
  993.       low resolution.
  994.  
  995.     "Chess Clock ?"
  996.        
  997.       You can turn off the clock. If you have turned off coordinates,  clock
  998.       is always turned of too.
  999.  
  1000.     "Draw beam frame ?"
  1001.        
  1002.       If this item is marked, then a border is  drawn  around  pieces  while
  1003.       beaming. So it is easier to see which pieces are moving.
  1004.  
  1005.     "Show Quality ?"
  1006.        
  1007.       Starting with release 4.0 of VChess,  to  every  move  is  assigned  a
  1008.       quality from 1 to 4, or !! to ?. Quality is important if you  want  to
  1009.       add moves to the opening-library. You can ignore the quality,  if  you
  1010.       deactivate this item.
  1011.  
  1012.     "Print Space for !?"
  1013.        
  1014.       For most games !? will be the default quality, so most moves will have
  1015.       quality !?. Then it is optically more nice if a simple space  is  used
  1016.       instead of !?.
  1017.  
  1018.     "Squareframes"
  1019.        
  1020.       "White ?"
  1021.          
  1022.         Draw a frame in color A around white squares
  1023.  
  1024.       "Black ?"
  1025.          
  1026.         Draw a frame in color A around black squares
  1027.  
  1028.     "Change Screen..."
  1029.        
  1030.       With this item you can select if you  want  to  play  on  the  default
  1031.       public screen, on a public screen or on a custom screen. If  you  want
  1032.       to play on a public screen, you have to type in its name. If you  want
  1033.       to play on a custom screen, it is recommended to  use  a  screen  with
  1034.       four or eight colors. It is possible to use a  screen  with  only  two
  1035.       colors, but this will not look very nice. More than eight  colors  are
  1036.       not recommended, because VChess currently doesn't use more than eleven
  1037.       different colors. Please keep in  mind,  that  screen  resolution  and
  1038.       number of colors may affect the calculating speed  of  your  computer.
  1039.       For example on my A3000 calculating speed is degraded about 50%  if  I
  1040.       use a hires-16-color-screen or Productivity-Mode. Note that  parts  of
  1041.       the pulldown-menu may be invisible if you use a large screenfont and a
  1042.       screen with a low horizontal resolution.
  1043.  
  1044.     "Screenfont..."
  1045.        
  1046.       If you play on a custom screen, then you can select a  font  which  is
  1047.       used for menus and windowtitles.
  1048.  
  1049.     "Textfont..."
  1050.        
  1051.       With this function you can select a font which is used in  the  active
  1052.       window. First click in the desired window to make it the  active  one,
  1053.       then select this item. So you can  select  different  fonts  for  each
  1054.       window.
  1055.  
  1056.   Set Up
  1057.      
  1058.     You can access this menu only if you are in Buildup-Mode, maybe you have
  1059.     to select "Project/StopGame" before.
  1060.  
  1061.     "Load Game..."
  1062.        
  1063.       See "Project/Load Game..."
  1064.  
  1065.     "First Move"
  1066.        
  1067.       Jumps to the beginning of the game.
  1068.  
  1069.     "Next Move"
  1070.        
  1071.       The next move is performed.
  1072.  
  1073.     "Previous Move"
  1074.        
  1075.       Takes back the last move.
  1076.  
  1077.     "Last Move"
  1078.        
  1079.       Jumps to the last move of the actual game.
  1080.  
  1081.       In Playing- and Buildup-Mode, you can use the Scroller and  associated
  1082.       Arrows in the board-window  to  move  in  a  game,  too.  And  if  the
  1083.       boardwindow is active, you can use the Cursor-Keys too:
  1084.  
  1085.       Cursor Left:  Move to beginning
  1086.       Cursor Right: Move to the end
  1087.       Cursor Down:  Do next move
  1088.       Cursor Up:    Go back, or undo
  1089.        
  1090.     "Clear Board"
  1091.        
  1092.       All pieces are removed from the board.
  1093.  
  1094.     "Build Up"
  1095.        
  1096.       All pieces are moved to their start-position.
  1097.  
  1098.     "Reset"
  1099.        
  1100.       Resets a modified board. This is useful, if there is a game in  memory
  1101.       (just played or loaded), and you have modified  the  board  by  moving
  1102.       pieces (or changed the active color with the following two items).  In
  1103.       this case it is not possible to  go  on  playing  this  game,  to  use
  1104.       "Next Move", "Previous Move" etc. Instead of pushing  back  all  moved
  1105.       pieces, you can use this item to reset the board and active color.
  1106.  
  1107.     "White's turn"
  1108.        
  1109.       The white player has to do the next move.
  1110.  
  1111.     "Black's turn"
  1112.        
  1113.       The black player has to do the next move.
  1114.  
  1115.   Config
  1116.   ------
  1117.      
  1118.     You can save all settings in a configuration-file.
  1119.  
  1120.     "Create Icons ?"
  1121.        
  1122.       With this item you can select if the program shall  create  icons  for
  1123.       saved files. If the program  has  to  make  Icons,  then  one  of  the
  1124.       following icons is copied if it exist, or defaults are used.
  1125.  
  1126.       Filetype          Used Icon (if it exists)
  1127.       ------------------------------------------
  1128.       Game              "Icons/GameIcon", "GameIcon", "Games/Game1", "Game1"
  1129.       Configuration     "Icons/ConfigIcon", "ConfigIcon",
  1130.                         "Configs/VChess.config", "VChess.config";
  1131.       Textfile          "Icons/TextIcon", "TextIcon", "Text/Text1", "Text1"
  1132.  
  1133.       Additional, if using Locale.library, for each filetype there  are  two
  1134.       language-dependant Iconnames. For "deutsch" these are:
  1135.  
  1136.       Filetype          Icons for deutsch language (if it exists)
  1137.       ------------------------------------------
  1138.       Game              "Spiele/Spiel1", "Spiel1"
  1139.       Configuration     "Configs/VChess.config", "VChess.config";
  1140.       Textfile          "Texte/Text1", "Text1"
  1141.  
  1142.        
  1143.     "Use opp. Time ?"
  1144.        
  1145.       Starting  with  release  4.0  VChess  may  take   advantage   of   the
  1146.       thinking-time of the human player. This can be useful if the  computer
  1147.       has only a short thinking-time, while the human  player  take  a  much
  1148.       longer time. If this item is activated, the computer may do  his  move
  1149.       at once. If a weak human player plays against a fast computer, then it
  1150.       may be necessary to deactivate this item. Otherwise the  computer  may
  1151.       always win, even if the thinking-time is only one second.
  1152.  
  1153.     "Teaching ?"
  1154.        
  1155.       With this function you can switch  on  a  teaching-mode.  If  you  are
  1156.       playing and it is your turn, and  you  click  on  a  piece,  then  all
  1157.       squares on which the chessman can be moved are marked.  This  is  very
  1158.       useful for children learning chess.
  1159.  
  1160.     "Set Sound Volume..."
  1161.        
  1162.       Type in a value from 0 to 64. 0 means no sound, 64 maximum volume.
  1163.  
  1164.     "Set Error-Sound..."
  1165.        
  1166.       Now VChess can play extern soundfiles  using  datatypes.  This  should
  1167.       work with OS 3.1 if DataTypes.library is  availiable.  The  sounds  in
  1168.       drawers   "Sounds"   are   8SVX-Files,   I   found   them    in    the
  1169.       Term4.7-Distribution of Olaf Barthel. Other soundfiles may  work  too,
  1170.       if corresponding datatypes are installed on  your  computer.  You  can
  1171.       select a file from drawer "Sounds", or you can type in an empty string
  1172.       to get a simple DisplayBeep.
  1173.  
  1174.     "Set Update-Sound..."
  1175.        
  1176.       Here  you  can  select  which  sound   should   be   played   if   the
  1177.       Thinking-Window or MoveChain-Window  is  updated.  Type  in  an  empty
  1178.       string to get a simple beep.
  1179.  
  1180.     "Set Move-Sound..."
  1181.        
  1182.       This sound is played if the computer makes a  move.  An  empty  string
  1183.       will give a simple beep.
  1184.  
  1185.       If you have any trouble with the sounds, try to enter an empty  string
  1186.       (just press Return) for all three sounds. Or set Sound-Volume to 0, or
  1187.       delete the whole "Sounds"-drawer.
  1188.  
  1189.     "Load..."
  1190.        
  1191.       Loads a configuration and activates it.
  1192.  
  1193.     "Save"
  1194.        
  1195.       Saves the actual settings as defaults.  The  program  will  use  these
  1196.       settings at the next start.  The  settings  are  stored  in  the  file
  1197.       VChess.config, or if the drawer Configs exists, in this drawer.
  1198.  
  1199.     "Save As..."
  1200.        
  1201.       With this function you can save additional configurations,  which  you
  1202.       can load and activate again with "Config/Load" .
  1203.  
  1204.     "Last Saved"
  1205.        
  1206.       This function activates the configuration which was used at the  start
  1207.       of the program, or which was saved with "Save". This is the file named
  1208.       Configs/VChess.config or VChess.config.
  1209.  
  1210.     "Reset to defaults"
  1211.        
  1212.       Resets all settings to defaults.
  1213.  
  1214.   Extras
  1215.   ------
  1216.      
  1217.     "Store this Pos."
  1218.        
  1219.       Stores the current position. You can use this function in Playing- and
  1220.       Buildup-Mode. This is very useful, if you try to solve a  chess  task,
  1221.       or to develop  new  openings  or  if  you  are  playing  letter  chess
  1222.       (exchanging single moves with a friend by letters, EMail or phone.)
  1223.  
  1224.     "Restore old Pos."
  1225.        
  1226.       Restores the stored position.
  1227.  
  1228.     "Set White's Aggr., Set Black's Aggr."
  1229.        
  1230.       With these two items you can change the aggression of the computer. If
  1231.       you enter the number N, then this means that the computer will  assign
  1232.       the pieces of his opponent a new value: 
  1233.       NewValue:=(RealValue + (RealValue*N/100).
  1234.       The values of his own pieces remain unchanged. So, if  you  entered  a
  1235.       positive value, then the computer will  give  the  opposite  pieces  a
  1236.       greater value than his own pieces, and will  play  a  more  aggressive
  1237.       game, maybe he will try to exchange a pawn of his own with a  pawn  of
  1238.       his opponent. If you enter a negative value, then  the  computer  will
  1239.       play a less aggressive game, he will try to prevent  the  exchange  of
  1240.       equal pieces.
  1241.  
  1242.       White's aggression is only important if the computers plays  with  the
  1243.       white pieces. If the computer plays with the black pieces, you have to
  1244.       use "Set Black's Aggr.". You will only have to use both items, if  the
  1245.       computer plays with white and black pieces (Playmode Amiga-Amiga).  So
  1246.       you can see what happens, if a aggressive computer player plays  again
  1247.       an un-aggressive computer player.
  1248.  
  1249.     "Valuation"
  1250.        
  1251.       The computer will evaluate the current position. In Buildup-Mode  this
  1252.       valuation is only an approximation, only the pieces on the  board  and
  1253.       their strategic positions are taken into account. It is  not  regarded
  1254.       if one chessman can capture an other chessman, or if a mate will occur
  1255.       after some moves. In playing mode, the gain of the next move is  added
  1256.       to this valuation. This gives a more precise result.
  1257.  
  1258.     "Break"
  1259.        
  1260.       With this function you can force the computer to make his move. Useful
  1261.       if you are not very patient.
  1262.  
  1263.     "Undo last Move"
  1264.        
  1265.       With this function you can take back the last  move.  The  chess-rules
  1266.       don't allows this, but I think some  people  will  use  this  function
  1267.       sometimes. Of course you can take back many moves  by  selecting  this
  1268.       function again and again. (There may be a little problem: If you  take
  1269.       back an "En Passant"-Move, you (or the computer) can not do this  move
  1270.       again. In this case go back two moves, and then go forward again these
  1271.       two moves.)
  1272.  
  1273.     "Redo the Move"
  1274.        
  1275.       The move which you have taken back is again performed.
  1276.  
  1277.     "Delete Successors"
  1278.        
  1279.       With this function you can delete all successors of the  actual  move.
  1280.       This can be useful if you want to save or print only the beginning  of
  1281.       a game. Go to the desired position, then select this item.
  1282.  
  1283.     "Pause"
  1284.        
  1285.       This function stops the chess clocks, and sets the thinking-process to
  1286.       a very low priority, so no  computing-power  is  consumed.  The  break
  1287.       automatically ends, if an user input is registered.
  1288.  
  1289.     "Set Task Pri. ..."
  1290.        
  1291.       With this function you  can  modify  the  priority  of  this  program.
  1292.       Generally you  will  not  need  this  function.  Because  a  permanent
  1293.       modification  of  priority  is  not  useful,  it  is  not  stored   in
  1294.       configuration files. At the next start of VChess, the priority will be
  1295.       again zero (if started from workbench) or equal to the priority of the
  1296.       shell-process  (if  started  from  shell).   The   priority   of   the
  1297.       thinking-process is always one point lower than the  priority  of  the
  1298.       main process. So user input is always processed in real-time.
  1299.  
  1300.     "Default Quality"
  1301.        
  1302.       Whenever a move is performed, a quality is  assigned  to  it.  If  the
  1303.       moves originates from the opening-library, then the quality  is  given
  1304.       by the opening-library, !! or !. If the computer calculates the  move,
  1305.       or if you do the move with the mouse,  then  the  default  quality  is
  1306.       used. Default quality can be !!, !, !?=?!  or  ?.  There  are  only  4
  1307.       different qualities, because one move is stored  on  disk  in  only  2
  1308.       Byte. There is no more space for other qualities. I think 4  different
  1309.       qualities are enough, it is not useful to waste  one  additional  Byte
  1310.       for each move.  It  may  look  strange  that  moves  originating  from
  1311.       opening-library have quality !! or !,  for  example  e2-e4!!.  If  you
  1312.       don't  like  this,  just  turn   of   displaying   of   quality   with
  1313.       "Display/Show Quality". In the general case,  you  should  use  !?  as
  1314.       default quality, and activate "Display/Print Space For !?".  Then  you
  1315.       can mark good moves with !! or !, and bad moves with ?.
  1316.  
  1317.       "!!"
  1318.          
  1319.         Default Quality is !!
  1320.  
  1321.       "!"
  1322.          
  1323.         Default Quality is !
  1324.  
  1325.       "!?"
  1326.          
  1327.         Default Quality is !?
  1328.  
  1329.       "?"
  1330.          
  1331.         Default Quality is ?
  1332.  
  1333.     "Random"
  1334.        
  1335.       With this item you can make the play of the computer more interesting.
  1336.       Principle the computer would do always  the  same  move  in  the  same
  1337.       situation, because he calculates the best move. But to the  result  of
  1338.       the calculation a random number is added. With this function  you  can
  1339.       select the upper border of this number. 100 points are  equal  to  the
  1340.       (virtual) win of a pawn.
  1341.  
  1342.       "0, 25, 50, 100"
  1343.          
  1344.         The random value is in the range between zero and 0, 25, 50 or  100.
  1345.         If you select "0", then the computer always will do the same move in
  1346.         the same situation. If you select "50", then to each calculated gain
  1347.         a random number between 0 and 50 is added.
  1348.  
  1349.         In late endgame, i.e. King vs (King+Bishop+Knight), it may be useful
  1350.         to select a smaller Random-Value, i.e. less than 16. Otherwise, with
  1351.         Random-Value >=25, it may occur that the Computer can  not  force  a
  1352.         mate in less than 50 moves. Large Random-Values in conjunction  with
  1353.         small thinking-time in  Endgame  sometimes  gives  strange  results,
  1354.         because the computer will always try to prevent a  repetition  of  a
  1355.         position.
  1356.  
  1357.       "Custom"
  1358.          
  1359.         With this function you can enter a custom  upper  boundary  for  the
  1360.         random number. If the boundary is high, then the playing-strength of
  1361.         the computer will decrease. But maybe this is what you want.
  1362.  
  1363.     "Set Comment..."
  1364.        
  1365.       With this function you can enter or modify a textual  comment  to  the
  1366.       actual  move.  The  actual  move  is  marked  with  a   ">"   in   the
  1367.       "All Moves"-Window.
  1368.  
  1369.     "Set Quality..."
  1370.        
  1371.       With this function you can modify the quality of the actual move.
  1372.  
  1373.     "Show Comment"
  1374.        
  1375.       Displays the comment of the actual  move  in  the  Board-Window-Title.
  1376.       This may be useful, if the window titled "All-Moves" is closed, or  if
  1377.       the  comment  is  very  long.  (In  the  "All-Moves"-Window  only  the
  1378.       beginning of a long comment is displayed.)
  1379.  
  1380.     "Show Game Com."
  1381.        
  1382.       Displays the comment to this game.
  1383.  
  1384.   Openings
  1385.   --------
  1386.      
  1387.     The computer can use an Opening-library for the first moves of  a  game.
  1388.     (Please don't be confused, the Opening-library is  not  a  Library  like
  1389.     ReqTools.library, but just a collection of openings.)  The  filename  of
  1390.     this library is VChessOpenings.  This  file  must  reside  in  the  same
  1391.     directory as the program VChess (PROGDIR:). (I think there is no  reason
  1392.     to hide it in sub-directories, or to use more than one Opening-library.)
  1393.     Using this library means that the computer needs no  thinking  time  for
  1394.     the first moves, and the playing-strength of the computer is greater. Of
  1395.     course the library can only be used, if the  game  starts  from  initial
  1396.     position. (Now it should work too, if Black starts the game.) Note  that
  1397.     the opening-library is loaded if playing  starts.  This  means,  if  you
  1398.     select "Openings/Use not" before you start playing, the library will not
  1399.     be loaded in memory. In release 4.0 one Halfmove of the library needs  2
  1400.     Bytes on disk, and 16 Bytes in  RAM.  This  means,  that  a  very  large
  1401.     Library of 10^5 = 100000 Halfmoves will need 200K  on  Disk,  and  1.6MB
  1402.     RAM.
  1403.  
  1404.     "Show Name"
  1405.        
  1406.       Displays the name of the used  Opening.  For  Example  "King's  indian
  1407.       defence (3)" means, that the three first moves of this game are called
  1408.       "King's indian defence", the fourth and the following  moves  have  no
  1409.       name.
  1410.  
  1411.     "Show Moves"
  1412.        
  1413.       This function looks like a simple  chess-database  for  openings.  All
  1414.       moves of the  opening-library,  which  can  be  used  in  the  current
  1415.       situation,   are   displayed   in   the    "Move-Chain"-Window.    Try
  1416.       "Project/New Game", and then select this Item. You  will  see  "e2-e4"
  1417.       and some other good starting-moves.
  1418.  
  1419.     "ShowNumber"
  1420.        
  1421.       Displays the total number of moves (halfmoves) in the Opening-Library.
  1422.        
  1423.     "Use !!"
  1424.        
  1425.       Computer shall use only !!-moves of the opening-library.
  1426.  
  1427.     "Prefer !!"
  1428.        
  1429.       Computer shall prefer !!-moves, but may used !-moves (second class) if
  1430.       no !!-move is available.
  1431.  
  1432.     "Use !! and !"
  1433.        
  1434.       Computer may use both classes.
  1435.  
  1436.     "Don't use"
  1437.        
  1438.       Computer shall not use the Opening-Library.
  1439.  
  1440.     "Delete actual"
  1441.        
  1442.       Which this function you can delete the  actual,  last  performed  move
  1443.       from opening-library. For example, if the computer has done  the  move
  1444.       a2-a3, and you think that this is a bad move, just select this item to
  1445.       delete it and all successors of this move in opening-library. You  can
  1446.       use this function to delete any opening. For example, you suppose that
  1447.       1. e2-e4  b7-b6 is stored in Opening-Library, and you think  that  the
  1448.       second halfmove is a  bad  move.  Select  "Playmode/Human-Human"  from
  1449.       menu, and then "Project/New Game". Now do these two  moves,  and  then
  1450.       select "Openings/Delete actual" to delete b7-b6  and  all  successors.
  1451.       e2-e4 will remain unmodified.
  1452.  
  1453.     "Cut Tree..."
  1454.        
  1455.       This  may  be  useful   if   your   Opening-Library   is   to   large.
  1456.       Opening-Library builds a tree, and with this function you can cut  all
  1457.       branches which are longer than the  number  which  you  enter  in  the
  1458.       string-gadget. This works like hedgeshears!
  1459.  
  1460.     "Delete all !"
  1461.        
  1462.       This may be useful if your Opening-Library is to large. It will delete
  1463.       all second-class moves.
  1464.  
  1465.     "Dump to File..."
  1466.        
  1467.       This function writes all moves to a file in  algebraic  notation.  The
  1468.       resulting file may become very large, because the three-structure  has
  1469.       to be converted to a linear form.
  1470.  
  1471.     "Add this Game"
  1472.        
  1473.       Adds the current game to the library. Please note,  that  only  first-
  1474.       and second-class moves can be stored in the library. Of course you can
  1475.       add only regular games, this means games started  from  their  initial
  1476.       position and white as active player. If you will add an opening from a
  1477.       chess  book,  it  is  recommended  to  do  it  in  this  way:   Select
  1478.       "Players/Human-Human" and now "Project/NewGame". Now you can play  the
  1479.       opening from the book, and then select this item  to  add  it  to  the
  1480.       library. You should only add your own openings (games) to the  library
  1481.       if you are a strong player, because an  opening  should  contain  only
  1482.       very strong moves. If there is only one weak move, then  the  computer
  1483.       may do this weak move and the playing-strength decreases. Please  note
  1484.       the following: If you want to add new entries to the  Opening-Library,
  1485.       it is necessary to load the existing library in memory before you  add
  1486.       new  entries.   To   test   if   the   library   is   loaded,   select
  1487.       "Openings/Show Number",  or  just  use  "Openings/Load"  to  load   it
  1488.       (again).
  1489.  
  1490.     "Correct Quality ?"
  1491.        
  1492.       If this item is marked, then the quality  of  existing  moves  in  the
  1493.       library may be overwritten if you add new moves. In general case  this
  1494.       item should not be activated. But it may be useful, for example if  1.
  1495.       e2-e4! is stored in the library, and you want to modify it to e2-e4!!.
  1496.        
  1497.     "Max Depth"
  1498.        
  1499.       With the following items you can set the maximum depth,  up  to  which
  1500.       moves can be added to the library with "Openings/Add This Game". It is
  1501.       not useful to add all moves of a game to the library. 18  Moves  =  36
  1502.       Halfmoves are a good depth. But of course  you  can  add  the  maximum
  1503.       value, 64 halfmoves, and use "Openings/Cut Tree" if the library  grows
  1504.       to big.
  1505.  
  1506.       "24"
  1507.          
  1508.         Don't add more than 24 Halfmoves.
  1509.  
  1510.       "36"
  1511.          
  1512.         Don't add more than 36 Halfmoves.
  1513.  
  1514.       "48"
  1515.          
  1516.         Don't add more than 48 Halfmoves.
  1517.  
  1518.       "64"
  1519.          
  1520.         Add up to 64 Halfmoves, this means up to 32 Moves.
  1521.  
  1522.     "Load"
  1523.        
  1524.       Load the Library again from disk. This can be useful if you have  done
  1525.       an operation like "Openings/Cut Tree", and you have  deleted  to  many
  1526.       moves.
  1527.  
  1528.     "Import V3.5..."
  1529.        
  1530.       This function is for people who have created a  large  Opening-Library
  1531.       with VChess 3.5, and want to use it with VChess 4.1.  You  can  import
  1532.       more than one V3.5-Library. Proceed as following:  Start  VChess,  and
  1533.       select this function. Now select the  (first)  V3.5-Openings-file.  It
  1534.       will be imported. Now you can select further  V3.5-Openings-files.  If
  1535.       you are done, you may select "Openings/Show Number" to  see  how  many
  1536.       Moves you have imported.  Now  select  "Openings/Save all Entries"  to
  1537.       save the library in the new format. This  function  will  destroy  the
  1538.       currend game!
  1539.  
  1540.     "Flush"
  1541.        
  1542.       This function will remove all moves from RAM. This can be  useful,  if
  1543.       you don't need the library any more, and you have not much RAM.
  1544.  
  1545.     "Save all Entries"
  1546.        
  1547.       If you select this item, then the opening-library  is  saved.  If  you
  1548.       forgot this, all modifications are lost. 
  1549.  
  1550. Menu-Shortcuts
  1551. ==============
  1552.  
  1553.   Some people like many Shortcuts, other not. The menu is very large, with a
  1554.   large  screenfont  a  menu  with  much shortcuts may look not so nice. The
  1555.   english VChess.catalog will give you many shortcuts. If you don't like  so
  1556.   much shortcuts, then you can delete (or rename) this catalog, and you will
  1557.   get only a few shortcuts in the "Project"-menu.
  1558.  
  1559. Advanced Topics
  1560. ===============
  1561.  
  1562.   If you want to start a game with a definite opening, then you  can  do  it
  1563.   this   way:   Select   "Players/Human-Human"    in    menu,    and    then
  1564.   "Project/New Game".  Now  do  the  desired  starting-moves,  for   example
  1565.   "1.e2-e4  e7-e5". Now select "Players/Human-Amiga". Now do your next move,
  1566.   for example 2.g1f3. Now the computer will do the next move, using  a  move
  1567.   from Opening-library if present. But you have to take care about this: You
  1568.   should switch  from  "Players/Human-Human"  to  "Players/Amiga-Human"  (or
  1569.   Players/Human-Amiga) only  if  it  will  be  your  turn  after  switching.
  1570.   Otherwise the computer is already thinking for his own move, and  he  will
  1571.   use the result of the thinking-process instead of a move from library.  If
  1572.   you want to use the same opening many  times,  then  do  the  first  moves
  1573.   (until it is your turn), and  save  the  game  ,  for  example  with  name
  1574.   "MyPreferedOpening". Now  select  "Config/Save"  to  make  this  name  the
  1575.   default  game-name.  If  you  start  VChess   again,   do   this:   Select
  1576.   "Project/Load Quick", "Setup/Last Move" and "Project/Start Game".  Now  it
  1577.   should be your turn, and you start the game  from  the  desired  position,
  1578.   while the computer can use the opening-library.
  1579.  
  1580.   If you enter additional openings, then it is not necessary to  enter  each
  1581.   opening from the beginning  again.  If  you  want  to  add  openings,  all
  1582.   beginning with e2e4,e7e5,g1f3, then you have to type in  the  first  three
  1583.   halfmoves only ones. You can use cursor-keys, scrollergadget or  the  menu
  1584.   to go back some moves, and then type in  the  new  way.  Or  you  can  use
  1585.   "Extras/Store Position" and "Extras/Restore Position" too. This  may  save
  1586.   some work, or it may confuse you. 
  1587.  
  1588. Now, at the end of this text, some general remarks:
  1589.  
  1590. Errors or bugs in VChess
  1591. ========================
  1592.    
  1593.   I'm sure that there are some small bugs in this version of  VChess.  Don't
  1594.   hesitate to write to me if you find bugs or have  comments  about  VChess.
  1595.   But please don't expect a (long) response to each of your  short  letters.
  1596.   Till summer 1997 you may reach me at this EMail-Adress:
  1597.  
  1598.   SALEWSKI@PHYSNET.UNI-HAMBURG.DE
  1599.    
  1600.   But please don't send mail just for fun!
  1601.  
  1602.  
  1603. New releases of VChess
  1604. ======================
  1605.    
  1606.   There are still  some  things  which  may  be  improved.  Transfering  the
  1607.   thinking-algorithm  from  Oberon   to   Assembler   would   increase   the
  1608.   calculating-power by a factor 2, and it  may  be  useful  to  use  special
  1609.   algorithm for special situations. An ARexx-port, a  Database  (Hash-Table)
  1610.   for endgame, PGN-Format-Support may be useful. Using a  (MUI)Control-Panel
  1611.   instead of such a large Pull-Down-Menu would make it more easy  to  change
  1612.   settings, and some people would like a board with 3D-Graphics. But I think
  1613.   that there will be no major Updates of  VChess  on  the  Amiga.  Till  now
  1614.   (27.12.1996) only 70 VChess-user paid their contribution. And in  the last
  1615.   12 months I got only 8 new regitrations. This is not enough  to  cover  my
  1616.   expenses. If this release should contain serious bugs, then you may find a
  1617.   bugfix in AmiNet in some months.
  1618.  
  1619.   Maybe there will be a transformation of VChess on a Pentium-  or  RISC-CPU
  1620.   in the far away future. But that release will not be Shareware again!
  1621.  
  1622. VChess and other languages
  1623. ==========================
  1624.    
  1625.   It is allowed to make verbatim translations of this  documentation  or  to
  1626.   produce new catalog files for other languages. You  can  distribute  these
  1627.   translations (together  with  the  VChess-package)  in  your  own  country
  1628.   without asking me for permission, but please don't make free, shortened or
  1629.   buggy translations. You should only make translations, if you  are  really
  1630.   using VChess, so that you can verify your work. (I think no translation is
  1631.   better than a bad one.) Making a translation is a lot of work, so  it  may
  1632.   be useful to contact me before starting with the translation. Maybe  there
  1633.   is already a new release of VChess, or someone else has already  made  the
  1634.   desired translation. If you have produced a really good translation,  then
  1635.   you can send it to me. Maybe I will add it to the VChess-package.
  1636.  
  1637.   By using the Locale.library, VChess can adapt itself to other languages if
  1638.   running under OS2.1+. Currently only english is supported.  But  the  file
  1639.   VChess.cd is part of this package. So if you have the program  CatComp  (©
  1640.   CBM) (or a FD-Program which works like CatComp) and you know  how  to  use
  1641.   CatComp, then you can produce Catalogfiles for  your  preferred  language.
  1642.   Although English is the built-in  language  of  VChess,  there  exists  an
  1643.   English VChess.ct-file. You  can  use  this  (together  with  CatComp  and
  1644.   locale.library) to adapt the English text to your own desire. (Modify  the
  1645.   VChess.ct-file, use CatComp  to  create  the  VChess.catalog-file  (Usage:
  1646.   CatComp VChess.cd TRANSLATION VChess.ct CATALOG VChess.catalog)  and  then
  1647.   copy the VChess.catalog-file to  Catalogs/english/VChess.catalog.  If  you
  1648.   now start VChess again (after a reset or "avail flush"),  you  should  get
  1649.   the new text.)
  1650.  
  1651.   (There exists an english Catalog (Drawer  Catalogs/english/VChess.catalog)
  1652.   too.  If  you  use  this catalog, you will get many Menu-Shortcuts. If you
  1653.   don't like so much shortcuts (like me), just delete this catalog. Then you
  1654.   will get the built in strings, with only very few Shortcuts.)
  1655.  
  1656.  
  1657.   If  you   modify   Catalog-translations   (VChess.ct),   or   create   new
  1658.   translations, please note this: Menu-Shortcuts are localized too. This  is
  1659.   suggested in the Amiga-Style-Guide-manual, although many programs don't do
  1660.   this. For most menutexts, there  is  a  corresponding  Shortcut-text.  Use
  1661.   "\x00" to get no shortcut, or a single character to use a  shortcut. (This
  1662.   is much overhead, Nico Francois used  an  other  way.  He  integrated  the
  1663.   shortcut into the menutext. I used this way in release 3.5 too,  but  this
  1664.   was diffical to handle  for  translators.)  In  the  Catalog-translations,
  1665.   there are some strings which contains vertical bars, "|". These characters
  1666.   have a special meaning for ReqTools.library.  They  divide  the  text  for
  1667.   different response-gadgets, so don't delete these characters.  If  such  a
  1668.   string contains any number of these characters,  the  number  must  remain
  1669.   constant. Some strings may contain the characters "%ld". This is  used  to
  1670.   insert a number, so don't delete this. Some strings contain  "\x20".  This
  1671.   is only a space, you may delete it, but  this  is  not  recommended.  Some
  1672.   strings must have a special length, look at the  file  VChess.cd  to  read
  1673.   this length. (/6/8) for example  means,  that  the  minimum  length  is  6
  1674.   characters, and maximum length is 8 characters.  Some  strings  contain  a
  1675.   "\n". This is only to write the following text on a new line. Most strings
  1676.   have no limitations in length, but if you create too long strings, it  may
  1677.   look ugly.
  1678.  
  1679.   And now I hope that you enjoy this game.
  1680.  
  1681.   Stefan Salewski, December 1996
  1682.  
  1683.