[gimp-help] Add more details to the View/Flip & Rotate submenu

[Jacob Boerema <jboerema src gnome org>]

commit 220c4a4fcdce0659b132be66ff78a9de73ca1c1f
Author: Jacob Boerema <jgboerema gmail com>
Date:   Sun May 29 16:13:15 2022 -0400

    Add more details to the View/Flip & Rotate submenu
    
    Updated image since it had one missing menu command and added sub
    sections for all commands with their help id's, that way we don't get
    missing help.
    
    (cherry picked from commit d8766a556818b2009514d1dc8d43e7bb42673808)

 images/C/menus/view/flip-rotate.png | Bin 16403 -> 6122 bytes
 src/menus/view/flip-rotate.xml      | 244 +++++++++++++++++++++++++++++++-----
 2 files changed, 212 insertions(+), 32 deletions(-)
---
diff --git a/images/C/menus/view/flip-rotate.png b/images/C/menus/view/flip-rotate.png
index 9cb532243..eb36b477e 100644
Binary files a/images/C/menus/view/flip-rotate.png and b/images/C/menus/view/flip-rotate.png differ
diff --git a/src/menus/view/flip-rotate.xml b/src/menus/view/flip-rotate.xml
index 9c488de85..747869e1b 100644
--- a/src/menus/view/flip-rotate.xml
+++ b/src/menus/view/flip-rotate.xml
@@ -5,27 +5,23 @@
   2017-03-07 j.h: created
 -->
 <sect2 id="gimp-view-flip-rotate">
-  <title>Flip and Rotate (0°)</title>
+  <title>Flip &amp; Rotate (0°)</title>
 
   <indexterm>
-    <primary>Flip and Rotate</primary>
+    <primary>Flip &amp; Rotate</primary>
   </indexterm>
 
   <para>
-    You can access this command from the image menubar through
+    You can access this submenu from the menu:
     <menuchoice>
       <guimenu>View</guimenu>
-      <guimenuitem>Flip and Rotate (0°)</guimenuitem>
+      <guimenuitem>Flip &amp; Rotate (0°)</guimenuitem>
     </menuchoice>,
   </para>
 
-  <para>
-    This command opens a submenu:
-  </para>
-
   <figure>
     <title>
-      The <quote>Flip and Rotate</quote> submenu
+      The <quote>Flip &amp; Rotate</quote> submenu
     </title>
     <mediaobject>
       <imageobject>
@@ -36,28 +32,212 @@
   </figure>
 
   <para>
-    These commands act on the view, not on the image. To act on the image, go 
-    to: <guimenu>Image</guimenu> <guimenuitem>Transform</guimenuitem>.
-  </para>
-  <para>
-    These commands are self-explanatory. Please note the <quote>!</quote> 
-    shortcut for the <guilabel>Reset Flip and Rotate</guilabel> command, which 
-    restores the image in its original state.
-  </para>
-  <para>
-    The <guilabel>Other…</guilabel> command opens a dialog that allows you to 
-    set a precise angle for the rotation of the view:
-    <figure>
-      <title>
-        The <quote>Select Rotation Angle</quote> dialog
-      </title>
-      <mediaobject>
-        <imageobject>
-          <imagedata format="PNG"
-            fileref="images/menus/view/select-rotation-angle.png"/>
-        </imageobject>
-      </mediaobject>
-    </figure>
+    These commands change the view only, not on the image itself. If you want
+    to change the image, go to: menu<link
+    linkend="gimp-image-transform">Image - Transform</link>.
   </para>
+
+  <sect3 id="gimp-view-rotate-reset">
+    <title>Reset Flip &amp; Rotate</title>
+    <para>
+      This command restores the view of the image to its original state.
+    </para>
+    <para>
+      Activate:
+    </para>
+    <itemizedlist>
+      <listitem>
+        <para>
+          From the menu:
+          <menuchoice>
+            <guimenu>View</guimenu>
+            <guisubmenu>Flip &amp; Rotate (0°)</guisubmenu>
+            <guimenuitem>Reset Flip &amp; Rotate</guimenuitem>
+          </menuchoice>.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Using the shortcut key <keycap>!</keycap>.
+        </para>
+      </listitem>
+    </itemizedlist>
+  </sect3>
+
+  <sect3 id="gimp-view-flip">
+    <title><quote>Flip Horizontally</quote> and <quote>Flip Vertically</quote></title>
+    <para>
+      These commands change the view by flipping the image horizontally or
+      vertically. If one of these is enabled you will see a check mark
+      in front of the command.
+    </para>
+    <para>
+      Activate:
+    </para>
+    <itemizedlist>
+      <listitem>
+        <para>
+          <menuchoice>
+            <guimenu>View</guimenu>
+            <guisubmenu>Flip &amp; Rotate (0°)</guisubmenu>
+            <guimenuitem>Flip Horizontally</guimenuitem>
+          </menuchoice>.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          <menuchoice>
+            <guimenu>View</guimenu>
+            <guisubmenu>Flip &amp; Rotate (0°)</guisubmenu>
+            <guimenuitem>Flip Vertically</guimenuitem>
+          </menuchoice>.
+        </para>
+      </listitem>
+    </itemizedlist>
+  </sect3>
+
+  <sect3 id="gimp-view-rotate-15">
+    <title>Rotate 15° clockwise</title>
+    <para>
+      This command rotates the view of the image 15° clockwise.
+    </para>
+    <para>
+      Activate:
+    </para>
+    <itemizedlist>
+      <listitem>
+        <para>
+          From the menu:
+          <menuchoice>
+            <guimenu>View</guimenu>
+            <guisubmenu>Flip &amp; Rotate (0°)</guisubmenu>
+            <guimenuitem>Rotate 15° clockwise</guimenuitem>
+          </menuchoice>.
+        </para>
+      </listitem>
+    </itemizedlist>
+  </sect3>
+
+  <sect3 id="gimp-view-rotate-345">
+    <title>Rotate 15° counter-clockwise</title>
+    <para>
+      This command rotates the view of the image 15° counter-clockwise.
+    </para>
+    <para>
+      Activate:
+    </para>
+    <itemizedlist>
+      <listitem>
+        <para>
+          From the menu:
+          <menuchoice>
+            <guimenu>View</guimenu>
+            <guisubmenu>Flip &amp; Rotate (0°)</guisubmenu>
+            <guimenuitem>Rotate 15° counter-clockwise</guimenuitem>
+          </menuchoice>.
+        </para>
+      </listitem>
+    </itemizedlist>
+  </sect3>
+
+  <sect3 id="gimp-view-rotate-90">
+    <title>Rotate 90° clockwise</title>
+    <para>
+      This command rotates the view of the image 90° clockwise.
+    </para>
+    <para>
+      Activate:
+    </para>
+    <itemizedlist>
+      <listitem>
+        <para>
+          From the menu:
+          <menuchoice>
+            <guimenu>View</guimenu>
+            <guisubmenu>Flip &amp; Rotate (0°)</guisubmenu>
+            <guimenuitem>Rotate 90° clockwise</guimenuitem>
+          </menuchoice>.
+        </para>
+      </listitem>
+    </itemizedlist>
+  </sect3>
+
+  <sect3 id="gimp-view-rotate-270">
+    <title>Rotate 90° counter-clockwise</title>
+    <para>
+      This command rotates the view of the image 90° counter-clockwise.
+    </para>
+    <para>
+      Activate:
+    </para>
+    <itemizedlist>
+      <listitem>
+        <para>
+          From the menu:
+          <menuchoice>
+            <guimenu>View</guimenu>
+            <guisubmenu>Flip &amp; Rotate (0°)</guisubmenu>
+            <guimenuitem>Rotate 90° counter-clockwise</guimenuitem>
+          </menuchoice>.
+        </para>
+      </listitem>
+    </itemizedlist>
+  </sect3>
+
+  <sect3 id="gimp-view-rotate-180">
+    <title>Rotate 180°</title>
+    <para>
+      This command rotates the view of the image 180°.
+    </para>
+    <para>
+      Activate:
+    </para>
+    <itemizedlist>
+      <listitem>
+        <para>
+          From the menu:
+          <menuchoice>
+            <guimenu>View</guimenu>
+            <guisubmenu>Flip &amp; Rotate (0°)</guisubmenu>
+            <guimenuitem>Rotate 180°</guimenuitem>
+          </menuchoice>.
+        </para>
+      </listitem>
+    </itemizedlist>
+  </sect3>
+
+  <sect3 id="gimp-view-rotate-other">
+    <title>Other rotation angle…</title>
+    <para>
+      This command opens a dialog that allows you to set the exact angle of
+      rotation for the view. You can set the angle in the numeric input
+      field, or drag the pointer in the circle to the desired angle.
+    </para>
+    <para>
+      Activate:
+    </para>
+    <itemizedlist>
+      <listitem>
+        <para>
+          From the menu:
+          <menuchoice>
+            <guimenu>View</guimenu>
+            <guisubmenu>Flip &amp; Rotate (0°)</guisubmenu>
+            <guimenuitem>Other rotation angle…</guimenuitem>
+          </menuchoice>.
+        </para>
+        <figure>
+          <title>
+            The <quote>Select Rotation Angle</quote> dialog
+          </title>
+          <mediaobject>
+            <imageobject>
+              <imagedata format="PNG"
+                fileref="images/menus/view/select-rotation-angle.png"/>
+            </imageobject>
+          </mediaobject>
+        </figure>
+          </listitem>
+    </itemizedlist>
+  </sect3>
 </sect2>
-      
\ No newline at end of file