SVN commit 430298 by annma:

improve doc a bit


 M  +33 -7     index.docbook  


--- trunk/playground/edu/doc/kalcul/index.docbook #430297:430298
@@ -36,12 +36,12 @@
 
 <legalnotice>&FDLNotice;</legalnotice>
 
-<date>2005-06-21</date>
+<date>2005-06-30</date>
 <releaseinfo>0.1</releaseinfo>
 
 <abstract>
 <para>
-Kalcul is a math application for young children (starting age 6) testing them on additions, substractions, multiplications and divisions. Two kinds of exercises can be done with kalcul: tests on operations where you set the operation type and the range and then the program asks random numbers questions and preset levels where you set yourself the questions asked.
+&kalcul; is a math application for young children (starting age 6) testing them on additions, substractions, multiplications and divisions. It also provides mixed exercises. Two kinds of exercises can be done with &kalcul;: tests on operations where you set the operation type and the range and then the program asks random numbers questions and preset levels (you can use provided tests or set your own levels via the <guimenu>Tools</guimenu> -&gt; <guimenuitem>Level Editor</guimenuitem>).
 </para>
 </abstract>
 
@@ -80,7 +80,7 @@
 <chapter id="using-kapp">
 <title>Using &kalcul;</title>
 
-<para>&kalcul;main window consists of the text area on the left and the timer on the right. The timer is a clock which either times your test or tells you to take a test in a given amount of time.
+<para>&kalcul; main window consists of the text area on the left and the timer on the right. The timer is a clock which either times your test or tells you to take a test in a given amount of time.
 </para>
 
 <para>
@@ -97,7 +97,7 @@
 </screenshot>
 </para>
 
-<para>Click the Start button to start a test. The clock starts and a question is displayed.
+<para>Click the Start button to start a test. The clock starts and a question is displayed. This is the Practice Mode where questions are randomly chosen and some parameters can be chosen in the <guimenu>Tools</guimenu> -&gt; <guimenuitem>Exercise Dialog</guimenuitem> menu. Defaults are: the operation is addition with two terms and each term is lower than 10.
 </para>
 
 <screenshot>
@@ -203,6 +203,31 @@
 </sect2>
 
 <sect2>
+<title>The Tools Menu</title>
+<para>
+<variablelist>
+<varlistentry>
+<term><menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Exercise Dialog</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Open</action> the Exercise Dialog</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Level Editor</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Open</action> the Level Editor dialog</para></listitem>
+</varlistentry>
+
+</variablelist>
+</para>
+
+</sect2>
+
+<sect2>
 <title>The <guimenu>Help</guimenu> Menu</title>
 &help.menu.documentation;
 
@@ -256,12 +281,13 @@
 Program copyright 2005 Anne-Marie Mahfouf <email>annma@kde.org</email>
 </para>
 <para>
-Developers:
 <itemizedlist>
-<listitem><para>Anne-Marie Mahfouf  <email>annma@kde.org</email></para>
+<listitem><para>Developer: Anne-Marie Mahfouf  <email>annma@kde.org</email></para>
 </listitem>
-<listitem><para>Michael Goettsche <email>michael.goettsche@kdemail.net</email></para>
+<listitem><para>Developer: Michael Goettsche <email>michael.goettsche@kdemail.net</email></para>
 </listitem>
+<listitem><para>Icon: Zoran Karavla <email>webmaster@the-error.net</email></para>
+</listitem>
 </itemizedlist>
 </para>