Warning, /games/kfourinline/doc/index.docbook is written in an unsupported language. File is not indexed.

 <?xml version="1.0" ?>
 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
 <!ENTITY % English "INCLUDE">
 <!ENTITY % addindex "IGNORE">
 ]>
 
 <book id="kfourinline" lang="&language;">
 <bookinfo>
 <title>The &kfourinline; Handbook</title>
 
 <authorgroup>
 <author>
 <firstname>Martin</firstname>
 <surname>Heni</surname>
 <affiliation>
 <address>&Martin.Heni.mail;</address>
 </affiliation>
 </author>
 <author>
 <firstname>Eugene</firstname>
 <surname>Trounev</surname>
 <affiliation>
 <address><email>eugene.trounev@gmail.com</email></address></affiliation>
 </author>
 <author>
 <firstname>Benjamin</firstname>
 <surname>Meyer</surname>
 </author>
 <author>
 <firstname>Johann Ollivier</firstname>
 <surname>Lapeyre</surname>
 </author>
 <author>
 <firstname>Anton</firstname>
 <surname>Brondz</surname>
 <affiliation>
 <address><email>dinolinux@gmail.com</email></address>
 </affiliation>
 </author>
 
 
 <!-- TRANS:ROLES_OF_TRANSLATORS -->
 </authorgroup>
 
 <copyright>
 <year>1995</year><year>2007</year>
 <holder>&Martin.Heni;</holder>
 </copyright>
 
 <legalnotice>&FDLNotice;</legalnotice>
 
 <date>2021-06-05</date>
 <releaseinfo>KDE Gear 21.04</releaseinfo>
 
 <abstract>
 <para>
 &kfourinline; is a four-in-a-row game by &kde;.</para>
 </abstract>
 
 <keywordset>
 <keyword>KDE</keyword>
 <keyword>kdegames</keyword>
 <keyword>game</keyword>
 <keyword>board</keyword>
 <keyword>board game</keyword>
 <keyword>four wins</keyword>
 <keyword>four</keyword>
 <keyword>four in a row</keyword>
 <keyword>four in line</keyword>
 <keyword>kfourinline</keyword>
 <keyword>connect four</keyword>
 <keyword>connect 4</keyword>
 </keywordset>
 </bookinfo>
 
 <chapter id="overview">
 <title>Introduction</title>
 
 <para>
 Game type: Strategy, Board
 </para>
 
 <para>
 &kfourinline; is a board game for two players based on the
 &nbsp;<trademark>Connect-Four</trademark> game.
 </para>
 
 <para>
 The players try to build up a row of four pieces using different strategies. Pieces are
 placed on a board. The game can also be played against a computer, as well on network.
 </para>
 
 </chapter>
 
 <chapter id="howtoplay">
 <title>How to Play</title>
 
 <screenshot>
 <mediaobject>
 <imageobject>
 <imagedata fileref="gameboard.png" format="PNG"/>
 </imageobject>
 <textobject>
 <phrase>&kfourinline; Game Board</phrase>
 </textobject>
 </mediaobject>
 </screenshot>
 
 <para>
 When &kfourinline; loads, you can select the difficulty or start a two player game. If you like,
 you can also pick your color and select which color starts the game.
 </para>
 
 <para>
 Each player is represented by a color (for example yellow or white for player one and red for player two).
 The goal of the game is to get four connected pieces of your color into any row, column or
 diagonal.
 The players move in turns. Each turn the player can place one of his or her pieces
 into any of the seven columns where each piece will fall to the lowest possible free place &ie; it
 will fall down until it reaches the ground level or another piece.
 </para>
 
 <para>
 After one player's move is done the second player can make his or her input.
 This is repeated until the game is over, which is when one of the
 players has four pieces in a row, column or diagonal or no more moves
 are possible because the board is filled.
 </para>
 
 <para>
 A player who first manages to get four pieces in a row, column or diagonal wins the
 game. If no more moves can be made but no player has won, the game ends drawn.
 </para>
 
 </chapter>
 
 <chapter id="rules">
 <title>Game rules, strategies and tips</title>
 
 <para>
 The board is separated into several regions.
 </para>
 
 <para>
 The <firstterm>game board</firstterm> is constructed out of 7x6 fields
 which will be filled from bottom to top. The fields are marked with pieces in the
 color of the player who made the move to this position.  On top of each column a
 colored arrow shows were the last piece had been put.
 </para>
 
 <para>
 The <firstterm>status display</firstterm> shows which player
 is controlled by which input device. A local player can input moves using
 keyboard or mouse, a remote player is shown as network input and finally
 the computer can control the input for a player.
 The status display further shows the player's names and the level of the computer opponent.
 Additionally the number of won, drawn, lost and ended games is noted for both players.
 Which player is next to move is indicated by one of the player's names being highlighted.
 </para>
 
 <para>
 The <firstterm>statusbar</firstterm> at the bottom of the screen displays the status of the game and
 which player is next to play.
 </para>
 
 <sect1 id="remote-connections">
 <title>Remote Connections</title>
 
 <para>
 It is possible to play the game over a network connection with another
 computer.
 One of the computers will act as game server. This one can determine
 who should play which color. You can configure the network options
 in the menu
 <menuchoice><guimenu>Settings</guimenu><guimenuitem>Network Configuration...</guimenuitem></menuchoice>.
 In the menu
 <menuchoice><guimenu>Game</guimenu><guimenuitem>Network Chat...</guimenuitem></menuchoice>.
 you find a chat dialog box which allows you to speak with your friend.
 </para>
 
 <para>
 When a network connection is built you will be asked to enter a remote host
 and a port. The port can usually just be left untouched, but if you know
 what you are doing 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 the client in
 the connection has to supply a hostname. It is often wise that the player
 behind a firewall chooses to be client as the firewall might not allow
 incoming connections.
 </para>
 
 </sect1>
 </chapter>
 
 <chapter id="interface-overview">
 <title>Interface Overview</title>
 
 <sect1 id="menu">
 <title>Menu Items</title>
 
 <variablelist>
 <varlistentry>
 <term><menuchoice>
 <shortcut>
 <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
 </shortcut>
 <guimenu>Game</guimenu>
 <guimenuitem>New</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 action="simul">&Ctrl;<keycap>O</keycap></keycombo>
 </shortcut>
 <guimenu>Game</guimenu>
 <guimenuitem>Load...</guimenuitem>
 </menuchoice></term>
 <listitem>
 <para>
 Loads a saved game.
 </para>
 </listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <shortcut>
 <keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>
 </shortcut>
 <guimenu>Game</guimenu>
 <guimenuitem>Save</guimenuitem>
 </menuchoice></term>
 <listitem>
 <para>
 Saves the current game.
 </para>
 </listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <shortcut>
 <keycombo action="simul">&Ctrl;&End;</keycombo>
 </shortcut>
 <guimenu>Game</guimenu>
 <guimenuitem>End Game</guimenuitem></menuchoice></term>
 <listitem>
 <para>
 Ends a running game.
 </para>
 </listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <guimenu>Game</guimenu>
 <guimenuitem>Network Chat...</guimenuitem></menuchoice></term>
 <listitem>
 <para>
 Pops up a chat widget which allows you to send messages to the
 other party.
 </para>
 </listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <guimenu>Game</guimenu>
 <guimenuitem>Show Statistics</guimenuitem>
 </menuchoice></term>
 <listitem>
 <para>
 Shows a dialog containing information about the overall game statistics, that is
 games won, lost or drawn by both players.
 The dialog also allows to clear this all time statistics.
 </para>
 </listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <shortcut>
 <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
 </shortcut>
 <guimenu>Game</guimenu>
 <guimenuitem>Quit</guimenuitem>
 </menuchoice></term>
 <listitem>
 <para>
 Quits the program.
 </para>
 </listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <shortcut>
 <keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo>
 </shortcut>
 <guimenu>Move</guimenu>
 <guimenuitem>Undo</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>
 <shortcut>
 <keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo>
 </shortcut>
 <guimenu>Move</guimenu>
 <guimenuitem>Redo</guimenuitem>
 </menuchoice></term>
 <listitem>
 <para>
 Replay a move which had been undone. If one of the players is played by
 the computer two moves are redone so that it is the player's turn again.
 </para>
 </listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <shortcut>
 <keycap>H</keycap>
 </shortcut>
 <guimenu>Move</guimenu>
 <guimenuitem>Hint</guimenuitem>
 </menuchoice></term>
 <listitem>
 <para>
 The computer will calculate the best possible move for you and mark it with a
 sign on the game board.  How good the move actually is depends on the level of
 the computer.
 </para>
 </listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <guimenu>Settings</guimenu>
 <guisubmenu>Theme</guisubmenu>
 </menuchoice></term>
 <listitem><para>
 <action>Choose a graphical theme for the game. Which themes are available depends on the current installation.</action>
 </para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <guimenu>Settings</guimenu>
 <guimenuitem>Network Configuration...</guimenuitem></menuchoice></term>
 <listitem>
 <para>
 Pops up a dialog for the network configuration. You can choose to be
 server or client. If you are server you can also choose what color the
 remote player should take over. If a network game is running you can
 also disconnect it in this menu.
 </para>
 </listitem>
 </varlistentry>
 
 </variablelist>
 
 <para>
 Additionally &kfourinline; has the common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu>
 menu items, for more information read the sections about the <ulink url="help:/fundamentals/menus.html#menus-settings"
 >Settings Menu</ulink> and <ulink url="help:/fundamentals/menus.html#menus-help">Help Menu</ulink>
 of the &kde; Fundamentals.
 </para>
 
 </sect1>
 
 </chapter>
 
 <chapter id="config">
 <title>Game Configuration</title>
 <para>&kfourinline; can be configured using the configuration dialog with the <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure &kfourinline;...</guimenuitem></menuchoice> menu item.</para>
 
 <screenshot>
 <mediaobject>
 <imageobject>
 <imagedata fileref="settings.png" format="PNG"/>
 </imageobject>
 <textobject>
 <phrase>Game Configuration</phrase>
 </textobject>
 </mediaobject>
 </screenshot>
 
 <para><guilabel>Starting Player Color</guilabel>: Determine which  player color (<guilabel>Red</guilabel> or <guilabel>Black</guilabel>) has the first move in the next game.</para>
 <para><guilabel>Player Names</guilabel>: Change the names of the players.</para>
 <para><guilabel>Black Plays With</guilabel>:
 Choose who should play for player 1. It can be either
 <guilabel>Mouse</guilabel> or <guilabel>Keyboard</guilabel>,
 &ie; a local player using the mouse or keyboard
 as input device or <guilabel>Computer</guilabel>, &ie; the computer
 plays for this player.</para>
 <para><guilabel>Red Plays With</guilabel>: Same as <guilabel>Black Plays With</guilabel> but for player 2
 (red).</para>
 <para><guilabel>Computer Difficulty</guilabel>: Select the level of the computer player.</para>
 <para><guilabel>Use AI learning</guilabel>: The computer AI can learn from mistakes made in one game.</para>
 
 </chapter>
 
 <chapter id="faq">
 <title>Frequently asked questions</title>
 <qandaset>
 
 <qandaentry>
 <question>
 <para>
 Can I change the look of the game?
 </para>
 </question>
 <answer>
 <para>
 You can change the color of the pieces by opening the <menuchoice><guimenu>Settings</guimenu> <guisubmenu>Theme</guisubmenu></menuchoice> menu item.
 </para>
 </answer>
 </qandaentry>
 
 <qandaentry>
 <question>
 <para>
 Can I use the keyboard to play the game?
 </para>
 </question>
 <answer>
 <para>
 You cannot use the keyboard to control the pieces.
 </para>
 </answer>
 </qandaentry>
 
 <qandaentry>
 <question>
 <para>
 I have lost control of who is in the lead, can I find it out?
 </para>
 </question>
 <answer>
 <para>
 Yes, you can see statistics by opening the <menuchoice><guimenu>Game</guimenu> <guimenuitem>Show Statistics</guimenuitem></menuchoice> menu item.
 </para>
 </answer>
 </qandaentry>
 
 </qandaset>
 
 </chapter>
 
 <chapter id="credits">
 <title>Credits and License</title>
 
 <para>
 &kfourinline;
 </para>
 <para>
 Program copyright 1995-2007 &Martin.Heni; &Martin.Heni.mail;
 and Benjamin Meyer.
 </para>
 <para>
 Graphics copyright 2007 Eugene Trounev <email>eugene.trounev@gmail.com</email>
 and Johann Ollivier Lapeyre.
 </para>
 <para>
 Documentation copyright 2007 &Martin.Heni; &Martin.Heni.mail; and Benjamin Meyer.
 </para>
 
 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
 
 &underFDL;
 &underGPL;
 
 </chapter>
 
 &documentation.index;
 </book>
 <!--
 Local Variables:
 mode: sgml
 sgml-minimize-attributes:nil
 sgml-general-insert-case:lower
 sgml-always-quote-attributes:t
 sgml-indent-step:0
 sgml-indent-data:t
 End:
 -->