I rewrote the documentation and made a few screenshots. There are some parts left to write, but I will do that soon.

16 files changed, 318 insertions, 22 deletions

diff --git a/docs/CMakeLists.txt b/docs/CMakeLists.txt
index 5ddaecc9..58af3730 100644
--- a/docs/CMakeLists.txt
+++ b/docs/CMakeLists.txt
@@ -1,5 +1,4 @@
-########### install files ###############
-#
+########### install files ################
 cmake_minimum_required(VERSION 2.6)
 find_package(KDE4 REQUIRED)
 include (KDE4Defaults)
diff --git a/docs/automatic_filters.png b/docs/automatic_filters.png
new file mode 100644
index 00000000..ad69fd3a
--- /dev/null
+++ b/docs/automatic_filters.png
diff --git a/docs/cache.png b/docs/cache.png
new file mode 100644
index 00000000..27e683c6
--- /dev/null
+++ b/docs/cache.png
diff --git a/docs/cookies.png b/docs/cookies.png
new file mode 100644
index 00000000..24c860e3
--- /dev/null
+++ b/docs/cookies.png
diff --git a/docs/fonts.png b/docs/fonts.png
new file mode 100644
index 00000000..54a1a10e
--- /dev/null
+++ b/docs/fonts.png
diff --git a/docs/general.png b/docs/general.png
new file mode 100644
index 00000000..d3e02f22
--- /dev/null
+++ b/docs/general.png
diff --git a/docs/index.docbook b/docs/index.docbook
index ca07e9cf..a1a18995 100644
--- a/docs/index.docbook
+++ b/docs/index.docbook
@@ -13,6 +13,11 @@
                               <surname>Garg</surname>
                               </personname>
                               ">
+  <!ENTITY Jonathan.Kolberg   "<personname>
+                              <firstname>Jonathan</firstname>
+                              <surname>Kolberg</surname>
+                              </personname>
+                              ">
  <!ENTITY The.rekonq.Team "<personname>
                               <firstname>rekonq</firstname>
                               <surname>Team</surname>
@@ -20,6 +25,7 @@
                               ">
   <!ENTITY Andrea.Diamantini.mail "<email>adjam7@gmail.com</email>">
   <!ENTITY Rohan.Garg.mail "<email>rohan16garg@gmail.com</email>">
+  <!ENTITY Jonathan.Kolberg.mail "<email>bulldog98@kubuntu-de.org</email>">
   <!ENTITY The.rekonq.Team.mail "<email>rekonq@kde.org</email>">
   <!ENTITY package "playground-network">
   <!ENTITY % addindex "IGNORE">
@@ -34,19 +40,23 @@
 <authorgroup>
 <author>&Andrea.Diamantini; &Andrea.Diamantini.mail;</author>
 <author>&Rohan.Garg; &Rohan.Garg.mail;</author>
+<author>&Jonathan.Kolberg; &Jonathan.Kolberg.mail;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
 </authorgroup>
 
 <copyright>
 <year>2008</year>
-<year>2009</year>
+<year>2009-2010</year>
+<year>2010</year>
 <holder>&Andrea.Diamantini;</holder>
 <holder>&Rohan.Garg;</holder>
+<holder>&Jonathan.Kolberg;</holder>
 </copyright>
 
 <legalnotice>&FDLNotice;</legalnotice>
 
-<date>2009-10-22</date>
-<releaseinfo>0.3.0</releaseinfo>
+<date>2010-05-01</date>
+<releaseinfo>0.5.0</releaseinfo>
 
 <abstract>
 <para>
@@ -70,16 +80,20 @@
 <title>Overview</title>
 
 <para>
-&rekonq; is a lightweight web browser for &kde; based on WebKit. It can currently 
+&rekonq; is a lightweight web browser for &kde; based on QtWebKit. Amongst other it provides the following features: 
 <itemizedlist>
-<listitem><para>Share bookmarks with &konqueror;</para></listitem>
-<listitem><para>Share Cookies with &konqueror;</para></listitem>
+<listitem><para>Shared bookmarks with &konqueror;</para></listitem>
+<listitem><para>Shared cookies with &konqueror;</para></listitem>
 <listitem><para>Handle tabbed browsing</para></listitem>
 <listitem><para>Display tab previews</para></listitem>
 <listitem><para>Handle support for NS plugins (eg: flash)</para></listitem>
 <listitem><para>Share General &kde; Proxy settings</para></listitem>
 <listitem><para>Browse anonymously</para></listitem>
 <listitem><para>Inspect web pages</para></listitem>
+<listitem><para>File and &FTP; protocol handling</para></listitem>
+<listitem><para>KWallet support for storing passwords</para></listitem>
+<listitem><para>Ad-Block support</para></listitem>
+<listitem><para>&kget; Download integration</para></listitem>
 </itemizedlist>
 </para>
 </chapter>
@@ -91,8 +105,8 @@
 <title>Introduction</title>
 
 <para>
-&rekonq; is a lightweight web browser for &kde; based on WebKit. Its code is based on Nokia QtDemoBrowser. 
-Its implementation is going to embrace &kde; technologies to have a full-featured &kde; web browser.
+&rekonq; is a lightweight web browser for &kde; based on WebKit. Its code is based on the Nokia QtDemoBrowser.
+Its implementation is going to embrace &kde; technologies, in order to have a full-featured &kde; web browser.
 </para>
 </chapter>
 <!-- ================== CHAPTER ==================  -->
@@ -115,6 +129,19 @@ Its implementation is going to embrace &kde; technologies to have a full-feature
 
 </screenshot>
 </para>
+<important><para>Like all &kde; applications, &rekonq; is highly
+        configurable. This document describes how &rekonq; behaves with the normal,
+        default settings.
+        </para>
+        <para> A three button mouse can be useful when you are running
+        &rekonq; or any other &kde; application. If your mouse only has two buttons
+        then you should be able to set your system up so that you can simulate a a middle mouse button by pressing both buttons at the same time.
+        </para>
+        <para>If you are used to having to double-click to perform an action,
+        then take care, because in common with the rest of &kde;, &rekonq; defaults
+        to single-clicking.
+        </para>
+</important>
 
 <sect1 id="Starting">
 
@@ -122,19 +149,286 @@ Its implementation is going to embrace &kde; technologies to have a full-feature
 <para>
 &rekonq; can be started in the following ways
 <itemizedlist>
-<listitem><para>From the application launcher select 
+  <listitem><para>From the application launcher select 
+    <menuchoice>
+    <guimenuitem>Applications</guimenuitem>
+    <guisubmenu>Internet</guisubmenu>
+    <guimenuitem>rekonq</guimenuitem>
+    </menuchoice>
+  </para></listitem>
+  <listitem><para><keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> will open a
+        <guimenuitem>Run Command</guimenuitem> dialog box,type &rekonq; (lower case) and press &Enter; or
+        the <guibutton>Run</guibutton> to start &rekonq;</para></listitem>
+</itemizedlist>
+</para>
+</sect1>
+</chapter>
+<!-- ================== CHAPTER ==================  -->
+
+<chapter id="Config-rekonq">
+<title>Configure &rekonq;</title>
+
+<sect1 id="General">
+
+<title>Do the general settings of &rekonq;</title>
+
+<para>
+You want to configure the general behavior of &rekonq;? You found the right place to get it explained.
+</para>
+
+<para>
+To open the general settings go to
 <menuchoice>
-<guimenuitem>Applications</guimenuitem>
-<guisubmenu>Internet</guisubmenu>
-<guimenuitem>rekonq</guimenuitem>
+<guimenuitem>Toolbutton</guimenuitem>
+<guisubmenu>Configure rekonq</guisubmenu>
 </menuchoice>
-</para></listitem>
-<listitem><para><keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> will open a
-<guimenuitem>Run Command</guimenuitem> dialog box,type rekonq (lower case) and press &Enter; or
-the <guibutton>Run</guibutton> to start &rekonq;</para></listitem>
+</para>
+
+<para>
+<screenshot>
+<screeninfo>Now you should see this</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="general.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Screenshot</phrase>
+	  </textobject>
+	</mediaobject>
+
+</screenshot>
+</para>
+
+<para>
+Here a List of configurable point and explanation for it:
+
+<itemizedlist>
+  <listitem> <para> <guimenuitem> When starting rekonq:</guimenuitem>  You can configure what &rekonq; should do on startup. </para> </listitem>
+  <listitem> <para> <guimenuitem> Home page URL:</guimenuitem>  You can either set your home page directly trought tipping the &URL; in. </para> </listitem>
+  <listitem> <para> <guimenuitem> Set to Current Page</guimenuitem> Sets your home page to the one you are visiting at the moment. </para> </listitem>
+  <listitem> <para> <guimenuitem> Default search engine:</guimenuitem> Here you can choose the search engine you like to be searched with as default. </para> </listitem>
+  <listitem> <para> <guimenuitem> Use KGet for downloading files</guimenuitem> This activates wether you want to download with <application>&kget;</application>. </para> </listitem>
+  <listitem> <para> <guimenuitem> List links with KGet</guimenuitem> ????? </para> </listitem>
+<!-- What does this? -->
 </itemizedlist>
+
+</para>
+
+</sect1>
+
+<sect1>
+
+<title>Configure the Tabs settings</title>
+
+<para>
+<screenshot>
+<screeninfo>Now you should see this</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="tabs.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Screenshot</phrase>
+	  </textobject>
+	</mediaobject>
+
+</screenshot>
 </para>
+
 </sect1>
+
+<sect1>
+
+<title>Configure the Fonts settings</title>
+
+<para>
+<screenshot>
+<screeninfo>Now you should see this</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="fonts.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Screenshot</phrase>
+	  </textobject>
+	</mediaobject>
+
+</screenshot>
+</para>
+
+</sect1>
+
+<sect1>
+
+<title>Configure the Webkit settings</title>
+
+<para>
+<screenshot>
+<screeninfo>Now you should see this</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="webkit.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Screenshot</phrase>
+	  </textobject>
+	</mediaobject>
+
+</screenshot>
+</para>
+
+</sect1>
+
+<sect1 id="Network">
+
+<title>Network configuration</title>
+
+<sect2 id="Cookies">
+
+<title>Handling of Cookies with &rekonq;</title>
+
+<para>
+<screenshot>
+<screeninfo>This is a screenshot of the cookie settings dialog</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="cookies.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Screenshot</phrase>
+	  </textobject>
+	</mediaobject>
+
+</screenshot>
+</para>
+
+<para>
+As you can see the Cookies can be configured in many ways.
+</para>
+
+<para>
+&rekonq; can handel Cookies in three ways
+<itemizedlist>
+<listitem><para>"Ask for Confirmation"</para></listitem>
+</itemizedlist>
+</para>
+</sect2>
+
+<sect2>
+
+<title>Rest</title>
+
+<para>
+<screenshot>
+<screeninfo>Now you should see this</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="cache.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Screenshot</phrase>
+	  </textobject>
+	</mediaobject>
+
+</screenshot>
+</para>
+
+<para>
+<screenshot>
+<screeninfo>Now you should see this</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="proxy.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Screenshot</phrase>
+	  </textobject>
+	</mediaobject>
+
+</screenshot>
+</para>
+</sect2>
+
+</sect1>
+
+<sect1>
+
+<title>Configure the Adblock settings</title>
+
+<para>
+<screenshot>
+<screeninfo>Now you should see this</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="automatic_fiters.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Screenshot</phrase>
+	  </textobject>
+	</mediaobject>
+
+</screenshot>
+</para>
+
+<para>
+<screenshot>
+<screeninfo>Now you should see this</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="own_filter.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Screenshot</phrase>
+	  </textobject>
+	</mediaobject>
+
+</screenshot>
+</para>
+
+</sect1>
+
+<sect1>
+
+<title>Configure the Shortcut settings</title>
+
+<para>
+<screenshot>
+<screeninfo>Now you should see this</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="shortcuts.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Screenshot</phrase>
+	  </textobject>
+	</mediaobject>
+
+</screenshot>
+</para>
+
+</sect1>
+
+<sect1>
+
+<title>Configure the Web Shortcuts settings</title>
+
+<para>
+<screenshot>
+<screeninfo>Now you should see this</screeninfo>
+	<mediaobject>
+	  <imageobject>
+	    <imagedata fileref="webshortcuts.png" format="PNG"/>
+	  </imageobject>
+	  <textobject>
+	    <phrase>Screenshot</phrase>
+	  </textobject>
+	</mediaobject>
+
+</screenshot>
+</para>
+
+</sect1>
+
 </chapter>
 
 <!-- ================== CHAPTER ==================  -->
@@ -162,12 +456,14 @@ Program copyright:
 Documentation copyright 2008 &Andrea.Diamantini; &Andrea.Diamantini.mail;
 </para>
 <para>
-Documentation copyright 2009 &Rohan.Garg; &Rohan.Garg.mail;
+Documentation copyright 2009-2010 &Rohan.Garg; &Rohan.Garg.mail;
+</para>
+<para>
+Documentation copyright 2010 &Jonathan.Kolberg; &Jonathan.Kolberg.mail;
 </para>
 
 
 <!--TRANS:CREDIT_FOR_TRANSLATORS-->
-
 &underFDL;               <!-- FDL: do not remove -->
 &underBSDLicense;        <!-- BSD License -->
 
@@ -185,15 +481,16 @@ Documentation copyright 2009 &Rohan.Garg; &Rohan.Garg.mail;
 <title>Requirements</title>
 
 <para>
-In order to successfully use &rekonq;, you need at least &Qt; 4.5.x and &kde; 4.3.x.
+In order to successfully use &rekonq;, you need at least &Qt; 4.6.x and &kde; 4.4.x.
 </para>
 
 </sect1>
 
 <sect1 id="compilation">
 <title>Compilation and Installation</title>
-<para>If you wish to compile &rekonq;,go to
+<para>If you wish to compile &rekonq;, go to
 <ulink url="http://techbase.kde.org/Projects/rekonq/Compiling_rekonq">The how to compile &rekonq; page</ulink>.
+<!-- TODO: add the instructions from the webpage above, to this docbook -->
 </para>
 </sect1>
 
diff --git a/docs/old_screenshot.png b/docs/old_screenshot.png
new file mode 100644
index 00000000..5603f409
--- /dev/null
+++ b/docs/old_screenshot.png
diff --git a/docs/own_filter.png b/docs/own_filter.png
new file mode 100644
index 00000000..01242602
--- /dev/null
+++ b/docs/own_filter.png
diff --git a/docs/proxy.png b/docs/proxy.png
new file mode 100644
index 00000000..f08dce80
--- /dev/null
+++ b/docs/proxy.png
diff --git a/docs/screenshot.png b/docs/screenshot.png
index 5603f409..ac9d9d76 100644
--- a/docs/screenshot.png
+++ b/docs/screenshot.png
diff --git a/docs/shortcuts.png b/docs/shortcuts.png
new file mode 100644
index 00000000..b47cb37b
--- /dev/null
+++ b/docs/shortcuts.png
diff --git a/docs/snapshot1.png b/docs/snapshot1.png
new file mode 100644
index 00000000..2300d36b
--- /dev/null
+++ b/docs/snapshot1.png
diff --git a/docs/tabs.png b/docs/tabs.png
new file mode 100644
index 00000000..21f81c7c
--- /dev/null
+++ b/docs/tabs.png
diff --git a/docs/webkit.png b/docs/webkit.png
new file mode 100644
index 00000000..9698be6d
--- /dev/null
+++ b/docs/webkit.png
diff --git a/docs/webshortcuts.png b/docs/webshortcuts.png
new file mode 100644
index 00000000..7f20e110
--- /dev/null
+++ b/docs/webshortcuts.png