<!DOCTYPE book PUBLIC  "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
  <!ENTITY kappname "&kwin4;">
  <!ENTITY Francais "INCLUDE"> 
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % ents PUBLIC "-//KDE//ENTITIES Documentation V1.0//EN">
 %ents;
]>

<book lang="&language;">
<bookinfo>
<title>Quatre gagnant</title>

<authorgroup>
<author>
<firstname>Martin</firstname>
<surname>Heni</surname>
<affiliation>
<address><email>martin@heni-online.de</email></address>
</affiliation>
</author>

<othercredit role="reviewer">
<firstname></firstname>
<surname></surname>
<contrib>Relecture</contrib>
<affiliation><address><email></email></address></affiliation>
</othercredit>

<othercredit role="translator">
<firstname>Eric</firstname>
<surname>Bischoff</surname>
<contrib>Traduction française</contrib>
<affiliation><address><email>e.bischoff@noos.fr</email></address></affiliation>
</othercredit>
</authorgroup>

<date>12/12/2000</date>
<releaseinfo>0.09.01</releaseinfo>

<abstract>
<para>Cette documentation décrit &kwin4; version 0.9.1</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>kdegames</keyword>
<keyword>jeu</keyword>
<keyword>plateau</keyword>
<keyword>jeu de plateau</keyword>
<keyword>quatre gagnant</keyword>
<keyword>quatre</keyword>
<keyword>quatre alignés</keyword>
<keyword>win4</keyword>
<keyword>kwin4</keyword>
<keyword>puissance quatre</keyword>
<keyword>puissance 4</keyword>
</keywordset>
</bookinfo>

<chapter id="presentation-generale">
<title>Présentation générale</title>

<para>
Quatre gagnant est un jeu pour deux joueurs.
Chaque joueur est représenté par une couleur (jaune et rouge).
Le but du jeu est de réussir à aligner quatre jetons de votre
couleur horizontalement, verticalement ou en diagonale.
Pour ce faire, vous placez un de vos jetons dans l'une
des sept rangées verticaless.
Le jeton commence à remplir 'lune des rangées verticales à partir du bas,
c'est-à-dire qu'il tombe jusqu'à ce qu'il ait atteint le sol ou un
autre jeton.
Lorsque le coup est joué c'est au tour de l'autre joueur. Il en va ainsi
jusqu'à ce que le jeu s'arrête, c'est-à-dire que l'un des joueurs ait
réussi à aligner quatre pièces horizontalement, verticalement ou en
diagonale, ou que plus aucun coup ne soit possible parce que le
terrain de jeu est rempli.
</para>

</chapter>

<chapter id="installation">
<title>Installation</title>

<sect1 id="comment-obtenir-kwin4">
<title>Comment obtenir kwin4</title>

<para>
&kwin4; fait partie du paquetage kdegames à l'adresse
<ulink url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, 
le site principal du projet KDE.</para>
</sect1>

<sect1 id="configuration-necessaire">
<title>Configuration nécessaire</title>

<para>
Pour réussir à compiler &kwin4;, il vous faut KDE 2.0.
</para>

<para>
Toutes les bibliothèques nécessaires ainsi que &kwin4; lui-même se trouvent à
l'adresse
<ulink 
url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>.</para>
</sect1>


<sect1 id="compilation">
<title>Compilation and installation</title>

<para>Pour compiler et installer &kwin4; sur votre système, décomprimez le paquetage
et tapez les commandes suivantes dans le répertoire de base de la distribution
de &kwin4;&nbsp;:</para>

<screen width="40">
<prompt>%</prompt> <userinput>cd kdegames</userinput>
<prompt>%</prompt> <userinput>./configure</userinput>
<prompt>%</prompt> <userinput>make</userinput>
<prompt>%</prompt> <userinput>make install</userinput>
</screen>
      
<para>Comme &kwin4; utilise <application>autoconf</application> et <application>automake</application>,
vous ne devriez pas avoir de problèmes à le compiler.</para>

</sect1>
</chapter>

<chapter id="regles-du-jeu">
<title>Règles du jeu</title>

<para>Le plateau de jeu est divisé en trois parties.</para>

<para>Le <emphasis>Le terrain de jeu</emphasis>
est constitué d'une grille de 7 cases sur 6 qui sera remplie de haut en bas.
Les cases sont coloriees dans la couleur du joeur dont c'est le tour.
Au sommet de chaque ranger verticale, une fleche indique ou les derniers jetons
ont ete joues.
</para>

<para><emphasis> The status display</emphasis> 
shows which player colour starts and which colour is
played by whom (player,computer,remote connection). It further shows the
level of the computer opponent, the number of moves done as well as the
computer calculated chance of winning. This chance is calculated only if
the computer opponent makes a move. A positive number means that the player
has an advantage, a negative number means that the computer thinks
he is better.
</para>

<para><emphasis> The table display shows</emphasis> 
the number of won, lost and drawn games is noted for both player.
Also the number of aborted games (Brk) and the sum of games is shown.
</para>

</chapter>

<chapter id="remote-connections">
<title>Remote connections</title>

<para>
It is possible to play the game over a network connection with another
computer. To do so both player on both computers have to select one colour
played by a human player and the other by the remote player. Who chooses
which side does not matter. It even does not matter if both choose to play
the same player as this will automatically be interchanged by the game.
</para>

<para>
One of the computers will act as game server. Only this one can start
a new network game. Also all its game data will be transfered to the
client computer. You can force your computer to be server if you do not
supply a hostname in the network dialog. This dialog pops up if you start
a new network game. As a client you enter the hostname of the machine
the server is running. The port needs usually not be changed. But you
can enter nearly any number there.
</para>

<para>
When a network connection is build you are ask to enter a remote
host and a port. The port can usually just been left untouched. But
if you now what you do replace it by another number, which has to
be the same in both player games of course. The hostname should be
the name of the remote host to which you are connecting. Only one
of the two players has to supply a hostname, the other one need not
to, but can.
</para>

</chapter>

<chapter id="menus">
<title>Menus</title>
<sect1 id="file-menu"><title>File Menu</title>
<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>F2</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu><guimenuitem>New Game</guimenuitem></menuchoice></term>
  <listitem><para>
     Starts a new game. In a network game this option is
     only available for the network server. The network client
     will be automatically started by the server.
  </para></listitem>
</varlistentry>
<varlistentry>
  <term><menuchoice>
  <shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>W</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu><guimenuitem>End Game</guimenuitem></menuchoice></term>
  <listitem><para>
     Aborts a running game.
  </para></listitem>
</varlistentry>
<varlistentry>
  <term><menuchoice><guimenu>File</guimenu><guimenuitem>statistics...</guimenuitem></menuchoice></term>
  <listitem><para>
     Shows the all time game statistics and allows to reset it.
     This statistic is
     usually saved when the game ended and shows the amount of
     played and won games per player. 
  </para></listitem>
</varlistentry>
<varlistentry>
  <term><menuchoice>
  <shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>M</keycap></keycombo>
</shortcut>
<guimenu>File</guimenu><guimenuitem>Send Message</guimenuitem></menuchoice></term>
  <listitem><para>
     If connected to another game in a remote session this
     option allows you to send a message to the remote player.
  </para></listitem>
</varlistentry>
<varlistentry>
  <term><menuchoice>
  <shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>H</keycap></keycombo>
</shortcut>
  <guimenu>File</guimenu><guimenuitem>Hint</guimenuitem></menuchoice></term>
  <listitem><para>
      The computer will calculate the best possible move and mark it with a small
      circle on the board.
      How good the move is depends on the level of the computer.
  </para></listitem>
</varlistentry>
<varlistentry>
  <term><menuchoice>
  <shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>Q</keycap></keycombo>
</shortcut>
  <guimenu>File</guimenu><guimenuitem>Exit</guimenuitem></menuchoice></term>
  <listitem><para>
     Quits the program.
  </para></listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="edit-menu"><title>Edit Menu</title>
<variablelist>
<varlistentry>
<term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Undo move</guimenuitem></menuchoice></term>
  <listitem><para>
      Undo the last move. If the previous player is played by the computer
      two moves are taken back so that it is the player's turn again.
  </para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Redo move</guimenuitem></menuchoice></term>
  <listitem><para>
      Replay a move which had been undone.
  </para></listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="view-menu"><title>View Menu</title>
<variablelist>
<varlistentry>
<term><menuchoice><guimenu>View</guimenu><guimenuitem>View statusbar</guimenuitem></menuchoice></term>
  <listitem><para>
     Shows or hides the statusbar.</para></listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="option-menu"><title>Options Menu</title>
<variablelist>
<varlistentry>
  <term><menuchoice><guimenu>Options</guimenu><guimenuitem>Startplayer</guimenuitem></menuchoice></term>
  <listitem><para>
      Determines which colour resp. player  has the first move in the next game.
  </para></listitem>
</varlistentry>
<varlistentry>
  <term><menuchoice><guimenu>Options</guimenu><guimenuitem>Yellow played by</guimenuitem></menuchoice></term>
  <listitem><para>
     Chooses who should play for player 1 (yellow). It can be either
     <guilabel>player</guilabel>, <abbrev>i.e.</abbrev> a local player using the mouse
     as input device, <guilabel>computer</guilabel>, <abbrev>i.e.</abbrev> the computer
     plays this player or <guilabel>remote</guilabel>, <abbrev>i.e.</abbrev> a remote
     connection to another computer will be build.
  </para></listitem>
</varlistentry>
<varlistentry>
  <term><menuchoice><guimenu>Options</guimenu><guimenuitem>Red played by</guimenuitem></menuchoice></term>
  <listitem><para>
     Same as <guimenuitem>Player 1 played by</guimenuitem> but for player 2 (red).
  </para></listitem>
</varlistentry>
<varlistentry>
  <term><menuchoice><guimenu>Options</guimenu><guimenuitem>Level</guimenuitem></menuchoice></term>
  <listitem><para>
     Selects the level of the computer player.
  </para></listitem>
</varlistentry>
<varlistentry>
  <term><menuchoice><guimenu>Options</guimenu><guimenuitem>Change names...</guimenuitem></menuchoice></term>
  <listitem><para>
     Change the names of the players.
  </para></listitem>
</varlistentry>
<varlistentry>
  <term><menuchoice><guimenu>Options</guimenu><guimenuitem>Network server</guimenuitem></menuchoice></term>
  <listitem><para>
If this menu item is selected your computer tries to behave as game network server. This is of course only of any importance if you are doing a network game.    Only the computer acting as server will be able to start a new game
    or transfer a started game to the client's side.
    If both computers want to be server or none of them it is randomly
    selected.  </para></listitem>
</varlistentry>
<varlistentry>
  <term><menuchoice><guimenu>Options</guimenu><guimenuitem>Animations</guimenuitem></menuchoice></term>
  <listitem><para>
    Switches the animations on or off.  </para></listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="help">
<title>The <guimenuitem>Help</guimenuitem> Menu</title>

<variablelist>
<varlistentry>
<term><anchor id="contents"><menuchoice>
<shortcut><keycombo><keycap>F1</keycap></keycombo></shortcut>
<guimenu>Help</guimenu><guimenuitem>Contents</guimenuitem></menuchoice></term>
<listitem>
<para>This invokes the KDE help system starting at the the top of this help file.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="bug-report"><menuchoice>
<guimenu>Help</guimenu><guimenuitem>Report Bug.</guimenuitem></menuchoice></term>
<listitem><para>If you find an error in the program, or you have an idea on how
to improve the game, clicking this option will let you send an official bug
report to the KDE team.</para>

</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="about-kwin4"><menuchoice>
<guimenu>Help</guimenu><guimenuitem>About kwin4</guimenuitem></menuchoice></term>
<listitem>
<para>This will display version and author information.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><anchor id="about-kde"><menuchoice>
<guimenu>Help</guimenu><guimenuitem>About KDE</guimenuitem></menuchoice></term>
<listitem>
<para>This displays the KDE version and other basic information.</para>
</listitem>
</varlistentry>
</variablelist>
</sect1>


</chapter>
<chapter id="credits">
<title>Credits and License</title>

<para>
&kwin4;
</para>
<para>
Program copyright 1995-2000 Martin Heni <email>martin@heni-online.de</email>
</para>
<para>
Documentation copyright 2000 Martin Heni <email>martin@heni-online.de</email>
</para>

&underFDL;
&underGPL;

</chapter>

<![ %addindex; [ &kdedocindex; ]]>
</book>
<!--
Local Variables:
mode: sgml-mode
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
End:
-->


