[graphics/kolourpaint] /: Add Zoom tool description

[Andrew Shark]

Git commit 0be0e379ede29e065534f05f58ff83ace1fee094 by Andrew Shark.
Committed on 04/07/2024 at 14:23.
Pushed by ashark into branch 'master'.

Add Zoom tool description

M  +31   -0    doc/index.docbook
A  +-    --    doc/tool_zoom.png
M  +2    -2    tools/kpToolZoom.cpp

https://invent.kde.org/graphics/kolourpaint/-/commit/0be0e379ede29e065534f05f58ff83ace1fee094

diff --git a/doc/index.docbook b/doc/index.docbook
index 818184c1..53ba6580 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -376,6 +376,19 @@ writing text (as the single key shortcuts will be disabled). For example, to sel
 </link>
 <link linkend="tool-text">Text</link> (T)
 </member>
+
+<member>
+<link linkend="tool-zoom">
+<guiicon>
+<inlinemediaobject>
+<imageobject>
+<imagedata fileref="tool_zoom.png" format="PNG"/>
+</imageobject>
+</inlinemediaobject>
+</guiicon>
+</link>
+<link linkend="tool-zoom">Zoom</link> (Z)
+</member>
 </simplelist>
 
 </sect1>
@@ -847,6 +860,24 @@ color.</para>
 </sect2>
 </sect1>
 
+<sect1 id="tool-zoom">
+<title>Zoom
+<inlinemediaobject>
+<imageobject>
+<imagedata fileref="tool_zoom.png" format="PNG"/>
+</imageobject>
+</inlinemediaobject>
+</title>
+
+<para>The &LMB; zooms in. The &RMB; zooms out.</para>
+<para>Drag with &LMB; to zoom into a specific area.</para>
+
+<tip>
+<para>Double click on the Zoom tool icon to set zoom to "Fit to Page".</para>
+</tip>
+
+</sect1>
+
 <sect1 id="tool-options">
 <title>Common Tool Options</title>
 
diff --git a/doc/tool_zoom.png b/doc/tool_zoom.png
new file mode 100644
index 00000000..94f08627
Binary files /dev/null and b/doc/tool_zoom.png differ
diff --git a/tools/kpToolZoom.cpp b/tools/kpToolZoom.cpp
index 169d9cd7..bea4a1f2 100644
--- a/tools/kpToolZoom.cpp
+++ b/tools/kpToolZoom.cpp
@@ -78,7 +78,7 @@ kpToolZoom::kpToolZoom (kpToolEnvironment *environ, QWidget *parent)
       d (new kpToolZoomPrivate ())
 {
   // different from objectName()
-  action()->setIcon(QIcon::fromTheme(QStringLiteral("zoom-original")));
+  action()->setIcon(QIcon::fromTheme(QStringLiteral("zoom")));
 }
 
 //---------------------------------------------------------------------
@@ -116,7 +116,7 @@ bool kpToolZoom::returnToPreviousToolAfterEndDraw () const
 // private
 QString kpToolZoom::haventBegunDrawUserMessage () const
 {
-    return i18n ("Click to zoom in/out or left drag to zoom into a specific area.");
+    return xi18nc("@info", "Click to zoom in. Right-click to zoom out. Drag to zoom into a specific area.");
 }