GNOME.org
 

[gnumeric] Update documentation.

commit 75f509529070ae71eba6d642ff17a447d5f5f4a4
Author: Andreas J Guelzow <aguelzow pyrshep ca>
Date:   Fri Apr 19 11:44:09 2013 -0600

    Update documentation.
    
    2013-04-19  Andreas J. Guelzow <aguelzow pyrshep ca>
    
        * files-formats.xml: updated
        * files-overview.xml: updated
        * files-textopen.xml: updated
        * gui-menus.xml: updated

 NEWS                     |   3 +
 doc/C/ChangeLog          |   7 +++
 doc/C/files-formats.xml  | 160 +++++++++++++++++++++++++++++++++++------------
 doc/C/files-overview.xml |   8 ++-
 doc/C/files-textopen.xml |   9 +--
 doc/C/gui-menus.xml      |   2 +-
 6 files changed, 141 insertions(+), 48 deletions(-)
---
diff --git a/NEWS b/NEWS
index 404390e..e506c43 100644
--- a/NEWS
+++ b/NEWS
@@ -1,5 +1,8 @@
 Gnumeric 1.12.2
 
+Andreas:
+       * Update documentation.
+
 Dominique Leuenberger:
        * Fix locale directory.
 
diff --git a/doc/C/ChangeLog b/doc/C/ChangeLog
index 38c4b16..71f968b 100644
--- a/doc/C/ChangeLog
+++ b/doc/C/ChangeLog
@@ -1,3 +1,10 @@
+2013-04-19  Andreas J. Guelzow <aguelzow pyrshep ca>
+
+       * files-formats.xml: updated
+       * files-overview.xml: updated
+       * files-textopen.xml: updated
+       * gui-menus.xml: updated
+
 2013-03-09  Morten Welinder <terra gnome org>
 
        * Release 1.12.1
diff --git a/doc/C/files-formats.xml b/doc/C/files-formats.xml
index 4adca7e..2725f4f 100644
--- a/doc/C/files-formats.xml
+++ b/doc/C/files-formats.xml
@@ -11,7 +11,7 @@
 
 <!--    TABLE    TABLE    TABLE    TABLE    TABLE    TABLE    -->
 <table frame='all'><title>The file formats supported by &gnum;</title>
-<tgroup cols='4' align='left' colsep='1' rowsep='1'>
+<tgroup cols='7' align='left' colsep='1' rowsep='1'>
        
 
 <thead>
@@ -20,20 +20,26 @@
   <entry align="left">Extension</entry>
   <entry align="left">Open</entry>
   <entry align="left">Save</entry>
+  <entry align="left">Import</entry>
+  <entry align="left">Export</entry>
   <entry align="left">MIME type</entry>
 </row>
 </thead>
 <tbody>
 <row>
   <entry><link linkend="file-format-gnumeric">Gnumeric</link></entry>
-  <entry><literal>.gnumeric</literal> / <literal>.gnm</literal></entry> 
+  <entry><literal>.gnumeric</literal> / <literal>.gnm</literal> / <literal>.xml</literal></entry> 
   <entry>YES</entry>
   <entry>YES</entry>
+  <entry></entry>
+  <entry></entry>
   <entry>application/x-gnumeric</entry>
 </row>
 <row>
   <entry><link linkend="file-format-applix">Applix</link></entry>
   <entry><literal>.as</literal></entry> 
+  <entry></entry>
+  <entry></entry>
   <entry>YES</entry>
   <entry></entry>
   <entry>application/x-applix-spreadsheet</entry>
@@ -41,6 +47,8 @@
 <row>
   <entry><link linkend="file-format-csv">Comma Separated Values</link></entry>
   <entry><literal>.csv</literal></entry> 
+  <entry></entry>
+  <entry></entry>
   <entry>YES</entry>
   <entry>YES</entry>
   <entry>text/plain</entry>
@@ -48,6 +56,8 @@
 <row>
   <entry><link linkend="file-format-dif">Data Interchange Format</link></entry>
   <entry><literal>.dif</literal></entry> 
+  <entry></entry>
+  <entry></entry>
   <entry>YES</entry>
   <entry>YES</entry>
   <entry></entry>
@@ -55,6 +65,8 @@
 <row>
   <entry><link linkend="file-format-oleo">GNU Oleo</link></entry>
   <entry><literal>.oleo</literal></entry> 
+  <entry></entry>
+  <entry></entry>
   <entry>YES</entry>
   <entry></entry>
   <entry>application/x-oleo</entry>
@@ -62,6 +74,8 @@
 <row>
   <entry><link linkend="file-format-html">HTML</link></entry>
   <entry><literal>.html</literal> / <literal>.htm</literal></entry> 
+  <entry></entry>
+  <entry></entry>
   <entry>YES</entry>
   <entry>YES</entry>
   <entry>text/html</entry>
@@ -70,12 +84,16 @@
   <entry><link linkend="file-format-latex">LaTeX</link></entry>
   <entry><literal>.tex</literal></entry> 
   <entry></entry>
+  <entry></entry>
+  <entry></entry>
   <entry>YES</entry>
   <entry>text/x-tex</entry>
 </row>
 <row>
   <entry><link linkend="file-format-mps">Linear and Integer Program</link></entry>
   <entry>none / <literal>.mps</literal></entry> 
+  <entry></entry>
+  <entry></entry>
   <entry>YES</entry>
   <entry></entry>
   <entry>application/x-mps</entry>
@@ -83,6 +101,8 @@
 <row>
   <entry><link linkend="file-format-lotus">Lotus 1-2-3</link></entry>
   <entry><literal>.wk1</literal> / <literal>.wks</literal></entry> 
+  <entry></entry>
+  <entry></entry>
   <entry>YES</entry>
   <entry></entry>
   <entry>application/vnd.lotus-1-2-3, application/x-123</entry>
@@ -93,6 +113,8 @@
   <entry><literal>.xls</literal> / <literal>.xlt</literal> / <literal>.xlw</literal></entry> 
   <entry>YES</entry>
   <entry></entry>
+  <entry></entry>
+  <entry></entry>
   <entry>application/vnd.ms-excel</entry>
 </row>
 <row>
@@ -101,13 +123,17 @@
   <entry><literal>.xls</literal> / <literal>.xlt</literal> / <literal>.xlw</literal></entry> 
   <entry>YES</entry>
   <entry>YES</entry>
+  <entry></entry>
+  <entry></entry>
   <entry>application/vnd.ms-excel</entry>
 </row>
 <row>
   <entry><link linkend="file-format-excel-oldxml">Microsoft Excel 2003 SpreadsheetML</link></entry>
   <entry><literal>.xlsx</literal></entry> 
   <entry>YES</entry>
-  <entry>YES (incomplete)</entry>
+  <entry></entry>
+  <entry></entry>
+  <entry></entry>
   <entry>application/vnd.ms-excel</entry>
 </row>
 <row>
@@ -115,14 +141,18 @@
   <entry><literal>.xlsx</literal></entry> 
   <entry>YES</entry>
   <entry>YES</entry>
+  <entry></entry>
+  <entry></entry>
   <entry>application/vnd.ms-excel</entry>
 </row>
 <row>
   <entry><link linkend="file-format-sxc">OpenOffice.Org / StarOffice
   Old Format</link></entry>
   <entry><literal>.sxc</literal> / <literal>.stc</literal></entry> 
+  <entry></entry>
+  <entry></entry>
   <entry>YES</entry>
-  <entry>YES (incomplete)</entry>
+  <entry></entry>
   <entry>application/vnd.sun.xml.calc</entry>
 </row>
 <row>
@@ -130,11 +160,15 @@
   <entry><literal>.ods</literal> / <literal>.odt</literal> / <literal>.sxc</literal> / 
<literal>.stc</literal></entry> 
   <entry>YES</entry>
   <entry>YES</entry>
+  <entry></entry>
+  <entry></entry>
   <entry>application/vnd.oasis.opendocument.spreadsheet</entry>
 </row>
 <row>
   <entry><!--<link linkend="file-format-paradox">-->Paradox Database<!--</link>--></entry>
   <entry><literal>.px</literal> / <literal>.db</literal></entry> 
+  <entry></entry>
+  <entry></entry>
   <entry>YES</entry>
   <entry>YES</entry>
   <entry></entry>
@@ -142,6 +176,8 @@
 <row>
   <entry><link linkend="file-format-planperfect">Plan Perfect</link></entry>
   <entry><literal>.pln</literal></entry> 
+  <entry></entry>
+  <entry></entry>
   <entry>YES</entry>
   <entry></entry>
   <entry>application/x-planperfect</entry>
@@ -149,6 +185,8 @@
 <row>
   <entry><!--<link linkend="file-format-psiconv">-->Psion 5 Sheet Files<!--</link>--></entry>
   <entry><literal>.psisheet</literal></entry> 
+  <entry></entry>
+  <entry></entry>
   <entry>YES</entry>
   <entry></entry>
   <entry></entry>
@@ -157,6 +195,8 @@
   <entry><link linkend="file-format-ps">Postscript</link></entry>
   <entry><literal>.ps</literal> / <literal>.eps</literal></entry> 
   <entry></entry>
+  <entry></entry>
+  <entry></entry>
   <entry>YES</entry>
   <entry>application/postscript</entry>
 </row>
@@ -164,12 +204,16 @@
   <entry><link linkend="file-format-pdf">PDF</link></entry>
   <entry><literal>.pdf</literal></entry> 
   <entry></entry>
+  <entry></entry>
+  <entry></entry>
   <entry>YES</entry>
   <entry>application/pdf</entry>
 </row>
 <row>
   <entry><link linkend="file-format-qpro">Quattro Pro</link></entry>
   <entry><literal>.wb1</literal> / <literal>.wb2</literal> / <literal>.wb3</literal></entry> 
+  <entry></entry>
+  <entry></entry>
   <entry>YES</entry>
   <entry></entry>
   <entry>application/x-quattropro, application/x-quattro-pro</entry>
@@ -177,6 +221,8 @@
 <row>
   <entry><link linkend="file-format-sc">SC/XSpread</link></entry>
   <entry>none / .<literal>sc</literal></entry> 
+  <entry></entry>
+  <entry></entry>
   <entry>YES</entry>
   <entry></entry>
   <entry>application/x-sc</entry>
@@ -186,11 +232,15 @@
   <entry> <literal>.sylk</literal> / <literal>.slk</literal></entry> 
   <entry>YES</entry>
   <entry>YES</entry>
+  <entry></entry>
+  <entry></entry>
   <entry>application/x-sylk</entry>
 </row>
 <row>
   <entry><link linkend="file-format-tab">Tab Separated Values</link></entry>
   <entry><literal>.tsv</literal> / <literal>.tab</literal></entry> 
+  <entry></entry>
+  <entry></entry>
   <entry>YES</entry>
   <entry>YES</entry>
   <entry>text/plain</entry>
@@ -198,6 +248,8 @@
 <row>
   <entry><link linkend="file-format-text">Text Formats</link></entry>
   <entry><literal>.txt</literal> / <literal>.text</literal></entry> 
+  <entry></entry>
+  <entry></entry>
   <entry>YES</entry>
   <entry>YES</entry>
   <entry>text/plain</entry>
@@ -206,12 +258,16 @@
   <entry><link linkend="file-format-troff">TROFF</link></entry>
   <entry><literal>.me</literal></entry> 
   <entry></entry>
+  <entry></entry>
+  <entry></entry>
   <entry>YES</entry>
   <entry>application/x-troff</entry>
 </row>
 <row>
   <entry><link linkend="file-format-xbase">Xbase</link></entry>
   <entry><literal>.dbf</literal></entry> 
+  <entry></entry>
+  <entry></entry>
   <entry>YES</entry>
   <entry></entry>
   <entry>application/dbase, application/dbf, application/x-dbase,
@@ -221,6 +277,8 @@
   <entry><link linkend="file-format-xhtml">XHTML</link></entry>
   <entry><literal>.xhtml</literal> / <literal>.html</literal></entry> 
   <entry></entry>
+  <entry></entry>
+  <entry></entry>
   <entry>YES</entry>
   <entry>application/xhtml+xml</entry>
 </row>
@@ -229,6 +287,20 @@
 </table>
 <!--    TABLE    TABLE    TABLE    TABLE    TABLE    TABLE    -->
 
+<note>
+  <para>
+    Files in the file formats marked as Save/Open can be opened or saved
+    with the
+    <guimenuitem>Open</guimenuitem>, <guimenuitem>Save</guimenuitem>,
+    and <guimenuitem>Save As</guimenuitem> menu items in the
+    <guimenuitem>File</guimenuitem> menu.
+    Files in the file formats marked as Import/Export can be imported or
+    exported with the items on the
+    <guimenuitem>Import Data</guimenuitem> and <guimenuitem>Export Data
+    </guimenuitem> submenus of the 
+    <guimenuitem>Data</guimenuitem> menu. 
+  </para>
+</note>
 
 
 
@@ -550,9 +622,9 @@ gunzip Book1.text.gz
          </row>
          <row>
            <entry>
-             <emphasis role="bold">Open / Save:</emphasis>
+             <emphasis role="bold">Import / Export:</emphasis>
            </entry>
-           <entry>Open only</entry>
+           <entry>Import only</entry>
          </row>
        </tbody>
       </tgroup>
@@ -659,7 +731,7 @@ gunzip Book1.text.gz
          </row>
          <row>
            <entry>
-             <emphasis role="bold">Open / Save:</emphasis>
+             <emphasis role="bold">Import / Export:</emphasis>
            </entry>
            <entry>Both</entry>
          </row>
@@ -773,7 +845,7 @@ gunzip Book1.text.gz
          </row>
          <row>
            <entry>
-             <emphasis role="bold">Open / Save:</emphasis>
+             <emphasis role="bold">Import / Export:</emphasis>
            </entry>
            <entry>Both</entry>
          </row>
@@ -879,7 +951,7 @@ gunzip Book1.text.gz
          </row>
          <row>
            <entry>
-             <emphasis role="bold">Open / Save:</emphasis>
+             <emphasis role="bold">Import / Export:</emphasis>
            </entry>
            <entry>Open Only</entry>
          </row>
@@ -978,9 +1050,9 @@ gunzip Book1.text.gz
          </row>
          <row>
            <entry>
-             <emphasis role="bold">Open / Save:</emphasis>
+             <emphasis role="bold">Import / Export:</emphasis>
            </entry>
-           <entry>Save Only, but also can import HTML &lt;table&gt; 
+           <entry>Export only, but also can import HTML &lt;table&gt; 
                   structures</entry>
          </row>
        </tbody>
@@ -1161,9 +1233,9 @@ gunzip Book1.text.gz
          </row>
          <row>
            <entry>
-             <emphasis role="bold">Open / Save:</emphasis>
+             <emphasis role="bold">Import / Export:</emphasis>
            </entry>
-           <entry>Save only</entry>
+           <entry>Export only</entry>
          </row>
        </tbody>
       </tgroup>
@@ -1421,9 +1493,9 @@ pdflatex Book1.tex
          </row>
          <row>
            <entry>
-             <emphasis role="bold">Open / Save:</emphasis>
+             <emphasis role="bold">Import / Export:</emphasis>
            </entry>
-           <entry>Open only</entry>
+           <entry>Import only</entry>
          </row>
        </tbody>
       </tgroup>
@@ -1561,9 +1633,9 @@ Columns:  2-3        5-12      15-22     25-36     40-47     50-61
          </row>
          <row>
            <entry>
-             <emphasis role="bold">Open / Save:</emphasis>
+             <emphasis role="bold">Import / Export:</emphasis>
            </entry>
-           <entry>Open only.</entry>
+           <entry>Import only.</entry>
          </row>
        </tbody>
       </tgroup>
@@ -2146,9 +2218,9 @@ Columns:  2-3        5-12      15-22     25-36     40-47     50-61
          </row>
          <row>
            <entry>
-             <emphasis role="bold">Open / Save:</emphasis>
+             <emphasis role="bold">Import / Export:</emphasis>
            </entry>
-           <entry>Open only</entry>
+           <entry>Import only</entry>
          </row>
        </tbody>
       </tgroup>
@@ -2367,7 +2439,7 @@ Columns:  2-3        5-12      15-22     25-36     40-47     50-61
          </row>
          <row>
            <entry>
-             <emphasis role="bold">Open / Save:</emphasis>
+             <emphasis role="bold">Import / Export:</emphasis>
            </entry>
            <entry>Both</entry>
          </row>
@@ -2454,9 +2526,9 @@ Columns:  2-3        5-12      15-22     25-36     40-47     50-61
          </row>
          <row>
            <entry>
-             <emphasis role="bold">Open / Save:</emphasis>
+             <emphasis role="bold">Import / Export:</emphasis>
            </entry>
-           <entry>Open only.</entry>
+           <entry>Import only.</entry>
          </row>
        </tbody>
       </tgroup>
@@ -2569,9 +2641,9 @@ Columns:  2-3        5-12      15-22     25-36     40-47     50-61
          </row>
          <row>
            <entry>
-             <emphasis role="bold">Open / Save:</emphasis>
+             <emphasis role="bold">Import / Export:</emphasis>
            </entry>
-           <entry>Save only.</entry>
+           <entry>Export only</entry>
          </row>
        </tbody>
       </tgroup>
@@ -2698,9 +2770,9 @@ Columns:  2-3        5-12      15-22     25-36     40-47     50-61
          </row>
          <row>
            <entry>
-             <emphasis role="bold">Open / Save:</emphasis>
+             <emphasis role="bold">Import / Export:</emphasis>
            </entry>
-           <entry>Save only</entry>
+           <entry>Export only</entry>
          </row>
        </tbody>
       </tgroup>
@@ -2809,9 +2881,9 @@ Columns:  2-3        5-12      15-22     25-36     40-47     50-61
          </row>
          <row>
            <entry>
-             <emphasis role="bold">Open / Save:</emphasis>
+             <emphasis role="bold">Import / Export:</emphasis>
            </entry>
-           <entry>Open only</entry>
+           <entry>Import only</entry>
          </row>
        </tbody>
       </tgroup>
@@ -2900,9 +2972,9 @@ Columns:  2-3        5-12      15-22     25-36     40-47     50-61
          </row>
          <row>
            <entry>
-             <emphasis role="bold">Open / Save:</emphasis>
+             <emphasis role="bold">Import / Export:</emphasis>
            </entry>
-           <entry>Open only.</entry>
+           <entry>Import only.</entry>
          </row>
        </tbody>
       </tgroup>
@@ -3011,7 +3083,7 @@ Columns:  2-3        5-12      15-22     25-36     40-47     50-61
          </row>
          <row>
            <entry>
-             <emphasis role="bold">Open / Save:</emphasis>
+             <emphasis role="bold">Import / Export:</emphasis>
            </entry>
            <entry>Both</entry>
          </row>
@@ -3108,7 +3180,14 @@ Columns:  2-3        5-12      15-22     25-36     40-47     50-61
     </para>
 
     <para>
-      Choosing the "Text import (configurable)" or "Text export
+      Choosing <guimenuitem>Import Text File...</guimenuitem> menu
+      item in the
+      <guimenuitem>Import Data</guimenuitem> submenu of the
+      <guimenuitem>Data</guimenuitem> menu or the <guimenuitem>Import
+      Other File...</guimenuitem> menu item in the
+      <guimenuitem>Import Data</guimenuitem> submenu of the
+      <guimenuitem>Data</guimenuitem> menu and specifying the
+      "Text import (configurable)" or "Text export
       (configurable)" file formats to open or save files will cause
       &gnum; to start the <interface>Text Import</interface> or
       <interface>Text Export</interface> druids. These allow the users
@@ -3132,13 +3211,14 @@ Columns:  2-3        5-12      15-22     25-36     40-47     50-61
     </para>
 
     <para>
-      &gnum; can open and save files to a wide variety of text file
+      &gnum; can import and export files from and to a wide variety
+      of text file
       formats when the text importer or the text exporter is
       configured appropriately. File can be generated with many
       different encodings. See the section on <link
       linkend="sect-file-textImport">importing text files</link> or
       the section on <link linkend="sect-file-textExport">exporting
-      text files</link> for an explanation of how to open or save
+      text files</link> for an explanation of how to import or export
       these formatted text files.
     </para>
 
@@ -3166,7 +3246,7 @@ Columns:  2-3        5-12      15-22     25-36     40-47     50-61
          </row>
          <row>
            <entry>
-             <emphasis role="bold">Open / Save:</emphasis>
+             <emphasis role="bold">Import / Export:</emphasis>
            </entry>
            <entry>Both</entry>
          </row>
@@ -3287,9 +3367,9 @@ Columns:  2-3        5-12      15-22     25-36     40-47     50-61
          </row>
          <row>
            <entry>
-             <emphasis role="bold">Open / Save:</emphasis>
+             <emphasis role="bold">Import / Export:</emphasis>
            </entry>
-           <entry>Save only</entry>
+           <entry>Export only</entry>
          </row>
        </tbody>
       </tgroup>
@@ -3498,9 +3578,9 @@ Sheet 0
          </row>
          <row>
            <entry>
-             <emphasis role="bold">Open / Save:</emphasis>
+             <emphasis role="bold">Import / Export:</emphasis>
            </entry>
-           <entry>Open only</entry>
+           <entry>Import only</entry>
          </row>
        </tbody>
       </tgroup>
@@ -3613,7 +3693,7 @@ Sheet 0
          </row>
          <row>
            <entry>
-             <emphasis role="bold">Open / Save:</emphasis>
+             <emphasis role="bold">Import / Export:</emphasis>
            </entry>
            <entry>Both</entry>
          </row>
diff --git a/doc/C/files-overview.xml b/doc/C/files-overview.xml
index 90be90a..02cd5f4 100644
--- a/doc/C/files-overview.xml
+++ b/doc/C/files-overview.xml
@@ -28,8 +28,10 @@
     Excel. &gnum; can use the Excel file format as if it were the
     native file format, meaning that &gnum; can store and retrieve
     essentially every aspect of a worksheet using the Excel
-    format. Similarly, &gnum; supports the OASIS standard Open Office
-    XML file format as if it were the native format.
+    format. Similarly, &gnum; supports the OASIS Open Document Format
+    for Office Applications (ODF 1.2) file format (ISO/IEC 26300:2006/Amd
+    1:2012) as well as the ECMA 376 2nd Edition file format (ISO/IEC 
+    29500:2008) as if they were the native format.
   </para>
 
   <warning>
@@ -57,7 +59,7 @@
     systems to structure the data such as using commas, tabs or spaces
     to separate values. &gnum; features a flexible system that enables
     users to define exactly the structure of the text file to be
-    opened or saved.
+    imported or exported.
   </para>
 
   <para>
diff --git a/doc/C/files-textopen.xml b/doc/C/files-textopen.xml
index 203d27a..6576619 100644
--- a/doc/C/files-textopen.xml
+++ b/doc/C/files-textopen.xml
@@ -10,10 +10,11 @@
     intervention on the part of the user so &gnum; provides a
     <interface>Text Import</interface> druid, which is a three paneled
     dialog with configuration options. For text imported from files,
-    this druid appears after the file has been opened, using the file
-    format named "Text Import (configurable)" in the <interface>File
-    Open</interface> dialog, as is explained in <xref
-    linkend="sect-file-open" />. For text imported from the clipboard,
+    this druid appears after the file has been imported, using the 
+    <guimenuitem>Import Text File...</guimenuitem> menu item in the
+    <guimenuitem>Import Data</guimenuitem> submenu of the
+    <guimenuitem>Data</guimenuitem> menu as described in
+    <xref linkend="Data-Menu"/>. For text imported from the clipboard,
     the druid appears when a user attempts to paste the text into a
     worksheet, as is explained in <xref
     linkend="sect-movecopy-xclipboard" />.
diff --git a/doc/C/gui-menus.xml b/doc/C/gui-menus.xml
index 92b0f1a..8008ebc 100644
--- a/doc/C/gui-menus.xml
+++ b/doc/C/gui-menus.xml
@@ -2346,7 +2346,7 @@
              <para>
                The items in this submenu allow the user to import data
                from various non-spreadsheet formats. To open files in  a
-               non-spreadsheet format,
+               spreadsheet format,
                use the <guimenuitem>Open</guimenuitem> menu described in
                <xref linkend="File-Menu"/>. See <xref
                linkend="sect-file-formats" /> for details.  These
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]