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/kdegraphics@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

4 files changed, 839 insertions, 0 deletions

diff --git a/doc/kview/Makefile.am b/doc/kview/Makefile.am
new file mode 100644
index 00000000..085981d9
--- /dev/null
+++ b/doc/kview/Makefile.am
@@ -0,0 +1,4 @@
+
+KDE_LANG = en
+KDE_DOCS = AUTO
+
diff --git a/doc/kview/index.docbook b/doc/kview/index.docbook
new file mode 100644
index 00000000..e1ddbbdf
--- /dev/null
+++ b/doc/kview/index.docbook
@@ -0,0 +1,835 @@
+<?xml version="1.0" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+  <!ENTITY kappname "&kview;">
+  <!ENTITY package "kdegraphics">
+  <!ENTITY % addindex "IGNORE">
+  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
+]>
+
+<book lang="&language;">
+
+<bookinfo>
+<title>The &kview; Handbook</title>
+
+<authorgroup>
+<author>
+<firstname>Hauke</firstname>
+<surname>Hildebrandt</surname>
+<affiliation>
+<address>&Hauke.Hildebrandt.mail;</address>
+</affiliation>
+</author>
+
+<othercredit role="developer">
+<firstname>Sirtaj</firstname>
+<othername>Singh</othername>
+<surname>Kang</surname>
+<contrib>Developer</contrib>
+</othercredit>
+
+<othercredit role="reviewer">
+<firstname>Lauri</firstname>
+<surname>Watts</surname>
+<affiliation><address>&Lauri.Watts.mail;</address></affiliation>
+<contrib>Reviewer</contrib>
+</othercredit>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
+
+
+<copyright>
+<year>2001</year>
+<holder>&Hauke.Hildebrandt;</holder>
+</copyright>
+
+<legalnotice>&FDLNotice;</legalnotice>
+
+<date>2006-05-20</date>
+<releaseinfo>3.5.2</releaseinfo>
+
+<abstract><para>&kview; is an image viewing program. It is small and fast and
+has some simple image processing commands. You can work with many different
+graphic file formats and convert your images to them. &kview; is not a
+fully-fledged image processor but it is sufficient for many of your everyday
+tasks.</para></abstract>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>kview</keyword>
+<keyword>kdegraphics</keyword>
+<keyword>image</keyword>
+<keyword>graphic</keyword>
+<keyword>viewer</keyword>
+</keywordset>
+
+</bookinfo>
+
+<chapter id="introduction">
+<title>Introduction</title>
+
+<para>&kview; is an image viewer for the &kde; desktop. You can view
+graphics of many different formats such as &PostScript;,
+<acronym>TIFF</acronym> &etc; By saving your files in a different
+format than the original you can easily convert images to other
+graphics formats. In addition, &kview; provides some nice little
+features for doing simple image processing, like stretching/shrinking,
+rotation and applying effects. You can arrange your images in a little
+slideshow.</para>
+
+</chapter>
+
+<chapter id="menus">
+<title>Menu Reference</title>
+
+<para>When you start &kview; you see the typical application layout: a
+workspace containing your documents (images in this case), a menubar that
+provides access to the various commands, a toolbar with shortcut buttons for
+some of them and a status bar at the bottom to display status messages. When
+you have the loaded an image into &kview;, there is also an additional
+context menu available which is displayed by clicking your right mouse
+button over the image. Below, all menu entries are explained in the order
+that they appear in the menubar.</para>
+
+<sect1 id="file-menu">
+<title>The <guimenu>File</guimenu> Menu</title>
+
+<variablelist>
+<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 new image</action> in &kview;. The size of the
+&kview; main window and the image after loading are determined by your
+settings. If you open several images, only the last one is shown, but all of
+them can be accessed using the image list.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>File</guimenu>
+<guimenuitem>Open Recent</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Displays a list of recently opened images.</action>
+Selecting one from this list reopens the image.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><shortcut><keycombo action="simul">
+&Ctrl;<keycap>S</keycap></keycombo></shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Save</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Save the current image</action>.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>File</guimenu>
+<guimenuitem>Save As</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Saves the image under a different name</action>. By
+choosing a new file format you can convert the image to a different graphics
+type.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut><keycombo action="simul">&Ctrl;
+<keycap>P</keycap></keycombo></shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Print...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Prints the image</action>. In the standard &kde; print dialog
+click the <guibutton>Options &gt;&gt;</guibutton> button, go to the tab <guilabel>Image 
+Settings</guilabel>. Select <guilabel>Fit image to page size</guilabel> or
+<guilabel>Center image on page</guilabel>.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><shortcut><keycombo>
+&Ctrl;<keycap>W</keycap></keycombo></shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Close</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Closes the currently displayed
+image.</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> &kview;. If you have several &kview;
+images open, all of them are closed.</para></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect1>
+
+<sect1 id="edit-menu">
+<title>The <guimenu>Edit</guimenu> Menu</title>
+
+<variablelist>
+<varlistentry>
+<term><menuchoice><shortcut><keycombo action="simul">&Ctrl;
+<keycap>C</keycap></keycombo></shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Copy</guimenuitem></menuchoice>
+</term>
+<listitem>
+<para><action>Copies</action> the entire image or the selection to the clipboard.</para> 
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><shortcut><keycombo action="simul">&Ctrl;
+<keycap>V</keycap></keycombo></shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Paste</guimenuitem></menuchoice>
+</term>
+<listitem>
+<para><action>Paste</action> the contents of the clipboard as a new image (only available, if the clipboard contains a valid image).</para> 
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><shortcut><keycap>C</keycap></shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Crop</guimenuitem>
+</menuchoice></term>
+<listitem>
+<para>If you have selected any part of the image (by drawing a box around it
+using your mouse) you can cut off all the rest around it by using this
+option. Your image is effectively reduced to your selection.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><shortcut><keycap>F5</keycap></shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Reload</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Reloads</action> the image to its original state (right
+after opening it).</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><shortcut><keycombo action="simul">
+<keycap>&Shift;</keycap><keycap>Delete</keycap></keycombo></shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Delete</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Deletes</action> the image.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><shortcut><keycap>V</keycap></shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Flip</guimenuitem>
+<guimenuitem>Vertical</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Flips the image along the
+vertical</action>. Mathematically, this does a reflection along the image's
+horizontal center line.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><shortcut><keycap>H</keycap></shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Flip</guimenuitem>
+<guimenuitem>Horizontal</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Flips the image along the
+horizontal</action>. Mathematically, this does a reflection along the image's
+vertical center line.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Rotate Counter-Clockwise</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Rotates the image by 90° in the counter-clockwise
+direction</action>.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Rotate Clockwise</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Rotates the image by 90° in the clockwise
+direction</action>.</para></listitem>
+</varlistentry>
+</variablelist>
+
+</sect1>
+
+<sect1 id="effects-menu">
+<title>The <guimenu>Effects</guimenu> Menu</title>
+
+<para>&kview; provides some functions for simple image processing:</para>
+
+<para>This menu item is only displayed in the menubar, if you choose the 
+application plugin effects in &kview;s configure dialog</para>
+
+<variablelist>
+<varlistentry>
+<term><menuchoice>
+<guimenu>Effects</guimenu>
+<guimenuitem>Gamma Correction...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Adjusts the gamma factor.</action></para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Effects</guimenu>
+<guimenuitem>Blend Color...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Blends the image to selected color and opacity</action></para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Effects</guimenu>
+<guimenuitem>Change Intensity (Brightness)...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Changes the brightness of the image.</action> Enter the
+new brightness in percent (with respect to the <emphasis>initial</emphasis>
+value).</para></listitem>
+</varlistentry>
+</variablelist>
+
+</sect1>
+
+<sect1 id="view-menu">
+<title>The <guimenu>View</guimenu> Menu</title>
+
+<variablelist>
+<varlistentry>
+<term><menuchoice><shortcut><keycombo action="simul">
+&Ctrl;<keycap>+</keycap></keycombo></shortcut>
+<guimenu>View</guimenu>
+<guimenuitem>Zoom In</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Enlarges the image by ten percent</action>. Notice that
+this refers to the <emphasis>current</emphasis> size of the
+picture.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>View</guimenu>
+<guimenuitem>Zoom...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Opens a list to <action>choose the zoom
+factor</action>. This value is given in percent and always refers to the
+<emphasis>initial</emphasis> size of the picture.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><shortcut><keycombo action="simul">
+&Ctrl;<keycap>-</keycap></keycombo></shortcut>
+<guimenu>View</guimenu>
+<guimenuitem>Zoom Out</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Reduces the image size by ten percent</action>. Again
+this refers to the <emphasis>current</emphasis> size of the
+image.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>View</guimenu><guimenuitem>Fit Image
+to Window</guimenuitem></menuchoice></term>
+<listitem><para><action>Maximizes the image size</action>. The image is scaled
+to the window size, keeping the aspect
+ratio.</para></listitem>
+</varlistentry>
+</variablelist>
+
+</sect1>
+
+<sect1 id="go-menu">
+<title>The <guimenu>Go</guimenu> Menu</title>
+
+<para>This item is only displayed in the menubar, if you choose the 
+application plugin presenter in &kview;s configure dialog</para>
+
+<variablelist>
+<varlistentry>
+<term><menuchoice>
+<guimenu>Go</guimenu>
+<guimenuitem>Image List...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Displays a list of the currently loaded images.</action>
+You can flip through the images by either double-clicking on them or using the
+<guibutton>Previous</guibutton> and <guibutton>Next</guibutton>
+buttons. <guibutton>Shuffle</guibutton> rearranges the images in a random order. 
+Pressing
+<guibutton>Start Slideshow</guibutton> will start the slideshow with the current
+settings for the interval. In addition, you can save and load your image
+list using the corresponding buttons.
+<guilabel>Slideshow interval:</guilabel> <!--is guilabel correct? -->
+Here you can change the interval between the different slides for the slideshow.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><shortcut><keycap>S</keycap></shortcut>
+<guimenu>Go</guimenu>
+<guimenuitem>Start/Stop Slideshow</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Starts or stops the
+slideshow.</action></para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><shortcut><keycombo action="simul">
+&Alt;<keysym>Left Arrow</keysym></keycombo></shortcut>
+<guimenu>Go</guimenu>
+<guimenuitem>Previous Image in List</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Switches to the previous image in the
+list.</action></para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><shortcut><keycombo action="simul">
+&Alt;<keysym>Right Arrow</keysym></keycombo></shortcut>
+<guimenu>Go</guimenu>
+<guimenuitem>Next Image in List</guimenuitem></menuchoice></term>
+<listitem><para><action>Switches to the next item in the
+list.</action></para></listitem>
+</varlistentry>
+</variablelist>
+
+</sect1>
+
+<sect1 id="tools-menu">
+<title>The <guimenu>Tools</guimenu> Menu</title>
+
+<variablelist>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Scan Image...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Opens</action> images from your scanner into &kview;.
+This menu item is only displayed in the menubar, if you choose the 
+application plugin scanner in &kview;s configure dialog
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><shortcut><keycombo action="simul">
+&Shift;<keysym>Left Arrow</keysym></keycombo></shortcut>
+<guimenu>Tools</guimenu>
+<guimenuitem>Back</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Switches to the previous image in the current
+folder.</action></para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><shortcut><keycombo action="simul">
+&Shift;<keysym>Right Arrow</keysym></keycombo></shortcut>
+<guimenu>Tools</guimenu>
+<guimenuitem>Forward</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Switches to the next image in the current
+folder.</action></para></listitem>
+</varlistentry>
+</variablelist>
+
+</sect1>
+
+<sect1 id="settings-menu">
+<title>The <guimenu>Settings</guimenu> Menu</title>
+<para>This menu provides options for configuring &kview;, changing its
+appearance, shortcuts and standard behavior.</para>
+
+<variablelist>
+<varlistentry>
+<term><menuchoice><shortcut><keycombo action="simul">
+&Ctrl;<keycap>M</keycap></keycombo></shortcut>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show/Hide Menubar</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Toggles the menubar on/off.</action></para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><guimenu>Settings</guimenu>
+<guisubmenu>Toolbars</guisubmenu>
+<guimenuitem>Main Toolbar (KView)</guimenuitem>
+</menuchoice></term>
+<term><menuchoice><guimenu>Settings</guimenu>
+<guisubmenu>Toolbars</guisubmenu>
+<guimenuitem>Extra Toolbar (KView)</guimenuitem>
+</menuchoice></term>
+<listitem>
+<para>Toggles the main toolbar and the extra toolbar on and off
+respectively</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show/Hide Statusbar</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Toggles the status bar on/off.</action></para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show/Hide Scrollbars</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Toggles the Scrollbars on/off.</action></para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><shortcut><keycombo action="simul">&Ctrl;
+<keycap>&Shift;</keycap><keycap>F</keycap></keycombo></shortcut>
+<guimenu>Settings</guimenu>
+<guimenuitem>Fullscreen Mode</guimenuitem></menuchoice>
+</term>
+<listitem>
+<para>This option maximizes the &kview; window and the currently shown image so
+you can have a closer look at it. Even the window decorations (titlebar &etc;) are
+temporarily removed. Selecting this option once again switches back to normal
+mode.</para> 
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Configure Shortcuts...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Opens a dialog for changing the key bindings.</action>
+Using this option you can change the standard key shortcut for &kview;'s commands
+or create new ones.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Configure Toolbars...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Opens a dialog for configuring the toolbar.</action> You
+can add and remove toolbuttons for &kview;'s commands with this
+option.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Configure &kview;...</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Opens a dialog for changing some options</action> as
+described in the section <xref linkend="kview-options"/></para>
+</listitem>
+</varlistentry>
+</variablelist>
+</sect1>
+
+<sect1 id="help-menu">
+<title>The <guimenu>Help</guimenu> Menu</title>
+
+&help.menu.documentation;
+
+</sect1>
+</chapter>
+
+<chapter id="command-line">
+<title>Command Line Options</title>
+
+<para>&kview; can be started directly from a terminal like &konsole; or
+<application>xterm</application>. Several command line options are
+available.</para>
+
+<variablelist>
+<varlistentry>
+<term><command>kview</command> <option>--help</option></term>
+<listitem><para>Lists the command line options (see below).</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><command>kview</command> <option>--help-qt</option></term>
+<listitem><para>Shows the options specific to &Qt; (the &GUI;
+library that &kde; is based on).</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><command>kview</command> <option>--help-kde</option></term>
+<listitem><para>Shows the &kde;-specific options.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><command>kview</command> <option>--help-all</option></term>
+<listitem><para>Displays all command line options.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><command>kview</command> <option>--author</option></term>
+<listitem><para>You want to send your warm wishes and euphoric cheers to
+someone? Here they are!</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><command>kview</command> <option>-v</option>,
+<option>--version</option></term>
+<listitem><para>Displays the version number of &kview; (and that of
+&Qt;/&kde;).</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><command>kview</command> <option>--license</option></term>
+<listitem><para>Shows under which licenses &kview; is being
+published.</para></listitem>
+</varlistentry>
+</variablelist>
+</chapter>
+
+<chapter id="kview-options">
+<title>&kview; Options</title>
+
+<sect1 id="kview-options-viewer">
+<title><guilabel>Viewer</guilabel></title>
+
+<para>This is the configuration for the part of &kview; that can be reused 
+by other applications (meaning that the settings will also affect the &kview; 
+part that gets embedded into &konqueror; or other applications).</para>
+
+<screenshot>
+<screeninfo>&kview; viewer configuration dialog</screeninfo>
+<mediaobject>
+<imageobject><imagedata fileref="kview-viewer-configuration.png" format="PNG"/></imageobject>
+<textobject><phrase>&kview; viewer configuration dialog</phrase></textobject>
+</mediaobject>
+</screenshot>
+
+<variablelist>
+<title>General configuration options for KViewCanvas</title>
+<varlistentry>
+<term><guilabel>Use smooth scaling (high quality but
+slower)</guilabel></term>
+<listitem>
+<para>As the option suggests, use a very high quality but relatively slow
+method of scaling images.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Keep aspect ratio</guilabel></term>
+<listitem>
+<para>If this is checked &kview; will always try to keep the aspect
+ratio. That means if the width is scaled with a factor x, the height is
+scaled with the same factor.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Center image</guilabel></term>
+<listitem>
+<para>If checked, the opened image will be displayed centered to the &kview;
+window.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Background Color</guilabel></term>
+<listitem>
+<para>Opens a normal &kde; color picker dialog, where you can choose the
+background color for the image</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Minimum width:</guilabel></term>
+<listitem>
+<para>The width of the image shown will not get smaller than the size you
+enter here. A value of 10 would cause a 1x1 image to be stretched
+horizontally by a factor of 10.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Maximum width:</guilabel></term>
+<listitem>
+<para>The width of the image shown will not get bigger than the size you
+enter here. A value of 100 would cause a 1000x1000 image to be compressed
+horizontally  by a factor of 0.1.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Minimum height:</guilabel></term>
+<listitem>
+<para>The height of the image shown will not get smaller than the size you
+enter here. A value of 10 would cause a 1x1 image to be stretched vertically
+by a factor of 10. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Maximum height:</guilabel></term>
+<listitem>
+<para>The height of the image shown will not get bigger than the size you
+enter here. A value of 100 would cause a 1000x1000 image to be compressed
+vertically by a factor of 0.1. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Choose which blend effects should be used:</guilabel></term>
+<listitem>
+<para>Every effect selected may be used to create a transition effect
+between the images. If you select multiple effects they will be chosen
+randomly.
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<variablelist>
+<title><guilabel>Chooose and Configure Your Plugins</guilabel></title>
+<varlistentry>
+<term><guilabel>Browser</guilabel></term>
+<listitem>
+<para>Here you can enable/disable use of the browser &kview; plugin, which
+enables you to browse through all the images in the current folder.
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</sect1>
+
+<sect1 id="kview-options-application">
+<title><guilabel>Application</guilabel></title>
+
+<para>Here you can set options that are special for the &kview; application
+when running stand-alone. What you change in here will not affect other
+applications.</para>
+
+<screenshot>
+<screeninfo>&kview; application configuration dialog</screeninfo>
+<mediaobject>
+<imageobject><imagedata fileref="kview-application-configuration.png" format="PNG"/></imageobject>
+<textobject><phrase>&kview; application configuration dialog</phrase></textobject>
+</mediaobject>
+</screenshot>
+
+<variablelist>
+<title><guilabel>Application</guilabel></title>
+<varlistentry>
+<term><guilabel>Resizing</guilabel></term>
+<listitem><para>This option determines if the window and/or the image will be
+resized after loading a new picture into &kview;. With <guilabel>Only resize
+window</guilabel> enabled, the &kview; window will be resized so that it snuggly
+fits around the loaded image. Notice that this can reduce the main window almost
+to a vertical arrangement of menu entries if you load a small button pixmap (you
+can resize the window afterwards in the usual way, of course). If your image is
+pretty large (in terms of pixels), sometimes the &kview; window is resized in
+such a way that the caption bar completely moves off your screen. Similarly,
+<guilabel>Resize image to fit window</guilabel> resizes the image to fit into the &kview;
+workspace (keeping its aspect ratio intact). And with <guilabel>Don't
+resize anything</guilabel> as your choice, both &kview; and your image keep their
+size. With <guilabel>Best fit</guilabel>
+&kview; will resize the window to fit the image. The image will never be 
+scaled up but if it is too large for the screen the image will be scaled down.
+</para></listitem>
+</varlistentry>
+</variablelist>
+
+<variablelist>
+<title><guilabel>Plugins</guilabel></title>
+<varlistentry>
+<term><guilabel>Effects</guilabel></term>
+<listitem>
+<para>Provides some image effects (and adds an <guimenu>Effects</guimenu> to
+the menubar to give you access to them).</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Presenter</guilabel></term>
+<listitem>
+<para>Creates an image list and enables you to create a slideshow.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guilabel>Scanner</guilabel></term>
+<listitem>
+<para>Adds <guimenu>Scan Image...</guimenu> to the <guimenu>Tools</guimenu>
+menu to open images from your scanner into &kview;.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</sect1>
+
+</chapter>
+
+<chapter id="credits">
+<title>Credits and License</title>
+
+<para>&kview;</para>
+
+<para>Program copyright 1997-2001 Sirtaj S. Kang
+&Sirtaj.Singh.Kang.mail;</para>
+<para>KParts integration by &Simon.Hausmann;
+<email>[email protected]</email></para>
+<para>Maintainer: Matthias Kretz <email>[email protected]</email></para>
+<para>Documentation copyright 2001 &Hauke.Hildebrandt;
+&Hauke.Hildebrandt.mail;
+</para>
+
+<para>Documentation substantially updated by Burkhard Lück
+<email>[email protected]</email> in 2005 for &kde; 3.5</para>
+
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+&underFDL;               <!-- FDL: do not remove -->
+&underGPL;        	 <!-- GPL License -->
+
+</chapter>
+
+<appendix id="installation">
+<title>Installation</title>
+
+<sect1 id="getting-kview">
+<title>How to obtain &kview;</title>
+
+&install.intro.documentation;
+
+&install.compile.documentation;
+
+</sect1>
+
+<sect1 id="requirements">
+<title>Requirements</title>
+
+<para>Since &kview; is part of the &kde; desktop you need a working &kde;
+installation to use it. However, some additional libraries are needed by &kview;
+to use the various graphics file formats. For example, to handle the
+<acronym>PNG</acronym> format &kview; needs the corresponding library
+libpng. &kview; uses the libraries that are registered by
+kdelibs/kimgio.</para>
+
+</sect1>
+
+</appendix>
+
+&documentation.index;
+</book>
+<!--
+Local Variables:
+mode: sgml
+sgml-minimize-attributes: nil
+sgml-general-insert-case: lower
+End:
+-->
diff --git a/doc/kview/kview-application-configuration.png b/doc/kview/kview-application-configuration.png
new file mode 100644
index 00000000..0ba79356
--- /dev/null
+++ b/doc/kview/kview-application-configuration.png
diff --git a/doc/kview/kview-viewer-configuration.png b/doc/kview/kview-viewer-configuration.png
new file mode 100644
index 00000000..f2e6d8c2
--- /dev/null
+++ b/doc/kview/kview-viewer-configuration.png