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

[Jacob Boerema <jboerema src gnome org>]

commit d8766a556818b2009514d1dc8d43e7bb42673808
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.

 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