From 67ced95378d984c30f53d33c14d7f7427de80f25 Mon Sep 17 00:00:00 2001
From: Colin Clark <cclark@mcb.net>
Date: Sun, 1 May 2016 17:44:01 +0100
Subject: [PATCH] Document toolbar enhancements

Update help file to describe how to put additional icons on the toolbar.

Requires re-work.
---
 doc/docbook/GuideReference.xml        |  1 +
 doc/docbook/GuideReferenceToolbar.xml | 24 ++++++++++++++++++++++++
 2 files changed, 25 insertions(+)
 create mode 100644 doc/docbook/GuideReferenceToolbar.xml

diff --git a/doc/docbook/GuideReference.xml b/doc/docbook/GuideReference.xml
index 66e38975..58702ca1 100644
--- a/doc/docbook/GuideReference.xml
+++ b/doc/docbook/GuideReference.xml
@@ -7,5 +7,6 @@
 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceKeyboardShortcuts.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceThumbnails.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceManagement.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="GuideReferenceToolbar.xml"/>
 
   <para/></chapter>
diff --git a/doc/docbook/GuideReferenceToolbar.xml b/doc/docbook/GuideReferenceToolbar.xml
new file mode 100644
index 00000000..cbe4e768
--- /dev/null
+++ b/doc/docbook/GuideReferenceToolbar.xml
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="utf-8"?>
+<section id="GuideReferenceToolbar">
+    <title>
+      Toolbar
+    </title>
+    <para/><section id="AddingIconsToToolbar"><title>How to set up new toolbar icons
+    </title>
+    <para>This section describes how to put additional icons on the toolbar.<para/>The functions these icons may initiate are as described in <link linkend="GuideImageManagementExternalEditing">External Editors</link>.
+    </para>
+    <para>
+      Edit the toolbar section of the file geeqierc.xml to include a reference to the new icon:</para>
+    <para><programlisting>
+    &lt;toolitem action = "new_icon_1.desktop" /&gt;
+    </programlisting></para><para>
+      Create a corresponding desktop file as described in <link linkend="GuideImageManagementExternalEditing">External Editors</link>.
+    </para>
+    <para/>
+    <para>Within the desktop file it is recommended that two additional items are included:</para>
+    <para><programlisting>Icon=new_icon_1.png</programlisting></para>
+    <para>The icon displayed. If an icon is not defined, it is likely that the display of the entire toolbar will be distorted by additional text.</para>
+    <para><programlisting>Comment=descriptive text</programlisting></para>
+    <para>The tooltip text displayed when the mouse is hovered over the icon.</para>
+    </section>
+</section>
-- 
2.20.1