[gimp-help/gimp-help-2-10] Fix issue #12 Save & Export docs mix both actions

[Jacob Boerema <jboerema src gnome org>]

commit e2269dd94e6b2b4a322fb34f5d549344d99bbd2b
Author: Jacob Boerema <jgboerema gmail com>
Date:   Sun Feb 13 22:50:52 2022 -0500

    Fix issue #12 Save & Export docs mix both actions
    
    Improved the text to not mix up the meanings of saving and exporting.
    
    (cherry picked from commit 598850c7936ad57c98d6317272aaf8defc4f162d)

 src/using/fileformats.xml | 83 ++++++++++++++++++++++++++---------------------
 1 file changed, 46 insertions(+), 37 deletions(-)
---
diff --git a/src/using/fileformats.xml b/src/using/fileformats.xml
index 229ad2669..c92fc1b3a 100644
--- a/src/using/fileformats.xml
+++ b/src/using/fileformats.xml
@@ -17,9 +17,9 @@
 
   <para>
     <acronym>GIMP</acronym> is capable of reading and writing a large
-    variety of graphics file formats.  With the exception of
-    <acronym>GIMP</acronym>'s native XCF file type, file handling is done by
-    Plugins.  Thus, it is relatively easy to extend <acronym>GIMP</acronym>
+    variety of graphics file formats. With the exception of
+    <acronym>GIMP</acronym>'s native XCF file format, file handling is done by
+    plug-ins. This makes it relatively easy to extend <acronym>GIMP</acronym>
     to support new file types when the need arises.
   </para>
 
@@ -33,48 +33,55 @@
     </indexterm>
     <note>
       <para>
-        In former <acronym>GIMP</acronym> releases, when you loaded an image in
-        some format, let us say JPG or PNG, the image kept its format and
-        was saved in the same format by <command>Save</command>. With
-        <acronym>GIMP</acronym>-2.8, images are loaded, imported, in the XCF
-        format as a new project. For example, a <quote>sunflower.png</quote>
-        image will be loaded as <quote>*[sunflower] (imported)-1.0 (indexed
-        color, 1 layer)</quote>. The leading asterisk indicates that this file
-        has been changed. This image will be saved as
-        <quote>sunflower.xcf</quote> by <command>Save</command>. To save this
-        image in a format other than XCF, you must use
-        <command>Export</command>.
+        When you opened an image in older <acronym>GIMP</acronym> releases,
+        let's say a JPG or PNG, the image kept its format and was saved in the
+        same format by using <command>Save</command>. Since
+        <acronym>GIMP</acronym> 2.8, all images are imported into GIMP's own XCF
+        format, as a new project.
       </para>
+      <para>
+        For example, a <quote>sunflower.png</quote> image will be loaded as
+        <quote>*[sunflower] (imported)-1.0 (indexed color, 1 layer)</quote>.
+        The leading asterisk indicates that this file has been changed. This
+        image can be saved as <quote>sunflower.xcf</quote> by using the
+        <command>Save</command> command. If you need your image in another
+        format, you should use the <command>Export</command> command.
+       </para>
     </note>
     <para>
-      When you are finished working with an image, you will want to save the
-      results. (In fact, it is often a good idea to save at intermediate
-      stages too: <acronym>GIMP</acronym>
-      is a pretty robust program, but we have heard rumors, possibly
-      apocryphal, that it may have been known on rare and mysterious occasions
-      to crash.) Most of the file formats that <acronym>GIMP</acronym>
-      can open, can also be used for saving. There is one file format that is
-      special, though: XCF is <acronym>GIMP</acronym>'s native format, and is
-      useful because it stores <emphasis>everything</emphasis> about an image
-      (well, almost everything; it does not store <quote>undo</quote>
-      information). Thus, the XCF format is especially suitable for saving
-      intermediate results, and for saving images to be re-opened later in
-      <acronym>GIMP</acronym>.
-      XCF files are not readable by most other programs that display images,
-      so once you have finished, you will probably also want to export the image
-      in a more widely used format, such as JPEG, PNG, TIFF, etc.
+      When you are finished working with an image, you will save the results.
+      In fact, it is often a good idea to save at intermediate stages too.
+      <acronym>GIMP</acronym> is a pretty robust program, but on rare occasions
+      crashes have happened.
+    </para>
+    <para>
+      <acronym>GIMP</acronym>'s native format XCF is special. It is the only
+      format that can store <emphasis>everything</emphasis> about an image
+      (with the exception of <quote>undo</quote> information).
+      This is the reason that saving can only be done in this format.
+      It makes the XCF format especially suited for storing intermediate
+      results, and for saving images to be re-opened later in 
+      <acronym>GIMP</acronym>. 
+    </para>
+    <para>
+      XCF files are not readable by most other programs that display images.
+      Once you have finished editing your image, you can export it to the
+      format of your choice.
+      <acronym>GIMP</acronym> supports a wide range of formats. Most file
+      formats that can be imported, can also be used for exporting.
     </para>
   </sect2>
 
   <sect2 id="gimp-using-fileformats-export-dialog">
     <title>File Formats</title>
     <para>
-      There are several commands for <emphasis>saving</emphasis> images. A list,
-      and information on how to use them, can be found in the section covering
-      the <link linkend="gimp-file-menu">File Menu</link>.
+      There are several commands for <emphasis>saving</emphasis> and <emphasis>
+      exporting</emphasis> images. They are listed in the section covering
+      the <link linkend="gimp-file-menu">File Menu</link>. More information on
+      how to use them can be found there.
     </para>
     <para><acronym>GIMP</acronym> allows you to <emphasis>export</emphasis> the
-      images you create in a wide variety of formats.  It is important to
+      images you create in a wide variety of formats. It is important to
       realize that the only format capable of saving <emphasis>all</emphasis> of
       the information in an image, including layers, transparency, etc., is
       GIMP's native XCF format. Every other format preserves some image
@@ -102,9 +109,11 @@
         </mediaobject>
       </figure>
       <para>
-        Saving an image in any file format will cause the image to be considered
-        "not dirty", even if the file format does not represent all of the
-        information from the image.
+        Saving an image in <acronym>GIMP</acronym>'s native format XCF will
+        cause the image to be considered "not dirty".
+        On the contrary, exporting an image will not change it to "not dirty",
+        because <acronym>GIMP</acronym> can't know for sure that no image
+        information will be lost.
       </para>
     </note>