Warning, /education/kgeography/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 % addindex "IGNORE">
   <!ENTITY % English "INCLUDE"> 
 ]>
 
 <book id="kgeography" lang="&language;">
 
 <bookinfo>
 <title>The &kgeography; Handbook</title>
 
 <authorgroup>
 <author>
 <personname>
 <firstname>Anne-Marie</firstname>
 <surname>Mahfouf</surname>
 </personname>
 &Anne-Marie.Mahfouf.mail;
 </author>
 <author>
 <personname>
 <firstname>Kushal</firstname>
 <surname>Das</surname>
 </personname>
 <email>kushaldas@gmail.com</email>
 </author>
 
 <!-- TRANS:ROLES_OF_TRANSLATORS -->
 </authorgroup>
 
 <copyright>
 <year>2005</year>
 <holder>&Anne-Marie.Mahfouf;</holder>
 </copyright>
 
 <copyright>
 <year>2008</year>
 <holder>Kushal Das</holder>
 </copyright>
 
 <legalnotice>&FDLNotice;</legalnotice>
 
 <date>2020-12-22</date>
 <releaseinfo>Applications 20.12</releaseinfo>
 
 <!-- Abstract about this handbook -->
 
 <abstract>
 <para>
 &kgeography; is a geography learning tool by &kde;. Right now it has seven usage modes:
 <itemizedlist>
 <listitem>
 <para>Browse the maps clicking in a map division to see its name, capital and flag</para>
 </listitem>
 <listitem>
 <para>The game tells you a map division name and you have to click on it</para>
 </listitem>
 <listitem>
 <para>The game tells you a capital and you have to guess the division it belongs to</para>
 </listitem><listitem>
 <para>The game tells you a division and you have to guess its capital</para>
 </listitem><listitem>
 <para>The game shows you a map division flag and you have to guess its name</para>
 </listitem><listitem>
 <para>The game tells you a map division name and you have to guess its flag</para>
 </listitem><listitem>
 <para>The game shows an empty map and you have to place divisions on it one by one</para>
 </listitem>
 </itemizedlist>
 </para>
 
 </abstract>
 
 
 <keywordset>
 <keyword>KDE</keyword>
 <keyword>kdeedu</keyword>
 <keyword>KGeography</keyword>
 <keyword>geography</keyword>
 <keyword>maps</keyword>
 <keyword>countries</keyword>
 </keywordset>
 
 </bookinfo>
 
 <chapter id="introduction">
 <title>Introduction</title>
 
 <para>
 &kgeography; is a geography learning tool by &kde;. It allows you to learn about the political divisions of some countries (divisions, capitals of those divisions and their associated flags if there are some).
 </para>
 </chapter>
 
 <chapter id="quick-start">
 <title>Quick Start to &kgeography;</title>
 <para>
 When you run &kgeography; for the first time, it first asks you to choose a map to start with.
 </para>
 <tip>
 <para>
   You can filter the map list using <guilabel>Filter Maps</guilabel> text field. Just enter a few first letters of the map name to narrow down the list to a few matches.
 </para>
 </tip>
 <screenshot>
 <screeninfo>Here's a screenshot of &kgeography; at first start</screeninfo>
         <mediaobject>
           <imageobject>
             <imagedata fileref="first-start1.png" format="PNG"/>
           </imageobject>
           <textobject>
             <phrase>Here's a screenshot of &kgeography; at first start</phrase>
           </textobject>
         </mediaobject>
 </screenshot>
 <para>
 Here we choose Canada
 <screenshot>
 <screeninfo>Canada is chosen</screeninfo>
         <mediaobject>
           <imageobject>
             <imagedata fileref="first-start2.png" format="PNG"/>
           </imageobject>
           <textobject>
             <phrase>Canada is chosen</phrase>
           </textobject>
         </mediaobject>
 </screenshot>
 </para>
 <para>
 And &kgeography; main window appears with the map of Canada:
 <screenshot>
 <screeninfo>&kgeography; main window</screeninfo>
         <mediaobject>
           <imageobject>
             <imagedata fileref="first-start3.png" format="PNG"/>
           </imageobject>
           <textobject>
             <phrase>&kgeography; main window</phrase>
           </textobject>
         </mediaobject>
 </screenshot>
 </para>
 <para>
 You can then choose what type of learning or testing you want to do by looking at the menu on the left:
 <screenshot>
 <screeninfo>&kgeography; menu</screeninfo>
         <mediaobject>
           <imageobject>
             <imagedata fileref="first-start4.png" format="PNG"/>
           </imageobject>
           <textobject>
             <phrase>&kgeography; menu</phrase>
           </textobject>
         </mediaobject>
 </screenshot>
 </para>
 <para>
 Explore Map: a &LMB; click on an area of the map will display information about that area, if you click on the small &nbsp;<inlinemediaobject> <imageobject> <imagedata fileref="dialog-information.png" format="PNG"/> </imageobject> </inlinemediaobject> <guiicon>Info</guiicon> icon on the popmap, it will open the wikipedia page for that division in the system's default browser:
 <screenshot>
 <screeninfo>Browse the map</screeninfo>
         <mediaobject>
           <imageobject>
             <imagedata fileref="first-start5.png" format="PNG"/>
           </imageobject>
           <textobject>
             <phrase>Browse the map</phrase>
           </textobject>
         </mediaobject>
 </screenshot>
 </para>
 <para>
 Location of Provinces or Territories: you are first asked how many questions you want.
 <screenshot>
 <screeninfo>How many questions</screeninfo>
         <mediaobject>
           <imageobject>
             <imagedata fileref="first-start6.png" format="PNG"/>
           </imageobject>
           <textobject>
             <phrase>How many questions</phrase>
           </textobject>
         </mediaobject>
 </screenshot>
 </para>
 <para>
 Then you are asked to click on a specific province:
 <screenshot>
 <screeninfo>Click on a province</screeninfo>
         <mediaobject>
           <imageobject>
             <imagedata fileref="first-start7.png" format="PNG"/>
           </imageobject>
           <textobject>
             <phrase>Click on a province</phrase>
           </textobject>
         </mediaobject>
 </screenshot>
 </para>
 <para>
 When you finish all the questions, a result dialog is shown with your correct and uncorrect answers:
 <screenshot>
 <screeninfo>Your results</screeninfo>
         <mediaobject>
           <imageobject>
             <imagedata fileref="first-start8.png" format="PNG"/>
           </imageobject>
           <textobject>
             <phrase>Your results</phrase>
           </textobject>
         </mediaobject>
 </screenshot>
 </para>
 <para>
 Place Provinces or Territories in the Map: the cursor takes the shape of a province and you have to place it in the map:
 <screenshot>
 <screeninfo>Place a division in the map</screeninfo>
         <mediaobject>
           <imageobject>
             <imagedata fileref="first-start13.png" format="PNG"/>
           </imageobject>
           <textobject>
             <phrase>Place a division in the map</phrase>
           </textobject>
         </mediaobject>
 </screenshot>
 </para>
 <para>
 Provinces or Territories by Capital: you are asked to find the name of a province among a choice of 4 given its capital:
 <screenshot>
 <screeninfo>Guess a division from its capital</screeninfo>
         <mediaobject>
           <imageobject>
             <imagedata fileref="first-start9.png" format="PNG"/>
           </imageobject>
           <textobject>
             <phrase>Guess a division from its capital</phrase>
           </textobject>
         </mediaobject>
 </screenshot>
 </para>
 <para>
 And the results are displayed when the test is finished:
 <screenshot>
 <screeninfo>Your results</screeninfo>
         <mediaobject>
           <imageobject>
             <imagedata fileref="first-start10.png" format="PNG"/>
           </imageobject>
           <textobject>
             <phrase>Your results</phrase>
           </textobject>
         </mediaobject>
 </screenshot>
 </para>
 <para>
 Capitals of Provinces and Territories: you have a capital and four province names and you must choose the correct one. As before, at the end a result dialog is shown.
 </para>
 <para>
 Provinces or Territories by Flag: a flag is shown and you must find the province it belongs to.
 <screenshot>
 <screeninfo>the flag question</screeninfo>
         <mediaobject>
           <imageobject>
             <imagedata fileref="first-start11.png" format="PNG"/>
           </imageobject>
           <textobject>
             <phrase>the flag question</phrase>
           </textobject>
         </mediaobject>
 </screenshot>
 </para>
 <para>
 Flags of Provinces and Territories: a province name is given and you must find the correct flag among four.
 <screenshot>
 <screeninfo>match the flag with the province</screeninfo>
         <mediaobject>
           <imageobject>
             <imagedata fileref="first-start12.png" format="PNG"/>
           </imageobject>
           <textobject>
             <phrase>match the flag with the province</phrase>
           </textobject>
         </mediaobject>
 </screenshot>
 </para>
 </chapter>
 
 <chapter id="using-kapp">
 <title>Using &kgeography;</title>
 
 <para>
 &kgeography; displays information about some countries and tests you about those information.
 
 
 <screenshot>
 <screeninfo>Here's a screenshot of &kgeography;</screeninfo>
         <mediaobject>
           <imageobject>
             <imagedata fileref="kgeography.png" format="PNG"/>
           </imageobject>
           <textobject>
             <phrase>Screenshot</phrase>
           </textobject>
         </mediaobject>
 </screenshot>
 </para>
 
 
 <sect1 id="kapp-features">
 <title>More &kgeography; features</title>
 
 <para>Another feature of &kgeography; is the possibility of zoom on a map.
 <screenshot>
 <screeninfo>Zoom</screeninfo>
         <mediaobject>
           <imageobject>
             <imagedata fileref="zoom.png" format="PNG"/>
           </imageobject>
           <textobject>
             <phrase>Zoom</phrase>
           </textobject>
         </mediaobject>
 </screenshot>
 You can click the <guibutton>Zoom</guibutton> button and then draw a rectangle to zoom in a part of the map. While in zoom mode, you can press &RMB; to go back to the original map size 
 (the <guimenuitem>Original Size</guimenuitem> action has the same effect). Use the scroll bars, the arrow keys or the mouse wheel to move around the zoomed map or use the <guimenuitem>Move</guimenuitem> action that will allow you to drag the map using &LMB;. The <guimenuitem>Automatic Zoom</guimenuitem> feature will make the map as big as possible.
 </para>
 
 </sect1>
 </chapter>
 
 <!--<chapter id="teachers-parents">
 <title>Teachers/Parents guide to &kgeography; </title>
  This chapter should emphasize the educational aims of your app and
 guide the parent/teacher on how to help the child using it.
 </chapter>-->
 
 <chapter id="how-to-maps">
 <title>How to make maps</title>
 <para>A map in &kgeography; is made by two files, one is the image of the map and the other one is its description.</para>
 <sect1 id="helper-tool">
 <title>Helper tool</title>
 <para>
 You can find <ulink url="https://invent.kde.org/education/kgeography/-/blob/master/tools/gen_map.pl">here</ulink> a tool (made by Yann Verley) which helped him with the map of France. To find out its usage, simply execute it and read the help message. It basically creates the <literal role="extension">.kgm</literal> file from a plain text file and creates a file with the colors it has assigned to each division, so you can fill the map according to them.</para>
 <para>
 There is another tool <ulink url="https://invent.kde.org/education/kgeography/-/blob/master/tools/colorchecker.py">colorchecker.py</ulink> written by Albert Astals Cid. You need PyQt4 to run this. Just run this with the <literal role="extension">.kgm</literal> filename as argument (you also need the <literal role="extension">.png</literal> file of the map in the same folder). This will tell you if any pixel on the map has a different color which is not defined in the <literal role="extension">.kgm</literal> (description) file.
 </para>
 <tip>
 <para>
 Please read also the tutorial <ulink url="https://edu.kde.org/kgeography/tutorials/kgeography-addmaps.pdf">How to add maps</ulink>
 on the &kgeography; website.
 </para>
 </tip>
 </sect1>
 <sect1 id="description-file">
 <title>Description file</title>
 <para>
  The description file is needed and its file extension is <literal role="extension">.kgm</literal>. It should begin with <sgmltag class="starttag">?xml version="1.0" encoding="utf-8"</sgmltag>, then <sgmltag class="starttag">!DOCTYPE kgeographyMap</sgmltag>, followed by <sgmltag class="starttag">map</sgmltag> and end with <sgmltag class="endtag">map</sgmltag>.
 </para>
 <para>
  Inside of those tags there should be:
 <itemizedlist>
 <listitem>
   <para><sgmltag class="starttag">mapFile</sgmltag> and <sgmltag class="endtag">mapFile</sgmltag>: the name of the file (without any path) containing the map image, &eg; <quote><literal>europe.png</literal></quote>.</para>
 </listitem>
 <listitem>
   <para><sgmltag class="starttag">name</sgmltag> and <sgmltag class="endtag">name</sgmltag>: the name of map, &eg; <quote><literal>Europe</literal></quote>.</para>
 </listitem>
 <listitem>
   <para><sgmltag class="starttag">divisionsName</sgmltag> and <sgmltag class="endtag">divisionsName</sgmltag>: the general name of divisions in this map, that is, Provinces, States, Countries, &etc;</para>
 </listitem>
 <listitem>
   <para>A <sgmltag class="starttag">division</sgmltag> and <sgmltag class="endtag">division</sgmltag> for each division in the map.</para>
 </listitem>
 </itemizedlist>
  </para>
 <para>
  Each division has these tags:
 <itemizedlist>
 <listitem>
   <para><sgmltag class="starttag">name</sgmltag> and <sgmltag class="endtag">name</sgmltag>: the name of the division, &eg; <quote><literal>Albania</literal></quote>.</para>
 </listitem>
 <listitem>
   <para><sgmltag class="starttag">capital</sgmltag> and <sgmltag class="endtag">capital</sgmltag>: the name of the capital of the division, &eg; <quote><literal>Tirana</literal></quote>.</para>
 </listitem>
 <listitem>
         <para><sgmltag class="starttag">ignore</sgmltag> and <sgmltag class="endtag">ignore</sgmltag>: can be set to <userinput>yes</userinput>, <userinput>allowClickMode</userinput>, <userinput>allowClickFlagMode</userinput> and <userinput>no</userinput>. If this tag is set to <userinput>yes</userinput> then the division will be ignored when asking for divisions in that map. It is then as if this division does not exist in &kgeography; quiz modes. If this tag is set to <userinput>allowClickMode</userinput> then &kgeography; will ask for the division in the <guibutton>Location of ...</guibutton> mode but not in other quiz modes. If this tag is set to <userinput>allowClickFlagMode</userinput> then &kgeography; will ask for the division in the <guibutton>Location of ...</guibutton> mode and in the flag related quizes but not in other quiz modes. Setting this tag to <userinput>no</userinput> means the division will appear in all modes (browse and quizzes). This tag is optional and when there is no <sgmltag class="starttag">ignore</sgmltag> tag that means as it is set to <userinput>no</userinput>. For example <quote><literal>Algeria</literal></quote> has this tag set to <userinput>yes</userinput> in the <quote><literal>Europe</literal></quote> map which means that <quote><literal>Algeria</literal></quote> will not be part of any quiz in the <quote><literal>Europe</literal></quote> map.</para>
 </listitem>
 <listitem>
   <para><sgmltag class="starttag">flag</sgmltag> and <sgmltag class="endtag">flag</sgmltag>: the file (without any path) containing the flag of the division, &eg; <quote><literal>albania.png</literal></quote>. This tag is optional. Not needed for the divisions whose <sgmltag class="starttag">ignore</sgmltag> tag is set to <userinput>yes</userinput>.</para>
 </listitem>
 <listitem>
   <para><sgmltag class="starttag">blurredflag</sgmltag> and <sgmltag class="endtag">blurredflag</sgmltag>: the file (without any path) containing the blurred flag of the division, &eg; <quote><literal>blurred_albania.png</literal></quote>. This tag is optional. It should be used in situations where the flag has the name of the division to which it belongs written on it. This can cause the flag guessing games to become too easy, and as such submission of the flags with the text blurred out is encouraged.</para>
 </listitem>
 <listitem>
   <para><sgmltag class="starttag">color</sgmltag> and <sgmltag class="endtag">color</sgmltag>: the color the division has in the map.</para>
 </listitem>
 <listitem>
   <para><sgmltag class="starttag">falseCapital</sgmltag> and <sgmltag class="endtag">falseCapital</sgmltag>: There can be any number of <userinput>falseCapital</userinput> pairs, they are used to provide a list of false answers to the capital question instead of choosing the false answers amongst the other divisions capitals.</para>
 </listitem>
 </itemizedlist>
  </para>
 <para>
  The color is defined using three tags:
 <itemizedlist>
 <listitem>
   <para><sgmltag class="starttag">red</sgmltag> and <sgmltag class="endtag">red</sgmltag>: red component of the color. Valid values are between 0 and 255.</para>
 </listitem>
 <listitem>
   <para><sgmltag class="starttag">green</sgmltag> and <sgmltag class="endtag">green</sgmltag>: green component of the color. Valid values are between 0 and 255.</para>
 </listitem>
 <listitem>
   <para><sgmltag class="starttag">blue</sgmltag> and <sgmltag class="endtag">blue</sgmltag>: blue component of the color. Valid values are between 0 and 255.</para>
 </listitem>
 </itemizedlist>
 </para>
 <tip>
  <para>
  It is convenient to create 2 or 3 false divisions like <quote><literal>Water</literal></quote>, <quote><literal>Frontier</literal></quote> and <quote><literal>Coast</literal></quote> and set them with the <sgmltag class="starttag">ignore</sgmltag> tag set to <userinput>yes</userinput>. Don't forget <userinput>not to set</userinput> color for any <quote><literal>Frontier</literal></quote> 0,0,0 in RGB. Please make it something like 1,1,1 so that a border outline comes while placing any division on the map.
  </para>
 </tip>
  <important>
    <para>All names (capitals and divisions) must be in English.</para>
 </important>
 </sect1>
 <sect1 id="map-file">
 <title>Map file</title>
 <para>
  The map file is quite simple but laborious to create. It has to be in <acronym>PNG</acronym> format.
  You can find some maps to transform at <ulink url="https://www.cia.gov/library/publications/the-world-factbook/docs/refmaps.html">Cia Reference Maps</ulink>. If no map fits your needs you can download the <ulink url="https://www.cia.gov/library/publications/resources/the-world-factbook/graphics/ref_maps/political/pdf/world.pdf">political world map</ulink>, take a screenshot of it and work from it.
  Each division in the map should have one and only one color. To achieve this you can use image processing programs like <application>The Gimp</application> and &kolourpaint;.
 </para>
 </sect1>
 <sect1 id="flags">
 <title>Flags</title>
 <para>
  If you have used the <sgmltag class="starttag">flag</sgmltag> tag you should provide the flag files. They have to be in <acronym>PNG</acronym> format and better if they are 300x200 pixels and you provide a &SVG; file for it. To obtain &SVG; flags of almost all countries in the world and some other divisions, you can consult the <ulink url="https://sourceforge.net/project/showfiles.php?group_id=4054&amp;package_id=16668&amp;release_id=208770">Sodipodi flags collection</ulink>.
 </para>
 <para>
  As noted previously, we encourage you to provide blurred flag files for flags that have the division written on them. The same requirements apply to the blurred flag files as to the regular flag files. While there is no prescribed naming notation for the blurred files, we recommend saving these down with the name of the original flag prefixed with <literal>blurred_</literal>, &eg; <quote><literal>blurred_albania.png</literal></quote>
 </para>
 </sect1>
 <sect1 id="how-to-test">
 <title>How to test</title>
 <para>
  Before sending your map to Albert &Albert.Astals.Cid.mail;, you should test it to see it has no errors. To achieve that, you have to do the following:
 <itemizedlist>
 <listitem>
     <para>Put the map description and map image file in <filename class="directory">$<envar>XDG_DATA_HOME</envar>/share/apps/kgeography/</filename></para>
 </listitem>
 <listitem>
   <para>Put the flag <acronym>PNG</acronym> files (if any) in <filename class="directory">$<envar>XDG_DATA_HOME</envar>/share/apps/kgeography/flags/</filename></para>
 </listitem>
 </itemizedlist>
  Once that has been done you should be able of opening your map from inside &kgeography;.
  </para>
  <para>
  If you don't know which is your <filename class="directory">$<envar>XDG_DATA_HOME</envar></filename>, type <userinput><command>qtpaths</command> <option>--paths HomeLocation</option></userinput> in a shell.
  </para>
 <tip>
 <para>
 Use the colorchecker.py tool from the helper tools to check if any extra color left on the map which is not defined on the <literal role="extension">.kgm</literal> file.
 </para>
 </tip>
 </sect1>
 <sect1 id="non-political-maps">
 <title>Non political maps</title>
 <para> Is it possible to do non-political maps? Yes, it is!
 <screenshot>
 <screeninfo>Example of how to create a non political map</screeninfo>
         <mediaobject>
           <imageobject>
             <imagedata fileref="river.png" format="PNG"/>
           </imageobject>
           <textobject>
             <phrase>Example of how to create a non political map</phrase>
           </textobject>
         </mediaobject>
 </screenshot>
 </para>
 <para>
  Of course, the division concept can be extended to a river or a mountain. During the creation of the map, you should keep in mind that most times the river or mountain will be too small that you should provide an additional clicking area.
  In this example the river would have the maroon area and color &lt;20,76,34&gt; as its identifier.
 </para>
 </sect1>
 </chapter>
 
 <chapter id="commands">
 <title>Command Reference</title>
 
 <sect1 id="kapp-mainwindow">
 <title>The main &kgeography; window</title>
 
 <sect2>
 <title>The File Menu</title>
 <para>
 <variablelist>
 <varlistentry>
 <term><menuchoice>
 <shortcut>
 <keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>
 </shortcut>
 <guimenu>File</guimenu>
 <guimenuitem>Open Map...</guimenuitem>
 </menuchoice></term>
 <listitem><para><action>Open the choose map dialog. If you type quickly enough the first letters 
 of the map you look for will select the first map that matches.</action></para></listitem>
 </varlistentry>
 <varlistentry>
 <term><menuchoice>
 <shortcut>
 <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
 </shortcut>
 <guimenu>File</guimenu>
 <guimenuitem>Quit</guimenuitem>
 </menuchoice></term>
 <listitem><para><action>Quits</action> &kgeography;.</para></listitem>
 </varlistentry>
 </variablelist>
 </para>
 
 </sect2>
 
 <sect2>
 <title>The View Menu</title>
 <para>
 <variablelist>
 <varlistentry>
 <term><menuchoice>
 <guimenu>View</guimenu>
 <guimenuitem>Zoom</guimenuitem>
 </menuchoice></term>
 <listitem><para><action>Goes in zoom mode, then draw a rectangle to zoom in a part of the map.</action></para></listitem>
 </varlistentry>
 <varlistentry>
 <term><menuchoice>
 <guimenu>View</guimenu>
 <guimenuitem>Original Size</guimenuitem>
 </menuchoice></term>
 <listitem><para><action>Sets</action> the map back to its original size as defined in the map file. 
 A &RMB; click in zoomed mode performs the same action.</para></listitem>
 </varlistentry>
 <varlistentry>
 <term><menuchoice>
 <guimenu>View</guimenu>
 <guimenuitem>Automatic Zoom</guimenuitem>
 </menuchoice></term>
 <listitem><para><action>Sets</action> the map to automatic zoom using as much space as possible when resizing the &kgeography;  window.</para></listitem>
 </varlistentry>
 <varlistentry>
 <term><menuchoice>
 <guimenu>View</guimenu>
 <guimenuitem>Move</guimenuitem>
 </menuchoice></term>
 <listitem><para><action>Moves</action> the current map. This item is only enabled, if you have zoomed into the map.</para></listitem>
 </varlistentry>
 </variablelist>
 </para>
 
 </sect2>
 
 <sect2>
 <title>The Settings Menu</title>
 <para>
 &kgeography; has the common &kde; <guimenu>Settings</guimenu> menu items, for more information read the section
 about the <ulink url="help:/fundamentals/menus.html#menus-settings">Settings Menu</ulink> of the &kde; Fundamentals.
 </para>
 
 </sect2>
 <sect2>
 <title>The Help Menu</title>
 
 <para>&kgeography; has a default &kde; <guimenu>Help</guimenu> menu as described in the 
 <ulink url="help:/fundamentals/menus.html#menus-help">&kde; Fundamentals</ulink> 
 with two additional entries:</para>
         
 <variablelist>
 <varlistentry>
 <term><menuchoice><guimenu>Help</guimenu>
 <guimenuitem>Disclaimer</guimenuitem>
 </menuchoice></term>
 <listitem>
 <para><action>Displays</action> a disclaimer about the accuracy of maps, flags and translations used by &kgeography;.</para>
 </listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice><guimenu>Help</guimenu>
 <guimenuitem>Map author</guimenuitem>
 </menuchoice></term>
 <listitem>
 <para><action>Displays</action> the name of author who created the current map.</para>
 </listitem>
 </varlistentry>
 </variablelist>
 
 </sect2>
 
 </sect1>
 
 </chapter>
 
 <chapter id="configuration">
 <title>Configuration</title>
 <para>
 <variablelist>
 <varlistentry>
 <term><guilabel>Question Alignment</guilabel></term>
 <listitem><para>Determines the position of the questions in the window, default is <guilabel>Top-left</guilabel>.</para></listitem>
 </varlistentry>
 <varlistentry>
 <term><guilabel>Wait for Validation</guilabel></term>
 <listitem><para>If enabled the user will have to press <guibutton>Accept</guibutton> after choosing an answer.</para></listitem>
 </varlistentry>
 <varlistentry>
 <term><guilabel>Focus follows Mouse</guilabel></term>
 <listitem><para>If enabled pressing &Space; will trigger the button under the mouse pointer.</para></listitem>
 </varlistentry>
 <varlistentry>
 <term><guilabel>Map divisions colors</guilabel></term>
 <listitem><para>
 You can choose if you always want to keep the same colors (default) or if you want to use random colors: with this option random colors are assigned to the divisions in the map.
 This helps the user to focus and learn the division shapes and not the division colors.
 </para></listitem>
 </varlistentry>
 </variablelist>
 </para>
 </chapter>
 
 <chapter id="credits">
 
 <title>Credits and License</title>
 
 <para>
 &kgeography;
 </para>
 <para>
 Program copyright 2004-2008 Albert Astals Cid &Albert.Astals.Cid.mail;
 </para>
 
 
 <para>
 Documentation Copyright &copy; 2005 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;
                                2008 Kushal Das <email>kushaldas@gmail.com</email>
 </para>
 
 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
 &underFDL;
 &underGPL;
 
 </chapter>
 
 &documentation.index;
 </book>
 
 <!--
 Local Variables:
 mode: xml
 sgml-minimize-attributes:nil
 sgml-general-insert-case:lower
 sgml-indent-step:0
 sgml-indent-data:nil
 End:
 
 vim:tabstop=2:shiftwidth=2:expandtab 
 -->