[eog] [help] Full review of many help topics, settings some to status=final (ready for translators)



commit 4fe6977f4b6370623aca1302568e9371d4345809
Author: Phil Bull <philbull gmail com>
Date:   Mon Sep 5 02:17:26 2011 +0100

    [help] Full review of many help topics, settings some to status=final (ready for translators)

 help/C/bug-filing.page                     |   20 ++---
 help/C/commandline.page                    |    2 +-
 help/C/copy-paste.page                     |   13 ++--
 help/C/default.page                        |   42 ++++++-----
 help/C/desktop-background.page             |   26 +++----
 help/C/edit.page                           |   47 ++++++++-----
 help/C/flip-rotate.page                    |   35 ++++++----
 help/C/format-change.page                  |  106 ++++++++++++++++------------
 help/C/formats-save.page                   |    6 +-
 help/C/formats-view.page                   |   14 ++--
 help/C/index.page                          |    8 +-
 help/C/introduction.page                   |   13 ++--
 help/C/open.page                           |   59 +++++----------
 help/C/plugin-exif-digital.page            |   82 +++++++++++++++++----
 help/C/plugin-fullscreen-double-click.page |   22 ++++---
 help/C/plugin-python-console.page          |   29 ++++++--
 help/C/shortcuts.page                      |    9 ++-
 17 files changed, 311 insertions(+), 222 deletions(-)
---
diff --git a/help/C/bug-filing.page b/help/C/bug-filing.page
index d463459..cfb0f45 100644
--- a/help/C/bug-filing.page
+++ b/help/C/bug-filing.page
@@ -4,9 +4,9 @@
 
   <info>
     <link type="guide" xref="index#get-involved"/>
-    <desc>How and where to report problems.</desc>
+    <desc>File a bug against the <app>image viewer</app>.</desc>
 
-    <revision pkgversion="3.2" version="0.1" date="2011-09-03" status="candidate"/>
+    <revision pkgversion="3.2" version="0.1" date="2011-09-05" status="final"/>
     <credit type="author">
       <name>Tiffany Antopolski</name>
       <email>tiffany antopolski com</email>
@@ -16,21 +16,17 @@
     </license>
   </info>
 
-<title>File a bug against the <app>image viewer</app></title>
+<title>Report a problem with the image viewer</title>
 <p>
-   To file a bug against the image viewer, click on the link <link href = "https://bugzilla.gnome.org/"/>.
+   If you experience problems with the image viewer (for example, if it crashes or behaves unexpectedly), or if it is missing some feature that you think it should have, please file a <em>bug report</em> by clicking on the link <link href="https://bugzilla.gnome.org/"/>. Bug reports are how software developers keep track of problems so that they can fix them.
    </p>
    <p>
-   This is a bug tracking system where users and developers can file details about bugs, crashes and request enhancements.  
+   To participate, you need an account which will give you the ability to file bugs and make comments.  Also, you need to register so you can receive updates by email about the status of your bug. If you don't already have an account, just click on the <gui>New</gui> link to create one.
    </p>
    <p>
-   To participate you need an account which will give you the ability to gain access, file bugs, and make comments.  Also, you need to register so you can receive updates by e-mail about the status of your bug. If you don't already have an account, just click on the "New" link to create one.
-   </p>
-   <p>
-   Once you have an account, log in, click on <guiseq><gui>File a
+   Once you have an account, log in, and click <guiseq><gui>File a
 Bug</gui><gui>Core</gui><gui>eog</gui></guiseq>.
-   Before reporting a bug, please read the <link href =
-"https://bugzilla.gnome.org/page.cgi?id=bug-writing.html";>bug writing
+   Before reporting a bug, please read the <link href="https://bugzilla.gnome.org/page.cgi?id=bug-writing.html";>bug writing
 guidelines</link>,  and please <link
 href="https://bugzilla.gnome.org/browse.cgi?product=eog";>browse</link> for the bug to see if it already exists.
    </p>
@@ -42,6 +38,6 @@ href="https://bugzilla.gnome.org/browse.cgi?product=eog";>browse</link> for the b
    Fill in the Summary and Description sections and click <gui>Commit</gui>.
    </p>
    <p>
-      Your report will be given an ID number, and its status will be updated as it is being dealt with.
+      Your report will be given an ID number, and its status will be updated as it is being dealt with. Bugs can take a while to be fixed, and the software developers might ask you for further information to help them figure out what the problem is.
    </p>
 </page>
diff --git a/help/C/commandline.page b/help/C/commandline.page
index 32e345e..2fc0db9 100644
--- a/help/C/commandline.page
+++ b/help/C/commandline.page
@@ -7,7 +7,7 @@
     <title type="sort">Command Line</title>
     <desc>The <cmd>eog</cmd> command can open any number of images in various modes.</desc>
 
-    <revision pkgversion="3.2" version="0.1" date="2011-09-03" status="candidate"/>
+    <revision pkgversion="3.2" version="0.1" date="2011-09-05" status="final"/>
     <credit type="author">
     <name>Tiffany Antopolski</name>
     <email>tiffany antopolski com</email>
diff --git a/help/C/copy-paste.page b/help/C/copy-paste.page
index 96c731a..9e81287 100644
--- a/help/C/copy-paste.page
+++ b/help/C/copy-paste.page
@@ -9,7 +9,7 @@
     <desc>How to copy/paste from the <app>image viewer</app> into
 another application.</desc>
 
-    <revision pkgversion="3.2" version="0.1" date="2011-09-03" status="candidate"/>
+    <revision pkgversion="3.2" version="0.1" date="2011-09-05" status="final"/>
     <credit type="author">
       <name>Tiffany Antopolski</name>
       <email>tiffany antopolski com</email>
@@ -20,12 +20,13 @@ another application.</desc>
 
   </info>
 
-<title>Copy image to clipboard</title>
-<p>To copy an image to the clipboard, click
+<title>Copy and paste a picture</title>
+<p>To copy a picture from the image viewer into another application, click
 <guiseq><gui>Edit</gui><gui>Copy</gui></guiseq> or right-click on the
-image and choose <gui>copy</gui>.</p>
-<p>The image can now be pasted from the clipboard into a
-<app>LibreOffice</app> document, <app>Gimp</app> file, or other program.</p>
+picture and choose <gui>copy</gui>.</p>
+
+<p>The picture has been copied to the <em>clipboard</em>, and can now be pasted into a
+<app>LibreOffice</app> document, <app>Gimp</app> image, or other application.</p>
 
 </page>
 
diff --git a/help/C/default.page b/help/C/default.page
index b84dd56..90589ee 100644
--- a/help/C/default.page
+++ b/help/C/default.page
@@ -4,10 +4,9 @@
 
   <info>
     <link type="guide" xref="index#faq"/>
-    <desc><guiseq><gui>Right-click</gui><gui>Properties</gui><gui>Open
-With</gui></guiseq>.</desc>
+    <desc>Make image viewer the default application for viewing pictures.</desc>
 
-    <revision pkgversion="3.2" version="0.1" date="2011-09-03" status="candidate"/>
+    <revision pkgversion="3.2" version="0.1" date="2011-09-05" status="final"/>
     <credit type="author">
       <name>Tiffany Antopolski</name>
       <email>tiffany antopolski com</email>
@@ -18,26 +17,33 @@ With</gui></guiseq>.</desc>
 
   </info>
 
-<title>Change <em>Open With</em> default program to <app>image
-viewer</app>.</title>
-<p>If you want to change the default program that opens certain image
-file types to <app>image viewer</app>: </p>
+<title>Open pictures in the image viewer by default</title>
+<p>If you want to make the image viewer the default program that opens certain image
+file types:</p>
 
 <steps>
-<item><p>In the <app>files app</app>, right click on the file and choose
-<gui>Properties</gui>.</p></item>
-<item><p>Click on the <gui>Open With</gui> tab. A list of
-<gui>Recommended Applications</gui> will appear. </p></item>
-<item><p>Select the <app>Image Viewer</app> and click <gui>Set as
+ <item>
+  <p>In the <app>files app</app>, right click the file and choose
+<gui>Properties</gui>.</p>
+ </item>
+ <item>
+  <p>Go to the <gui>Open With</gui> tab. A list of
+<gui>Recommended Applications</gui> will appear. </p>
+ </item>
+ <item>
+  <p>Select the <gui>Image Viewer</gui> and click <gui>Set as
 default</gui>.</p>
-<p>If <app>Image Viewer</app> is not on the <gui>Recommended
-Applications</gui> list, click on <gui>Show
-other applications</gui>, and a list of <gui>Other Applications</gui>
-will appear.  Select the <app>Image Viewer</app> and click <gui>Set as
+  <p>If <app>Image Viewer</app> is not on the <gui>Recommended
+Applications</gui> list, click <gui>Show other applications</gui>. 
+Select <gui>Image Viewer</gui> from the list that appears and click <gui>Set as
 default</gui>.</p>
-</item>
-<item><p>Click <gui>Close</gui></p></item>
+ </item>
+ <item>
+  <p>Click <gui>Close</gui>.</p>
+ </item>
 </steps>
 
+<p>In future, when you double-click a file of the same type, it will open up in the image viewer.</p>
+
 </page>
 
diff --git a/help/C/desktop-background.page b/help/C/desktop-background.page
index edd6293..b0a5f64 100644
--- a/help/C/desktop-background.page
+++ b/help/C/desktop-background.page
@@ -4,9 +4,9 @@
 
   <info>
     <link type="guide" xref="index#tips"/>
-    <desc>Set your favourite image as your background.</desc>
+    <desc>Set your favorite picture as your desktop background/wallpaper.</desc>
 
-    <revision pkgversion="3.2" version="0.1" date="2011-09-03" status="candidate"/>
+    <revision pkgversion="3.2" version="0.1" date="2011-09-05" status="final"/>
     <credit type="author">
       <name>Tiffany Antopolski</name>
       <email>tiffany antopolski com</email>
@@ -17,17 +17,15 @@
 
   </info>
 
-<title>Set desktop background</title>
-<p>To set the image you are currently viewing in the <app>image
-viewer</app> as the background image on your desktop:</p>
-<list>
-<item><p>click <guiseq><gui>Image</gui><gui>Set as Desktop
-Background</gui></guiseq>.</p></item>
-</list>
-<p>This will immediately change your background to the image open in the
-<app>image viewer</app>. You will then be asked if you would like to
-modify the image's appearance using the <gui>background</gui>
-preferences dialog. If you click <gui>Hide</gui>, the message will
-dissappear.</p>
+<title>Make the current picture your desktop background</title>
+<p>To set the picture that you are currently viewing as the background 
+image on your desktop, click <guiseq><gui>Image</gui><gui>Set as Desktop
+Background</gui></guiseq>.</p>
+
+<p>This will immediately change the background to the picture you're viewing. 
+You will then be asked if you would like to
+modify the picture's appearance using the <gui>background</gui>
+preferences window. If you click <gui>Hide</gui>, the message will
+disappear.</p>
 </page>
 
diff --git a/help/C/edit.page b/help/C/edit.page
index 7b36e8c..86fde8f 100644
--- a/help/C/edit.page
+++ b/help/C/edit.page
@@ -4,9 +4,9 @@
 
   <info>
     <link type="guide" xref="index#edit"/>
-    <desc><guiseq><gui>Image</gui><gui>Open with</gui></guiseq>, <guiseq><gui>Edit</gui><gui>Move to Trash</gui></guiseq></desc>
+    <desc>Click <guiseq><gui>Image</gui><gui>Open with</gui></guiseq> to edit a picture using an external image editor.</desc>
 
-    <revision pkgversion="3.2" version="0.1" date="2011-09-03" status="candidate"/>
+    <revision pkgversion="3.2" version="0.1" date="2011-09-06" status="final"/>
     <credit type="author">
       <name>Tiffany Antopolski</name>
       <email>tiffany antopolski com</email>
@@ -16,25 +16,38 @@
     </license>
 
   </info>
-<title>Edit or delete an image</title>
-<section id="edit"><title>Edit image using the <app>image viewer</app></title>
+<title>Edit or delete a picture</title>
+
+<section id="edit"><title>Edit a picture</title>
+<p>The image viewer can only be used to view pictures; it can't edit them. 
+For that, you must use a picture editing application, like the GIMP image 
+editor. To open a picture for editing in a different application:</p>
 <steps>
-  <item><p>Click <guiseq><gui>Image</gui><gui>Open with</gui></guiseq>,
-or right-click on the image.</p></item>
-  <item><p>Select the program to use to edit your image with.</p></item>
-<item><p>When you are finished editing your image, save it and close the
-program.  The <app>image viewer</app> will ask you if you want to
-reload the image.  Clicking <gui>Reload</gui> will ensure you are
-working with the most recent version of the file.</p></item>
+ <item>
+  <p>Click <guiseq><gui>Image</gui><gui>Open with</gui></guiseq>,
+or right-click on the image.</p>
+ </item>
+ <item>
+  <p>Select the application you want to use to edit the picture.</p>
+ </item>
+ <item>
+  <p>When you are finished editing, save it and close the
+other application.</p>
+ </item>
+ <item>
+  <p>The <app>image viewer</app> will detect that the 
+picture has been changed and will ask you if you want to
+reload it. Clicking <gui>Reload</gui> will ensure that you are
+viewing the most recent version of the file.</p>
+ </item>
 </steps>
 </section>
 
 <section id="delete">
-<title>Delete an image</title>
-<list>
-  <item><p>Click <guiseq><gui>Edit</gui><gui>Move to
-Trash</gui></guiseq>, or</p></item>
-  <item><p>Right-click on the image and select <gui>Move to Trash</gui>.</p></item>
-</list>
+<title>Delete a picture</title>
+<p>To delete a picture that you don't want any more, click 
+<guiseq><gui>Edit</gui><gui>Move to Trash</gui></guiseq>, or 
+right-click the picture and select <gui>Move to Trash</gui>.</p>
 </section>
+
 </page>
diff --git a/help/C/flip-rotate.page b/help/C/flip-rotate.page
index 2b5c89f..de998a3 100644
--- a/help/C/flip-rotate.page
+++ b/help/C/flip-rotate.page
@@ -6,7 +6,7 @@
     <link type="guide" xref="index#edit"/>
     <desc>Horizontal/vertical, clockwise/counter-clockwise</desc>
 
-    <revision pkgversion="3.2" version="0.1" date="2011-09-03" status="candidate"/>
+    <revision pkgversion="3.2" version="0.1" date="2011-09-05" status="final"/>
     <credit type="author">
       <name>Tiffany Antopolski</name>
       <email>tiffany antopolski com</email>
@@ -17,31 +17,38 @@
 
   </info>
 
-<title>Flip or rotate images</title>
+<title>Flip or rotate pictures</title>
+
+<p>If your pictures are the wrong way up or back-to-front, you can flip or 
+rotate them so that they look right.</p>
 
-<note><p>If you would like to save your changes, make sure you save in a
-<link xref="formats-save">supported format</link>.</p></note>  
 <section id="flip">
-<title>Flip image</title>
-<p>To flip the image:</p>
+<title>Flip a picture</title>
 <steps>
-<item><p>Click <gui>Edit</gui></p></item>
-<item><p>Select either <gui>Flip Horizontal</gui> or <gui>Flip Vertical</gui>.</p></item>
+ <item><p>Click <gui>Edit</gui>.</p></item>
+ <item><p>Select either <gui>Flip Horizontal</gui> or <gui>Flip Vertical</gui>.</p></item>
+ <item>
+  <p>If you want to keep the picture flipped in this way, click <guiseq><gui>Image</gui><gui>Save</gui></guiseq>.</p>
+  <p>Otherwise, don't save the picture and it will be returned to its original orientation the next time you open it.</p>
+ </item>
 </steps>
 </section>
 
 <section id="rotate">
-<title>Rotate image</title>
-<p>To rotate the image:</p>
+<title>Rotate a picture</title>
 <steps>
-<item><p>Click <gui>Edit</gui></p></item>
-<item><p>Select either <gui>Rotate Clockwise</gui> or <gui>Rotate
+ <item><p>Click <gui>Edit</gui>.</p></item>
+ <item><p>Select either <gui>Rotate Clockwise</gui> or <gui>Rotate
 Counter-clockwise</gui>.</p></item>
+ <item>
+  <p>If you want to keep the picture rotated in this way, click <guiseq><gui>Image</gui><gui>Save</gui></guiseq>.</p>
+  <p>Otherwise, don't save the picture and it will be returned to its original orientation the next time you open it.</p>
+ </item>
 </steps>
 
-<p>You can use the tools in the <link xref="toolbar">toolbar</link>.</p>
+<p>You can use the tools in the <link xref="toolbar">toolbar</link> to do this 
+instead. You can also use the keyboard shortcuts:</p>
 
-<p>You can also use the keyboard shortcuts:</p>
 <table>
   <tr>
     <td><p>Rotate Clockwise</p></td>
diff --git a/help/C/format-change.page b/help/C/format-change.page
index e6a3ded..f4ecac9 100644
--- a/help/C/format-change.page
+++ b/help/C/format-change.page
@@ -4,9 +4,9 @@
  
   <info> 
     <link type="guide" xref="index#edit"/> 
-    <desc>Single and multiple images.</desc> 
+    <desc>You can convert pictures from one image format to another. You can do this in a batch for multiple pictures.</desc> 
  
-    <revision pkgversion="3.2" version="0.1" date="2011-09-03" status="candidate"/> 
+    <revision pkgversion="3.2" version="0.1" date="2011-09-05" status="final"/> 
     <credit type="author"> 
       <name>Tiffany Antopolski</name> 
       <email>tiffany antopolski com</email> 
@@ -17,54 +17,68 @@
   </info> 
  
 <title>Convert to a different file type</title>
+
 <section id="single">
-<title>Convert single image</title>
-<list type="numbered">
-<item><p>Click <guiseq><gui>Image</gui><gui>Save As</gui></guiseq>.  The
-<gui>Save Image</gui> dialog will pop up.</p></item>
-<item><p>In the name field, change (or add) the extension to the file type you wish to
-convert your image too.  For example:</p>
-<note style="sidebar"><p><app>Image viewer</app> tries to determine the file type from
-the file extension.</p></note>
-<p><em>original file:</em> <file>image.jpg</file></p>
-<p><em>new file:</em> <file>image.bmp</file> (or <file>image.jpg.bmp</file>).</p>
-</item>
-<item><p>Click <gui>Save</gui></p>
-<note><p>The file is saved in the current folder by default.If the image
-should be saved in another folder or the file type
-detection failed, expand the dialog by clicking on <gui>Browse</gui> for other
-folders. This allows further folder navigation and the specification of
-the file type from the drop down box.
-</p></note></item>
-<item><p><app>Image viewer</app> will ask if you would like to reload
-the new image.  Click <gui>Reload</gui> if you want to work with the new
-file.  Click <gui>Hide</gui> if you want to continue working with the
+ <title>Convert a single picture to a different file type</title>
+ <list type="numbered">
+  <item>
+   <p>Click <guiseq><gui>Image</gui><gui>Save As</gui></guiseq>.  The
+<gui>Save Image</gui> window will pop up.</p>
+  </item>
+  <item>
+   <p>In the name field, change the <em>file extension</em> to the file type you want to
+convert your image to. The file extension is the part of the file name after the period.</p>
+   <p>For example, to convert a JPEG (<file>.jpg</file>) file into a Bitmap file (<file>.bmp</file>):</p>
+   <p><em>original file:</em> <file>image.jpg</file></p>
+   <p><em>new file:</em> <file>image.bmp</file></p>
+  </item>
+  <item>
+   <p>Click <gui>Save</gui>, and a new file will be saved in the new format. The old file (in the old format) will remain where it was, and will not be deleted.</p>
+  </item>
+  <item>
+   <p>The image viewer will ask if you would like to reload
+the new picture. Click <gui>Reload</gui> to do this, or click 
+<gui>Hide</gui> if you want to continue working with the
 original file.</p></item>
 </list>
-</section>
 
-<section id="multiple"><title>Convert multiple images</title>
-<list style="numbered">
-<item><p>Press the <key>Ctrl</key> key and click on the images you want
-to convert in the <link xref="view#image-gallery">image
-gallery</link> or press 
-<keyseq><key>Ctrl</key><key>A</key></keyseq> to select all the
-images.</p></item>
-<item><p>Click <guiseq><gui>Image</gui><gui>Save as</gui></guiseq>.  The
-following dialog will appear.</p>
-<note style="sidebar"> 
-<p> 
-  The same dialog is used to <link xref="rename-multiple">rename multiple images</link>. 
-</p> 
-</note>
+<p>The image viewer tries to guess which file format to save a picture in 
+based on the file extension you choose. If it doesn't recognize the file 
+extension you types, or if you don't know which one to use, click 
+<gui>Browse</gui> in the <gui>Save Image</gui> window. This will allow you to 
+choose the file type from the drop down box.
+</p>
 
-<media type="image" src="figures/multiple-convert.png" width="300"/></item>
-<item><p>The images will be saved in the current folder by default.  If
-you want to save them elsewhere, select the folder from the
-<gui>Destination folder</gui> drop-down menu.</p></item>
-<item><p>Select the file format from the drop-down menu to the right of
-the <gui>Filename format</gui> entry box.</p></item>
-<item><p>Click <gui>Save</gui>.</p></item>
-</list>
 </section>
+
+<section id="multiple">
+ <title>Convert multiple pictures to a different format</title>
+ <p>You can convert a number of pictures from one file format to another in 
+ one go. This is useful if you have a lot of pictures that need converting.</p>
+ <list style="numbered">
+  <item>
+   <p>In the <link xref="view#image-gallery">image gallery</link>, press and 
+   hold down the <key>Ctrl</key> key and select the pictures you want
+   to convert one by one. Alternatively, press 
+   <keyseq><key>Ctrl</key><key>A</key></keyseq> to select all of the pictures.</p>
+  </item>
+  <item>
+   <p>Click <guiseq><gui>Image</gui><gui>Save as</gui></guiseq>. A window 
+   will appear (shown below).</p>
+   <media type="image" src="figures/multiple-convert.png" width="300"/>
+  </item>
+  <item>
+   <p>The converted pictures will be saved in the current folder by default. 
+   If you want to save them elsewhere, change the <gui>Destination folder</gui>.</p>
+  </item>
+  <item>
+   <p>Select the file format you want to convert the pictures to from the 
+   drop-down list to the right of the <gui>Filename format</gui> box.</p>
+  </item>
+  <item>
+   <p>Click <gui>Save</gui>.</p>
+  </item>
+ </list>
+</section>
+
 </page>
diff --git a/help/C/formats-save.page b/help/C/formats-save.page
index 282194b..c82ff9e 100644
--- a/help/C/formats-save.page
+++ b/help/C/formats-save.page
@@ -6,7 +6,7 @@
     <link type="guide" xref="index#edit"/>
     <desc>JPEG, PNG, BMP and others.</desc>
 
-    <revision pkgversion="3.2" version="0.1" date="2011-09-03" status="candidate"/>
+    <revision pkgversion="3.2" version="0.1" date="2011-09-05" status="final"/>
   <credit type="author">
     <name>Tiffany Antopolski</name>
     <email>tiffany antopolski gmail com</email>
@@ -16,8 +16,8 @@
   </license>
   </info>
 
- <title>Formats supported for saving images</title>
-  <p>The image viewer is able to save the following formats:</p>
+ <title>Formats supported for saving pictures</title>
+  <p>The image viewer can save pictures in the following file formats:</p>
   <list>
    <item><p>JPEG/JPG</p></item>
    <item><p>PNG</p></item>
diff --git a/help/C/formats-view.page b/help/C/formats-view.page
index fe01c3a..d7925fa 100644
--- a/help/C/formats-view.page
+++ b/help/C/formats-view.page
@@ -5,9 +5,9 @@
   <info>
     <link type="guide" xref="index"/>
     <link type="seealso" xref="formats-save"/>
-    <desc>PNG, JPEG, TIFF and others.</desc>
+    <desc>The image viewer can display pictures in a wide range of image formats, including PNG, JPEG, and TIFF.</desc>
 
-    <revision pkgversion="3.2" version="0.1" date="2011-09-03" status="candidate"/>
+    <revision pkgversion="3.2" version="0.1" date="2011-09-05" status="final"/>
   <credit type="author">
     <name>Tiffany Antopolski</name>
     <email>tiffany antopolski gmail com</email>
@@ -17,11 +17,9 @@
   </license>
   </info>
 
- <title>Supported formats</title>
+ <title>Supported image formats</title>
 
-  <p>
-    The image viewer is able to open the following formats:
-  </p>
+  <p>The image viewer is able to open pictures in the following formats:</p>
   <list>
    <item><p>ANI - Animation</p></item>
    <item><p>BMP - Bitmap</p></item>
@@ -40,7 +38,7 @@
    <item><p>XPM - X Pixmap</p></item>
   </list>
   <p>
-   If you try to open an unsupported format, you will get a <em>Could
-not load image 'image_name'.</em> error.
+   If you try to open a picture in an unsupported format, you will get a <gui>Could
+not load image 'image_name'.</gui> error.
   </p>
 </page>
diff --git a/help/C/index.page b/help/C/index.page
index ec29695..e4cda20 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -7,7 +7,7 @@
     <title type='link' role="trail"><media type="image" src="figures/eog-trail.png"/></title>
     <title type='link'>Eye of GNOME Image Viewer</title>
     <title type='text'>Eye of GNOME Image Viewer</title>
-    <revision pkgversion="3.2" version="0.1" date="2011-09-03" status="candidate"/>
+    <revision pkgversion="3.2" version="0.1" date="2011-09-05" status="final"/>
     <credit type="author">
       <name>Tiffany Antopolski</name>
       <email>tiffany antopolski gmail com</email>
@@ -22,15 +22,15 @@ Eye of GNOME Image Viewer</title>
 </section>
 
 <section id="edit" style="2column">
-    <title>Edit images</title>
+    <title>Edit pictures</title>
 </section>
 
 <section id="printing" style="2column">
-    <title>Print images</title>
+    <title>Print pictures</title>
 </section>
 
 <section id="plugins" style="2column" groups="first">
-    <title>Extend functionality</title>
+    <title>Add extra features</title>
 </section>
 <section id="advanced" style="2column">
     <title>Advanced</title>
diff --git a/help/C/introduction.page b/help/C/introduction.page
index a5ea6c2..5bec55f 100644
--- a/help/C/introduction.page
+++ b/help/C/introduction.page
@@ -6,7 +6,7 @@
     <link type="guide" xref="index"/>
     <desc>Welcome to the <app>Eye of GNOME Image Viewer</app>.</desc>
 
-    <revision pkgversion="3.2" version="0.1" date="2011-09-03" status="candidate"/>
+    <revision pkgversion="3.2" version="0.1" date="2011-09-05" status="final"/>
     <credit type="author">
       <name>Tiffany Antopolski</name>
       <email>tiffany antopolski com</email>
@@ -20,10 +20,11 @@
 <title>Introduction</title>
 
 <p><app>Eye of GNOME</app> is an image viewer. With it, you can view
-single image files, as well as large image collections. The <app>image
-viewer</app> supports a variey of image <link
-xref="formats-view"> formats for viewing, by default</link>.  It also
-supports certain <link xref="formats-save">file formats for saving by
-default</link>.</p>  
+pictures of <link xref="formats-view">almost any type</link>. It can handle 
+<link xref="view#image-gallery">large collections</link> of pictures, and can 
+display a <link xref="slideshow">slideshow</link>. You can also make basic 
+changes to pictures, like <link xref="flip-rotate">rotating or flipping</link> 
+them, or <link xref="format-change">converting them</link> to a different file 
+format.</p>
 
 </page>
diff --git a/help/C/open.page b/help/C/open.page
index 76ecfe4..88c351b 100644
--- a/help/C/open.page
+++ b/help/C/open.page
@@ -4,9 +4,9 @@
 
   <info>
     <link type="guide" xref="index#viewing"/>
-<desc>Open from <app>files</app> or from <app>image viewer</app>.</desc>
+    <desc>Pictures open in a new window.</desc>
 
-    <revision pkgversion="3.2" version="0.1" date="2011-09-03" status="candidate"/>
+    <revision pkgversion="3.2" version="0.1" date="2011-09-05" status="final"/>
   <credit type="author">
     <name>Tiffany Antopolski</name>
     <email>tiffany antopolski gmail com</email>
@@ -17,42 +17,23 @@
   </info>
 
 
-   <title>Open images</title>
-
-
-<note><p>Each image you open will open in a new
-<app>image viewer</app> window. You may wish also wish to <link
-xref="view">view multiple images</link> in one window.</p></note>
-
-    <section id="from-nautilus"><title>Open image from <app>files</app> application</title>
-      <p>To open an image from the <app>files</app> application:</p>
-        <list>
-          <item><p>Right-click on the image icon and select <gui>Open With Image
-Viewer</gui>, which should be the top item on the menu.  In this case, you
-can also open files of the same type by double-clicking on the image
-icon in the <app>files</app> application.</p></item>
-          <item><p>If <gui>Open With Image Viewer</gui> is not the top item in the
-right-click menu, select <guiseq><gui>Open
-With</gui><gui>Image Viewer</gui></guiseq>.</p></item>
-          <item><p>If the <app>image viewer</app> is not listed in the <gui>Open
-With</gui> menu, click <guiseq><gui>Open With</gui><gui>Other
-Application</gui></guiseq>.  You may need to click on the <gui>Show
-other applications</gui> button.  Click on <gui>Image Viewer</gui> in
-the <gui>Recommended Applications</gui> or <gui>Other Applications</gui>
-lists.  Then click on <gui>Select</gui>.</p></item>
-        </list>
-    </section>
-
-
-    <section id="from-eog"><title>Open image from <app>image viewer</app></title>
-      <p>To open an image from the <app>image viewer</app>:</p>
-        <steps>
-          <item><p>Click <guiseq><gui>Image</gui><gui>Open</gui></guiseq> (or
+<title>Open a picture</title>
+
+<p>Pictures should automatically open in the image viewer when you 
+double-click them in the <app>files</app> file browser. If this is not the 
+case, you may need to make the image viewer the 
+<link xref="default">default application</link> for viewing pictures.</p>
+
+<p>Each picture you double-click will open in a new image viewer window by 
+default, but you can <link xref="view">view multiple pictures</link> in one 
+window if you like.</p>
+
+<p>You can also open pictures from within the image viewer itself:</p>
+<steps>
+ <item><p>Click <guiseq><gui>Image</gui><gui>Open</gui></guiseq> (or
 press <keyseq><key>Ctrl</key><key>O</key></keyseq>). The <gui>Open
-Image</gui> dialog will open.</p></item>
-          <item><p>Select the image you wish to open.</p></item>
-          <item><p>Click <gui>Open</gui>.</p></item>
-        </steps>
-    </section>
-  
+Image</gui> window will appear.</p></item>
+ <item><p>Select the picture you want to open and click <gui>Open</gui>.</p></item>
+</steps>
+
 </page>
diff --git a/help/C/plugin-exif-digital.page b/help/C/plugin-exif-digital.page
index 45cfc2e..60b2ddc 100644
--- a/help/C/plugin-exif-digital.page
+++ b/help/C/plugin-exif-digital.page
@@ -4,9 +4,9 @@
 
   <info>
    <link type="guide" xref="index#plugins"/>
-   <desc><link xref="plugin-exif-digital#exif-map">Camera settings and histogram, geolocation</link>, <link xref="plugin-exif-digital#date">and date.</link></desc>
+   <desc>You can view lots of information about pictures taken with a digital camera, such as <link xref="plugin-exif-digital#exif">camera settings and histogram</link>, <link xref="plugin-exif-digital#map">geolocation</link>, and <link xref="plugin-exif-digital#date">date</link>.</desc>
 
-   <revision pkgversion="3.2" version="0.1" date="2011-09-03" status="candidate"/>
+   <revision pkgversion="3.2" version="0.1" date="2011-09-05" status="final"/>
    <credit type="author">
      <name>Tiffany Antopolski</name>
      <email>tiffany antopolski gmail com</email>
@@ -17,25 +17,75 @@
 
   </info>
 
-<title>View digital picture data</title>
-<section id="exif-map"><title>Exif display and map</title>
-  <p>In order to add the <app>Exif display</app> and/or <app>Map</app> functions, you will need to install <link
-xref="plugins">eog-plugins</link>.</p>
+<title>View detailed information about a picture</title>
 
-  <p>Once installed, you can activate/deactivate <gui>Exif display</gui> and/or <gui>Map</gui> in the <link
-xref="preferences#plugins">preferences plugins menu</link>.</p>
-<p>Click <guiseq><gui>View</gui><gui>Side Pane</gui></guiseq> to view the camera settings, histogram and geolocation of the image on a map (if available).</p>
-</section>
+<p>Pictures taken by digital cameras are stored with a host of extra 
+information embedded in them, such as the date that they were taken, what 
+exposure settings were used on the camera and, in some cases, even where the 
+picture was taken.</p>
+
+<p>This topic shows you how to access this information.</p>
 
 <section id="date">
-<title>Date in statusbar</title>
+<title>Show the date in the status bar</title>
   <media type="image" src="figures/prefs-plugins-date.png" width="300"
 style="floatright"/>
-  <p>To activate this function, you will need to check it in the <link
-xref="preferences#plugins">plugins</link>
-tab of the <link xref="preferences">preferences</link> menu.</p>
-<p>The date the image was taken (if available) will
-show in the statusbar (bottom-right of image window). </p>
+  <p>You can display the date that a picture was taken in the status bar at 
+  the bottom of the window.</p>
+  <p> To do this, click <guiseq><gui>Edit</gui><gui>Preferences</gui></guiseq> 
+  and go to the <gui>Plugins</gui> tab. Then, check <gui>Date in 
+  statusbar</gui>.</p>
+</section>
 
+<section id="exif">
+ <title>Detailed Exif data</title>
+  <p>The detailed information stored with digital photos is called <em>Exif 
+  data</em>. You can view it by installing a plugin for the image viewer.</p>
+  
+  <steps>
+   <item>
+    <p>To be able to see the Exif data embedded in your photos, you must 
+  first install the <link xref="plugins">eog-plugins</link> package.</p>
+   </item>
+   <item>
+    <p>If <sys>eog-plugins</sys> is installed, click 
+    <guiseq><gui>Edit</gui><gui>Preferences</gui></guiseq> and go to the 
+    <gui>Plugins</gui> tab. Then, check <gui>Exif display</gui> and click 
+    <gui>Close</gui>.</p>
+   </item>
+   <item>
+    <p>Click <guiseq><gui>View</gui><gui>Side Pane</gui></guiseq> to view the 
+    camera settings used to take the photo, and a histogram showing the balance 
+    of colors and light/shade in the picture.</p>
+   </item>
+  </steps>
 </section>
+
+<section id="map">
+ <title>Display a photo location map</title>
+  <p>Some cameras are able to attach <em>geolocation</em> information 
+  (geotags) to digital photos. Geotags are usually just the GPS coordinates 
+  (latitude and longitude) for the place where a photo was taken.</p>
+  
+  <steps>
+   <item>
+    <p>To be able to see a map of where your photos were taken, you must 
+  first install the <link xref="plugins">eog-plugins</link> package.</p>
+   </item>
+   <item>
+    <p>If <sys>eog-plugins</sys> is installed, click 
+    <guiseq><gui>Edit</gui><gui>Preferences</gui></guiseq> and go to the 
+    <gui>Plugins</gui> tab. Then, check <gui>Map</gui> and click 
+    <gui>Close</gui>.</p>
+   </item>
+   <item>
+    <p>Click <guiseq><gui>View</gui><gui>Side Pane</gui></guiseq> to show the map.</p>
+   </item>
+  </steps>
+  <p>The map will show the location that a picture was taken in only if there 
+  is geolocation information attached to the photo. Many cameras do not attach 
+  geolocation information to pictures.</p>
+</section>
+
+
 </page>
diff --git a/help/C/plugin-fullscreen-double-click.page b/help/C/plugin-fullscreen-double-click.page
index 6f34550..9369300 100644
--- a/help/C/plugin-fullscreen-double-click.page
+++ b/help/C/plugin-fullscreen-double-click.page
@@ -4,9 +4,9 @@
 
   <info>
    <link type="guide" xref="index#plugins"/>
-   <desc>Activate fullscreen mode with double-click.</desc>
+   <desc>Activate fullscreen mode by double-clicking a picture.</desc>
 
-   <revision pkgversion="3.2" version="0.1" date="2011-09-03" status="candidate"/>
+   <revision pkgversion="3.2" version="0.1" date="2011-09-05" status="final"/>
    <credit type="author">
      <name>Tiffany Antopolski</name>
      <email>tiffany antopolski gmail com</email>
@@ -17,15 +17,19 @@
 
   </info>
 
-<title>Fullscreen with double-click</title>
-  <media type="image" src="figures/prefs-plugins-fullscreen.png"
+<title>Full-screen with double-click</title>
+
+<media type="image" src="figures/prefs-plugins-fullscreen.png"
 width="300" style="floatright"/>
-  <p>To activate this function, you will need to check it in the <link
-xref="preferences#plugins">plugins</link>
-tab of the <link xref="preferences">preferences</link> menu.</p>
-<p>Once activated, double-clicking on an image will toggle between
-fullscreen and unfullscreen modes.</p>
 
+<p>If you like, you can make it so that pictures are shown full-screen when 
+you double-click them in the image viewer.</p>
+
+<p>To do this, click <guiseq><gui>Edit</gui><gui>Preferences</gui></guiseq> and 
+go to the <gui>Plugins</gui> tab. Then, check <gui>Fullscreen with 
+double-click</gui> and click <gui>Close</gui>.</p>
 
+<p>Now, double-clicking on an image will toggle between the fullscreen and 
+normal (window) modes.</p>
 
 </page>
diff --git a/help/C/plugin-python-console.page b/help/C/plugin-python-console.page
index 3cb1dfa..1f3e148 100644
--- a/help/C/plugin-python-console.page
+++ b/help/C/plugin-python-console.page
@@ -4,9 +4,9 @@
 
   <info>
    <link type="guide" xref="index#advanced"/>
-   <desc>A python console for the <app>image viewer</app>.</desc>
+   <desc>The Python console can be used to add extra functions and run scripts in the image viewer.</desc>
 
-   <revision pkgversion="3.2" version="0.1" date="2011-09-03" status="candidate"/>
+   <revision pkgversion="3.2" version="0.1" date="2011-09-05" status="final"/>
    <credit type="author">
      <name>Tiffany Antopolski</name>
      <email>tiffany antopolski gmail com</email>
@@ -19,10 +19,27 @@
 
 <title>Python console</title>
 
-  <p>In order to add this functionality, you will need to install <link
+<p>The image viewer has a plugin system which uses the Python scripting 
+ language. If you activate the <em>Python console</em>, you can gain direct 
+ access to a Python interpreter from inside the image viewer, which you can 
+ then use to write scripts or programmatically manipulate images, for example.</p>
+
+<steps>
+ <item>
+  <p>Before you can activate the Python console, you will need to install <link
 xref="plugins">eog-plugins</link>.</p>
+ </item>
+ <item>
+  <p>Once <sys>eog-plugins</sys> is installed, click <guiseq><gui>Edit</gui>
+ <gui>Preferences</gui></guiseq> and go to the <gui>Plugins</gui> tab.</p>
+ </item>
+ <item>
+  <p>Check <gui>Python Console</gui> and click <gui>Close</gui>.</p>
+ </item>
+ <item>
+  <p>Click <guiseq><gui>Tools</gui><gui>Python Console</gui></guiseq> to 
+  bring up the console.</p>
+ </item>
+</steps>
 
-  <p>Once installed, you can activate/deactivate the <gui>Python console</gui> <gui>Tools</gui> menu item in the <link
-xref="preferences#plugins">preferences plugins menu</link>. </p>
-<p>Click <guiseq><gui>Tools</gui><gui>Python Console</gui></guiseq> to bring up the console.</p>
 </page>
diff --git a/help/C/shortcuts.page b/help/C/shortcuts.page
index 14554d3..47c1213 100644
--- a/help/C/shortcuts.page
+++ b/help/C/shortcuts.page
@@ -4,9 +4,9 @@
 
   <info>
     <link type="guide" xref="index#advanced"/>
-    <desc>List of all shortcuts.</desc>
+    <desc>A list of all keyboard shortcuts.</desc>
 
-    <revision pkgversion="3.2" version="0.1" date="2011-09-03" status="candidate"/>
+    <revision pkgversion="3.2" version="0.1" date="2011-09-05" status="final"/>
     <credit type="author">
        <name>Tiffany Antopolski</name>
        <email>tiffany antopolski gmail com</email>
@@ -18,12 +18,15 @@
 
 <title>Keyboard shortcuts</title>
 
+<p>This is a list of all of the keyboard shortcuts that you can use in the 
+image viewer.</p>
+
 <section id="open-close-save-print">
   <title>Opening, closing, saving and printing</title>
   <table frame="all" rules="cols" shade="rows">
     <tr>
         <td><p>Open an image file</p></td>
-        <td><p><keyseq><key>Ctrl</key><key>O</key></keyseq> (letter O)</p></td>
+        <td><p><keyseq><key>Ctrl</key><key>O</key></keyseq></p></td>
     </tr>
     <tr>
         <td><p>Save the image with the same filename</p></td>



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]