From 55a0967f594b0ed2be8273c0bff901d9021f3666 Mon Sep 17 00:00:00 2001
From: Colin Clark <colin.clark@cclark.uk>
Date: Thu, 28 Dec 2023 15:45:49 +0000
Subject: [PATCH] Include Help file documentation for Open With

---
 doc/docbook/GuideMainWindowMenus.xml          | 10 ++-
 doc/docbook/GuideReferenceStandardPlugins.xml | 65 +++++++++++--------
 2 files changed, 46 insertions(+), 29 deletions(-)

diff --git a/doc/docbook/GuideMainWindowMenus.xml b/doc/docbook/GuideMainWindowMenus.xml
index 9edd15f0..5a7931e3 100644
--- a/doc/docbook/GuideMainWindowMenus.xml
+++ b/doc/docbook/GuideMainWindowMenus.xml
@@ -174,6 +174,14 @@
           <para>Renames the current file selection.</para>
         </listitem>
       </varlistentry>
+      <varlistentry>
+        <term>
+          <guimenu>Open With...</guimenu>
+        </term>
+        <listitem>
+          <para>Calls the standard GTK application chooser for a single file.</para>
+        </listitem>
+      </varlistentry>
       <varlistentry>
         <term>
           <menuchoice>
@@ -1488,7 +1496,7 @@
             </shortcut>
             <guimenu>Hide Bars and Files</guimenu>
           </menuchoice>
-         </term>
+        </term>
         <listitem>
           <para>This item is intended to be used by its shortcut key. When pressed, the info sidebar, sort manager, file list, menu and status bars will be hidden (if displayed). Pressing the shortcut key again will revert the display to its previous layout.</para>
         </listitem>
diff --git a/doc/docbook/GuideReferenceStandardPlugins.xml b/doc/docbook/GuideReferenceStandardPlugins.xml
index ec2dec1c..6f3298a8 100644
--- a/doc/docbook/GuideReferenceStandardPlugins.xml
+++ b/doc/docbook/GuideReferenceStandardPlugins.xml
@@ -2,15 +2,6 @@
 <section id="GuideReferenceStandardPlugins">
   <title id="titleGuideReferenceStandardPlugins">Standard Plugins</title>
   <para>The following plugins are supplied as standard with Geeqie.</para>
-  <section id="Symlink">
-    <title>Symlink</title>
-    <para>Creates a symbolic link on the selected files. If a file has sidecars, they will also be symlinked.</para>
-    <para>
-      This item is displayed in the
-      <emphasis role="strong">File</emphasis>
-      menu.
-    </para>
-  </section>
   <section id="Applytheorientationtoimagecontent">
     <title>Apply the orientation to image content</title>
     <para>This command affects only jpeg, tiff and png files. The image file on disk is rotated to the orientation as specified by its Exif Orientation tag.</para>
@@ -71,29 +62,18 @@
       menu.
     </para>
   </section>
-  <section id="Randomimage">
-    <title>Random image</title>
-    <para>Selects and displays a random image from a list of all images in Collections and the currently displayed folder.</para>
+  <section id="OpenWith">
+    <title>Open With</title>
+    <para>Call the standard GTK application chooser for a single file.</para>
     <para>
-      This item is displayed in the
-      <emphasis role="strong">Plugins</emphasis>
+      This item is also displayed in the
+      <emphasis role="strong">File</emphasis>
       menu.
     </para>
   </section>
-  <section id="Tetheredphotography">
-    <title>Tethered photography</title>
-    <para>
-      If a camera is connected to the computer via USB, photos taken are immediately downloaded to the current folder and displayed on the computer.
-      <para />
-      If a file already exists with the same name, it is not overwritten but the download will not take place.
-      <para />
-      Auto-rename can be achieved with the --filename option of gphoto2.
-      <para />
-      In file
-      <code>$HOME/.config/gphoto2/settings</code>
-      , set the option:
-      <code>gphoto2=filename=&lt;see the gphoto2 manual&gt;</code>
-    </para>
+  <section id="Randomimage">
+    <title>Random image</title>
+    <para>Selects and displays a random image from a list of all images in Collections and the currently displayed folder.</para>
     <para>
       This item is displayed in the
       <emphasis role="strong">Plugins</emphasis>
@@ -172,4 +152,33 @@
     </programlisting>
     <para />
   </section>
+  <section id="Symlink">
+    <title>Symlink</title>
+    <para>Creates a symbolic link on the selected files. If a file has sidecars, they will also be symlinked.</para>
+    <para>
+      This item is displayed in the
+      <emphasis role="strong">File</emphasis>
+      menu.
+    </para>
+  </section>
+  <section id="Tetheredphotography">
+    <title>Tethered photography</title>
+    <para>
+      If a camera is connected to the computer via USB, photos taken are immediately downloaded to the current folder and displayed on the computer.
+      <para />
+      If a file already exists with the same name, it is not overwritten but the download will not take place.
+      <para />
+      Auto-rename can be achieved with the --filename option of gphoto2.
+      <para />
+      In file
+      <code>$HOME/.config/gphoto2/settings</code>
+      , set the option:
+      <code>gphoto2=filename=&lt;see the gphoto2 manual&gt;</code>
+    </para>
+    <para>
+      This item is displayed in the
+      <emphasis role="strong">Plugins</emphasis>
+      menu.
+    </para>
+  </section>
 </section>
-- 
2.20.1