updated documentation
[xboard.git] / winboard / install / files / root / WinBoard / doc / manual.html
index 5627b4f..11af3cb 100644 (file)
@@ -2,31 +2,36 @@
 <html>\r
 \r
 <head>\r
-<title>WinBoard 4.3.15</title>\r
+<title>WinBoard 4.4.0</title>\r
 </head>\r
 \r
 <body>\r
 <table><tr><td halign="top">\r
-<h1>WinBoard 4.3.15</h1>\r
+<h1>WinBoard 4.4.0</h1>\r
 <h2>"For the ultimate WinBoard experience"</h2>\r
 <h3>Introduction</h3>\r
 <p>\r
-The WinBoard 4.3 series is a continuation of the WinBoard_x line by Allessandro Scotti.\r
-It is been further developed, and is maintained, by H.G. Muller.\r
+The WinBoard 4.3 series was a continuation of the WinBoard_x line by Allessandro Scotti.\r
+It has been further developed, and is maintained, by H.G. Muller.\r
 Most addtions and improvements that went into this since the last version produced\r
 by the GNU-Savannah xboard project team, WinBoard 4.2.7b,\r
-are unfortunately not parallelled in xboard.\r
-On the contrary, they have destroyed the compatibility of the back-end sources\r
-shared by WinBoard and xboard with the xboard front-end of version 4.2.7b.\r
-Since WinBoard 4.3.14, however, the releases again coms with a compatible xboard front-end.\r
+were unfortunately not parallelled in XBoard.\r
+On the contrary, they had destroyed the compatibility of the back-end sources\r
+shared by WinBoard and XBoard with the XBoard front-end of version 4.2.7b.\r
+Since WinBoard 4.3.14, however, the releases again comes with a compatible XBoard front-end.\r
 That does not mean that all the features added to WinBoard can already be used\r
-in this xboard version.\r
+in the latest XBoard version.\r
 But some can, an in 4.3.15 many more have been added.\r
 </p><p>\r
+WinBoard 4.4 is a merger of the WinBoard 4.3 line (WinBoard 4.3.pre16) \r
+and what was left in the GNU-Svannah XBoard repository (WinBoard 4.2.pre8).\r
+More WinBoard functionality has been ported to XBoard,\r
+but there still is a sizable gap to bridge.\r
+</p><p>\r
 The description below applies specifically to WinBoard, \r
 although we have tried to mark features that can also be used in xboard by (x) everywhere.\r
-This version of xboard does does have som new menus added to control such features.\r
-Other functionss, if they work at all, must be switched on from the command line.\r
+This version of XBoard now does have some new menus added to control such features.\r
+Other functions, if they work at all, must be switched on from the command line.\r
 </p>\r
 </td><td width="20">\r
 </td><td width="200" halign="center" cellpdding="20">\r
@@ -84,7 +89,7 @@ and handles the castling, e.p. and 50-move field in FENs on input and output as
     </td><td>\r
       Options -> Engine.. (x)\r
   </td></tr><tr><td>\r
-      -adjudicateDrawMoves 0 (*)\r
+      -adjudicateDrawMoves 0 (*x)\r
     </td><td>\r
       adjudicate draw when game lasts too long\r
     </td><td>\r
@@ -154,9 +159,9 @@ and handles the castling, e.p. and 50-move field in FENs on input and output as
     </td><td>\r
       -\r
   </td></tr><tr><td>\r
-      -delayBeforeQuit 0 (*)\r
+      -delayBeforeQuit 0 (*x)\r
       <br>\r
-      -delayAfterQuit 0 (*)\r
+      -delayAfterQuit 0 (*x)\r
     </td><td>\r
       timing parameter specifying how to terminate the engine processes\r
     </td><td>\r
@@ -168,6 +173,12 @@ and handles the castling, e.p. and 50-move field in FENs on input and output as
     </td><td>\r
       left- or right-cick on clock in edit-game mode\r
   </td></tr><tr><td>\r
+      -niceEngines 0 (*x)\r
+    </td><td>\r
+      lower the CPU priority of the engines\r
+    </td><td>\r
+      -\r
+  </td></tr><tr><td>\r
       \r
     </td><td bgcolor="lightblue">\r
       <strong>DISPLAY-LOOK OPTIONS</strong>\r
@@ -234,6 +245,16 @@ and handles the castling, e.p. and 50-move field in FENs on input and output as
     </td><td>\r
       -\r
   </td></tr><tr><td>\r
+      -autoLogo false (*)\r
+      <br>\r
+      -firstLogo ""\r
+      <br>\r
+      -secondLogo ""\r
+    </td><td>\r
+      causes WinBoard to display player logos above the board, next to the clocks.\r
+    </td><td>\r
+      -\r
+  </td></tr><tr><td>\r
       -\r
     </td><td>\r
       Swap white and black clock\r
@@ -242,85 +263,107 @@ and handles the castling, e.p. and 50-move field in FENs on input and output as
   </td></tr><tr><td>\r
       \r
     </td><td bgcolor="lightblue">\r
-      <strong>UCI ENGINE OPTIONS</strong>\r
+      <strong>(UCI) ENGINE OPTIONS</strong>\r
     </td><td>\r
       \r
   </td></tr><tr><td>\r
-      -polyglotDir "" (*)\r
+      -polyglotDir "" (*x)\r
     </td><td>\r
       tells WinBoard where you installed Polyglot, for automatic invocation with UCI engines\r
     </td><td>\r
-      Options -> UCI... (x)\r
+      Options -> Global Settings... (x)\r
   </td></tr><tr><td>\r
-      -polyglotBook "" (*)\r
+      -polyglotBook "" (*x)\r
     </td><td>\r
       tells WinBoard which opening book it should use, or should make Polyglot use.\r
     </td><td>\r
-      Options -> UCI... (x)\r
+      Options -> Global Settings... (x)\r
   </td></tr><tr><td>\r
-      -usePolyglotBook false (*)\r
+      -usePolyglotBook false (*x)\r
     </td><td>\r
       turns the use of the Polygot book on or off\r
     </td><td>\r
-      Options -> UCI... (x)\r
+      Options -> Global Settings... (x)\r
   </td></tr><tr><td>\r
-      -defaultPathEGTB "c:\egtb" (*)\r
+      -defaultPathEGTB "c:\egtb" (*x)\r
     </td><td>\r
       folder where to find end-game tables\r
     </td><td>\r
-      Options -> UCI... (x)\r
+      Options -> Global Settings... (x)\r
   </td></tr><tr><td>\r
-      -defaultCacheSizeEGTB 4 (*)\r
+      -defaultCacheSizeEGTB 4 (*x)\r
     </td><td>\r
       specifies the cache size for UCI engines\r
     </td><td>\r
-      Options -> UCI... (x)\r
+      Options -> Global Settings... (x)\r
   </td></tr><tr><td>\r
-      -defaultHashSize 64 (*)\r
+      -defaultHashSize 64 (*x)\r
     </td><td>\r
-      Specifies the size of the main hash table for UCI engines\r
+      specifies the size of the main hash table for UCI engines and WinBoard engines implementing the memory command\r
     </td><td>\r
-      Options -> UCI... (x)\r
+      Options -> Global Settings... (x)\r
   </td></tr><tr><td>\r
-      -firstIsUCI false\r
+      -firstIsUCI false (x)\r
       <br>\r
-      -secondIsUCI false\r
+      -secondIsUCI false (x)\r
       <br>\r
-      -fUCI\r
+      -fUCI (x)\r
       <br>\r
-      -sUCI\r
+      -sUCI (x)\r
     </td><td>\r
       tells WinBoard the corresponding engine should be run through Polyglot\r
     </td><td>\r
       -\r
   </td></tr><tr><td>\r
-      -firstHasOwnBookUCI true\r
+      -firstHasOwnBookUCI true (x)\r
       <br>\r
-      -secondHasOwnBookUCI true\r
+      -secondHasOwnBookUCI true (x)\r
       <br>\r
-      -fNoOwnBookUCI true\r
+      -fNoOwnBookUCI true (x)\r
       <br>\r
-      -sNoOwnBookUCI true\r
+      -sNoOwnBookUCI true (x)\r
+      <br>\r
+      -firstXBook (x)\r
+      <br>\r
+      -secondXBook (x)\r
     </td><td>\r
-      tells Polyglot if the engine should use its own opening book\r
+      tells WinBoard (or Polyglot) if the engine should use its own opening book\r
     </td><td>\r
-      Options -> Engine Settings... (xboard only)\r
+      Options -> Global Settings... (x)\r
   </td></tr><tr><td>\r
       -smpCores 1 (*x)\r
     </td><td>\r
-      Sets the maximum number of CPUs an SMP engine can use.\r
+      sets the maximum number of CPUs an SMP engine can use.\r
       (only affects engines that support the <strong>cores</strong> command of WB protocol)\r
     </td><td>\r
-      Options -> Engine Settings... (xboard only)\r
+      Options -> Global Settings... (x)\r
   </td></tr><tr><td>\r
       -egtFormats "" (*x)\r
     </td><td>\r
-      Specifies which end-game tables are installed on the computer,\r
+      specifies which end-game tables are installed on the computer,\r
       and where they can be found\r
       (e.g. "nalimov:\chess\egtb,scorpio:\chess\bitbases")\r
     </td><td>\r
       -\r
   </td></tr><tr><td>\r
+      -firstOptions "" (x)\r
+      <br>\r
+      -secondOptions "" (x)\r
+    </td><td>\r
+      sets engine-defined options of UCI engines and WinBoard engines that support the option feature.\r
+    </td><td>\r
+      Options -> Engine #1 Settings... (x)\r
+      <br>\r
+      Options -> Engine #2 Settings... (x)\r
+  </td></tr><tr><td>\r
+      -firstNeedsNoncompliantFEN "" (x)\r
+      <br>\r
+      -secondNeedsNoncompliantFEN "" (x)\r
+    </td><td>\r
+      directly specifies castling and e.p. field to be used in all FENs sent to mentioned engine\r
+    </td><td>\r
+      -\r
+  </td></tr><tr><td>\r
       \r
     </td><td bgcolor="lightblue">\r
       <strong>CHESS-VARIANT OPTIONS</strong>\r
@@ -341,7 +384,7 @@ and handles the castling, e.p. and 50-move field in FENs on input and output as
       -variant normal (x)\r
     </td><td>\r
       supports many new variants: xiangqi, shogi, fischerandom, capabanca, gothic, caparandom, janus,\r
-      shatranj, courier, knightmate, berolina, falcon, cylinder, fairy, super\r
+      shatranj, courier, knightmate, berolina, falcon, cylinder, fairy, super, great\r
     </td><td>\r
       File -> New Variant... (x)\r
   </td></tr><tr><td>\r
@@ -401,13 +444,19 @@ and handles the castling, e.p. and 50-move field in FENs on input and output as
     </td><td>\r
       Options -> General... (x)\r
   </td></tr><tr><td>\r
+      -userName "" (x)\r
+    </td><td>\r
+      sets the name of the human player\r
+    </td><td>\r
+      Mode -> Enter Username... (x)\r
+  </td></tr><tr><td>\r
       \r
     </td><td bgcolor="lightblue">\r
       <strong>USER-INTERFACE OPTIONS AND WINDOW CONTROL</strong>\r
     </td><td>\r
       \r
   </td></tr><tr><td>\r
-      -moveHistoryUP true (*)\r
+      -moveHistoryUp true (*)\r
       <br>\r
       -moveHistoryX 0 (*)\r
       <br>\r
@@ -418,6 +467,7 @@ and handles the castling, e.p. and 50-move field in FENs on input and output as
       -moveHistoryH 0 (*)\r
     </td><td>\r
       controls opening, placement and size of a window containing the moves of the current game\r
+      (new in 4.4 is that all X and Y coordinates of auxiliary windows are stored relative to the main window)\r
     </td><td>\r
       Mode -> Show Move History (x)\r
   </td></tr><tr><td>\r
@@ -488,20 +538,50 @@ and handles the castling, e.p. and 50-move field in FENs on input and output as
     </td><td>\r
       Options -> Game List...\r
   </td></tr><tr><td>\r
+      -noGUI (x)\r
+    </td><td>\r
+      suppress update of display on all machine and ICS moves (moves, clocks, icon)\r
+    </td><td>\r
+      -\r
+  </td></tr><tr><td>\r
+      \r
+    </td><td bgcolor="lightblue">\r
+      <strong>ICS OPTIONS</strong>\r
+    </td><td>\r
+      \r
+  </td></tr><tr><td>\r
+      -autoKibitz (x)\r
+    </td><td>\r
+      kibitz engine Thinking Output to ICS, and capture opponent kibitz for in PGN\r
+    </td><td>\r
+      -\r
+  </td></tr><tr><td>\r
+      -zippyShortGame 0 (x)\r
+    </td><td>\r
+      ban opponents on ICS that abort without playing\r
+    </td><td>\r
+      -\r
+  </td></tr><tr><td>\r
       \r
     </td><td bgcolor="lightblue">\r
       <strong>MISCELLANEOUS</strong>\r
     </td><td>\r
       \r
   </td></tr><tr><td>\r
-      -debugFile "winboard.debug"\r
+      -debugFile "winboard.debug" (x)\r
       <br>\r
-      -nameOfDebugFile "winboard.debug"\r
+      -nameOfDebugFile "winboard.debug" (x)\r
     </td><td>\r
       allows you to specify an alternative name for saving the debug information\r
     </td><td>\r
       -\r
   </td></tr><tr><td>\r
+      -engineDebugOutput 0 (x)\r
+    </td><td>\r
+      tells WinBoard if and how to put protocol-violating output in the debug file\r
+    </td><td>\r
+      -\r
+  </td></tr><tr><td>\r
       -\r
     </td><td>\r
       save chess-board display as diagram in bitmap file\r
@@ -509,6 +589,12 @@ and handles the castling, e.p. and 50-move field in FENs on input and output as
     </td><td>\r
       File -> Save Diagram...\r
   </td></tr><tr><td>\r
+      -defaultFrcPosition -1 (*x)\r
+    </td><td>\r
+      specify the number of the starting position in shuffle Chess variants\r
+    </td><td>\r
+      File -> New Shuffle Game... (x)\r
+  </td></tr><tr><td>\r
       -\r
     </td><td>\r
       display only those lines in the game list that contain a given string\r
@@ -525,6 +611,12 @@ and handles the castling, e.p. and 50-move field in FENs on input and output as
       and -2 after every two games (so that each position is played with black and white).\r
     </td><td>\r
       -\r
+  </td></tr><tr><td>\r
+      -sameColorGames 0 (x)\r
+    </td><td>\r
+      play a match, but without alternating the colors (overrules -matchGames)\r
+    </td><td>\r
+      -\r
 </td></tr></table>\r
 <p>\r
 The value with which the option is listed is the default value.\r