1 files changed, 75 insertions, 0 deletions
diff --git a/doc/kpercentage/using.docbook b/doc/kpercentage/using.docbook
new file mode 100644
index 00000000..3d61a023
--- /dev/null
+++ b/doc/kpercentage/using.docbook
@@ -0,0 +1,75 @@
+<chapter id="using-kpercentage">
+<title>Using &kpercentage;</title>
+
+<para> The welcome window lets you choose the type of exercise by
+clicking on one of the buttons.  The buttons are labeled with the
+value to be deduced in the exercises.</para>
+
+<screenshot>
+	<screeninfo>Here's a screenshot of the &kpercentage; welcome window</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="welcome.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Here's a screenshot of the &kpercentage; welcome window</phrase>
+	  </textobject>
+	</mediaobject>
+</screenshot>
+
+<sect1 id="kpercentage-features">
+<title>More &kpercentage; features</title>
+
+<para>On the left hand the number of exercises can be selected. One
+can choose from 1 to 10 tasks.</para>
+
+<para>On the right hand you can change the level of difficulty:</para>
+
+<variablelist>
+<varlistentry>
+<term>Easy</term>
+<listitem>
+<para>Only percentages with easy to calculate values are given.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>Medium</term>
+<listitem>
+<para>Harder percentages are included, even some with values greater
+than 100%</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>Crazy</term>
+<listitem>
+<para>Any percentage up to 200% may occur.  All values are whole
+numbered however, so be honest, calculate them in your head!</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<para>There are some help functions integrated. As usual some tool tips arise when the mouse is over 
+	a control element like a button or an edit line. If you click
+on the <guibutton>Help</guibutton> button, a little menu pops up with
+further opportunities:</para>
+
+<screenshot>
+	<screeninfo>The Help popup menu.</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="help.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+		  <phrase>The Help popup menu.</phrase>
+	  </textobject>
+	</mediaobject>
+</screenshot>
+
+&help.menu.documentation;
+
+</sect1>
+
+</chapter>
+