Mercurial > hg > forks > geeqie

changeset 2435:eccb275b0175

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Update documentation for orientation commands Clarify some sections and remove a TBD
author Colin Clark <cclark@mcb.net>
date Mon, 23 Jan 2017 20:17:13 +0000
parents ddba21e66364
children 8cd75e68e050
files doc/docbook/GuideMainWindowMenus.xml doc/docbook/GuideOptionsMetadata.xml
diffstat 2 files changed, 20 insertions(+), 5 deletions(-) [+]
line wrap: on
line diff
--- a/doc/docbook/GuideMainWindowMenus.xml	Mon Jan 23 17:40:40 2017 +0000
+++ b/doc/docbook/GuideMainWindowMenus.xml	Mon Jan 23 20:17:13 2017 +0000
@@ -645,6 +645,13 @@
         </term>
         <listitem>
           <para>Swaps the top and bottom sides of the image, does not modify the file on disk.</para>
+          <warning>
+            <para>
+              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
+              <link linkend="MetadataMiscellaneous">Metadata tab of the Preferences Dialog</link>
+              if you wish these changes to be written to metadata.
+            </para>
+          </warning>
         </listitem>
       </varlistentry>
       <varlistentry>
@@ -661,7 +668,7 @@
           </menuchoice>
         </term>
         <listitem>
-          <para>Removes all effects applied through the Adjust menu, reverting image to its original state.</para>
+          <para>Removes all temporary effects applied through the above commands, reverting the image according to its Exif Orientation tag.</para>
         </listitem>
       </varlistentry>
       <varlistentry>
@@ -672,9 +679,14 @@
           </menuchoice>
         </term>
         <listitem>
-          The commands above modifies image metadata only. This commands actually transforms image pixels. See
-          <link linkend="GuideImageManagementExternalEditing">Editors section</link>
-          for details
+          <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>
+          <warning>
+            <para>
+              The file rotate.desktop, using external commands exiftran, exiv2 and mogrify, is used to implement this command. Refer to
+              <link linkend="GuideImageManagementExternalEditing">Editors section</link>
+              for details.
+            </para>
+          </warning>
         </listitem>
       </varlistentry>
       <varlistentry>
--- a/doc/docbook/GuideOptionsMetadata.xml	Mon Jan 23 17:40:40 2017 +0000
+++ b/doc/docbook/GuideOptionsMetadata.xml	Mon Jan 23 20:17:13 2017 +0000
@@ -112,8 +112,11 @@
         <para>
           <guilabel>Write altered image orientation to the metadata</guilabel>
           <para />
-          TBD
+          If checked, the results of orientation commands (Rotate, Mirror and Flip) issued on an image will be written to metadata either automatically as specified below or when manually initiated.
         </para>
+        <warning>
+          <para>If this option is not checked, the results of orientation commands will be lost when Geeqie closes.</para>
+        </warning>
       </listitem>
     </itemizedlist>
     <para />