<!DOCTYPE article PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[
        <!-- if not using PNG graphic, replace reference above with
             .....PUBLIC "-//OASIS//DTD DocBook V3.1//EN"[
         -->
<!ENTITY version "1.4.0"> <!-- replace with application version -->
<!ENTITY date "4/20/2001"> <!-- date the manual was last updated -->
]>

<!-- 
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://developer.gnome.org/projects/gdp
  Template version: 1.0.4
  Template last modified April 20, 2001
-->


<!-- =============Document Header ============================= -->

<article id="index" lang="en"> 
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->

  <artheader>
    <title>Gnome Chess Manual</title>
    <copyright>
      <year>2001</year>
      <holder>JP Rosevear</holder>
    </copyright>

  <!-- translators: uncomment this:

  <copyright>
   <year>2000</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>

   -->

  <legalnotice id="legalnotice">
   <para>
    Permission is granted to copy, distribute and/or modify this document
    under the terms of the <link linkend="fdl"><citetitle>GNU
    Free Documentation License</citetitle></link>, Version 1.1 or any later
    version published by the Free Software Foundation with no Invariant
    Sections, no Front-Cover Texts, and no Back-Cover Texts.  A copy of the
    license can be found in <xref linkend="fdl">.
   </para>
   <para>
    Many of the names used by companies to distinguish their products and
    services are claimed as trademarks. Where those names appear in any
    GNOME documentation, and those trademarks are made aware to the members
    of the GNOME Documentation Project, the names have been printed in caps
    or initial caps.
   </para>
  </legalnotice>
  -->

    <releaseinfo>
       This manual describes version &version; of Gnome Chess. It was
       last updated on &date;.
    </releaseinfo>

  </artheader>

 <!-- ============= Document Body ============================= -->

 <!-- ============= Introduction ============================== -->
  <sect1 id="intro">
    <title>Introduction</title>

    <para>
     <application>Gnome Chess</application> is an application which
     allows the user to do a variety of chess related things.
     Currently you can play the Crafty or GNU Chess engines, play on
     internet chess servers such as FICS and view games in PGN files.
    </para>

    <para>
      To run <application>Gnome Chess</application>, select
      <menuchoice>
	<guisubmenu>Games</guisubmenu>
	<guimenuitem>Gnome Chess</guimenuitem>
      </menuchoice>
      from the <guimenu>Main Menu</guimenu>, or type
      <command>gnome-chess</command> on the command line.
  </para>

    <para>
      <application>Gnome Chess</application> is included in the
      <filename>gnome-chess</filename> package.  This document
      describes version &version; of <application>Gnome
      Chess</application>.
    </para>
  </sect1>


 <!-- ================ Usage ================================ -->

  <sect1 id="usage">
    <title>Using Gnome Chess</title>
    <para>
      <application>Gnome Chess</application> can be used to play against
      the GNU Chess or Crafty chess engines, view files in PGN format or
      play on chess servers like FICS.  It provides an easy to easy-to-use 
      graphical interface for this. This section describes basic usage of
      <application>Gnome Chess</application>.
    </para>

    <!-- ========= Basic Usage =========================== -->
    <sect2 id="mainwin">
      <title>Basic usage</title>
      <para>
        Starting <application>Gnome Chess</application> opens the
        <interface>Main window</interface>, shown in <xref
        linkend="mainwindow-fig">. The window at first contains a chess 
        board at the starting usual starting position.

        <!-- ==== Figure ==== -->
        <figure id="mainwindow-fig">
	  <title>Gnome Chess Main Window</title>
	  <screenshot>
	    <screeninfo>Gnome Chess Main Window</screeninfo>
	    <graphic fileref="./figures/main.png" format="png" srccredit="JP Rosevear">
            </graphic>
	  </screenshot>
	</figure>
    <!-- ==== End of Figure ==== -->
      </para> 

      <sect3 id="playing-program">
	<title>Playing Against A Program</title>
	<para>
          To play against a program, once you have added some via the
          Preferences dialog, select
          <menuchoice>
	    <guisubmenu>File</guisubmenu>
	    <guimenuitem>Open</guimenuitem>
	  </menuchoice>,
            which will bring up a new game view in its own tab.
            By default you are white, simply begin moving the pieces and
            the program will respond.
        </para>
      </sect3>

      <sect3 id="playing-server">
	<title>Playing On A Server</title>
	<para>
          To play on a server, once you have added some via the
          Preferences dialog, select
          <menuchoice>
	    <guisubmenu>File</guisubmenu>
	    <guimenuitem>Programs</guimenuitem>
	  </menuchoice>,
            which will bring up a new game view in its own tab.  It will 
            also bring up an information area which is a terminal view of the
            chess server with an area to enter commands.
        </para>
      </sect3>

      <sect3 id="pgn">
	<title>Playing On A Server</title>
	<para>
          To open PGN formatted files, select
          <menuchoice>
	    <guisubmenu>File</guisubmenu>
	    <guimenuitem>Open</guimenuitem>
	  </menuchoice>,
            which will bring up a new game view in its own tab.  It will 
            also bring up an information area which is a list of all the games
            in the file.
        </para>
        <para>
          Clicking on any game will display it in the game view.  You can then
          use the buttons under the list of moves to move forward and backward
          through the game.
        </para>
      </sect3>

    <!-- ========= Menus =========================== --> 

    <sect2 id="menubar">

      <title>Menus</title>
      <para>
	The menu bar, located at the top of the <interface>Main
	Window</interface>, contains the following menus:
       </para>
      <variablelist>
	<varlistentry>
	  <term><guimenu>File</guimenu></term>
	  <listitem>
	    <para>
	       This menu contains:
	       <itemizedlist>
		<listitem>
		  <para>
	            <menuchoice>
		      <shortcut>
			<keycap>F3</keycap>
		      </shortcut>
		      <guimenuitem>Open</guimenuitem>
		     </menuchoice>
	             &mdash; This opens a PGN file which is saved on your computer.
	           </para>
		</listitem>
		<listitem>
		  <para>
	             <menuchoice>
		      <shortcut>
			<keycombo><keycap>Ctrl</keycap><keycap>S</keycap></keycombo>
		      </shortcut>
		      <guimenuitem>Save</guimenuitem>
		    </menuchoice>
	            &mdash; This saves the moves of the current game in PGN format.
	          </para>
		</listitem>
		<listitem>
		  <para>
	             <menuchoice>
		      <guimenuitem>Programs</guimenuitem>
		    </menuchoice>
	            &mdash; A list of programs to play against.  Selecting one opens
                    a new game view.
	          </para>
		</listitem>
		<listitem>
		  <para>
	             <menuchoice>
		      <guimenuitem>Server</guimenuitem>
		    </menuchoice>
	            &mdash; A list of servers to play against.  Selecting one opens
                    a new game view and a info window displaying a terminal view of
                    the chess server.
	          </para>
		</listitem>
		<listitem>
		  <para>
	             <menuchoice>
		      <shortcut>
			<keycombo><keycap>Ctrl</keycap><keycap>W</keycap></keycombo>
		      </shortcut>
		      <guimenuitem>Close</guimenuitem>
		    </menuchoice>
	            &mdash; This closes the current game view.
	          </para>
		</listitem>
		<listitem>
		  <para>
	            <menuchoice>
		      <shortcut>
			<keycombo><keycap>Ctrl</keycap><keycap>Q</keycap></keycombo>
		      </shortcut>
		      <guimenuitem>Exit</guimenuitem>
		    </menuchoice>
	            &mdash; This quits the application.
	          </para>
		</listitem>
	      </itemizedlist>
	  </para>
	  </listitem>
	</varlistentry>
	
	<varlistentry>
	  <term><guimenu>Game</guimenu></term>
	</varlistentry>

	<varlistentry>
	  <term><guimenu>Settings</guimenu></term>
	  <listitem>
	    <para>
	   This menu contains:
	   <itemizedlist>
		<listitem>
		  <para>
	      <guimenuitem>Preferences&hellip;</guimenuitem>
	       &mdash; This opens the <link
	       linkend="prefs"><interface>Preferences
	       Dialog</interface></link>, which allows you to configure
	       many settings.
	     </para>
		</listitem>
	      </itemizedlist>
	    </para>
	  </listitem>
	</varlistentry>
	
	<varlistentry>
	  <term><guimenu>Help</guimenu></term>
	  <listitem>
	    <para>
	      This menu contains:
	       <itemizedlist>
		<listitem>
		  <para>
	             <guimenuitem>Manual</guimenuitem> &mdash; This
    	              opens the <application>GNOME Help
    	              Browser</application> and displays this manual.
	          </para>
		</listitem>
		
		<listitem>
		  <para>
	            <guimenuitem>About</guimenuitem> &mdash; This
    	            opens the <interface>About</interface> dialog
    	            which shows basic information about
    	            <application>Gnome Chess</application>, such as
    	            the author's name, the application version number,
    	            and the URL for the application's Web page if one
    	            exists.
	          </para>
		</listitem>
	      </itemizedlist>
            </para>
	  </listitem>
	</varlistentry>
      </variablelist>
    </sect2>
  </sect1>



 <!-- ============= Customization ============================= -->

 <sect1 id="prefs">
  <title>Customization</title>
  <para>
   To change the application settings, select
   <menuchoice>
    <guimenu>Settings</guimenu>
    <guimenuitem>Preferences...</guimenuitem>
   </menuchoice>.  This opens the
   <interface>Preferences</interface> dialog, shown in <xref
   linkend="preferences-fig">.
  </para>

  <figure id="preferences-fig">
   <title>Preferences Dialog</title>
   <screenshot>
    <screeninfo>Preferences Dialog</screeninfo>
    <graphic fileref="./figures/prefs.png" format="png" srccredit="JP Rosevear">
    </graphic>
   </screenshot>
  </figure>

  <para>
   The properties in the <guilabel>Board &amp; Pieces</guilabel> tab are:

      <variablelist>
	<varlistentry>
	  <term> <guilabel>Light Colored Squares</guilabel></term>
	  <listitem>
	    <para>
              Select the color that light (white) board squares will be.
            </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term> <guilabel>Dark Colored Squares</guilabel></term>
	  <listitem>
	    <para>
              Select the color that dark (black) board squares will be.
            </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term>Pieces</term>
	  <listitem>
	    <para>
             Select the directory in which the piece set you want to use
             is located.  Defaults to the set that comes with Gnome Chess.
             </para>
	  </listitem>
	</varlistentry>
      </variablelist>
    </para>

    <para>
     The properties in the <guilabel>Playing</guilabel> tab are:
       <variablelist>
	<varlistentry>
	  <term>Beep when a move is made</term>
	  <listitem>
	    <para>
             If checked, a beep will be emitted whenever a move is made.
             </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term>Always promote to queen</term>
	  <listitem>
	    <para>
             Automatically promotes a pawn to a queen, rather than any 
             other piece.
             </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term>Autoflag</term>
	  <listitem>
	    <para>
             Automatically call your opponents flag.  Currently works
             only on chess servers.
             </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term>Move list in Standard Algebraic Notation</term>
	  <listitem>
	    <para>
             Check this to have the move list display Standard Algebraic 
             Notation
             </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term>Move list in Coordinate Notation</term>
	  <listitem>
	    <para>
             Check this to have the move list display Coordinate Notation
             </para>
	  </listitem>
	</varlistentry>
      </variablelist>
    </para>

    <para>
     The properties in the <guilabel>Servers</guilabel> tab are:
       <variablelist>
	<varlistentry>
	  <term>Server List</term>
	  <listitem>
	    <para>
             This is a list of servers available to connect to.  Click
             the Add button to add one.  Highlight a server in the list
             and click the Modify button to change it or the Delete button
             to remove it from the list.  The list of servers for connecting
             will be available under the File menu.  
             </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term>Telnet Program</term>
	  <listitem>
	    <para>
             Use this to set the program to use when connecting to a
             chess server.  You may, for instance, wish to use timeseal
             rather than the default telnet.
             </para>
	  </listitem>
	</varlistentry>
      </variablelist>
    </para>

    <para>
     The properties in the <guilabel>Programs</guilabel> tab are:
       <variablelist>
	<varlistentry>
	  <term>Program List</term>
	  <listitem>
	    <para>
             This is a list of chess program available to play.  Click
             the Add button to add one.  Highlight a program in the list
             and click the Modify button to change it or the Delete button
             to remove it from the list.  The list of programs for playing
             will be available under the File menu.  Note that play GNU Chess
             you should use the gnuchessx executable program.
             </para>
	  </listitem>
	</varlistentry>
	<varlistentry>
	  <term>Telnet Program</term>
	  <listitem>
	    <para>
             Use this to set the program to use when connecting to a
             chess server.  You may, for instance, wish to use timeseal
             rather than the default telnet.
             </para>
	  </listitem>
	</varlistentry>
      </variablelist>
    </para>

  <para>
    After you have made all the changes you want, click on
    <guibutton>OK</guibutton> to apply the changes and close the
    <interface>Properties</interface> dialog. To cancel the changes
    and return to previous values, click the
    <guibutton>Close</guibutton> button.
  </para>

 </sect1>


 <!-- ============= Various Sections ============================= -->

 <!-- Here you should add, if necessary, several more sect1's,
 describing other windows (besides the main one), file formats,
 preferences dialogs,  etc. as appropriate. Try not to make any of
 these sections too long. -->


 <!-- ============= Bugs ================================== -->

 <sect1 id="bugs">
  <title>Known Bugs and Limitations</title>
  <para>
   All known bugs are listed on <ulink url="http://bugzilla.gnome.org" 
   type="http">Gnome Bugzilla</ulink>.
  </para>
 </sect1>


<!-- ============= Authors ================================ -->

 <sect1 id="authors">
  <title>Authors</title>
  <para>
   <application>Gnome Chess</application> was written by Robert Wilhelm
   (<email>robert.wilhelm@gmx.net</email>) and JP Rosevear 
   (<email>jpr@ximian.com</email>). To find more information about
   <application>Gnome Chess</application>, please visit the <ulink
   url="http://primates.ximian.com/~jpr/gnome-chess" type="http">Gnome Chess 
   Web page</ulink>.  This manual was written by JP Rosevear
   (<email>jpr@ximian.com</email>).
  </para>
  <para>
    If you have some comments or suggestions regarding this
   application, need help, or want to report a bug, plese contact us!
   Instructions for doing so are given in <ulink type="help"
   url="gnome-help:gnome-feedback"><citetitle>Reporting GNOME bugs and other
   feedback</citetitle></ulink> document, which you can find in the
   <guilabel>Help</guilabel> tab of
   <application>Nautilus</application> file manager.
  </para>

  <!-- For translations: uncomment this:

  <para>
   Latin translation was done by ME
   (<email>MYNAME@MYADDRESS</email>). Please send all  comments  and
   suggestions regarding this translation to SOMEWHERE.
  </para>

  -->

 </sect1>


 <!-- ============= Application License ============================= -->

 <sect1 id="license">
  <title>License</title>
  <para>
   This program is free software; you can redistribute it and/or
   modify it under the terms of the  <ulink type="help" url="gnome-help:gpl">
    <citetitle>GNU General Public License</citetitle></ulink> as
   published by the Free Software Foundation; 
   either version 2 of the License, or (at your option) any later
   version.
  </para>
  <para>
   This program is distributed in the hope that it will be useful, but
   WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   <citetitle>GNU General Public License</citetitle> for more details.
  </para>
  <para>
   A copy of the <citetitle>GNU General Public License</citetitle> is
   included as an appendix to the <citetitle>GNOME Users
   Guide</citetitle>.  You may also obtain a copy of the
   <citetitle>GNU General Public License</citetitle> from the Free
   Software Foundation by visiting <ulink type="http"
   url="http://www.fsf.org">their Web site</ulink> or by writing to
   <address>
    Free Software Foundation, Inc.
    <street>59 Temple Place</street> - Suite 330
    <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
    <country>USA</country>
   </address>
  </para>
 </sect1>
</article>




