<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&ktuberling;">
  <!ENTITY package "kdegames">
  <!ENTITY technical.reference SYSTEM "technical-reference.docbook">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
]>

<book id="ktuberling" lang="&language;">
<bookinfo>
<title>The &ktuberling; Handbook</title>
<authorgroup>

<author>
<firstname>Éric</firstname><surname>Bischoff</surname>
<affiliation><address>&Eric.Bischoff.mail;</address></affiliation>
</author>

<author>
<firstname>Paul</firstname><othername>E.</othername><surname>Ahlquist</surname><lineage>Jr.</lineage>
<affiliation><address>&Paul.E.Ahlquist.Jr.mail;</address></affiliation>
</author>

<author>
<firstname>Eugene</firstname><surname>Trounev</surname>
<affiliation><address><email>eugene.trounev@gmail.com</email></address></affiliation>
</author>

<othercredit role="reviewer">
<firstname>Lauri</firstname>
<surname>Watts</surname>
<contrib>Reviewer</contrib>
</othercredit>

<!-- TRANS:ROLES_OF_TRANSLATORS -->

</authorgroup>

<date>2012-08-06</date>
<releaseinfo>0.8.0 (&kde; 4.9)</releaseinfo>

<copyright>
<year>1999</year><year>2000</year><year>2002</year><year>2006</year>
<holder>&Eric.Bischoff;</holder>
</copyright>

<copyright>
<year>2001</year>
<holder>&Paul.E.Ahlquist.Jr;</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<abstract>
<para>
&ktuberling; is a game intended for small children.
</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>KTuberling</keyword>
<keyword>game</keyword>
<keyword>toy</keyword>
<keyword>constructor</keyword>
<keyword>doll</keyword>
<keyword>decorating</keyword>
<keyword>children</keyword>
<keyword>tuberling</keyword>
<keyword>potato</keyword>
<keyword>train station</keyword>
<keyword>one player</keyword>
</keywordset>
</bookinfo>

<chapter id="introduction">
<title>Introduction</title>
<para>Gametype: Toy</para>
<para>Number of possible players: One</para>
<para>
&ktuberling; a simple constructor game suitable for children and adults alike. The idea of the game is based around a once popular doll making concept. A potato was decorated with various small artifacts to make it look more like a tiny person. &ktuberling; however, goes much further in terms of content and adds a surprising variety of different themes.
</para>
</chapter>

<chapter id="howto">
<title>How to Play</title>

<para>
<!--<inlinemediaobject><imageobject>
<imagedata fileref="ktuberling.png" format="PNG"/></imageobject>
</inlinemediaobject>-->
&ktuberling; is a game intended for small children. Of course, it may be
suitable for adults who have remained young at heart.
</para>

<para>
It is a <quote>potato editor</quote>. That means that you can drag and drop
eyes, mouths, mustache, and other parts of face and goodies onto a potato-like
guy. Similarly, you have other playgrounds with different themes.
</para>

<para>
There is no winner for the game. The only purpose is to make the funniest faces
you can.
</para>

<para>
&ktuberling; can also <quote>speak</quote>. It will spell out the name of
the objects you drag and drop. It will <quote>speak</quote> in a language
that you can choose. You can even use it to learn a bit of vocabulary
in foreign languages.
</para>
</chapter>

<chapter id="rules_and_tips">
<title>Rules and Tips</title>

<sect1 id="mouse-operation">
<title>Mouse Operation</title>

<para>
There are two areas in the main window:
</para>

<itemizedlist>
<listitem><para><quote>Playground</quote> area.
</para></listitem>
<listitem><para>
<quote>Objects</quote> area, where you select objects to
place on your playground.
</para></listitem>
</itemizedlist>
<note><title>Note:</title><para>An actual look of the application screen may change depending on a <quote>playground</quote> selected.</para></note>
<screenshot>
<screeninfo>Main Window of &ktuberling;</screeninfo>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="gameboard.png"/>
</imageobject>
<textobject><phrase>Main Window</phrase></textobject>
</mediaobject>
</screenshot>

<sect2 id="place-object">
<title>Placing an Object</title>

<para>
To drag an object, move the mouse pointer to the <quote>objects</quote>
area and click on it. Then move it to the <quote>playground</quote> area 
and click again.
<note><title>Note:</title><para>Size of the objects may change while dragging. Some of the oversized objects have been scaled down to feet into the “objects” area.</para></note>
</para>
</sect2>

<sect2 id="move-object">
<title>Moving an Object</title>
<para>
Once dropped in the <quote>playground</quote> area, an object can be moved.
Just click on the object to select it, move it to the new place and click again
to drop it. When you drop it, it goes on top of other objects that were partially hiding it.
This trick is useful for getting the glasses and eyes placed correctly.
</para>
</sect2>

<sect2 id="remove-object">
<title>Removing an Object</title>
<para>
To remove an object that has been dropped in the <quote>playground</quote>
area, drag it back from the <quote>playground</quote> area to the
<quote>objects</quote> area.
</para>
</sect2>
</sect1>
</chapter>

<chapter id="interface">
<title>Interface Overview </title>
<sect1 id="the-tool-bar">
<title>The Tool Bar</title>

<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="toolbar.png"/>
</imageobject>
<textobject><phrase>Toolbar</phrase></textobject>
</mediaobject>

<para>
The toolbar provides buttons for the commonly used functions.
</para>

<table>
<title>Toolbar Buttons</title>
<tgroup cols="4">

<thead>
<row>
<entry>Button</entry>
<entry>Name</entry>
<entry>Menu Equivalent</entry>
<entry>Action</entry>
</row>
</thead>
<tbody>

<row>
<entry>
  <inlinemediaobject>
  <imageobject>
  <imagedata format="PNG" fileref="button-new.png"/>
  </imageobject>
	<textobject><phrase>New Game Button</phrase></textobject>
  </inlinemediaobject>
  </entry>
<entry>
  <guiicon>New</guiicon></entry>
<entry>
  <link linkend="game-new"><menuchoice>
  <guimenu>Game</guimenu> <guimenuitem>New</guimenuitem></menuchoice>
  </link>
  </entry>
<entry>
Resets the <quote>playground</quote> area. This cleans all parts of the
playground so a new decoration may be created.
</entry>
</row>


<row>
<entry>
  <inlinemediaobject>
  <imageobject>
  <imagedata format="PNG" fileref="button-open.png"/>
  </imageobject>
	<textobject><phrase>Load Button</phrase></textobject>
  </inlinemediaobject>
  </entry>
<entry><guiicon>Load</guiicon></entry>
<entry>
  <link linkend="game-load"><menuchoice>
  <guimenu>Game</guimenu> <guimenuitem>Load...</guimenuitem></menuchoice>
  </link>
  </entry>
<entry>
Opens an existing tuberling file from the disk.
</entry>
</row>

<row>
<entry>
  <inlinemediaobject>
  <imageobject>
  <imagedata format="PNG" fileref="button-save.png"/>
  </imageobject>
  <textobject><phrase>Save Button</phrase></textobject>
  </inlinemediaobject>
</entry>
<entry><guiicon>Save</guiicon></entry>
<entry>
  <link linkend="game-save"><menuchoice>
  <guimenu>Game</guimenu> <guimenuitem>Save</guimenuitem></menuchoice>
  </link>
  </entry>
<entry>
Saves your creation to your home folder, or to some other folder 
on your disk. The tuberling is saved to a small file where only the
position of objects are saved.
</entry>
</row>


<row>
<entry>
  <inlinemediaobject>
  <imageobject>
  <imagedata format="PNG" fileref="button-print.png"/>
  </imageobject>
  <textobject><phrase>Print Button</phrase></textobject>
</inlinemediaobject>
</entry>
<entry>
<guiicon>Print</guiicon>
</entry>
<entry>
  <link linkend="game-print"><menuchoice>
  <guimenu>Game</guimenu> <guimenuitem>Print...</guimenuitem></menuchoice>
  </link>
  </entry>
<entry>
Prints your picture.
</entry>
</row>

<row>
<entry>
  <inlinemediaobject>
  <imageobject>
  <imagedata format="PNG" fileref="button-undo.png"/>
  </imageobject>
  <textobject><phrase>Undo Button</phrase></textobject>
  </inlinemediaobject>
  </entry>
<entry>
  <guiicon>Undo</guiicon>
  </entry>
<entry>
  <link linkend="edit-undo"><menuchoice>
  <guimenu>Edit</guimenu> <guimenuitem>Undo</guimenuitem></menuchoice>
  </link>
  </entry>
<entry>Undoes last operation.</entry>
</row>

<row>
<entry>
  <inlinemediaobject>
  <imageobject>
  <imagedata format="PNG" fileref="button-redo.png"/>
  </imageobject>
  <textobject><phrase>Redo Button</phrase></textobject>
  </inlinemediaobject>
  </entry>
<entry>
<guiicon>Redo</guiicon>
</entry>
<entry>
  <link linkend="edit-redo"><menuchoice>
  <guimenu>Edit</guimenu> <guimenuitem>Redo</guimenuitem></menuchoice>
  </link>
  </entry>
<entry>
Re-does last operation.</entry>
</row>

<!--  Currently there is no HELP button on the toolbar
<row>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata format="PNG" fileref="button-help.png"/>
</imageobject>
<imageobject>
<imagedata format="EPS" fileref="button.help.eps"/>
</imageobject>
<textobject><phrase>Help Button</phrase></textobject>
</inlinemediaobject>
</entry>
<entry>
Help
</entry>
<entry>Displays this handbook.</entry>
</row>
-->

</tbody>
</tgroup>
</table>
</sect1>

<sect1 id="the-menu-items">
<title>The Menu Items</title>

<sect2>
<title>The <guimenu>Game</guimenu> Menu</title>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="menu-game.png"/>
</imageobject>
<textobject><phrase><guimenu>Game</guimenu> Menu</phrase></textobject>
</mediaobject>

<variablelist>

<varlistentry id="game-new">
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
 </shortcut>
<guimenu>Game</guimenu>
 <guimenuitem>New</guimenuitem>
 </menuchoice></term>
<listitem><para><action>Clears</action> the <quote>playground</quote>
area </para></listitem>
</varlistentry>

<varlistentry id="game-load">
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>
 </shortcut>
<guimenu>Game</guimenu>
 <guimenuitem>Load...</guimenuitem>
 </menuchoice></term>
 <listitem><para><action>Opens an existing tuberling file</action> from
your disk.</para></listitem>
</varlistentry>

<varlistentry id="game-save">
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>
</shortcut>
<guimenu>Game</guimenu>
<guimenuitem>Save</guimenuitem>
</menuchoice></term>
<listitem><para><action>Saves</action> your creation. The tuberling is
saved to a small file where only the position of objects are saved.
</para></listitem>
</varlistentry>

<varlistentry id="game-save-as-picture">
<term><menuchoice>
<guimenu>Game</guimenu>
<guimenuitem>Save as Picture...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Creates a graphics file</action>
containing a picture of your tuberling.
</para></listitem>
</varlistentry>

<varlistentry id="game-print">
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo>
</shortcut>
<guimenu>Game</guimenu>
<guimenuitem>Print...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Prints</action> your tuberling picture.
</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><action>Quit</action> &ktuberling;.
</para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2>
<title>The <guimenu>Edit</guimenu> Menu</title>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="menu-edit.png"/>
</imageobject>
<textobject><phrase>Edit Menu</phrase></textobject>
</mediaobject>

<variablelist>

<varlistentry id="edit-undo">
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Undo</guimenuitem>
</menuchoice></term>
<listitem><para><action>Undo</action> the last
<quote>object</quote> placement.
</para></listitem>
</varlistentry>

<varlistentry id="edit-redo">
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;&Shift;
<keycap>Z</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Redo</guimenuitem>
</menuchoice></term>
<listitem><para><action>Re-does</action> the last <quote>object</quote>
placement.  This menu option is active only if you have previously used
<guilabel>Undo</guilabel>.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu>
<guimenuitem>Copy</guimenuitem>
</menuchoice></term>
<listitem><para><action>Copy</action> the <quote>playground</quote> area to the
clipboard.</para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2>
<title>The <guimenu>Playground</guimenu> Menu</title>

<variablelist>

<varlistentry>
<term><menuchoice>
<guimenu>Playground</guimenu>
<guimenuitem>Lock Aspect Ratio</guimenuitem>
</menuchoice></term>
<listitem><para>This option preserves the playground aspect ratio when resizing 
the &ktuberling; window. When the playground aspect ratio does not match the one 
of the window the background is filled with the one specified in the theme.
</para></listitem>
</varlistentry>

<varlistentry id="theme_change">
<term><menuchoice>
<guimenu>Playground</guimenu>
<guimenuitem>Playground Name</guimenuitem>
</menuchoice></term>
<listitem><para><action>Switches to the playground</action>.
</para></listitem>
</varlistentry>

</variablelist>

<para>
It will contain the playgrounds installed in your system.
</para>
<para>
&ktuberling; remembers the last chosen playground the next time it starts up.
</para>
</sect2>

<sect2>
<title>The <guimenu>Speech</guimenu> Menu</title>

<!--<para>
Please note that you need to have <command>&phonon;</command> installed
and properly configured to be able to hear sounds.
</para>-->

<variablelist>

<varlistentry>
<term><menuchoice>
<guimenu>Speech</guimenu>
<guimenuitem>No Sound</guimenuitem>
</menuchoice></term>
<listitem><para><action>Toggles sound off</action>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Speech</guimenu>
<guimenuitem>Language Name</guimenuitem>
</menuchoice></term>
<listitem><para><action>Toggles sound on and speaks the selected language</action>.
</para></listitem>
</varlistentry>

</variablelist>

<para>
&ktuberling; remembers of this option the next time it starts up.
</para>

</sect2>

<sect2 id="settings">
<title>The <guimenu>Settings</guimenu> Menu</title>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="menu-settings.png"/>
</imageobject>
<textobject><phrase>Settings Menu</phrase></textobject>
</mediaobject>

<variablelist>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Toolbars Shown</guimenuitem>
</menuchoice></term>
<listitem><para><action>Toggle the Main Toolbar and Game Options display</action> on and off.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo>
</shortcut>
<guimenu>Settings</guimenu>
<guimenuitem>Full Screen Mode</guimenuitem>
</menuchoice></term>
<listitem><para><action>Toggles the Full Screen mode</action> on and off.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure Shortcuts...</guimenuitem>
</menuchoice></term>
<listitem><para>Opens a standard &kde; shortcut configuration dialog, where you can change the 
keyboard shortcuts used by &ktuberling;.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure Toolbars...</guimenuitem>
</menuchoice></term>
<listitem><para>Display the standard &kde; toolbar configuration dialog.</para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2>
<title>The <guimenu>Help</guimenu> Menu</title>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="menu-help.png"/>
</imageobject>
<textobject><phrase>Help Menu</phrase></textobject>
</mediaobject>

&help.menu.documentation;

</sect2>
</sect1>
</chapter>

<chapter id="faq">
<title>Frequently Asked Questions</title>

<qandaset>
<qandaentry>
 <question><para>I want to change the way this game looks. Can I? </para></question>
 <answer><para>Yes you can. Refer to <link linkend="theme_change">this</link> section of 'Interface Overview' for details.</para></answer>
</qandaentry>
<qandaentry>
 <question><para>Can I use the keyboard to play this game? </para></question>
 <answer><para>No. This game cannot be played using keyboard.</para></answer>
</qandaentry>
<qandaentry>
 <question><para>I have made a great picture and I want to share it with my friends. Can I save it as an image?</para></question>
  <answer><para>Yes. To save the current session as an image refer to <link linkend="game-save-as-picture">this</link> section of 'Interface Overview' for details.</para></answer>
</qandaentry>
</qandaset>
</chapter>

&technical.reference;

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

<para>&ktuberling;</para>

<itemizedlist>
<listitem>
<para>Alex Fiestas <email>alex@eyeos.org</email> - current Maintainer</para>
</listitem>

<listitem>
<para>John Calhoun - Original idea, original pictures and English
sounds</para>
</listitem>

<listitem>
<para>&Eric.Bischoff; &Eric.Bischoff.mail; - &kde;
Programming</para>
</listitem>

<listitem>
<para>Fran&ccedil;ois-Xavier Duranceau <email>duranceau@free.fr</email> - Tests,
advice and help</para>
</listitem>

<listitem>
<para>Peter Silva <email>peter.silva@videotron.ca</email> - Proofreading of
the documentation</para>
</listitem>

<listitem>
<para>Paul Ahlquist &Paul.E.Ahlquist.Jr.mail; - Bettering of
documentation</para>
</listitem>
</itemizedlist> 

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->

&underFDL;
&underGPL;

</chapter>

</book>
