3 files changed, 1087 insertions, 0 deletions
diff --git a/doc/kiconedit/Makefile.am b/doc/kiconedit/Makefile.am
new file mode 100644
index 00000000..085981d9
--- /dev/null
+++ b/doc/kiconedit/Makefile.am
@@ -0,0 +1,4 @@
+
+KDE_LANG = en
+KDE_DOCS = AUTO
+
diff --git a/doc/kiconedit/index.docbook b/doc/kiconedit/index.docbook
new file mode 100644
index 00000000..92bc8bc3
--- /dev/null
+++ b/doc/kiconedit/index.docbook
@@ -0,0 +1,1083 @@
+<?xml version="1.0" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+  <!ENTITY kappname "&kiconedit;">
+  <!ENTITY package "kdegraphics">
+  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
+  <!ENTITY % addindex "IGNORE">
+]>
+
+<book lang="&language;">
+<bookinfo>
+<title>The &kiconedit; Manual</title>
+<authorgroup>
+<author>
+<firstname>Thomas</firstname>
+<surname>Tanghus</surname>
+<affiliation>
+<address>&Thomas.Tanghus.mail;</address>
+</affiliation>
+</author>
+
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+
+</authorgroup>
+
+<copyright>
+<year>1997</year>
+<holder>&Thomas.Tanghus;</holder>
+</copyright>
+<copyright>
+<year>2001</year><year>2003</year>
+<holder>&Lauri.Watts;</holder>
+</copyright>
+
+<legalnotice>
+&FDLNotice;
+</legalnotice>
+
+<date>2005-12-10</date>
+<releaseinfo>3.5.0</releaseinfo>
+
+<abstract>
+<para>
+&kiconedit; is designed to help create icons for &kde; using the
+standard icon palette.
+</para>
+</abstract>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>kdegraphics</keyword>
+<keyword>KIconEdit</keyword>
+<keyword>icon</keyword>
+</keywordset>
+</bookinfo>
+
+<chapter id="Introduction">
+<title>Introduction</title>
+
+<blockquote>
+<attribution>&Thomas.Tanghus;
+&Thomas.Tanghus.mail;</attribution>
+
+<para>
+&kiconedit; is designed to help create icons for &kde; using the
+standard icon palette.
+</para>
+
+<para>
+I hope you will find this program somehow useful and I would
+appreciate any suggestions and comments.
+</para>
+
+</blockquote>
+
+</chapter>
+
+<chapter id="onscreen-fundamentals">
+<title>Onscreen Fundamentals</title>
+
+<para>
+In this section will be briefly described the Icon Editor user
+interface.
+</para>
+
+<para>
+The Icon Editor window is separated in five areas: main toolbar, tools
+toolbar, statusbar, color palette and the grid, where you paint the icon.
+</para>
+
+<sect1 id="main-toolbar">
+<title>Main Toolbar</title>
+
+<variablelist>
+
+<varlistentry>
+<term><guiicon>New</guiicon></term>
+<listitem>
+<para>
+<action>Create a new icon.</action> If the current file has been
+modified you will be asked if you want to save the changes. After that a
+dialog will open where you can choose to create the icon from scratch or
+from a template.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guiicon>Open</guiicon></term>
+<listitem>
+<para>
+<action>Open an existing icon file.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guiicon>Save</guiicon></term>
+<listitem>
+<para>
+<action>Save the currently open icon.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guiicon>Print</guiicon></term>
+<listitem>
+<para>
+<action>Print the icon.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guiicon>Undo</guiicon></term>
+<listitem><para>Undo the last action</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guiicon>Redo</guiicon></term>
+<listitem><para>Redo the last action undone.  If no actions have been
+undone, this action is disabled.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guiicon>Cut</guiicon></term>
+<listitem>
+<para>
+<action>Cuts out the entire icon and put it onto the clipboard.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guiicon>Copy</guiicon></term>
+<listitem>
+<para>
+<action>Copies the entire icon to the clipboard.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guiicon>Paste</guiicon></term>
+<listitem>
+<para>
+<action>Paste the contents of the clipboard as a new image (if the
+clipboard contains a valid icon).</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guiicon>Zoom</guiicon></term>
+<term><guiicon>Zoom In</guiicon></term>
+<term><guiicon>Zoom Out</guiicon></term>
+<listitem>
+<para>
+<action>Zoom to predefined zoom factor, zoom in or zoom out.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guiicon>Resize</guiicon></term>
+<listitem>
+<para>
+<action>Resize icon to width X height.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><action>GrayScale</action></term>
+<listitem>
+<para>
+<action>Gray scale the icon image.</action> This may create colors not
+conformant to the &kde; icon palette.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guiicon>Show Grid</guiicon></term>
+<listitem>
+<para>
+<action>Toggle grid on/off.</action>
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect1>
+
+<sect1 id="tools-toolbar">
+<title>Tools Toolbar</title>
+
+<para>
+This toolbar contains the tools you can use to manipulate the
+icon.
+</para>
+
+<variablelist>
+<varlistentry>
+<term><guiicon>Freehand</guiicon></term>
+<listitem>
+<para>
+<action>Draw free hand.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guiicon>Color Picker</guiicon></term>
+<listitem>
+<para>
+Doesn't change the icon but <action>changes the current drawcolor to the
+color clicked on.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guiicon>Rectangle</guiicon></term>
+<listitem>
+<para>
+<action>Draw a rectangle.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guiicon>Filled Rectangle</guiicon></term>
+<listitem>
+<para>
+<action>Draw a filled rectangle.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guiicon>Circle</guiicon></term>
+<listitem>
+<para>
+<action>Draw a circle.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guiicon>Filled Circle</guiicon></term>
+<listitem>
+<para>
+<action>Draw a filled circle.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guiicon>Ellipse</guiicon></term>
+<listitem>
+<para>
+<action>Draw an ellipse</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guiicon>Filled Ellipse</guiicon></term>
+<listitem>
+<para>
+<action>Draw a filled ellipse</action> (almost the same thing as drawing
+a circle.)
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guiicon>Spray</guiicon></term>
+<listitem>
+<para>
+<action>Draws a randow dotted pattern like a spraycan.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guiicon>Flood Fill</guiicon></term>
+<listitem>
+<para>
+<action>Fill an area with the current color.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guiicon>Line</guiicon></term>
+<listitem>
+<para>
+<action>Draw a line.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guiicon>Eraser (Transparent)</guiicon></term>
+<listitem>
+<para>
+<action>Draw transparent (invisible).</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><guiicon>Rectangular Selection</guiicon></term>
+<term><guiicon>Circular Selection</guiicon></term>
+<listitem>
+<para>
+<action>Select (mark) a part of the icon.</action>
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect1>
+
+<sect1 id="grid">
+<title>Grid</title>
+
+<para>
+The grid is where you manipulate the icon contents.
+</para>
+</sect1>
+
+<sect1 id="statusbar">
+<title>Statusbar</title>
+
+<para>
+The status bar keeps you informed of current operations.  From left to
+right, it tells you the x,y coordinates of the pixel you are working on,
+the size of the current canvas, the zoom factor, and the current number
+of colors in the icon.
+</para>
+
+</sect1>
+</chapter>
+
+<chapter id="the-menu-entries">
+<title>The Menu Entries</title>
+
+<sect1 id="file">
+<title>The <guimenu>File</guimenu> Menu</title>
+
+<para>
+The following functions are available from the <guimenu>File</guimenu>
+menu:
+</para>
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>New</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Lets you create a new icon</action>, either from a template or
+by specifying the size.
+</para> 
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>File</guimenu>
+<guimenuitem>New Window</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Open a new Icon Editor window.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Open...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Open an existing icon file.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>File</guimenu>
+<guisubmenu>Open Recent</guisubmenu>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Displays a list of recently opened icons to choose
+from.</action>
+</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 currently open icon.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>File</guimenu>
+<guimenuitem>Save As...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Save the currently open icon under a new name.</action>
+</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>Print the icon</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>Close</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Close</action> &kiconedit;.
+</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect1>
+
+<sect1 id="edit">
+<title>The <guimenu>Edit</guimenu> Menu</title>
+
+<para>
+The <guimenu>Edit</guimenu> menu contains the following entries:
+</para>
+
+<variablelist>
+
+<varlistentry>
+<term><menuchoice><shortcut><keycombo
+action="simul">&Ctrl;<keycap>Z</keycap></keycombo></shortcut>
+<guimenu>Edit</guimenu><guimenuitem>Undo</guimenuitem>
+</menuchoice></term>
+<listitem><para>Undo the last action</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><shortcut><keycombo action="simul">
+&Ctrl;&Shift;<keycap>Z</keycap></keycombo></shortcut>
+<guimenu>Edit</guimenu><guimenuitem>Redo</guimenuitem></menuchoice></term>
+<listitem><para>Redo the last action undone.  If no actions have been
+undone, this action is disabled.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Cut</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Cuts out the entire icon and put it onto the clipboard.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<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 the entire icon to the clipboard.</action>
+</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 the contents of the clipboard (if the clipboard contains a
+valid icon).</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Paste as New</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Paste the contents of the clipboard as a new image into a new Icon Editor window (if the
+clipboard contains a valid icon).</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Edit</guimenu>
+<guimenuitem>Clear</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Clear the grid and fill it with transparent color.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo>
+</shortcut>
+<guimenu>Edit</guimenu>
+<guimenuitem>Select All</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Marks the entire icon as selected.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Resize...</guimenuitem>
+</menuchoice></term>
+<listitem><para>
+<action>Resize icon to width X height.</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><guimenu>Edit</guimenu><guimenuitem>GrayScale</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Gray scale the icon image.</action> This may
+create colors not conformant to the &kde; icon palette.</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect1>
+
+<sect1 id="view">
+<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>Magnify the view of the icon</action>.
+</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>Shrink the view icon to a smaller screen size</action>
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>View</guimenu>
+<guisubmenu>Zoom</guisubmenu>
+</menuchoice>
+</term>
+<listitem>
+<para>Zoom to a predefined zoom factor</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect1>
+
+<sect1 id="tools">
+<title>The <guimenu>Tools</guimenu> Menu</title>
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Freehand</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+Draw free hand.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><guimenu>Tools</guimenu><guimenuitem>Color
+Picker</guimenuitem></menuchoice></term>
+<listitem><para>Select a color from the screen to use as the
+foreground color.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Rectangle</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+Draw a rectangle.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Filled Rectangle</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+Draw a filled rectangle.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Circle</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+Draw a circle.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Filled Circle</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+Draw a filled circle.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Ellipse</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+Draw an ellipse
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Filled Ellipse</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Draw a filled ellipse</action> (almost the same thing as drawing
+a circle.)
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Spray</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+Draws a random dotted pattern like a spraycan.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Flood Fill</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+Fill an area with the current color.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Line</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+Draw a line.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Tools</guimenu>
+<guimenuitem>Eraser (Transparent)</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>Draw transparent (invisible).</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice><guimenu>Tools</guimenu>
+<guimenuitem>Rectangular Selection</guimenuitem></menuchoice></term>
+<term><menuchoice><guimenu>Tools</guimenu>
+<guimenuitem>Circular Selection</guimenuitem></menuchoice></term>
+<listitem><para><action>Select (mark) a part of the icon.</action>
+</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect1>
+
+<sect1 id="settings">
+<title>The <guimenu>Settings</guimenu> Menu</title>
+
+<variablelist>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Toolbars</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Toggle on and off the display of the toolbars.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show/Hide Statusbar</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Toggle on and off the display of the status bar.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Show/Hide Grid</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+<action>Toggle on and off the grid.</action>
+</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><menuchoice><guimenu>Settings</guimenu>
+<guimenuitem>Configure Shortcuts...</guimenuitem>
+</menuchoice></term>
+<listitem><para>Opens a dialog where you can customize &kiconedit;'s
+keyboard shortcuts.</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Configure &kiconedit;...</guimenuitem>
+</menuchoice>
+</term>
+<listitem>
+<para>
+Opens the &kiconedit; <link linkend="configuration">configuration
+dialog</link> configuration dialog, described separately.
+</para>
+</listitem>
+</varlistentry>
+
+
+</variablelist>
+
+</sect1>
+
+<sect1 id="help">
+<title>The <guimenu>Help</guimenu> Menu</title>
+
+&help.menu.documentation;
+
+</sect1>
+</chapter>
+
+<chapter id="configuration">
+<title>Configuration</title>
+
+<sect1>
+<title>Configuring &kiconedit;</title>
+<para>Selecting the <menuchoice><guimenu>Settings</guimenu>
+<guimenuitem>Configure &kiconedit;...</guimenuitem></menuchoice> menu item will
+open a configuration dialog with the tree tabs <guilabel>Icon Templates</guilabel>,
+<guilabel>Background</guilabel> and <guilabel>Icon Grid</guilabel>.</para>
+
+<screenshot>
+<screeninfo>&kiconedit; configuration dialog</screeninfo>
+<mediaobject>
+<imageobject><imagedata fileref="kiconedit-configuration.png" format="PNG"/></imageobject>
+<textobject><phrase>&kiconedit; configuration dialog</phrase></textobject>
+</mediaobject>
+</screenshot>
+
+<sect2 id="icon-templates-tab">
+<title>The <guilabel>Icon Templates</guilabel> Tab</title>
+<para><guilabel>Add...</guilabel>, <guilabel>Edit...</guilabel> and <guilabel>Remove</guilabel>
+the templates for <guilabel>Standard File</guilabel>, <guilabel>Source File</guilabel>, 
+<guilabel>Compressed File</guilabel> &etc;.</para>
+</sect2>
+<sect2 id="background-tab">
+<title>The <guilabel>Background</guilabel> Tab</title>
+<para>Select to <guibutton>Use color</guibutton> or to <guibutton>Use pixmap</guibutton>
+as background.  A <guilabel>Preview</guilabel> of your choice is displayed.</para>
+</sect2>
+<sect2 id="icon-grid-tab">
+<title>The <guilabel>Icon Grid</guilabel> Tab</title>
+<para>Select to <guilabel>Paste transparent pixels</guilabel> or <guilabel>Show rulers</guilabel>
+and set a <guilabel>Solid Color</guilabel> or a <guilabel>Checkerboard</guilabel> as 
+<guilabel>Transparency Display</guilabel>.
+You can set the Checkerboard <guilabel>Size:</guilabel> to <guilabel>Small</guilabel>, 
+<guilabel>Medium</guilabel> or <guilabel>Large</guilabel> and choose <guilabel>Color 1:</guilabel> 
+and <guilabel>Color 2:</guilabel> of the checkerboard.</para>
+</sect2>
+</sect1>
+
+</chapter>
+
+<chapter id="credits-and-license">
+<title>Credits and Licenses</title>
+
+<para>
+&kiconedit;
+</para>
+
+<para>
+Program copyright &Thomas.Tanghus; <email>tanghus@kde.org</email>
+</para>
+
+<itemizedlist>
+<title>Contributors</title>
+<listitem>
+<para>
+John Califf <email>jcaliff@compuzone.net</email>
+</para>
+</listitem>
+<listitem>
+<para>
+Laurent Montel <email>lmontel@mandrakesoft.com</email>
+</para>
+</listitem>
+<listitem><para>Aaron Seigo  &Aaron.J.Seigo.mail;</para></listitem>
+<listitem><para>Nadeem Hassan <email>nhasan@nadmm.com</email> - Rewrote UI to use
+XMLGUI, Lots of fixes and cleanup</para></listitem>
+<listitem><para>Adrian Page <email>Adrian.Page@tesco.net</email> - Bug Fixes and &GUI; tidy up.</para></listitem>
+
+
+</itemizedlist>
+
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+
+&underFDL; 
+&underGPL;
+
+</chapter>
+
+<appendix id="installation">
+<title>Installation</title>
+
+<sect1 id="how-to-obtain-the-icon-editor">
+<title>How to obtain &kiconedit;</title>
+
+&install.intro.documentation;
+
+</sect1>
+
+<sect1 id="compilation-and-installation">
+<title>Compilation and Installation</title>
+
+&install.compile.documentation;
+
+</sect1>
+
+<!-- 
+<sect1 id="configuration">
+<title>Configuration</title>
+
+</sect1>
+
+-->
+</appendix>
+
+
+</book>
+
+<!--
+Local Variables:
+mode: sgml
+sgml-indent-step:0
+sgml-indent-data:nil
+sgml-omittag:nil
+sgml-shorttag:t
+End:
+-->
+
diff --git a/doc/kiconedit/kiconedit-configuration.png b/doc/kiconedit/kiconedit-configuration.png
new file mode 100644
index 00000000..100a68cb
--- /dev/null
+++ b/doc/kiconedit/kiconedit-configuration.png