<title>ICS options - XBoard</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="XBoard">
-<meta name="generator" content="makeinfo 4.12">
+<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Options.html#Options" title="Options">
-<link rel="prev" href="UCI-_002b-WB-Engine-Settings.html#UCI-_002b-WB-Engine-Settings" title="UCI + WB Engine Settings">
+<link rel="prev" href="Tournament-options.html#Tournament-options" title="Tournament options">
<link rel="next" href="Load-and-Save-options.html#Load-and-Save-options" title="Load and Save options">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
</head>
<body>
<div class="node">
-<p>
<a name="ICS-options"></a>
+<p>
Next: <a rel="next" accesskey="n" href="Load-and-Save-options.html#Load-and-Save-options">Load and Save options</a>,
-Previous: <a rel="previous" accesskey="p" href="UCI-_002b-WB-Engine-Settings.html#UCI-_002b-WB-Engine-Settings">UCI + WB Engine Settings</a>,
+Previous: <a rel="previous" accesskey="p" href="Tournament-options.html#Tournament-options">Tournament options</a>,
Up: <a rel="up" accesskey="u" href="Options.html#Options">Options</a>
<hr>
</div>
-<h3 class="section">3.3 ICS options</h3>
+<h3 class="section">4.4 ICS options</h3>
-<p><a name="index-ICS-options-189"></a><a name="index-Options_002c-ICS-190"></a>
+<p><a name="index-ICS-options-313"></a><a name="index-Options_002c-ICS-314"></a>
<dl>
-<dt>-ics/-xics or -internetChessServerMode true/false<dd><a name="index-ics_002c-option-191"></a><a name="index-internetChessServerMode_002c-option-192"></a>Connect with an Internet Chess Server to play chess against its\r
-other users, observe games they are playing, or review games\r
-that have recently finished. Default: false.\r
-<br><dt>-icshost or -internetChessServerHost host<dd><a name="index-icshost_002c-option-193"></a><a name="index-internetChessServerHost_002c-option-194"></a>The Internet host name or address of the chess server to connect\r
-to when in ICS mode. Default: <code>chessclub.com</code>.\r
-Another popular chess server to try is <code>freechess.org</code>.\r
-If your site doesn't have a working Internet name server, try\r
-specifying the host address in numeric form. \r
-You may also need\r
-to specify the numeric address when using the icshelper option\r
-with timestamp or timeseal (see below).\r
-<br><dt>-icsport or -internetChessServerPort port-number<dd><a name="index-icsport_002c-option-195"></a><a name="index-internetChessServerPort_002c-option-196"></a>The port number to use when connecting to a chess server in ICS\r
-mode. Default: 5000.\r
-<br><dt>-icshelper or -internetChessServerHelper prog-name<dd><a name="index-icshelper_002c-option-197"></a><a name="index-internetChessServerHelper_002c-option-198"></a>An external helper program used to communicate with the chess server.\r
-You would set it to "timestamp" for ICC (chessclub.com) or\r
-"timeseal" for FICS (freechess.org), after\r
-obtaining the correct version of timestamp or timeseal for your\r
-computer. See "help timestamp" on ICC and "help timeseal" on FICS.\r
-This option is shorthand for <code>-useTelnet -telnetProgram program</code>.\r
-<br><dt>-telnet/-xtelnet or -useTelnet true/false<dd><a name="index-telnet_002c-option-199"></a><a name="index-useTelnet_002c-option-200"></a>This option is poorly named; it should be called useHelper.\r
-If set to true, it instructs XBoard to run an external\r
-program to communicate with the Internet Chess Server. \r
-The program to use is given by the telnetProgram option.\r
-If the option is\r
-false (the default), XBoard opens a TCP socket and uses its own\r
-internal implementation of the telnet protocol to communicate with the\r
-ICS. See <a href="Firewalls.html#Firewalls">Firewalls</a>.\r
-<br><dt>-telnetProgram prog-name<dd><a name="index-telnetProgram_002c-option-201"></a>This option is poorly named; it should be called helperProgram.\r
-It gives the name of the telnet program to be used with\r
-the <code>gateway</code> and <code>useTelnet</code> options. The default is\r
-<samp><span class="file">telnet</span></samp>. The telnet program is invoked with the value of\r
-<code>internetChessServerHost</code> as its first argument and the value\r
-of <code>internetChessServerPort</code> as its second argument.\r
-See <a href="Firewalls.html#Firewalls">Firewalls</a>.\r
-<br><dt>-gateway host-name<dd><a name="index-gateway_002c-option-202"></a>If this option is set to a host name, XBoard communicates with the\r
-Internet Chess Server by using <samp><span class="file">rsh</span></samp> to run\r
-the <code>telnetProgram</code> on the given host,\r
-instead of using its own internal implementation\r
-of the telnet protocol. You can substitute a different remote shell\r
-program for <samp><span class="file">rsh</span></samp> using the <code>remoteShell</code> option described below.\r
-See <a href="Firewalls.html#Firewalls">Firewalls</a>.\r
-<br><dt>-internetChessServerCommPort or -icscomm dev-name<dd><a name="index-internetChessServerCommPort_002c-option-203"></a><a name="index-icscomm_002c-option-204"></a>If this option is set, XBoard communicates with the ICS through\r
-the given character I/O device instead of opening a TCP connection.\r
-Use this option if your system does not have any kind of\r
-Internet connection itself (not even a SLIP or PPP connection),\r
-but you do have dialup access (or a hardwired terminal line) to\r
-an Internet service provider from which you can telnet to the ICS.\r
-\r
-The support for this option in XBoard is minimal. You need to\r
-set all communication parameters and tty modes before you enter\r
-XBoard.\r
-\r
-Use a script something like this:\r
-\r
- <pre class="example"> stty raw -echo 9600 > /dev/tty00\r
- xboard -ics -icscomm /dev/tty00\r
-</pre>
- <p>\r
-Here replace ‘<samp><span class="samp">/dev/tty00</span></samp>’ with the name of the device that your\r
-modem is connected to. You might have to add several more\r
-options to these stty commands. See the man pages for <samp><span class="file">stty</span></samp>\r
-and <code>tty</code> if you run into problems. Also, on many systems stty\r
-works on its standard input instead of standard output, so you\r
-have to use ‘<samp><span class="samp"><</span></samp>’ instead of ‘<samp><span class="samp">></span></samp>’.\r
-\r
-If you are using linux, try starting with the script below.\r
-Change it as necessary for your installation.\r
-\r
- <pre class="example"> #!/bin/sh -f\r
- # configure modem and fire up XBoard\r
- \r
- # configure modem\r
- (\r
- stty 2400 ; stty raw ; stty hupcl ; stty -clocal\r
- stty ignbrk ; stty ignpar ; stty ixon ; stty ixoff\r
- stty -iexten ; stty -echo\r
- ) < /dev/modem\r
- xboard -ics -icscomm /dev/modem\r
-</pre>
- <p class="noindent">After you start XBoard in this way, type whatever commands are\r
-necessary to dial out to your Internet provider and log in.\r
-Then telnet to ICS, using a command like\r
-<kbd>telnet chessclub.com 5000</kbd>.\r
-Important: See the paragraph below about extra echoes, \r
-in <a href="Limitations.html#Limitations">Limitations</a>.\r
-<br><dt>-icslogon or -internetChessServerLogonScript file-name<dd><a name="index-icslogon_002c-option-205"></a><a name="index-internetChessServerLogonScript_002c-option-206"></a><a name="index-g_t_002eicsrc-207"></a>Whenever XBoard connects to the Internet Chess Server,\r
-if it finds a file with the name given in this option, it feeds the\r
-file's contents to the ICS as commands. The default file name\r
-is <samp><span class="file">.icsrc</span></samp>.\r
-Usually the first two lines of the file should be\r
-your ICS user name and password.\r
-The file can be either in $CHESSDIR, in XBoard's working\r
-directory if CHESSDIR is not set, or in your home directory.\r
-<br><dt>-msLoginDelay delay<dd><a name="index-msLoginDelay_002c-option-208"></a>If you experience trouble logging on to an ICS when using the\r
-<code>-icslogon</code> option, inserting some delay between characters\r
-of the logon script may help. This option adds <code>delay</code>\r
-milliseconds of delay between characters. Good values to try\r
-are 100 and 250.\r
-<br><dt>-icsinput/-xicsinput or -internetChessServerInputBox true/false<dd><a name="index-icsinput_002c-option-209"></a><a name="index-internetChessServerInputBox_002c-option-210"></a>Sets the ICS Input Box menu option. See <a href="Mode-Menu.html#Mode-Menu">Mode Menu</a>. Default: false.\r
-<br><dt>-autocomm/-xautocomm or -autoComment true/false<dd><a name="index-autocomm_002c-option-211"></a><a name="index-autoComment_002c-option-212"></a>Sets the Auto Comment menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.\r
-<br><dt>-autoflag/-xautoflag or -autoCallFlag true/false<dd><a name="index-autoflag_002c-option-213"></a><a name="index-autoCallFlag_002c-option-214"></a>Sets the Auto Flag menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.\r
-<br><dt>-autobs/-xautobs or -autoObserve true/false<dd><a name="index-autobs_002c-option-215"></a><a name="index-autoObserve_002c-option-216"></a>Sets the Auto Observe menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.\r
-<br><dt>-autoKibitz<dd><a name="index-autoKibitz_002c-option-217"></a>Enables kibitzing of the engines last thinking output (depth, score, time, speed, PV) \r
-before it moved\r
-to the ICS, in zippy mode. The option <code>showThinking</code> must be switched on for \r
-this option to work.\r
-Also diverts similar kibitz information of an opponent engine that is playing you \r
-through the ICS to the engine-output window, as if the engine was playing locally.\r
-<br><dt>-moves/-xmoves or -getMoveList true/false<dd><a name="index-moves_002c-option-218"></a><a name="index-getMoveList_002c-option-219"></a>Sets the Get Move List menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: true.\r
-<br><dt>-alarm/-xalarm or -icsAlarm true/false<dd><a name="index-alarm_002c-option-220"></a><a name="index-icsAlarm_002c-option-221"></a>Sets the ICS Alarm menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: true.\r
-<br><dt>-icsAlarmTime ms<dd><a name="index-icsAlarmTime_002c-option-222"></a>Sets the time in milliseconds for the ICS Alarm menu option. \r
-See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: 5000.\r
-<br><dt>-pre/-xpre \fRor\fB -premove true/false<dd><a name="index-pre_002c-option-223"></a><a name="index-premove_002c-option-224"></a>Sets the Premove menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: true.\r
-<br><dt>-quiet/-xquiet or -quietPlay true/false<dd><a name="index-quiet_002c-option-225"></a><a name="index-quietPlay_002c-option-226"></a>Sets the Quiet Play menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.\r
-<br><dt>-colorizeMessages or -colorize<dd><a name="index-Colors-227"></a><a name="index-colorize_002c-option-228"></a>Setting colorizeMessages\r
-to true tells XBoard to colorize the messages received from\r
-the ICS. Colorization works only if your xterm \r
-supports ISO 6429 escape sequences for changing text colors.\r
-<br><dt>-colorShout foreground,background,bold<dt>-colorSShout foreground,background,bold<dt>-colorChannel1 foreground,background,bold<dt>-colorChannel foreground,background,bold<dt>-colorKibitz foreground,background,bold<dt>-colorTell foreground,background,bold<dt>-colorChallege foreground,background,bold<dt>-colorRequest foreground,background,bold<dt>-colorSeek foreground,background,bold<dt>-colorNormal foreground,background,bold<dd><a name="index-Colors-229"></a><a name="index-colorShout_002c-option-230"></a><a name="index-colorSShout_002c-option-231"></a><a name="index-colorChannel1_002c-option-232"></a><a name="index-colorChannel_002c-option-233"></a><a name="index-colorKibitz_002c-option-234"></a><a name="index-colorTell_002c-option-235"></a><a name="index-colorChallenge_002c-option-236"></a><a name="index-colorRequest_002c-option-237"></a><a name="index-colorSeek_002c-option-238"></a><a name="index-colorNormal_002c-option-239"></a>These options set the colors used when colorizing ICS messages.\r
-All ICS messages are grouped into one of these categories:\r
-shout, sshout, channel 1, other channel, kibitz, tell, challenge, \r
-request (including abort, adjourn, draw, pause, and takeback), or\r
-normal (all other messages). \r
-\r
-Each foreground or background argument can be one of the following:\r
-black, red, green, yellow, blue, magenta, cyan, white, or default.\r
-Here “default” means the default foreground or background color of\r
-your xterm. Bold can be 1 or 0. If background is omitted, “default”\r
-is assumed; if bold is omitted, 0 is assumed.\r
-\r
-Here is an example of how to set the colors in your <samp><span class="file">.Xresources</span></samp> file.\r
-The colors shown here are the default values; you will get\r
-them if you turn <code>-colorize</code> on without specifying your own colors.\r
-\r
- <pre class="example"> xboard*colorizeMessages: true \r
- xboard*colorShout: green\r
- xboard*colorSShout: green, black, 1\r
- xboard*colorChannel1: cyan\r
- xboard*colorChannel: cyan, black, 1\r
- xboard*colorKibitz: magenta, black, 1\r
- xboard*colorTell: yellow, black, 1\r
- xboard*colorChallenge: red, black, 1\r
- xboard*colorRequest: red\r
- xboard*colorSeek: blue\r
- xboard*colorNormal: default\r
+<dt>-ics/-xics or -internetChessServerMode true/false<dd><a name="index-ics_002c-option-315"></a><a name="index-internetChessServerMode_002c-option-316"></a>Connect with an Internet Chess Server to play chess against its
+other users, observe games they are playing, or review games
+that have recently finished. Default: false.
+<br><dt>-icshost or -internetChessServerHost host<dd><a name="index-icshost_002c-option-317"></a><a name="index-internetChessServerHost_002c-option-318"></a>The Internet host name or address of the chess server to connect
+to when in ICS mode. Default: <code>chessclub.com</code>.
+Another popular chess server to try is <code>freechess.org</code>.
+If your site doesn't have a working Internet name server, try
+specifying the host address in numeric form.
+You may also need
+to specify the numeric address when using the icshelper option
+with timestamp or timeseal (see below).
+<br><dt>-icsport or -internetChessServerPort port-number<dd><a name="index-icsport_002c-option-319"></a><a name="index-internetChessServerPort_002c-option-320"></a>The port number to use when connecting to a chess server in ICS
+mode. Default: 5000.
+<br><dt>-icshelper or -internetChessServerHelper prog-name<dd><a name="index-icshelper_002c-option-321"></a><a name="index-internetChessServerHelper_002c-option-322"></a>An external helper program used to communicate with the chess server.
+You would set it to "timestamp" for ICC (chessclub.com) or
+"timeseal" for FICS (freechess.org), after
+obtaining the correct version of timestamp or timeseal for your
+computer. See "help timestamp" on ICC and "help timeseal" on FICS.
+This option is shorthand for <code>-useTelnet -telnetProgram program</code>.
+<br><dt>-telnet/-xtelnet or -useTelnet true/false<dd><a name="index-telnet_002c-option-323"></a><a name="index-useTelnet_002c-option-324"></a>This option is poorly named; it should be called useHelper.
+If set to true, it instructs XBoard to run an external
+program to communicate with the Internet Chess Server.
+The program to use is given by the telnetProgram option.
+If the option is
+false (the default), XBoard opens a TCP socket and uses its own
+internal implementation of the telnet protocol to communicate with the
+ICS. See <a href="Firewalls.html#Firewalls">Firewalls</a>.
+<br><dt>-telnetProgram prog-name<dd><a name="index-telnetProgram_002c-option-325"></a>This option is poorly named; it should be called helperProgram.
+It gives the name of the telnet program to be used with
+the <code>gateway</code> and <code>useTelnet</code> options. The default is
+<samp><span class="file">telnet</span></samp>. The telnet program is invoked with the value of
+<code>internetChessServerHost</code> as its first argument and the value
+of <code>internetChessServerPort</code> as its second argument.
+See <a href="Firewalls.html#Firewalls">Firewalls</a>.
+<br><dt>-gateway host-name<dd><a name="index-gateway_002c-option-326"></a>If this option is set to a host name, XBoard communicates with the
+Internet Chess Server by using <samp><span class="file">rsh</span></samp> to run
+the <code>telnetProgram</code> on the given host,
+instead of using its own internal implementation
+of the telnet protocol. You can substitute a different remote shell
+program for <samp><span class="file">rsh</span></samp> using the <code>remoteShell</code> option described below.
+See <a href="Firewalls.html#Firewalls">Firewalls</a>.
+<br><dt>-internetChessServerCommPort or -icscomm dev-name<dd><a name="index-internetChessServerCommPort_002c-option-327"></a><a name="index-icscomm_002c-option-328"></a>If this option is set, XBoard communicates with the ICS through
+the given character I/O device instead of opening a TCP connection.
+Use this option if your system does not have any kind of
+Internet connection itself (not even a SLIP or PPP connection),
+but you do have dial-up access (or a hardwired terminal line) to
+an Internet service provider from which you can telnet to the ICS.
+
+ <p>The support for this option in XBoard is minimal. You need to
+set all communication parameters and tty modes before you enter
+XBoard.
+
+ <p>Use a script something like this:
+
+ <pre class="example"> stty raw -echo 9600 > /dev/tty00
+ xboard -ics -icscomm /dev/tty00
</pre>
- <br><dt>-soundProgram progname<dd><a name="index-soundProgram_002c-option-240"></a><a name="index-Sounds-241"></a>If this option is set to a sound-playing program that is installed and\r
-working on your system, XBoard can play sound files when certain\r
-events occur, listed below. The default program name is "play". If\r
-any of the sound options is set to "$", the event rings the terminal\r
-bell by sending a ^G character to standard output, instead of playing\r
-a sound file. If an option is set to the empty string "", no sound is\r
-played for that event.\r
-<br><dt>-soundShout filename<dt>-soundSShout filename<dt>-soundChannel filename<dt>-soundKibitz filename<dt>-soundTell filename<dt>-soundChallenge filename<dt>-soundRequest filename<dt>-soundSeek filename<dd><a name="index-soundShout_002c-option-242"></a><a name="index-soundSShout_002c-option-243"></a><a name="index-soundChannel_002c-option-244"></a><a name="index-soundKibitz_002c-option-245"></a><a name="index-soundTell_002c-option-246"></a><a name="index-soundChallenge_002c-option-247"></a><a name="index-soundRequest_002c-option-248"></a><a name="index-soundSeek_002c-option-249"></a>These sounds are triggered in the same way as the colorization events\r
-described above. They all default to "", no sound. They are played\r
-only if the colorizeMessages is on.\r
-<br><dt>-soundMove filename<dd><a name="index-soundMove_002c-option-250"></a>This sound is used by the Move Sound menu option. Default: "$".\r
-<br><dt>-soundIcsAlarm filename<dd><a name="index-soundIcsAlarm_002c-option-251"></a>This sound is used by the ICS Alarm menu option. Default: "$".\r
-<br><dt>-soundIcsWin filename<dd><a name="index-soundIcsWin_002c-option-252"></a>This sound is played when you win an ICS game. Default: "" (no sound).\r
-<br><dt>-soundIcsLoss filename<dd><a name="index-soundIcsLoss_002c-option-253"></a>This sound is played when you lose an ICS game. Default: "" (no sound).\r
-<br><dt>-soundIcsDraw filename<dd><a name="index-soundIcsDraw_002c-option-254"></a>This sound is played when you draw an ICS game. Default: "" (no sound).\r
-<br><dt>-soundIcsUnfinished filename<dd><a name="index-soundIcsUnfinished_002c-option-255"></a>This sound is played when an ICS game that you are participating in is\r
-aborted, adjourned, or otherwise ends inconclusively. Default: "" (no\r
-sound).\r
-\r
-Here is an example of how to set the sounds in your <samp><span class="file">.Xresources</span></samp> file:\r
-\r
- <pre class="example"> xboard*soundShout: shout.wav\r
- xboard*soundSShout: sshout.wav\r
- xboard*soundChannel1: channel1.wav\r
- xboard*soundChannel: channel.wav\r
- xboard*soundKibitz: kibitz.wav\r
- xboard*soundTell: tell.wav\r
- xboard*soundChallenge: challenge.wav\r
- xboard*soundRequest: request.wav\r
- xboard*soundSeek: seek.wav\r
- xboard*soundMove: move.wav\r
- xboard*soundIcsWin: win.wav\r
- xboard*soundIcsLoss: lose.wav\r
- xboard*soundIcsDraw: draw.wav\r
- xboard*soundIcsUnfinished: unfinished.wav\r
- xboard*soundIcsAlarm: alarm.wav\r
+ <p>Here replace ‘<samp><span class="samp">/dev/tty00</span></samp>’ with the name of the device that your
+modem is connected to. You might have to add several more
+options to these stty commands. See the man pages for <samp><span class="file">stty</span></samp>
+and <code>tty</code> if you run into problems. Also, on many systems stty
+works on its standard input instead of standard output, so you
+have to use ‘<samp><span class="samp"><</span></samp>’ instead of ‘<samp><span class="samp">></span></samp>’.
+
+ <p>If you are using linux, try starting with the script below.
+Change it as necessary for your installation.
+
+ <pre class="example"> #!/bin/sh -f
+ # configure modem and fire up XBoard
+
+ # configure modem
+ (
+ stty 2400 ; stty raw ; stty hupcl ; stty -clocal
+ stty ignbrk ; stty ignpar ; stty ixon ; stty ixoff
+ stty -iexten ; stty -echo
+ ) < /dev/modem
+ xboard -ics -icscomm /dev/modem
</pre>
- </dl>
- \r
+ <p class="noindent">After you start XBoard in this way, type whatever commands are
+necessary to dial out to your Internet provider and log in.
+Then telnet to ICS, using a command like
+<kbd>telnet chessclub.com 5000</kbd>.
+Important: See the paragraph below about extra echoes,
+in <a href="Limitations.html#Limitations">Limitations</a>.
+<br><dt>-icslogon or -internetChessServerLogonScript file-name<dd><a name="index-icslogon_002c-option-329"></a><a name="index-internetChessServerLogonScript_002c-option-330"></a><a name="index-g_t_002eicsrc-331"></a>Whenever XBoard connects to the Internet Chess Server,
+if it finds a file with the name given in this option, it feeds the
+file's contents to the ICS as commands. The default file name
+is <samp><span class="file">.icsrc</span></samp>.
+Usually the first two lines of the file should be
+your ICS user name and password.
+The file can be either in $CHESSDIR, in XBoard's working
+directory if CHESSDIR is not set, or in your home directory.
+<br><dt>-msLoginDelay delay<dd><a name="index-msLoginDelay_002c-option-332"></a>If you experience trouble logging on to an ICS when using the
+<code>-icslogon</code> option, inserting some delay between characters
+of the logon script may help. This option adds <code>delay</code>
+milliseconds of delay between characters. Good values to try
+are 100 and 250.
+<br><dt>-icsinput/-xicsinput or -internetChessServerInputBox true/false<dd><a name="index-icsinput_002c-option-333"></a><a name="index-internetChessServerInputBox_002c-option-334"></a>Sets the ICS Input Box menu option. See <a href="Mode-Menu.html#Mode-Menu">Mode Menu</a>. Default: false.
+<br><dt>-autocomm/-xautocomm or -autoComment true/false<dd><a name="index-autocomm_002c-option-335"></a><a name="index-autoComment_002c-option-336"></a>Sets the Auto Comment menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.
+<br><dt>-autoflag/-xautoflag or -autoCallFlag true/false<dd><a name="index-autoflag_002c-option-337"></a><a name="index-autoCallFlag_002c-option-338"></a>Sets the Auto Flag menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.
+<br><dt>-autobs/-xautobs or -autoObserve true/false<dd><a name="index-autobs_002c-option-339"></a><a name="index-autoObserve_002c-option-340"></a>Sets the Auto Observe menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.
+<br><dt>-autoKibitz<dd><a name="index-autoKibitz_002c-option-341"></a>Enables kibitzing of the engines last thinking output (depth, score, time, speed, PV)
+before it moved
+to the ICS, in zippy mode. The option <code>showThinking</code> must be switched on for
+this option to work.
+Also diverts similar kibitz information of an opponent engine that is playing you
+through the ICS to the engine-output window, as if the engine was playing locally.
+<br><dt>-seekGraph true/false or -sg<dd><a name="index-seekGraph_002c-option-342"></a><a name="index-sg_002c-option-343"></a>Enables displaying of the seek graph by left-clicking the board when
+you are logged on to an ICS and currently idle.
+The seek graph show all players currently seeking games on the ICS,
+plotted according to their rating and the time control of the game they seek,
+in three different colors (for rated, unrated and wild games).
+Computer ads are displayed as squares, human ads are dots.
+Default: false.
+<br><dt>-autoRefresh true/false<dd><a name="index-autoRefresh_002c-option-344"></a>Enables automatic updating of the seek graph,
+by having the ICS send a running update of all newly placed
+and removed seek ads.
+This consumes a substantial amount of communication bandwidth,
+and is only supported for FICS and ICC.
+Default: false.
+<br><dt>-backgroundObserve true/false<dd><a name="index-backgroundObserve_002c-option-345"></a>When true, boards sent to you by the ICS from other games while you are playing
+(e.g. because you are observing them)
+will not be automatically displayed.
+Only a summary of time left and material of both players will appear
+in the message field above the board.
+XBoard will remember the last board it has received this way,
+and will display it in stead of the position in your own game
+when you press the right mouse button.
+No other information is stored on such games observed in the background;
+you cannot save such a game later, or step through its moves.
+This feature is provided solely for the benefit of bughouse players,
+to enable them to peek at their partner's game without the need
+to logon twice.
+Default: false.
+<br><dt>-dualBoard true/false<dd><a name="index-dualBoard_002c-option-346"></a>In combination with -backgroundObserve true, this option will display
+the board of the background game side by side with that of your own game,
+so you can have it in view permanently.
+Any board or holdings info coming in will be displayed on the secondary
+board immediately.
+This feature is still experimental and largely unfinished.
+There is no animation or highlighting of moves on the secondary board.
+Default: false.
+<br><dt>-disguisePromotedPieces true/false<dd><a name="index-disguisePromotedPieces_002c-option-347"></a>When set promoted Pawns in crazyhouse/bughouse are displayed identical
+to primordial pieces of the same type, rather than distinguishable.
+Default: true.
+<br><dt>-moves/-xmoves or -getMoveList true/false<dd><a name="index-moves_002c-option-348"></a><a name="index-getMoveList_002c-option-349"></a>Sets the Get Move List menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: true.
+<br><dt>-alarm/-xalarm or -icsAlarm true/false<dd><a name="index-alarm_002c-option-350"></a><a name="index-icsAlarm_002c-option-351"></a>Sets the ICS Alarm menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: true.
+<br><dt>-icsAlarmTime ms<dd><a name="index-icsAlarmTime_002c-option-352"></a>Sets the time in milliseconds for the ICS Alarm menu option.
+See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: 5000.
+<br><dt>lowTimeWarning true/false<dd><a name="index-lowTimeWarning_002c-option-353"></a>Controls a color change of the board as a warning your time is running out.
+See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.
+<br><dt>-pre/-xpre \fRor\fB -premove true/false<dd><a name="index-pre_002c-option-354"></a><a name="index-premove_002c-option-355"></a>Sets the Premove menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: true.
+<br><dt>-prewhite/-xprewhite or -premoveWhite<dt>-preblack/-xpreblack or -premoveBlack<dt>-premoveWhiteText string<dt>-premoveBlackText string<dd><a name="index-prewhite_002c-option-356"></a><a name="index-premoveWhite_002c-option-357"></a><a name="index-preblack_002c-option-358"></a><a name="index-premoveBlack_002c-option-359"></a><a name="index-premoveWhiteText_002c-option-360"></a><a name="index-premoveBlackText_002c-option-361"></a>Set the menu options for specifying the first move for either color.
+See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Defaults: false and empty strings, so no pre-moves.
+<br><dt>-quiet/-xquiet or -quietPlay true/false<dd><a name="index-quiet_002c-option-362"></a><a name="index-quietPlay_002c-option-363"></a>Sets the Quiet Play menu option. See <a href="Options-Menu.html#Options-Menu">Options Menu</a>. Default: false.
+<br><dt>-colorizeMessages or -colorize/-xcolorize<dd><a name="index-Colors-364"></a><a name="index-colorize_002c-option-365"></a><a name="index-colorizeMessages_002c-option-366"></a>Setting colorizeMessages
+to true tells XBoard to colorize the messages received from
+the ICS. Colorization works only if your xterm
+supports ISO 6429 escape sequences for changing text colors.
+Default: true.
+<br><dt>-colorShout foreground,background,bold<dt>-colorSShout foreground,background,bold<dt>-colorCShout foreground,background,bold<dt>-colorChannel1 foreground,background,bold<dt>-colorChannel foreground,background,bold<dt>-colorKibitz foreground,background,bold<dt>-colorTell foreground,background,bold<dt>-colorChallege foreground,background,bold<dt>-colorRequest foreground,background,bold<dt>-colorSeek foreground,background,bold<dt>-colorNormal foreground,background,bold<dd><a name="index-Colors-367"></a><a name="index-colorShout_002c-option-368"></a><a name="index-colorSShout_002c-option-369"></a><a name="index-colorCShout_002c-option-370"></a><a name="index-colorChannel1_002c-option-371"></a><a name="index-colorChannel_002c-option-372"></a><a name="index-colorKibitz_002c-option-373"></a><a name="index-colorTell_002c-option-374"></a><a name="index-colorChallenge_002c-option-375"></a><a name="index-colorRequest_002c-option-376"></a><a name="index-colorSeek_002c-option-377"></a><a name="index-colorNormal_002c-option-378"></a>These options set the colors used when colorizing ICS messages.
+All ICS messages are grouped into one of these categories:
+shout, sshout, channel 1, other channel, kibitz, tell, challenge,
+request (including abort, adjourn, draw, pause, and takeback), or
+normal (all other messages).
+
+ <p>Each foreground or background argument can be one of the following:
+black, red, green, yellow, blue, magenta, cyan, white, or default.
+Here “default” means the default foreground or background color of
+your xterm. Bold can be 1 or 0. If background is omitted, “default”
+is assumed; if bold is omitted, 0 is assumed.
+
+ <br><dt>-soundProgram progname<dd><a name="index-soundProgram_002c-option-379"></a><a name="index-Sounds-380"></a>If this option is set to a sound-playing program that is installed and
+working on your system, XBoard can play sound files when certain
+events occur, listed below. The default program name is "play". If
+any of the sound options is set to "$", the event rings the terminal
+bell by sending a ^G character to standard output, instead of playing
+a sound file. If an option is set to the empty string "", no sound is
+played for that event.
+<br><dt>-soundDirectory directoryname<dd><a name="index-soundDirectory_002c-option-381"></a><a name="index-Sounds-382"></a>This option specifies where XBoard will look for sound files,
+when these are not given as an absolute path name.
+<br><dt>-soundShout filename<dt>-soundSShout filename<dt>-soundCShout filename<dt>-soundChannel filename<dt>-soundChannel1 filename<dt>-soundKibitz filename<dt>-soundTell filename<dt>-soundChallenge filename<dt>-soundRequest filename<dt>-soundSeek filename<dd><a name="index-soundShout_002c-option-383"></a><a name="index-soundSShout_002c-option-384"></a><a name="index-soundCShout_002c-option-385"></a><a name="index-soundChannel_002c-option-386"></a><a name="index-soundChannel1_002c-option-387"></a><a name="index-soundKibitz_002c-option-388"></a><a name="index-soundTell_002c-option-389"></a><a name="index-soundChallenge_002c-option-390"></a><a name="index-soundRequest_002c-option-391"></a><a name="index-soundSeek_002c-option-392"></a>These sounds are triggered in the same way as the colorization events
+described above. They all default to "", no sound. They are played
+only if the colorizeMessages is on.
+CShout is synonymous with SShout.
+<br><dt>-soundMove filename<dd><a name="index-soundMove_002c-option-393"></a>This sound is used by the Move Sound menu option. Default: "$".
+<br><dt>-soundIcsAlarm filename<dd><a name="index-soundIcsAlarm_002c-option-394"></a>This sound is used by the ICS Alarm menu option. Default: "$".
+<br><dt>-soundIcsWin filename<dd><a name="index-soundIcsWin_002c-option-395"></a>This sound is played when you win an ICS game. Default: "" (no sound).
+<br><dt>-soundIcsLoss filename<dd><a name="index-soundIcsLoss_002c-option-396"></a>This sound is played when you lose an ICS game. Default: "" (no sound).
+<br><dt>-soundIcsDraw filename<dd><a name="index-soundIcsDraw_002c-option-397"></a>This sound is played when you draw an ICS game. Default: "" (no sound).
+<br><dt>-soundIcsUnfinished filename<dd><a name="index-soundIcsUnfinished_002c-option-398"></a>This sound is played when an ICS game that you are participating in is
+aborted, adjourned, or otherwise ends inconclusively. Default: "" (no
+sound).
+</dl>
</body></html>
projects / xboard.git / blobdiff