Imported Upstream version 0.18.1upstream/0.18.1

1 files changed, 54 insertions, 0 deletions

diff --git a/help/C/edit-external.page b/help/C/edit-external.page
new file mode 100644
index 0000000..cee9fea
--- /dev/null
+++ b/help/C/edit-external.page
@@ -0,0 +1,54 @@
+<page xmlns="http://projectmallard.org/1.0/"
+      type="guide"
+      id="edit-external">
+
+    <info>
+        <link type="guide" xref="index#edit"/>
+        <desc>Use a different program to edit a photo.</desc>
+        
+        <link type="next" xref="edit-redeye" />
+    </info>
+
+    <title>
+        Edit photos with an external program
+    </title>
+
+    <p>
+        You might want to use an external editor to do additional work on a photo.
+        If installed, GIMP and UFRaw are the default external editors for photo and RAW editing, 
+        respectively.  If these programs are not installed, you must select your preferred 
+        editors by choosing <guiseq><gui>Edit</gui><gui>Preferences</gui></guiseq> and selecting
+        editors from drop-down menus of installed applications.
+    </p>
+
+    <p>
+        Once your editors have been set, select a photo and choose <guiseq><gui>Photos</gui>
+        <gui>Open With External Editor</gui></guiseq> to open the photo with the external editor.
+        Likewise, if the original photo is a RAW file, select <guiseq><gui>Photos</gui><gui>Open 
+        With RAW Editor</gui></guiseq> to edit the RAW file directly with the set RAW editor.
+    </p>
+
+    <p>
+        When you complete your edits and save the file, Shotwell will detect the changes and 
+        update the photo.   When external edits have been made, press and hold the 
+        <key>Shift</key> key in full-window view to show the original photo rather than the 
+        externally-edited one.
+    </p>
+                            
+    <p>
+        Reverting to original will erase any external edits.
+    </p>
+    
+    <note>
+        <p>
+            If you externally edit a RAW photo and save the result to another image, such as a
+            JPEG or PNG, Shotwell cannot automatically determine that the original RAW and the 
+            new image should be paired.
+        </p>
+            
+        <p>    
+            If you want to work within the resulting image within Shotwell, you'll need to 
+            import it yourself.
+        </p>
+    </note>    
+</page>