<p><a name="index-ICS-options-189"></a><a name="index-Options_002c-ICS-190"></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
-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-193"></a><a name="index-internetChessServerHost_002c-option-194"></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-195"></a><a name="index-internetChessServerPort_002c-option-196"></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-197"></a><a name="index-internetChessServerHelper_002c-option-198"></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-199"></a><a name="index-useTelnet_002c-option-200"></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-201"></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-202"></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-203"></a><a name="index-icscomm_002c-option-204"></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 dialup 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
+<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>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
+ <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
-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-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,
-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-208"></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-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.
-<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.
-<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.
-<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.
-<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)
-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>-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.
-<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.
-<br><dt>-icsAlarmTime ms<dd><a name="index-icsAlarmTime_002c-option-222"></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>-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.
-<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.
-<br><dt>-colorizeMessages or -colorize<dd><a name="index-Colors-227"></a><a name="index-colorize_002c-option-228"></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.
-<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.
-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.
-
- <p>Here is an example of how to set the colors in your <samp><span class="file">.Xresources</span></samp> file.
-The colors shown here are the default values; you will get
-them if you turn <code>-colorize</code> on without specifying your own colors.
-
- <pre class="example"> xboard*colorizeMessages: true
- xboard*colorShout: green
- xboard*colorSShout: green, black, 1
- xboard*colorChannel1: cyan
- xboard*colorChannel: cyan, black, 1
- xboard*colorKibitz: magenta, black, 1
- xboard*colorTell: yellow, black, 1
- xboard*colorChallenge: red, black, 1
- xboard*colorRequest: red
- xboard*colorSeek: blue
- xboard*colorNormal: default
+ <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
</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
-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>-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
-described above. They all default to "", no sound. They are played
-only if the colorizeMessages is on.
-<br><dt>-soundMove filename<dd><a name="index-soundMove_002c-option-250"></a>This sound is used by the Move Sound menu option. Default: "$".
-<br><dt>-soundIcsAlarm filename<dd><a name="index-soundIcsAlarm_002c-option-251"></a>This sound is used by the ICS Alarm menu option. Default: "$".
-<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).
-<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).
-<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).
-<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
-aborted, adjourned, or otherwise ends inconclusively. Default: "" (no
-sound).
-
- <p>Here is an example of how to set the sounds in your <samp><span class="file">.Xresources</span></samp> file:
-
- <pre class="example"> xboard*soundShout: shout.wav
- xboard*soundSShout: sshout.wav
- xboard*soundChannel1: channel1.wav
- xboard*soundChannel: channel.wav
- xboard*soundKibitz: kibitz.wav
- xboard*soundTell: tell.wav
- xboard*soundChallenge: challenge.wav
- xboard*soundRequest: request.wav
- xboard*soundSeek: seek.wav
- xboard*soundMove: move.wav
- xboard*soundIcsWin: win.wav
- xboard*soundIcsLoss: lose.wav
- xboard*soundIcsDraw: draw.wav
- xboard*soundIcsUnfinished: unfinished.wav
- xboard*soundIcsAlarm: alarm.wav
+ <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
</pre>
</dl>
+ \r
</body></html>
projects / xboard.git / blobdiff