Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdeedu@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

24 files changed, 958 insertions, 0 deletions

diff --git a/doc/kverbos/Makefile.am b/doc/kverbos/Makefile.am
new file mode 100644
index 00000000..085981d9
--- /dev/null
+++ b/doc/kverbos/Makefile.am
@@ -0,0 +1,4 @@
+
+KDE_LANG = en
+KDE_DOCS = AUTO
+
diff --git a/doc/kverbos/anterior.png b/doc/kverbos/anterior.png
new file mode 100644
index 00000000..f1945f54
--- /dev/null
+++ b/doc/kverbos/anterior.png
diff --git a/doc/kverbos/borrar.png b/doc/kverbos/borrar.png
new file mode 100644
index 00000000..373b87bd
--- /dev/null
+++ b/doc/kverbos/borrar.png
diff --git a/doc/kverbos/cancelar.png b/doc/kverbos/cancelar.png
new file mode 100644
index 00000000..fc3d71bd
--- /dev/null
+++ b/doc/kverbos/cancelar.png
diff --git a/doc/kverbos/cerrar.png b/doc/kverbos/cerrar.png
new file mode 100644
index 00000000..af4eda1f
--- /dev/null
+++ b/doc/kverbos/cerrar.png
diff --git a/doc/kverbos/continuar.png b/doc/kverbos/continuar.png
new file mode 100644
index 00000000..0316cb7c
--- /dev/null
+++ b/doc/kverbos/continuar.png
diff --git a/doc/kverbos/corregir.png b/doc/kverbos/corregir.png
new file mode 100644
index 00000000..5d1a89b4
--- /dev/null
+++ b/doc/kverbos/corregir.png
diff --git a/doc/kverbos/editar.png b/doc/kverbos/editar.png
new file mode 100644
index 00000000..15b5c54e
--- /dev/null
+++ b/doc/kverbos/editar.png
diff --git a/doc/kverbos/index.docbook b/doc/kverbos/index.docbook
new file mode 100644
index 00000000..f60e6060
--- /dev/null
+++ b/doc/kverbos/index.docbook
@@ -0,0 +1,954 @@
+<?xml version="1.0" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"  "dtd/kdex.dtd" [
+  <!ENTITY package "kdeedu">
+  <!ENTITY kappname "&kverbos;">
+  <!ENTITY % addindex "IGNORE">
+  <!ENTITY % English "INCLUDE"><!-- change language only here -->
+]>
+
+<book lang="&language;">
+
+<bookinfo>
+<title>The &kverbos; Handbook</title>
+
+<authorgroup>
+<author>
+<firstname>Arnold</firstname>
+<surname>Kraschinski</surname>
+<affiliation>
+<address><email>&Arnold.Kraschinski.mail;</email></address>
+</affiliation>
+</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+<copyright>
+<year>2001</year>
+<year>2002</year>
+<holder>&Arnold.Kraschinski;</holder>
+</copyright>
+
+<legalnotice>&FDLNotice;</legalnotice>
+
+<date>2002-05-23</date>
+<releaseinfo>3.0.8</releaseinfo>
+
+<abstract>
+<para>
+&kverbos; is an application specially designed to study Spanish verbforms.
+</para>
+</abstract>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>kdeutils</keyword>
+<keyword>Kapp</keyword>
+<keyword>verb</keyword>
+<keyword>spanish</keyword>
+</keywordset>
+
+</bookinfo>
+
+
+
+<chapter id="introduction">
+<title>Introduction</title>
+
+<para>With &kverbos; the user can learn the forms of Spanish verbs. The
+program suggests a verb and a time and the user enters the different
+forms. The program corrects the user input an gives a feedback.  The
+user can edit the list of the verbs that can be studied. The program
+can built regular verb forms by itself. Irregular verb forms have to
+be entered by the user. If a form of a verb is uncertain then the
+internet offers good sources:
+<ulink url="http://csgrs6k1.uwaterloo.ca/~dmg/lando/verbos/con-jugador.html">
+http://csgrs6k1.uwaterloo.ca/~dmg/lando/verbos/con-jugador.html</ulink>
+</para>
+
+<para>
+The most interesting feature in the recent release is the use of
+&kfeeder;. This is a separate program that
+the user has to install separately if he wants to use it. If it is
+installed then the learning progress will be shown in the &kfeeder;
+application. A dog is running around and will be fed with bones if
+you are a good learner. Otherwise he will be lying around most of the
+time. 
+</para>
+</chapter>
+
+<chapter id="using-kverbos">
+<title>Using &kverbos;</title>
+
+<screenshot>
+<screeninfo>Here's a screenshot of &kverbos;</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="mainscreen-leer.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>This window can be seen when the user starts the program.</phrase>
+	  </textobject>
+	</mediaobject>
+</screenshot>
+
+<para>When the user starts the program he can see this window. This is
+the main window of the application where the user can train verb
+forms. At the moment no verb file is loaded. So the program cannot
+suggest a verb. First the user has to open a file either with the menu
+<menuchoice><guimenu>File</guimenu><guimenuitem>Open</guimenuitem></menuchoice>
+or with the menubar or he has to enter some verbs with
+<menuchoice><guimenu>Edit</guimenu>
+<guimenuitem>Enter</guimenuitem></menuchoice>new verb.</para>
+
+<screenshot>
+<screeninfo>Here's a screenshot of &kverbos; with a loaded verb
+file</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="mainscreen1.png" format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>Here you see the main window with a loaded verb file.</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
+
+<para>Once the user has opened a file with verbs the program suggests
+one of them and a time. The user can type the solution into the textboxes.
+</para>
+
+<variablelist>
+<varlistentry>
+<term><inlinemediaobject>
+<imageobject>
+<imagedata fileref="limpiar.png" format="PNG"/>
+		</imageobject>
+		</inlinemediaobject></term>
+<listitem><para>This button wipes out all user input.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><inlinemediaobject>
+		<imageobject>
+		<imagedata fileref="corregir.png" format="PNG"/>
+		</imageobject>
+		</inlinemediaobject></term>
+<listitem><para>The user can test his input with this
+button. Incorrect forms will be underlined. Then the user has the
+chance to do it better and correct the forms another time. If one of
+the forms wasn't correct the verb cannot be counted as correct
+anymore.  </para></listitem>
+</varlistentry>
+<varlistentry>
+		<term><inlinemediaobject>
+<imageobject>
+<imagedata fileref="solucion.png" format="PNG"/>
+		</imageobject>
+		</inlinemediaobject></term>
+<listitem><para>If the user wants to see the solution he can use <guiicon>show
+solution</guiicon>. Then the correct solution is displayed in the editboxes. If
+the user uses this button the verb cannot be counted as correct
+anymore.</para></listitem>
+</varlistentry>	
+<varlistentry>
+<term><inlinemediaobject>
+<imageobject>
+<imagedata fileref="continuar.png" format="PNG"/>
+		</imageobject>
+		</inlinemediaobject></term>
+<listitem>
+<para>The last button in this row can have two functions.</para>
+
+<para>If the user presses this button and the verb forms haven't been
+corrected yet the button behaves like the 'corregir' button. The verb
+forms are corrected and the user can see if his input was correct. If
+the user wants to go on he has to press the button again.</para>
+
+<para>If the button is pressed and the verbs already have been
+corrected the program goes on to the next verb. That means another
+verb is selected and presented to the user.</para>
+</listitem>
+</varlistentry>	
+</variablelist>
+
+<para>A second line of buttons 	<inlinemediaobject>
+		<imageobject>
+		<imagedata fileref="letters.png" format="PNG"/>
+		</imageobject>
+	</inlinemediaobject>
+allows the user enter special spanish characters which probably cannot be entered by keyboard.
+</para>
+
+<para>
+In the status bar of the program the user gets information about his
+work. He can see how many verbs he has trained and how many of them
+have been correct. He can see how many verbs are stored in the opened
+file and which username has been entered, too.
+</para>
+
+<para>
+The progress bar is another feedback for the user. He can see his
+correct answers as a percentage of trained verbs.
+</para>
+</chapter>
+
+<chapter id="commands">
+<title>Command Reference</title>
+
+<sect1 id="kverbos-mainwindow">
+<title>The main &kverbos; window</title>
+<para>
+<screenshot>
+<screeninfo>Here's a screenshot of &kverbos; with a loaded verb file</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="mainscreen1.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Here you see the main window with a loaded verb file.</phrase>
+	  </textobject>
+	</mediaobject>
+</screenshot>
+</para>
+
+<!-- The File Menu ................................................................ -->
+<sect2>
+<title>The <guimenu>File</guimenu> Menu</title>
+
+<variablelist>
+
+<!-- File->New -->
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>New</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Creates a new document. That means that the verbs
+ in the actual list are deleted. The number of verbs is set to 0.</action></para></listitem>
+</varlistentry>
+
+<!-- File->Open -->
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Open</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Opens a verb file.</action> The file dialog opens and
+the user can select one of the verb files. The user has to make sure,
+that it is a verb file. There isn't a default verb file that comes
+with the program. The user has to enter his own verbs or he has to
+download a verb file from the &kverbos; website.</para></listitem> 
+</varlistentry>
+
+<!-- File->Open Standard Verb File -->
+<varlistentry>
+<term><menuchoice>
+<guimenu>File</guimenu>
+<guimenuitem>Open Standard Verb File</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Opens a verb file</action> that is delivered
+with &kverbos;. The user can use this file if he doesn't want to enter
+his own verbs.</para></listitem> 
+</varlistentry>
+
+<!-- File->Save -->
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Save</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Saves the document.</action> The file name
+dialog opens and the user can choose a name for the verb file. If the
+file name end with <literal role="extension">.htm</literal> or
+<literal role="extension">.html</literal> the verb list is saved as a
+&HTML; file.</para></listitem>
+</varlistentry>
+
+<!-- File->Save As -->
+<varlistentry>
+<term><menuchoice>
+<guimenu>File</guimenu>
+<guimenuitem>Save As</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Saves the document.</action> The file name
+dialog opens and the user can choose a name for the verb file. If the
+file name end with <literal role="extension">.htm</literal> or
+<literal role="extension">.html</literal> the verb list is saved as a
+&HTML; file.</para></listitem>
+</varlistentry>
+
+<!-- File->Close -->
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Close</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Terminates the program.</action></para></listitem>
+</varlistentry>
+
+<!-- File->New Window -->
+<varlistentry>
+<term><menuchoice>
+<guimenu>File</guimenu>
+<guimenuitem>New Window</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Starts a new instance of the program.</action></para></listitem>
+</varlistentry>
+
+<!-- File->Quit -->
+<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> &kverbos;</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+<!-- The Edit Menu ................................................................ -->
+<sect2>
+<title>The <guimenu>Edit</guimenu> Menu</title>
+
+<variablelist>
+
+<!-- Edit->Enter new verb -->
+<varlistentry>
+<term><menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Enter new verb</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Opens the dialog new verbs where you can add
+new verbs to the verb  list. This dialog is described in another
+chapter of this documentation.  </action></para></listitem>
+</varlistentry>
+
+<!-- Edit->Edit verblist -->
+<varlistentry>
+<term><menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Edit verblist</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Opens a dialog with a list of all the verbs that are in the actual
+verb list. You can edit this verb list. This dialog is described in another chapter of this
+documentation.</action></para></listitem>
+</varlistentry>
+</variablelist>
+
+</sect2>
+
+<!-- The User Menu ................................................................ -->
+<sect2>
+<title>The <guimenu>User</guimenu> Menu</title>
+
+<variablelist>
+
+<!-- User->username -->
+<varlistentry>
+<term><menuchoice>
+<guimenu>User</guimenu>
+<guimenuitem>username</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Opens a small dialog where you can enter your username.
+ </action></para></listitem>
+</varlistentry>
+
+<!-- User->results -->
+<varlistentry>
+<term><menuchoice>
+<guimenu>User</guimenu>
+<guimenuitem>results</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Opens a dialog where a user can see the number of training
+ sessions he has done with the program and the latest ten results.</action></para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+<!-- The settings menu -->
+<sect2>
+<title>The <guimenu>Settings</guimenu> Menu</title>
+
+<variablelist>
+
+<!-- Settings->Show toolbar -->
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show toolbar</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>The user can decide whether he wants to see the toolbar or not.
+He can set it here.</action></para></listitem>
+</varlistentry>
+
+<!-- Settings->Show status bar -->
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show statusbar</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>The user can decide whether he wants to see the status bar or not.
+In the status bar are shown information like the number of trained verbs and the user name.
+</action></para></listitem>
+</varlistentry>
+
+<!-- Settings->options -->
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>options</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Opens a dialog where a user can select the times he wants to train
+and the correction mode. More details see the chapter about this dialog.
+</action></para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+<!-- The Help Menu ................................................................ -->
+<sect2>
+<title>The Help Menu</title>
+
+&help.menu.documentation;
+
+</sect2>
+</sect1>
+
+<!-- ................................................................ -->
+<!-- The New Verb Dialog ............................................ -->
+<sect1 id="new-verb-dialog">
+<title>The New Verb Dialog</title>
+
+<screenshot>
+<screeninfo>Here's a screenshot of the New Verb dialog</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="newverb.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Here you can see the new verb dialog where the user can enter new verbs.</phrase>
+	  </textobject>
+	</mediaobject>
+</screenshot>
+
+<para>
+Use this dialog if you want to make your own verb list or if you want
+to append some new verbs to an existing verb list. Here you can enter
+the infinitive of the spanish verb and its meaning in a foreign
+language. Important is, that you tell the program if it is a regular
+verb or one of the spanish group verbs or an irregular one. If it is
+irregular you have to enter the irregular forms, too. Be careful with
+this dialog and the verb forms you enter because the program uses this
+data to generate forms automatically.
+</para>
+
+<variablelist>
+	<varlistentry>
+		<term><inlinemediaobject>
+		<imageobject>
+		<imagedata fileref="input.png" format="PNG"/>
+		</imageobject>
+		</inlinemediaobject></term>
+		<listitem><para>Some of the Edit boxes where you can enter the verb information.
+		There are similar Edit Boxes for the gerund and participle form and all the other forms
+		if needed.
+		</para></listitem>
+	</varlistentry>
+	<varlistentry>
+		<term><inlinemediaobject>
+		<imageobject>
+		<imagedata fileref="type.png" format="PNG"/>
+		</imageobject>
+		</inlinemediaobject></term>
+		<listitem><para>With this Combo Box you select which type of verb you have entered. Do
+		 this carfully because it is important information for the program to do its work properly.
+		 </para>
+		 <para>
+		 The Spanish language knows three types of regular conjugation. These are the conjugation
+		 pattern for the verbs ending on -er, -ar, and -ir. A lot of verbs are not regular in all
+		 forms but they aren't completely irregular. This verbs are called group verbs and can
+		 be divided in several groups. The program can generate the forms for the regular verbs
+		 and the ones for the group verbs itself. It only needs the information to which group
+		 the verb belongs. Other verbs are irregular and the irregular forms have to be entered.
+		 Select the group in the Combo Box.
+		 <variablelist>
+			<varlistentry>
+				<term>regular</term>
+				<listitem><para>Chose this if it is a completely regular verb of one of the
+				patterns -ar, -er or -ir.</para></listitem>
+			</varlistentry>	
+			<varlistentry>
+				<term>irregular</term>
+				<listitem><para>Select this if the verbs doesn't belong to one of the groups
+				described below. The Tab View will be activated and you can enter all the
+				irregular forms.</para></listitem>
+			</varlistentry>				
+			<varlistentry>
+				<term>e &gt; ie</term>
+				<listitem><para>Chose this for stem changing verbs where the e in the stem changes to ie.
+				</para></listitem>
+			</varlistentry>	
+			<varlistentry>
+				<term>o &gt; ue</term>
+				<listitem><para>Chose this for stem changing verbs where the o in the stem changes to ue.
+				</para></listitem>
+			</varlistentry>				
+			<varlistentry>
+				<term>u &gt; ue</term>
+				<listitem><para>Chose this for stem changing verbs where the u in the stem changes to ue.
+				</para></listitem>
+			</varlistentry>				
+			<varlistentry>
+				<term>e &gt; i</term>
+				<listitem><para>Chose this for stem changing verbs where the e in the stem changes to i.
+				</para></listitem>
+			</varlistentry>				
+			<varlistentry>
+				<term>c &gt; qu</term>
+				<listitem><para>A verb with orthografic irregularity. If a <quote>c</quote> comes before an <quote>e</quote>
+				the <quote>c</quote> changes to <quote>qu</quote>. Examples: colocar, atacar</para></listitem>
+			</varlistentry>				
+  		<varlistentry>
+				<term>g &gt; gu</term>
+				<listitem><para>A verb with orthografic irregularity. If a <quote>g</quote> comes before an <quote>e</quote>
+				the <quote>g</quote> changes to <quote>gu</quote>. Example: pagar</para></listitem>
+			</varlistentry>	
+			<varlistentry>
+				<term>z &gt; c</term>
+				<listitem><para>A verb with orthografic irregularity. If a <quote>z</quote> comes before an <quote>e</quote>
+				the <quote>z</quote> changes to <quote>c</quote>. Examples: cazar, alzar</para></listitem>
+			</varlistentry>	
+			<varlistentry>
+				<term>gu &gt; gu</term>
+				<listitem><para>A verb with orthografic irregularity. If a <quote>gu</quote> comes before an <quote>e</quote>
+				the <quote>gu</quote> changes to <quote>gu</quote>. Example: averiguar</para></listitem>
+			</varlistentry>	
+			<varlistentry>
+				<term>c &gt; z</term>
+				<listitem><para>A verb with orthografic irregularity. If a <quote>c</quote> comes before an <quote>o</quote>
+				or <quote>a</quote> the <quote>c</quote> changes to <quote>z</quote>. Examples: vencer, zurcir</para></listitem>
+			</varlistentry>	
+			<varlistentry>
+				<term>g &gt; j</term>
+				<listitem><para>A verb with orthografic irregularity. If a <quote>g</quote> comes before an <quote>o</quote>
+				or <quote>a</quote> the <quote>g</quote> changes to <quote>j</quote>. Examples: coger, dirigir</para></listitem>
+			</varlistentry>	
+			<varlistentry>
+				<term>gu &gt; g</term>
+				<listitem><para>A verb with orthografic irregularity. If <quote>gu</quote> comes before an <quote>o</quote>
+				or <quote>a</quote> the <quote>gu</quote> changes to <quote>g</quote>. Example: distinguir</para></listitem>
+			</varlistentry>	
+			<varlistentry>
+				<term>qu &gt; c</term>
+				<listitem><para>A verb with
+				orthografic irregularity. If
+				<quote>qu</quote> comes before an
+				<quote>o</quote> or <quote>a</quote>
+				the <quote>qu</quote> changes to
+				<quote>c</quote>. Example:
+				delinquir</para></listitem> 
+			</varlistentry>	
+			<varlistentry>
+				<term>accent like <quote>enviar</quote></term>
+				<listitem><para>A verb where the accent changes in some forms. Example: enviar
+				</para></listitem>
+			</varlistentry>	
+			<varlistentry>
+				<term>accent like <quote>continuar</quote></term>
+				<listitem><para>A verb where the accent changes in some forms. Example: continuar
+				</para></listitem>
+			</varlistentry>	
+			<varlistentry>
+				<term>missing i</term>
+				<listitem><para>Some verbs lose the instressed <quote>i</quote> in some forms. Examples:
+				taner, grunir, bullir</para></listitem>
+			</varlistentry>							
+		 </variablelist>
+		 </para>
+     </listitem>
+	</varlistentry>
+	<varlistentry>
+		<term><inlinemediaobject>
+		<imageobject>
+		<imagedata fileref="times.png" format="PNG"/>
+		</imageobject>
+		</inlinemediaobject></term>
+		<listitem><para>If you enter an irregular verb the tab view will be activated and
+		you can select the tab with the irregular forms.</para></listitem>
+	</varlistentry>	
+	<varlistentry>
+		<term><inlinemediaobject>
+		<imageobject>
+		<imagedata fileref="limpiarpagina.png" format="PNG"/>
+		</imageobject>
+		</inlinemediaobject></term>
+		<listitem>
+		<para>You have entered some incorrect information and want to delete them. With this
+		button you can wipe out the data in the Edit box of one single tab.
+		</para>
+		</listitem>
+	</varlistentry>	
+	<varlistentry>
+		<term><inlinemediaobject>
+		<imageobject>
+		<imagedata fileref="letters.png" format="PNG"/>
+		</imageobject>
+		</inlinemediaobject></term>
+		<listitem>
+		<para>This buttons insert the displayed spanish characters to the Edit box that has the
+		focus. Often these characters cannot be entered with the keyboard.
+		</para>
+		</listitem>
+	</varlistentry>	
+	<varlistentry>
+		<term><inlinemediaobject>
+		<imageobject>
+		<imagedata fileref="limpiar.png" format="PNG"/>
+		</imageobject>
+		</inlinemediaobject></term>
+		<listitem>
+		<para>You want to wipe out all information in all Edit Boxes on all tabs. Then use this
+		button.
+		</para>
+		</listitem>
+	</varlistentry>			
+	<varlistentry>
+		<term><inlinemediaobject>
+		<imageobject>
+		<imagedata fileref="anterior.png" format="PNG"/>
+		</imageobject>
+		</inlinemediaobject></term>
+		<listitem>
+		<para>Selects the verb before the actual verb in the verb list into the dialog. You can
+		read an change the information for this verb. If the actual verb is the first one then
+		the last one is loaded into the dialog.
+		</para>
+		</listitem>
+	</varlistentry>		
+	<varlistentry>
+		<term><inlinemediaobject>
+		<imageobject>
+		<imagedata fileref="siguiente.png" format="PNG"/>
+		</imageobject>
+		</inlinemediaobject></term>
+		<listitem>
+		<para>Selects the verb behind the actual verb in the verb list into the dialog. You can
+		read an change the information for this verb. If the actual verb is the last one then the
+		first one is loaded.
+		</para>
+		</listitem>
+	</varlistentry>	
+	<varlistentry>
+		<term><inlinemediaobject>
+		<imageobject>
+		<imagedata fileref="cerrar.png" format="PNG"/>
+		</imageobject>
+		</inlinemediaobject></term>
+		<listitem>
+		<para>Closes the dialog and returns to the main program or the Edit Verblist Dialog
+		depending from where the dialog was opened.
+		</para>
+		</listitem>
+	</varlistentry>			
+</variablelist>
+</sect1>
+
+<!-- ................................................................ -->
+<!-- The Verblist Dialog ............................................ -->
+<sect1 id="editverblist-dialog">
+<title>The Edit Verblist Dialog</title>
+<para>
+<screenshot>
+<screeninfo>Here's a screenshot of the Edit Verblist dialog</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="verblist.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Here you can see the Edit verblist dialog where the user can edit the list
+	    of the verbs.</phrase>
+	  </textobject>
+	</mediaobject>
+</screenshot>
+</para>
+<para>
+In the list view of this dialog you can see all the verbs of the opened verb file. If there
+aren't any verbs in the file or if there isn't a file open the list view will be empty.
+You can select a verb from the list and edit this verb or you select and delete one of them.
+</para>
+
+<variablelist>
+	<varlistentry>
+		<term><inlinemediaobject>
+		<imageobject>
+		<imagedata fileref="borrar.png" format="PNG"/>
+		</imageobject>
+		</inlinemediaobject></term>
+		<listitem><para>This button deletes the selected verb from the list of verbs.
+		</para></listitem>
+	</varlistentry>
+	<varlistentry>
+		<term><inlinemediaobject>
+		<imageobject>
+		<imagedata fileref="cancelar.png" format="PNG"/>
+		</imageobject>
+		</inlinemediaobject></term>
+		<listitem><para>With this button you can leave the dialog. All changes that have been
+		 made until this moment will not affect the verb list of the main program. That means
+		 that the list of the main program will be unchanged.
+		 </para></listitem>
+	</varlistentry>
+	<varlistentry>
+		<term><inlinemediaobject>
+		<imageobject>
+		<imagedata fileref="editar.png" format="PNG"/>
+		</imageobject>
+		</inlinemediaobject></term>
+		<listitem><para>The selected verb will be edited. The new verb dialog opens and the
+		selected verb is loaded to the edit boxes. You can make your changes. If you make a
+		double click on a verb this has the same effect than this button.
+		</para></listitem>
+	</varlistentry>	
+	<varlistentry>
+		<term><inlinemediaobject>
+		<imageobject>
+		<imagedata fileref="cerrar.png" format="PNG"/>
+		</imageobject>
+		</inlinemediaobject></term>
+		<listitem>
+		<para>With this button you can close the dialog. The changes that have been made are
+		stored in the verb list of the main program.
+		</para>
+		</listitem>
+	</varlistentry>	
+</variablelist>
+</sect1>
+
+<!-- ................................................................ -->
+<!-- The Username Dialog ............................................ -->
+<sect1 id="username-dialog">
+<title>The Username Dialog</title>
+
+<screenshot>
+<screeninfo>Here's a screenshot of the Username Dialog</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="username.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Here you can see the Username Dialog where the user can enter his name.</phrase>
+	  </textobject>
+	</mediaobject>
+</screenshot>
+
+<para>
+Enter your name here. The name is set as the new username of the program. It will be
+displayed in the programs status bar. Use the
+<guibutton>OK</guibutton> Button to confirm your input. The
+<guibutton>Cancel</guibutton> button leaves the user name unchanged.
+</para>
+<para>
+The program will store some information about your learning progress. The number of training
+sessions, the result of the last ten sessions and lists with the verbs that you entered
+right or wrong recently.
+</para>
+<para>
+You can have a look at this information in the
+<menuchoice><guimenu>User</guimenu><guimenuitem>Results</guimenuitem></menuchoice>
+dialog.
+</para>
+</sect1>
+
+<!-- ................................................................ -->
+<!-- The User Result Dialog ......................................... -->
+<sect1 id="userresult-dialog">
+<title>The User Result Dialog</title>
+
+<screenshot>
+<screeninfo>Here's a screenshot of the User Result Dialog</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="result.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Here you can see the User Result Dialog where the user can see his results.</phrase>
+	  </textobject>
+	</mediaobject>
+</screenshot>
+
+<para>
+In this dialog you can see the information that the program stores about you under
+your username. On the left you can see the results of the latest ten sessions and on the
+right are lists with the word that you entered right or wrong recently. A verb remains in the
+list of the right verbs for some time then it changes to the status unlearned again. The
+verbs that are in the wrong list will appear more frequently. They stay in the list until
+you enter them correctly. Then they will return to the list of the unlearned verbs.
+</para>
+</sect1>
+
+<!-- ................................................................ -->
+<!-- The Settings Options Dialog .................................... -->
+<sect1 id="settingsoptions-dialog">
+<title>The Settings Options Dialog</title>
+
+<screenshot>
+<screeninfo>Here's a screenshot of the Settings Options Dialog</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="options.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Here you can see the Settings Options Dialog where the user can change
+	    some options of the program.</phrase>
+	  </textobject>
+	</mediaobject>
+</screenshot>
+
+<para>
+In this dialog you can select the tenses that should be trained. So if you want to study a
+specific tense or if you haven't learned how to build the forms of a specific tense yet so
+you can select or deselect the tenses here. Your selection is stored to the properties file
+of the program.
+</para>
+<para>
+You can select a correction mode too. If you select <guilabel>correct
+strictly</guilabel> then every missing accent is regarded as an
+error. You can make it easier with <guilabel>ignore accent</guilabel>
+then a missing accent isn't an error.
+</para>
+<para>
+At last you can control the use of &kfeeder; if this application is
+installed. You can decide if the learning results will be shown with
+&kfeeder;, if the splash screen can be seen when the program is
+starting and what type of food animations are used. The last points
+needs a further explanation. &kfeeder; displays an animal that is
+running around. When you enter a correct solution your points will be
+send to &kfeeder;. The dog gets bones for each point. If you chose
+<guilabel>move food automatically</guilabel> then the bones move down
+from the ceiling and one point is one bone.  Otherwise every point is
+only a move for a bone. So you will need more points until the dog can
+reach the bone. Really the option <guilabel>move food
+automatically</guilabel> is more interesting.
+</para>
+</sect1>
+</chapter>
+
+<chapter id="developers">
+<title>Developer's Guide to &kverbos;</title>
+
+<para>
+At the moment it is not possible to program any plugins for &kverbos;.
+</para>
+
+</chapter>
+
+<chapter id="faq">
+<title>Questions and Answers</title>
+
+&reporting.bugs;
+&updating.documentation;
+
+<para>Until now nobody had a question that could be answered here.</para>
+</chapter>
+
+<chapter id="credits">
+
+<title>Credits and License</title>
+
+<para>
+&kverbos;
+</para>
+<para>
+Program Copyright 2002 &Arnold.Kraschinski; <email>&Arnold.Kraschinski.mail;</email>
+</para>
+<!--<para>
+Contributors:
+<itemizedlist>
+<listitem><para>-<email>-</email></para>
+</listitem>
+<listitem><para>-<email>-</email></para>
+</listitem>
+</itemizedlist>
+</para>-->
+
+<para>
+Documentation Copyright 2002 &Arnold.Kraschinski; <email>&Arnold.Kraschinski.mail;</email>
+</para>
+
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+&underFDL;
+&underGPL;
+
+</chapter>
+
+<appendix id="installation">
+<title>Installation</title>
+
+<sect1 id="getting-kverbos">
+<title>How to obtain &kverbos;</title>
+
+&install.intro.documentation;
+
+</sect1>
+
+<sect1 id="requirements">
+<title>Requirements</title>
+
+<para>
+In order to successfully use &kverbos;, you need &kde; 3.x.x. The program is distributed
+without a verblist file. So you have to enter the verbs yourself or you can download a
+verbfile.
+</para>
+
+<para>
+A verblist file and &kverbos; itself can be found
+on <ulink url="http://members.tripod.de/arnoldk67/computer/kverbos/kverbos.htm">
+The &kverbos; home page</ulink>.
+</para>
+
+<para>
+You can find a list of changes at <ulink
+url="http://edu.kde.org/kverbos/">http://edu.kde.org/kverbos/</ulink>.
+</para>
+</sect1>
+
+<sect1 id="compilation">
+<title>Compilation and Installation</title>
+
+&install.compile.documentation;
+
+</sect1>
+
+</appendix>
+
+&documentation.index;
+</book>
+<!--
+Local Variables:
+mode: sgml
+sgml-minimize-attributes:nil
+sgml-general-insert-case:lower
+sgml-indent-step:0
+sgml-indent-data:nil
+End:
+-->
diff --git a/doc/kverbos/input.png b/doc/kverbos/input.png
new file mode 100644
index 00000000..520b61c7
--- /dev/null
+++ b/doc/kverbos/input.png
diff --git a/doc/kverbos/letters.png b/doc/kverbos/letters.png
new file mode 100644
index 00000000..00050749
--- /dev/null
+++ b/doc/kverbos/letters.png
diff --git a/doc/kverbos/limpiar.png b/doc/kverbos/limpiar.png
new file mode 100644
index 00000000..0e459c8f
--- /dev/null
+++ b/doc/kverbos/limpiar.png
diff --git a/doc/kverbos/limpiarpagina.png b/doc/kverbos/limpiarpagina.png
new file mode 100644
index 00000000..9ec55dd6
--- /dev/null
+++ b/doc/kverbos/limpiarpagina.png
diff --git a/doc/kverbos/mainscreen-leer.png b/doc/kverbos/mainscreen-leer.png
new file mode 100644
index 00000000..504054b1
--- /dev/null
+++ b/doc/kverbos/mainscreen-leer.png
diff --git a/doc/kverbos/mainscreen1.png b/doc/kverbos/mainscreen1.png
new file mode 100644
index 00000000..6eaf31dd
--- /dev/null
+++ b/doc/kverbos/mainscreen1.png
diff --git a/doc/kverbos/newverb.png b/doc/kverbos/newverb.png
new file mode 100644
index 00000000..ffe638f8
--- /dev/null
+++ b/doc/kverbos/newverb.png
diff --git a/doc/kverbos/options.png b/doc/kverbos/options.png
new file mode 100644
index 00000000..032e3a44
--- /dev/null
+++ b/doc/kverbos/options.png
diff --git a/doc/kverbos/result.png b/doc/kverbos/result.png
new file mode 100644
index 00000000..1d2f8399
--- /dev/null
+++ b/doc/kverbos/result.png
diff --git a/doc/kverbos/siguiente.png b/doc/kverbos/siguiente.png
new file mode 100644
index 00000000..a6c68260
--- /dev/null
+++ b/doc/kverbos/siguiente.png
diff --git a/doc/kverbos/solucion.png b/doc/kverbos/solucion.png
new file mode 100644
index 00000000..780f3454
--- /dev/null
+++ b/doc/kverbos/solucion.png
diff --git a/doc/kverbos/times.png b/doc/kverbos/times.png
new file mode 100644
index 00000000..5570a51e
--- /dev/null
+++ b/doc/kverbos/times.png
diff --git a/doc/kverbos/type.png b/doc/kverbos/type.png
new file mode 100644
index 00000000..0f965b05
--- /dev/null
+++ b/doc/kverbos/type.png
diff --git a/doc/kverbos/username.png b/doc/kverbos/username.png
new file mode 100644
index 00000000..a8928558
--- /dev/null
+++ b/doc/kverbos/username.png
diff --git a/doc/kverbos/verblist.png b/doc/kverbos/verblist.png
new file mode 100644
index 00000000..280ff44d
--- /dev/null
+++ b/doc/kverbos/verblist.png