Fix #323: Rating system
[geeqie.git] / doc / docbook / GuideMainWindowMenus.xml
index 8c13af8..754c5bd 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>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