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