1
<!DOCTYPE article PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[
2
<!-- if not using PNG graphic, replace reference above with
3
.....PUBLIC "-//OASIS//DTD DocBook V3.1//EN"[
5
<!ENTITY version "1.4.0"> <!-- replace with application version -->
6
<!ENTITY date "4/20/2001"> <!-- date the manual was last updated -->
10
(Do not remove this comment block.)
11
Maintained by the GNOME Documentation Project
12
http://developer.gnome.org/projects/gdp
13
Template version: 1.0.4
14
Template last modified April 20, 2001
18
<!-- =============Document Header ============================= -->
20
<article id="index" lang="en">
21
<!-- please do not change the id; for translations, change lang to -->
22
<!-- appropriate code -->
25
<title>Gnome Chess Manual</title>
28
<holder>JP Rosevear</holder>
31
<!-- translators: uncomment this:
35
<holder>ME-THE-TRANSLATOR (Latin translation)</holder>
40
<legalnotice id="legalnotice">
42
Permission is granted to copy, distribute and/or modify this document
43
under the terms of the <link linkend="fdl"><citetitle>GNU
44
Free Documentation License</citetitle></link>, Version 1.1 or any later
45
version published by the Free Software Foundation with no Invariant
46
Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the
47
license can be found in <xref linkend="fdl">.
50
Many of the names used by companies to distinguish their products and
51
services are claimed as trademarks. Where those names appear in any
52
GNOME documentation, and those trademarks are made aware to the members
53
of the GNOME Documentation Project, the names have been printed in caps
60
This manual describes version &version; of Gnome Chess. It was
61
last updated on &date;.
66
<!-- ============= Document Body ============================= -->
68
<!-- ============= Introduction ============================== -->
70
<title>Introduction</title>
73
<application>Gnome Chess</application> is an application which
74
allows the user to do a variety of chess related things.
75
Currently you can play the Crafty or GNU Chess engines, play on
76
internet chess servers such as FICS and view games in PGN files.
80
To run <application>Gnome Chess</application>, select
82
<guisubmenu>Games</guisubmenu>
83
<guimenuitem>Gnome Chess</guimenuitem>
85
from the <guimenu>Main Menu</guimenu>, or type
86
<command>gnome-chess</command> on the command line.
90
<application>Gnome Chess</application> is included in the
91
<filename>gnome-chess</filename> package. This document
92
describes version &version; of <application>Gnome
98
<!-- ================ Usage ================================ -->
101
<title>Using Gnome Chess</title>
103
<application>Gnome Chess</application> can be used to play against
104
the GNU Chess or Crafty chess engines, view files in PGN format or
105
play on chess servers like FICS. It provides an easy to easy-to-use
106
graphical interface for this. This section describes basic usage of
107
<application>Gnome Chess</application>.
110
<!-- ========= Basic Usage =========================== -->
112
<title>Basic usage</title>
114
Starting <application>Gnome Chess</application> opens the
115
<interface>Main window</interface>, shown in <xref
116
linkend="mainwindow-fig">. The window at first contains a chess
117
board at the starting usual starting position.
119
<!-- ==== Figure ==== -->
120
<figure id="mainwindow-fig">
121
<title>Gnome Chess Main Window</title>
123
<screeninfo>Gnome Chess Main Window</screeninfo>
124
<graphic fileref="./figures/main.png" format="png" srccredit="JP Rosevear">
128
<!-- ==== End of Figure ==== -->
131
<sect3 id="playing-program">
132
<title>Playing Against A Program</title>
134
To play against a program, once you have added some via the
135
Preferences dialog, select
137
<guisubmenu>File</guisubmenu>
138
<guimenuitem>Open</guimenuitem>
140
which will bring up a new game view in its own tab.
141
By default you are white, simply begin moving the pieces and
142
the program will respond.
146
<sect3 id="playing-server">
147
<title>Playing On A Server</title>
149
To play on a server, once you have added some via the
150
Preferences dialog, select
152
<guisubmenu>File</guisubmenu>
153
<guimenuitem>Programs</guimenuitem>
155
which will bring up a new game view in its own tab. It will
156
also bring up an information area which is a terminal view of the
157
chess server with an area to enter commands.
162
<title>Playing On A Server</title>
164
To open PGN formatted files, select
166
<guisubmenu>File</guisubmenu>
167
<guimenuitem>Open</guimenuitem>
169
which will bring up a new game view in its own tab. It will
170
also bring up an information area which is a list of all the games
174
Clicking on any game will display it in the game view. You can then
175
use the buttons under the list of moves to move forward and backward
180
<!-- ========= Menus =========================== -->
186
The menu bar, located at the top of the <interface>Main
187
Window</interface>, contains the following menus:
191
<term><guimenu>File</guimenu></term>
202
<guimenuitem>Open</guimenuitem>
204
— This opens a PGN file which is saved on your computer.
211
<keycombo><keycap>Ctrl</keycap><keycap>S</keycap></keycombo>
213
<guimenuitem>Save</guimenuitem>
215
— This saves the moves of the current game in PGN format.
221
<guimenuitem>Programs</guimenuitem>
223
— A list of programs to play against. Selecting one opens
230
<guimenuitem>Server</guimenuitem>
232
— A list of servers to play against. Selecting one opens
233
a new game view and a info window displaying a terminal view of
241
<keycombo><keycap>Ctrl</keycap><keycap>W</keycap></keycombo>
243
<guimenuitem>Close</guimenuitem>
245
— This closes the current game view.
252
<keycombo><keycap>Ctrl</keycap><keycap>Q</keycap></keycombo>
254
<guimenuitem>Exit</guimenuitem>
256
— This quits the application.
265
<term><guimenu>Game</guimenu></term>
269
<term><guimenu>Settings</guimenu></term>
276
<guimenuitem>Preferences…</guimenuitem>
277
— This opens the <link
278
linkend="prefs"><interface>Preferences
279
Dialog</interface></link>, which allows you to configure
289
<term><guimenu>Help</guimenu></term>
296
<guimenuitem>Manual</guimenuitem> — This
297
opens the <application>GNOME Help
298
Browser</application> and displays this manual.
304
<guimenuitem>About</guimenuitem> — This
305
opens the <interface>About</interface> dialog
306
which shows basic information about
307
<application>Gnome Chess</application>, such as
308
the author's name, the application version number,
309
and the URL for the application's Web page if one
323
<!-- ============= Customization ============================= -->
326
<title>Customization</title>
328
To change the application settings, select
330
<guimenu>Settings</guimenu>
331
<guimenuitem>Preferences...</guimenuitem>
332
</menuchoice>. This opens the
333
<interface>Preferences</interface> dialog, shown in <xref
334
linkend="preferences-fig">.
337
<figure id="preferences-fig">
338
<title>Preferences Dialog</title>
340
<screeninfo>Preferences Dialog</screeninfo>
341
<graphic fileref="./figures/prefs.png" format="png" srccredit="JP Rosevear">
347
The properties in the <guilabel>Board & Pieces</guilabel> tab are:
351
<term> <guilabel>Light Colored Squares</guilabel></term>
354
Select the color that light (white) board squares will be.
359
<term> <guilabel>Dark Colored Squares</guilabel></term>
362
Select the color that dark (black) board squares will be.
370
Select the directory in which the piece set you want to use
371
is located. Defaults to the set that comes with Gnome Chess.
379
The properties in the <guilabel>Playing</guilabel> tab are:
382
<term>Beep when a move is made</term>
385
If checked, a beep will be emitted whenever a move is made.
390
<term>Always promote to queen</term>
393
Automatically promotes a pawn to a queen, rather than any
399
<term>Autoflag</term>
402
Automatically call your opponents flag. Currently works
403
only on chess servers.
408
<term>Move list in Standard Algebraic Notation</term>
411
Check this to have the move list display Standard Algebraic
417
<term>Move list in Coordinate Notation</term>
420
Check this to have the move list display Coordinate Notation
428
The properties in the <guilabel>Servers</guilabel> tab are:
431
<term>Server List</term>
434
This is a list of servers available to connect to. Click
435
the Add button to add one. Highlight a server in the list
436
and click the Modify button to change it or the Delete button
437
to remove it from the list. The list of servers for connecting
438
will be available under the File menu.
443
<term>Telnet Program</term>
446
Use this to set the program to use when connecting to a
447
chess server. You may, for instance, wish to use timeseal
448
rather than the default telnet.
456
The properties in the <guilabel>Programs</guilabel> tab are:
459
<term>Program List</term>
462
This is a list of chess program available to play. Click
463
the Add button to add one. Highlight a program in the list
464
and click the Modify button to change it or the Delete button
465
to remove it from the list. The list of programs for playing
466
will be available under the File menu. Note that play GNU Chess
467
you should use the gnuchessx executable program.
472
<term>Telnet Program</term>
475
Use this to set the program to use when connecting to a
476
chess server. You may, for instance, wish to use timeseal
477
rather than the default telnet.
485
After you have made all the changes you want, click on
486
<guibutton>OK</guibutton> to apply the changes and close the
487
<interface>Properties</interface> dialog. To cancel the changes
488
and return to previous values, click the
489
<guibutton>Close</guibutton> button.
495
<!-- ============= Various Sections ============================= -->
497
<!-- Here you should add, if necessary, several more sect1's,
498
describing other windows (besides the main one), file formats,
499
preferences dialogs, etc. as appropriate. Try not to make any of
500
these sections too long. -->
503
<!-- ============= Bugs ================================== -->
506
<title>Known Bugs and Limitations</title>
508
All known bugs are listed on <ulink url="http://bugzilla.gnome.org"
509
type="http">Gnome Bugzilla</ulink>.
514
<!-- ============= Authors ================================ -->
517
<title>Authors</title>
519
<application>Gnome Chess</application> was written by Robert Wilhelm
520
(<email>robert.wilhelm@gmx.net</email>) and JP Rosevear
521
(<email>jpr@ximian.com</email>). To find more information about
522
<application>Gnome Chess</application>, please visit the <ulink
523
url="http://primates.ximian.com/~jpr/gnome-chess" type="http">Gnome Chess
524
Web page</ulink>. This manual was written by JP Rosevear
525
(<email>jpr@ximian.com</email>).
528
If you have some comments or suggestions regarding this
529
application, need help, or want to report a bug, plese contact us!
530
Instructions for doing so are given in <ulink type="help"
531
url="gnome-help:gnome-feedback"><citetitle>Reporting GNOME bugs and other
532
feedback</citetitle></ulink> document, which you can find in the
533
<guilabel>Help</guilabel> tab of
534
<application>Nautilus</application> file manager.
537
<!-- For translations: uncomment this:
540
Latin translation was done by ME
541
(<email>MYNAME@MYADDRESS</email>). Please send all comments and
542
suggestions regarding this translation to SOMEWHERE.
550
<!-- ============= Application License ============================= -->
553
<title>License</title>
555
This program is free software; you can redistribute it and/or
556
modify it under the terms of the <ulink type="help" url="gnome-help:gpl">
557
<citetitle>GNU General Public License</citetitle></ulink> as
558
published by the Free Software Foundation;
559
either version 2 of the License, or (at your option) any later
563
This program is distributed in the hope that it will be useful, but
564
WITHOUT ANY WARRANTY; without even the implied warranty of
565
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
566
<citetitle>GNU General Public License</citetitle> for more details.
569
A copy of the <citetitle>GNU General Public License</citetitle> is
570
included as an appendix to the <citetitle>GNOME Users
571
Guide</citetitle>. You may also obtain a copy of the
572
<citetitle>GNU General Public License</citetitle> from the Free
573
Software Foundation by visiting <ulink type="http"
574
url="http://www.fsf.org">their Web site</ulink> or by writing to
576
Free Software Foundation, Inc.
577
<street>59 Temple Place</street> - Suite 330
578
<city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
579
<country>USA</country>