Fix #492: Shortcut to Hide all sidebars simultaneously
[geeqie.git] / doc / docbook / GuideMainWindowMenus.xml
index 8c13af8..a0ee585 100644 (file)
       </varlistentry>\r
       <varlistentry>\r
         <term>\r
-          <guimenu>Find duplicates…</guimenu>\r
+          <menuchoice>\r
+            <shortcut>\r
+              <keycombo>\r
+                <keycap>D</keycap>\r
+              </keycombo>\r
+            </shortcut>\r
+            <guimenu>Find duplicates...</guimenu>\r
+          </menuchoice>\r
         </term>\r
         <listitem>\r
           <para>Opens a new Find Duplicates window.</para>\r
           <menuchoice>\r
             <shortcut>\r
               <keycombo>\r
-                <keycap>4</keycap>\r
+                <keycap>Backspace</keycap>\r
               </keycombo>\r
             </shortcut>\r
             <guimenu>Previous Image</guimenu>\r
       <varlistentry>\r
         <term>\r
           <menuchoice>\r
+            <shortcut>\r
+              <keycombo>\r
+                <keycap>Ctrl</keycap>\r
+                <keycap>A</keycap>\r
+              </keycombo>\r
+            </shortcut>\r
             <guimenu>Select all</guimenu>\r
           </menuchoice>\r
         </term>\r
       <varlistentry>\r
         <term>\r
           <menuchoice>\r
+            <shortcut>\r
+              <keycombo>\r
+                <keycap>Ctrl</keycap>\r
+                <keycap>Shift</keycap>\r
+                <keycap>A</keycap>\r
+              </keycombo>\r
+            </shortcut>\r
             <guimenu>Select none</guimenu>\r
           </menuchoice>\r
         </term>\r
       <varlistentry>\r
         <term>\r
           <menuchoice>\r
-            <guimenu>Invert Selection</guimenu>\r
+            <shortcut>\r
+              <keycombo>\r
+                <keycap>Ctrl</keycap>\r
+                <keycap>Shift</keycap>\r
+                <keycap>I</keycap>\r
+              </keycombo>\r
+            </shortcut>\r
+            <guimenu>Invert selection</guimenu>\r
           </menuchoice>\r
         </term>\r
         <listitem>\r
           <para>Inverts current selection</para>\r
         </listitem>\r
       </varlistentry>\r
+      <varlistentry>\r
+        <term>\r
+          <menuchoice>\r
+            <shortcut>\r
+              <keycombo>\r
+                <keycap>Alt</keycap>\r
+                <keycap>R</keycap>\r
+              </keycombo>\r
+            </shortcut>\r
+            <guimenu>Rectangular selection</guimenu>\r
+          </menuchoice>\r
+        </term>\r
+        <listitem>\r
+          <para>Toggles rectangular selection mode for icons</para>\r
+        </listitem>\r
+      </varlistentry>\r
       <varlistentry>\r
         <term>\r
           <menuchoice>\r
       <varlistentry>\r
         <term>\r
           <menuchoice>\r
+            <shortcut>\r
+              <keycombo>\r
+                <keycap>M</keycap>\r
+              </keycombo>\r
+            </shortcut>\r
             <guimenu>Show marks</guimenu>\r
           </menuchoice>\r
         </term>\r
         </term>\r
         <listitem>\r
           <para>Swaps the top and bottom sides of the image, does not modify the file on disk.</para>\r
+          <warning>\r
+            <para>\r
+              The above orientation commands - Rotate, Mirror and Flip - do not change the image on disk. The changes will be lost when Geeqie closes. Refer to the\r
+              <link linkend="MetadataMiscellaneous">Metadata tab of the Preferences Dialog</link>\r
+              if you wish these changes to be written to metadata.\r
+            </para>\r
+            <para>\r
+              Refer also to the\r
+              <link linkend="HowdotheExifauto-rotationcommandswork">FAQ</link>\r
+              .\r
+            </para>\r
+          </warning>\r
         </listitem>\r
       </varlistentry>\r
       <varlistentry>\r
           </menuchoice>\r
         </term>\r
         <listitem>\r
-          <para>Removes all effects applied through the Adjust menu, reverting image to its original state.</para>\r
+          <para>Removes all temporary effects applied through the above commands, reverting the image according to its Exif Orientation tag.</para>\r
+        </listitem>\r
+      </varlistentry>\r
+      <varlistentry>\r
+        <term>\r
+          <guilabel>Auto rotate image using EXIF information</guilabel>\r
+        </term>\r
+        <listitem>\r
+          <para>\r
+            Auto rotates images based on metadata stored in images that have Exif data. Refer also to the\r
+            <link linkend="HowdotheExifauto-rotationcommandswork">FAQ</link>\r
+            .\r
+          </para>\r
         </listitem>\r
       </varlistentry>\r
       <varlistentry>\r
           </menuchoice>\r
         </term>\r
         <listitem>\r
-          The commands above modifies image metadata only. This commands actually transforms image pixels. See\r
-          <link linkend="GuideImageManagementExternalEditing">Editors section</link>\r
-          for details\r
+          <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>\r
+          <warning>\r
+            <para>\r
+              The file rotate.desktop, using external commands exiftran, exiv2 and mogrify, is used to implement this command. Refer to\r
+              <link linkend="GuideImageManagementExternalEditing">Editors section</link>\r
+              for details.\r
+            </para>\r
+          </warning>\r
+        </listitem>\r
+      </varlistentry>\r
+      <varlistentry>\r
+        <term>\r
+          <menuchoice>\r
+            <shortcut>\r
+              <keycombo>\r
+                <keycap>[</keycap>\r
+              </keycombo>\r
+            </shortcut>\r
+            <guimenu>Orientation</guimenu>\r
+            <guimenuitem>Rotate counterclockwise</guimenuitem>\r
+          </menuchoice>\r
+        </term>\r
+        <listitem>\r
+          <para>Rotates the current image counterclockwise 90 degrees, does not modify the file on disk.</para>\r
+        </listitem>\r
+      </varlistentry>\r
+      <varlistentry>\r
+        <term>\r
+          <menuchoice>\r
+            <shortcut>\r
+              <keycombo>\r
+                <keycap>Shift</keycap>\r
+                <keycap>R</keycap>\r
+              </keycombo>\r
+            </shortcut>\r
+            <guimenu>Orientation</guimenu>\r
+            <guimenuitem>Rotate 180</guimenuitem>\r
+          </menuchoice>\r
+        </term>\r
+        <listitem>\r
+          <para>Rotates the current image 180 degrees, does not modify the file on disk.</para>\r
+        </listitem>\r
+      </varlistentry>\r
+      <varlistentry>\r
+        <term>\r
+          <menuchoice>\r
+            <guimenu>Orientation</guimenu>\r
+            <guimenuitem>Write orientation to file</guimenuitem>\r
+          </menuchoice>\r
+        </term>\r
+        <listitem>\r
+          <para>\r
+            Saves the current image orientation to the disk file. This operation can only be carried out on jpeg, tiff and png files. Jpeg rotations are lossless.\r
+            <note>\r
+              The Preferences/Metadata option "Write altered image orientation to the metadata" must be off.\r
+              <para />\r
+              Exiftran and mogrify must be installed.\r
+            </note>\r
+          </para>\r
+        </listitem>\r
+      </varlistentry>\r
+      <varlistentry>\r
+        <term>\r
+          <menuchoice>\r
+            <guimenu>Orientation</guimenu>\r
+            <guimenuitem>Write orientation to file (preserve timestamp)</guimenuitem>\r
+          </menuchoice>\r
+        </term>\r
+        <listitem>\r
+          <para>As above, but the file date and time are preserved.</para>\r
+        </listitem>\r
+      </varlistentry>\r
+      <varlistentry>\r
+        <term>\r
+          <menuchoice>\r
+            <guimenu>Rating</guimenu>\r
+          </menuchoice>\r
+        </term>\r
+        <listitem>\r
+          <para>Set a Rating value for each image.</para>\r
+        </listitem>\r
+      </varlistentry>\r
+      <varlistentry>\r
+        <term>\r
+          <menuchoice>\r
+            <shortcut>\r
+              <keycombo>\r
+                <keycap>Alt+Keypad+n</keycap>\r
+              </keycombo>\r
+            </shortcut>\r
+            <guimenu>Rating</guimenu>\r
+            <guimenuitem>n</guimenuitem>\r
+          </menuchoice>\r
+        </term>\r
+        <listitem>\r
+          <para>"n" is in the range 0 to 5. Sets the Rating value for the image.</para>\r
+        </listitem>\r
+      </varlistentry>\r
+      <varlistentry>\r
+        <term>\r
+          <menuchoice>\r
+            <shortcut>\r
+              <keycombo>\r
+                <keycap>Alt+Keypad+Minus</keycap>\r
+              </keycombo>\r
+            </shortcut>\r
+            <guimenu>Rating</guimenu>\r
+            <guimenuitem>-1</guimenuitem>\r
+          </menuchoice>\r
+        </term>\r
+        <listitem>\r
+          <para>Sets the Rating value to -1 for the image.</para>\r
         </listitem>\r
       </varlistentry>\r
       <varlistentry>\r
           <para>Toggles display of the Sort Manager sidebar.</para>\r
         </listitem>\r
       </varlistentry>\r
+      <varlistentry>\r
+        <term>\r
+          <guimenu>Hide Bars</guimenu>\r
+        </term>\r
+        <listitem>\r
+          <para>This item is intended to be used by its shortcut key - by default this is the backtick key. When pressed, the info sidebar, sort manager and file list will be hidden (if displayed). Pressing backtick again will revert the display to its previous layout.</para>\r
+        </listitem>\r
+      </varlistentry>\r
       <varlistentry>\r
         <term>\r
           <guimenu>Toggle slideshow</guimenu>\r