home *** CD-ROM | disk | FTP | other *** search
/ Freelog 65 / Freelog065.iso / BAS / Bureautique / Gnumeric / gnumeric-1.3.92-rc1.exe / files-formats.xml < prev    next >
Encoding:
Text File  |  2004-11-01  |  78.2 KB  |  3,188 lines
  1. <sect1 id="sect-file-formats">
  2.   <title>File Formats</title>
  3.     
  4.   <para>
  5.     &gnum; supports numerous file formats in addition to its own XML
  6.     based format. The table below lists the formats currently
  7.     supported. In the table below, the name of the format is a link
  8.     which can be used to jump to the section which discusses the
  9.     format.
  10.   </para>
  11.  
  12. <!--    TABLE    TABLE    TABLE    TABLE    TABLE    TABLE    -->
  13. <table frame='all'><title>The file formats supported by &gnum;</title>
  14. <tgroup cols='4' align='left' colsep='1' rowsep='1'>
  15.        
  16.  
  17. <thead>
  18. <row>
  19.   <entry align="left">Format</entry>
  20.   <entry align="left">Extension</entry>
  21.   <entry align="left">Open</entry>
  22.   <entry align="left">Save</entry>
  23. </row>
  24. </thead>
  25. <tbody>
  26. <row>
  27.   <entry><link linkend="file-format-gnumeric">Gnumeric</link></entry>
  28.   <entry><literal>.gnumeric</literal> / <literal>.gnm</literal></entry> 
  29.   <entry>YES</entry>
  30.   <entry>YES</entry>
  31. </row>
  32. <row>
  33.   <entry><link linkend="file-format-applix">Applix</link></entry>
  34.   <entry><literal>.as</literal></entry> 
  35.   <entry>YES</entry>
  36.   <entry></entry>
  37. </row>
  38. <row>
  39.   <entry><link linkend="file-format-csv">Comma Separated Values</link></entry>
  40.   <entry><literal>.csv</literal></entry> 
  41.   <entry>YES</entry>
  42.   <entry>YES</entry>
  43. </row>
  44. <row>
  45.   <entry><link linkend="file-format-dif">Data Interchange Format</link></entry>
  46.   <entry><literal>.dif</literal></entry> 
  47.   <entry>YES</entry>
  48.   <entry>YES</entry>
  49. </row>
  50. <row>
  51.   <entry><link linkend="file-format-oleo">GNU Oleo</link></entry>
  52.  <entry><literal>.oleo</literal></entry> 
  53.   <entry>YES</entry>
  54.   <entry></entry>
  55. </row>
  56. <row>
  57.   <entry><link linkend="file-format-html">HTML</link></entry>
  58.   <entry><literal>.html</literal> / <literal>.htm</literal></entry> 
  59.   <entry>YES</entry>
  60.   <entry>YES</entry>
  61. </row>
  62. <row>
  63.   <entry><link linkend="file-format-latex">LaTeX</link></entry>
  64.   <entry><literal>.tex</literal></entry> 
  65.   <entry></entry>
  66.   <entry>YES</entry>
  67. </row>
  68. <row>
  69.   <entry><link linkend="file-format-mps">Linear and Integer Program</link></entry>
  70.   <entry>none / <literal>.mps</literal></entry> 
  71.   <entry>YES</entry>
  72.   <entry></entry>
  73. </row>
  74. <row>
  75.   <entry><link linkend="file-format-lotus">Lotus 1-2-3</link></entry>
  76.   <entry><literal>.wk1</literal> / <literal>.wks</literal></entry> 
  77.   <entry>YES</entry>
  78.   <entry></entry>
  79. </row>
  80. <row>
  81.   <entry><link linkend="file-format-excel">Microsoft Excel</link></entry>
  82.   <entry><literal>.xls</literal></entry> 
  83.   <entry>YES</entry>
  84.   <entry>YES</entry>
  85. </row>
  86. <row>
  87.   <entry><link linkend="file-format-multiplan">Multiplan SYLK</link></entry>
  88.   <entry><literal>none / .slk</literal></entry> 
  89.   <entry>YES</entry>
  90.   <entry></entry>
  91. </row>
  92. <row>
  93.   <entry><link linkend="file-format-ooo">OpenOffice.Org / StarOffice</link></entry>
  94.   <entry><literal>.sxc</literal></entry> 
  95.   <entry>YES</entry>
  96.   <entry>YES</entry>
  97. </row>
  98. <row>
  99.   <entry><link linkend="file-format-planperfect">Plan Perfect</link></entry>
  100.   <entry><literal>.pln</literal></entry> 
  101.   <entry>YES</entry>
  102.   <entry></entry>
  103. </row>
  104. <row>
  105.   <entry><link linkend="file-format-ps">Postscript</link></entry>
  106.   <entry><literal>.ps</literal> / <literal>.eps</literal></entry> 
  107.   <entry></entry>
  108.   <entry>YES</entry>
  109. </row>
  110. <row>
  111.   <entry><link linkend="file-format-pdf">PDF</link></entry>
  112.   <entry><literal>.pdf</literal></entry> 
  113.   <entry></entry>
  114.   <entry>YES</entry>
  115. </row>
  116. <row>
  117.   <entry><link linkend="file-format-qpro">Quattro Pro</link></entry>
  118.   <entry><literal>.wb1</literal> / <literal>.wb2</literal> / <literal>.wb3</literal></entry> 
  119.   <entry>YES</entry>
  120.   <entry></entry>
  121. </row>
  122. <row>
  123.   <entry><link linkend="file-format-sc">SC/XSpread</link></entry>
  124.   <entry>none / .<literal>sc</literal></entry> 
  125.   <entry>YES</entry>
  126.   <entry></entry>
  127. </row>
  128. <row>
  129.   <entry><link linkend="file-format-tab">Tab Separated Values</link></entry>
  130.   <entry><literal>.tsv</literal> / <literal>.tab</literal></entry> 
  131.   <entry>YES</entry>
  132.   <entry>YES</entry>
  133. </row>
  134. <row>
  135.   <entry><link linkend="file-format-text">Text Formats</link></entry>
  136.   <entry><literal>.txt</literal> / <literal>.text</literal></entry> 
  137.   <entry>YES</entry>
  138.   <entry>YES</entry>
  139. </row>
  140. <row>
  141.   <entry><link linkend="file-format-troff">TROFF</link></entry>
  142.   <entry><literal>.me</literal></entry> 
  143.   <entry></entry>
  144.   <entry>YES</entry>
  145. </row>
  146. <row>
  147.   <entry><link linkend="file-format-xbase">Xbase</link></entry>
  148.   <entry><literal>.dbf</literal></entry> 
  149.   <entry>YES</entry>
  150.   <entry></entry>
  151. </row>
  152. <row>
  153.   <entry><link linkend="file-format-xhtml">XHTML</link></entry>
  154.   <entry><literal>.xhtml</literal> / <literal>.html</literal></entry> 
  155.   <entry></entry>
  156.   <entry>YES</entry>
  157. </row>
  158. </tbody>
  159. </tgroup>
  160. </table>
  161. <!--    TABLE    TABLE    TABLE    TABLE    TABLE    TABLE    -->
  162.  
  163.  
  164.  
  165.  
  166.   <sect2 id="file-format-gnumeric">
  167.     <title>&gnum; XML File Format</title>
  168.  
  169.     <para>
  170.       The &gnum; file format is based on the eXtensible Markup
  171.       Language (XML) and is used as the default file format.
  172.     </para>
  173.  
  174.     <note>
  175.       <para>
  176.         &gnum; is currently using two different systems to process
  177.         XML.
  178.       </para>
  179.  
  180.       <para>
  181.         The newer system is based on the SAX processing method for XML
  182.         and is substantially faster than the older method. This code
  183.         is based in a plugin module. The exporter is currently used
  184.         by default but the importer is still incomplete.
  185.       </para>
  186.  
  187.       <para>
  188.     The older system is part of the core &gnum; program and is
  189.         still used to open files in the &gnum; format.
  190.       </para>
  191.     </note>
  192.  
  193.  
  194.     <informaltable frame='all'>
  195.       <tgroup cols='2' align='left' colsep='1' rowsep='1'>
  196.         <tbody>
  197.       <row>
  198.         <entry>
  199.           <emphasis role="bold">Name:</emphasis>
  200.         </entry>
  201.         <entry>The Gnumeric file format</entry>
  202.       </row>
  203.       <row>
  204.         <entry>
  205.           <emphasis role="bold">Extensions:</emphasis>
  206.         </entry>
  207.         <entry><literal>.gnumeric</literal></entry>
  208.       </row>
  209.       <row>
  210.         <entry>
  211.           <emphasis role="bold">Compatible Programs:</emphasis>
  212.             </entry>
  213.         <entry>&gnum;</entry>
  214.       </row>
  215.       <row>
  216.         <entry>
  217.           <emphasis role="bold">Open / Save:</emphasis>
  218.         </entry>
  219.         <entry>Both</entry>
  220.       </row>
  221.     </tbody>
  222.       </tgroup>
  223.     </informaltable>
  224.  
  225.     <variablelist>
  226.       <!-- <title></title> -->
  227.       <varlistentry>
  228.         <term>
  229.       <emphasis role="bold">Limitations</emphasis>
  230.     </term>
  231.     <listitem>
  232.       <para>
  233.         This is the default file format and therefore has the best
  234.             support of all the formats available. Every feature that
  235.         can be created in the spreadsheet should be savable using
  236.         this format.
  237.       </para>
  238.     </listitem>
  239.       </varlistentry>
  240.  
  241.       <varlistentry>
  242.         <term>
  243.       <emphasis role="bold">Plugin</emphasis>
  244.     </term>
  245.     <listitem>
  246.       <para>
  247.         The &gnum; file format is handled using two different code
  248.         bases. The older version is part of the application
  249.         itself. The newer version is in a plugin called
  250.         "EXPERIMENTAL SAX based XML" because the parser is based
  251.         on SAX.
  252. <!-- TODO: explain SAX differences and advantages. -->
  253.       </para>
  254.     </listitem>
  255.       </varlistentry>
  256.  
  257.       <varlistentry>
  258.         <term>
  259.       <emphasis role="bold">Format Details</emphasis>
  260.     </term>
  261.     <listitem>
  262.       <para>
  263.             The &gnum; file format stores the file contents in the
  264.             eXtensible Markup Language (XML) and compresses the file
  265.             using the GNU project's <application>gzip</application>
  266.             compression library.
  267.           </para>
  268.  
  269.           <para>
  270.             The &gnum; file format is designed to be flexible and
  271.             powerful. The format is easily processed by computers. The
  272.             format can readily be improved as gnumeric develops
  273.             without breaking compatibility with older versions. The
  274.             format is designed to be easily translated into text so
  275.             that it can be read by humans.
  276.           </para>
  277.  
  278.       <para>
  279.         &gnum; automatically recognizes the version of the file
  280.         format of any file saved since this format is contained in
  281.         the file header. The table below is for information
  282.         purposes only.
  283.  
  284. <!--    TABLE    TABLE    TABLE    TABLE    TABLE    TABLE    -->
  285. <table frame='all'>
  286.   <title>Gnumeric XML format versions</title>
  287. <tgroup cols='2' align='left' colsep='1' rowsep='1'>
  288.        
  289.  
  290. <thead>
  291. <row>
  292.   <entry align="center">XML File Format Version</entry>
  293.   <entry align="center">Gnumeric Version</entry>
  294. </row>
  295. </thead>
  296. <tbody>
  297. <row>
  298.    <entry>1</entry>
  299.   <entry></entry>
  300. </row>
  301. <row>
  302.    <entry>2</entry>
  303.   <entry></entry>
  304. </row>
  305. <row>
  306.    <entry>3</entry>
  307.   <entry>Since 0.52</entry>
  308. </row>
  309. <row>
  310.    <entry>4</entry>
  311.   <entry>Since 0.57</entry>
  312. </row>
  313. <row>
  314.    <entry>5</entry>
  315.   <entry>Since 0.58</entry>
  316. </row>
  317. <row>
  318.    <entry>6</entry>
  319.   <entry>Since 0.62</entry>
  320. </row>
  321. <row>
  322.    <entry>7</entry>
  323.   <entry>Since 0.66</entry>
  324. </row>
  325. <row>
  326.    <entry>8</entry>
  327.   <entry>Since 0.71</entry>
  328. </row>
  329. <row>
  330.    <entry>9</entry>
  331.   <entry>Since 0.73</entry>
  332. </row>
  333. <row>
  334.    <entry>10</entry>
  335.   <entry>Since 1.03</entry>
  336. </row>
  337. </tbody>
  338. </tgroup>
  339. </table>
  340.       </para>
  341.  
  342.       <para>
  343.         An outdated PDF document discussing the &gnum; file format
  344.         which should provide a useful starting point was developed
  345.         by the JWorkbook project. The file can be downloaded from
  346.         <literal><ulink type="http"
  347.         url="http://www.jfree.org/jworkbook/gnumeric-xml.pdf">
  348.         http://www.jfree.org/jworkbook/gnumeric-xml.pdf</ulink></literal>.
  349.       </para>
  350.  
  351.  
  352.  
  353.     </listitem>
  354.       </varlistentry>
  355.  
  356.       <varlistentry>
  357.         <term>
  358.       <emphasis role="bold">Further Processing</emphasis>
  359.     </term>
  360.     <listitem>
  361.       <para>
  362.             Direct manipulation of &gnum; files is possible by
  363.         transforming the files to text files and then using
  364.         standard text file tools like document editors. In order
  365.         to read the contents a &gnum; file must first be
  366.         decompressed and can then be opened. In GNU systems, the
  367.         &gnum; default file "Book1.gnumeric" can be uncompressed
  368.         as follows:
  369. <screen>
  370. zcat Book1.gnumeric > Book1.text
  371. </screen>
  372.             alternatively, the file can be renamed and then
  373.             uncompressed with the following pair of commands:
  374. <screen>
  375. cp Book1.gnumeric Book1.text.gz
  376. gunzip Book1.text.gz
  377. </screen>
  378.             both possibilities yield the file "Book1.text" which is
  379.             an ASCII text file. This file can be opened in any editor,
  380.             like <application>Vim</application> or
  381.             <application>Emacs</application>,
  382.             or pager, like <application>Less</application>.
  383.           </para>
  384.  
  385.       <para></para>
  386. <!-- TODO Ask Shaun: why is this needed to get a par break? -->
  387.  
  388. <!-- TODO: add uses of XML manipulation of .gnumeric files. -->
  389.           <para>
  390.         XML manipulation tools can be used to transform &gnum;
  391.             files and access the data they contain, since the file
  392.             format is XML. The file can be validated by a Document
  393.             Type Definition document. Each &gnum; file format version
  394.             has its own DTD.
  395. <!-- TODO: get link to gnumeric DTD
  396.             These are available via the Internet
  397.             at <uri>http://www.gnome.org/projects/gnumeric/v10.dtd</uri>.
  398.  -->
  399.           </para>
  400.  
  401.       <para>
  402.         The Java<trademark/> Language can be used to create,
  403.         access, or manipulate &gnum; format files using the
  404.         <application>JWorkbook</application> project library. See
  405.         the project's <ulink type="http"
  406.         url="http://http://www.jfree.org/jworkbook/index.html">
  407.         website</ulink> for details.
  408.       </para>
  409.  
  410.       <para>
  411.         The C# language, through the
  412.         <application>mono</application> implementation can also be
  413.         used to manipulate &gnum; format files. 
  414. <!-- TODO: get link to C# version of JWorkbook
  415.              See the project's
  416.         <ulink type="http" linkend="" > website</ulink> for
  417.         details.
  418. -->
  419.       </para>
  420.  
  421.  
  422.     </listitem>
  423.       </varlistentry>
  424.  
  425.     </variablelist>
  426.  
  427.  
  428.   </sect2>
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.   <sect2 id="file-format-applix">
  440.     <title>Applix File Format</title>
  441.  
  442.     <para>
  443.       The Applix file format is used by the
  444.     <application>Applixware</application> group of applications which
  445.     include a spreadsheet component. The
  446.     <application>Applixware</application> spreadsheet is made by
  447.     <ulink type="http"
  448.     url="http://www.vistasource.com">Vistasource</ulink> and
  449.     claims to be a 'real-time', event driven software system.
  450.     </para>
  451.  
  452.     <para>
  453.       &gnum; can read some files produced by the
  454.       <application>Applixware</application> spreadsheet.
  455.     </para>
  456.  
  457.     <informaltable frame='all'>
  458.       <tgroup cols='2' align='left' colsep='1' rowsep='1'>
  459.         <tbody>
  460.       <row>
  461.         <entry>
  462.           <emphasis role="bold">Name:</emphasis>
  463.         </entry>
  464.         <entry>The Applix File Format</entry>
  465.       </row>
  466.       <row>
  467.         <entry>
  468.           <emphasis role="bold">Extensions:</emphasis>
  469.         </entry>
  470.         <entry>.as</entry>
  471.       </row>
  472.       <row>
  473.         <entry>
  474.           <emphasis role="bold">Compatible Programs:</emphasis>
  475.             </entry>
  476.         <entry>The <application>Applixware</application> Spreadsheet</entry>
  477.       </row>
  478.       <row>
  479.         <entry>
  480.           <emphasis role="bold">Open / Save:</emphasis>
  481.         </entry>
  482.         <entry>Open only</entry>
  483.       </row>
  484.     </tbody>
  485.       </tgroup>
  486.     </informaltable>
  487.  
  488.     <variablelist>
  489.       <!-- <title></title> -->
  490.       <varlistentry>
  491.         <term>
  492.       <emphasis role="bold">Limitations</emphasis>
  493.     </term>
  494.     <listitem>
  495.       <para>
  496.         Saving <application>Applixware</application> files has
  497.             recently been disabled due to lack of developer
  498.             interest. Instead of directly saving a file in the
  499.             <application>Applix</application> format, files can be
  500.             exported to to <application>Applixware</application> can
  501.             be performed using the <link
  502.             linkend="file-format-excel">Excel</link> file format.
  503.       </para>
  504.     </listitem>
  505.       </varlistentry>
  506.  
  507.       <varlistentry>
  508.         <term>
  509.       <emphasis role="bold">Plugin</emphasis>
  510.     </term>
  511.     <listitem>
  512.       <para>
  513.         Supported by the Applix plugin.
  514.       </para>
  515.     </listitem>
  516.       </varlistentry>
  517.  
  518.       <varlistentry>
  519.         <term>
  520.       <emphasis role="bold">Format Details</emphasis>
  521.     </term>
  522.     <listitem>
  523.       <para>
  524.       </para>
  525.     </listitem>
  526.       </varlistentry>
  527.  
  528.     </variablelist>
  529.  
  530.  
  531.   </sect2>
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.   <sect2 id="file-format-csv">
  543.     <title>Comma Separated Value (CSV) File Format</title>
  544.  
  545. <!-- TODO: explain locale prob- CSV file comma vs. decimal separator -->
  546.  
  547.     <para>
  548.       The Comma Separated Value (CSV) file format is a common
  549.       structuring strategy for text format files. In CSV flies, each
  550.       line in the file represents a row of data and, within each line
  551.       of the file, the different data fields are separated from one
  552.       another using a comma. &gnum; handles CSV files through the text
  553.       importer and exporter but this format is given its own
  554.       definition in this document because it is such a common format.
  555.     </para>
  556.  
  557.     <para>
  558.       &gnum; will automatically open CSV format files separating each
  559.       row into columns based on the presence of comma characters in
  560.       the file. If the automatic import leads to any errors, these can
  561.       generally be corrected by using the "Text Import (configurable)"
  562.       file format instead. Selecting that file format will launch the
  563.       <interface>Text Import</interface> druid which allows the user
  564.       to import CSV format files while specifying in greater detail
  565.       the settings of the import configuration parameters. See the
  566.       section on <link linkend="sect-file-textImport">importing text
  567.       files</link> or the section on <link
  568.       linkend="sect-file-textExport">exporting text files</link> for
  569.       an explanation of how to open or save CSV files through the
  570.       <interface>Text Import</interface> druid.
  571.     </para>
  572.  
  573.     <informaltable frame='all'>
  574.       <tgroup cols='2' align='left' colsep='1' rowsep='1'>
  575.         <tbody>
  576.       <row>
  577.         <entry>
  578.           <emphasis role="bold">Name:</emphasis>
  579.         </entry>
  580.         <entry>Comma Separated Value, CSV</entry>
  581.       </row>
  582.       <row>
  583.         <entry>
  584.           <emphasis role="bold">Extensions:</emphasis>
  585.         </entry>
  586.         <entry>.csv, .txt</entry>
  587.       </row>
  588.       <row>
  589.         <entry>
  590.           <emphasis role="bold">Compatible Programs:</emphasis>
  591.             </entry>
  592.         <entry>Many</entry>
  593.       </row>
  594.       <row>
  595.         <entry>
  596.           <emphasis role="bold">Open / Save:</emphasis>
  597.         </entry>
  598.         <entry>Both</entry>
  599.       </row>
  600.     </tbody>
  601.       </tgroup>
  602.     </informaltable>
  603.  
  604.     <variablelist>
  605.       <!-- <title></title> -->
  606.       <varlistentry>
  607.         <term>
  608.       <emphasis role="bold">Limitations</emphasis>
  609.     </term>
  610.     <listitem>
  611.       <para>
  612.         The CSV file format is only useful for the exchange of
  613.             cell data and cannot be used for sheet objects like
  614.             graphical plots. This file format cannot save the
  615.             formatting of cell contents, backgrounds or borders.
  616.       </para>
  617.     </listitem>
  618.       </varlistentry>
  619.  
  620.       <varlistentry>
  621.         <term>
  622.       <emphasis role="bold">Plugin</emphasis>
  623.     </term>
  624.     <listitem>
  625.       <para>
  626.         Supported by the core &gnum; program.
  627.       </para>
  628.     </listitem>
  629.       </varlistentry>
  630.  
  631.       <varlistentry>
  632.         <term>
  633.       <emphasis role="bold">Format Details</emphasis>
  634.     </term>
  635.     <listitem>
  636.       <para>
  637.         CSV files are simple text files where each row of the text
  638.         file represents one row in the spreadsheet and where the
  639.         cells within a row are separated from each other by a
  640.         comma. 
  641.       </para>
  642.     </listitem>
  643.       </varlistentry>
  644.  
  645.       <varlistentry>
  646.         <term>
  647.       <emphasis role="bold">Further Processing</emphasis>
  648.     </term>
  649.     <listitem>
  650.       <para>
  651.         CSV files can be processed using any tool which operates
  652.         on text files. The CSV format is also common as a format
  653.         which can be opened by applications.
  654.       </para>
  655.     </listitem>
  656.       </varlistentry>
  657.  
  658.     </variablelist>
  659.  
  660.     <para>
  661.       <emphasis role="italic">See the section on </emphasis>
  662.       <link linkend="file-format-text">Text Formats</link>
  663.     </para>
  664.  
  665.   </sect2>
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.   <sect2 id="file-format-dif">
  677.     <title>Data Interchange Format (DIF) File Format</title>
  678.  
  679.     <para>
  680.       The Data Interchange Format (DIF) file format is a text based
  681.       format encoded in ASCII with a header, for integrity
  682.       checking, and a body. The format was originally developed by
  683.       Software Arts in order to transfer data from
  684.       <application>VisiCalc</application>, the first spreadsheet.
  685.     </para>
  686.  
  687.     <informaltable frame='all'>
  688.       <tgroup cols='2' align='left' colsep='1' rowsep='1'>
  689.         <tbody>
  690.       <row>
  691.         <entry>
  692.           <emphasis role="bold">Name:</emphasis>
  693.         </entry>
  694.         <entry>Data Interchange Format</entry>
  695.       </row>
  696.       <row>
  697.         <entry>
  698.           <emphasis role="bold">Extensions:</emphasis>
  699.         </entry>
  700.         <entry>.dif</entry>
  701.       </row>
  702.       <row>
  703.         <entry>
  704.           <emphasis role="bold">Compatible Programs:</emphasis>
  705.             </entry>
  706.         <entry>Various</entry>
  707.       </row>
  708.       <row>
  709.         <entry>
  710.           <emphasis role="bold">Open / Save:</emphasis>
  711.         </entry>
  712.         <entry>Both</entry>
  713.       </row>
  714.     </tbody>
  715.       </tgroup>
  716.     </informaltable>
  717.  
  718.     <variablelist>
  719.       <!-- <title></title> -->
  720.       <varlistentry>
  721.         <term>
  722.       <emphasis role="bold">Limitations</emphasis>
  723.     </term>
  724.     <listitem>
  725.       <para>
  726.         Since the DIF format only supports a single worksheet,
  727.             &gnum; only exports the top worksheet in the view used to
  728.             save the workbook.
  729.       </para>
  730.     </listitem>
  731.       </varlistentry>
  732.  
  733.       <varlistentry>
  734.         <term>
  735.       <emphasis role="bold">Plugin</emphasis>
  736.     </term>
  737.     <listitem>
  738.       <para>
  739.         Supported by the <quote>Data Interchange Format
  740.             (DIF) module</quote> plug-in.
  741.       </para>
  742.     </listitem>
  743.       </varlistentry>
  744.  
  745.       <varlistentry>
  746.         <term>
  747.       <emphasis role="bold">Format Details</emphasis>
  748.     </term>
  749.     <listitem>
  750.       <para>
  751.         The format is a text file, encoded in ASCII, with a header
  752.         and body.
  753.       </para>
  754.     </listitem>
  755.       </varlistentry>
  756.  
  757.       <varlistentry>
  758.         <term>
  759.       <emphasis role="bold">Further Processing</emphasis>
  760.     </term>
  761.     <listitem>
  762.       <para>
  763.         The file can be processed as a text file or imported to
  764.         any program that recognizes the DIF format.
  765.       </para>
  766.     </listitem>
  767.       </varlistentry>
  768.  
  769.     </variablelist>
  770.  
  771.  
  772.   </sect2>
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.   <sect2 id="file-format-oleo">
  784.     <title>GNU Oleo File Format</title>
  785.  
  786.     <para>
  787.       The GNU Oleo file format is the format used by the GNU Oleo
  788.       spreadsheet, one of the early free software spreadsheets. The
  789.       GNU Oleo project has stagnated so this format is only supported
  790.       to enable the import of old files.
  791.     </para>
  792.  
  793.     <informaltable frame='all'>
  794.       <tgroup cols='2' align='left' colsep='1' rowsep='1'>
  795.         <tbody>
  796.       <row>
  797.         <entry>
  798.           <emphasis role="bold">Name:</emphasis>
  799.         </entry>
  800.         <entry>GNU Oleo</entry>
  801.       </row>
  802.       <row>
  803.         <entry>
  804.           <emphasis role="bold">Extensions:</emphasis>
  805.         </entry>
  806.         <entry>Unknown</entry>
  807.       </row>
  808.       <row>
  809.         <entry>
  810.           <emphasis role="bold">Compatible Programs:</emphasis>
  811.             </entry>
  812.         <entry><application>GNU oleo</application></entry>
  813.       </row>
  814.       <row>
  815.         <entry>
  816.           <emphasis role="bold">Open / Save:</emphasis>
  817.         </entry>
  818.         <entry>Open Only</entry>
  819.       </row>
  820.     </tbody>
  821.       </tgroup>
  822.     </informaltable>
  823.  
  824.     <variablelist>
  825.       <!-- <title></title> -->
  826.       <varlistentry>
  827.         <term>
  828.       <emphasis role="bold">Limitations</emphasis>
  829.     </term>
  830.     <listitem>
  831.       <para>
  832.         
  833.       </para>
  834.     </listitem>
  835.       </varlistentry>
  836.  
  837.       <varlistentry>
  838.         <term>
  839.       <emphasis role="bold">Plugin</emphasis>
  840.     </term>
  841.     <listitem>
  842.       <para>
  843.         Supported by the 'GNU Oleo' plugin.
  844.       </para>
  845.     </listitem>
  846.       </varlistentry>
  847.  
  848.       <varlistentry>
  849.         <term>
  850.       <emphasis role="bold">Format Details</emphasis>
  851.     </term>
  852.     <listitem>
  853.       <para>
  854.         
  855.       </para>
  856.     </listitem>
  857.       </varlistentry>
  858.  
  859.     </variablelist>
  860.  
  861.  
  862.   </sect2>
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871. <!-- TODO: html format edit limitations, encodings.  -->
  872. <!-- TODO: html format edit fragment handling (cut and paste) -->
  873.  
  874.   <sect2 id="file-format-html">
  875.     <title>The HTML File Format</title>
  876.  
  877.     <para>
  878.       The Hypertext Markup Language (HTML) file format is a text file
  879.       format with markup in the Hypertext Markup Language. These files
  880.       are designed to be viewed in a web browser.
  881.     </para>
  882.  
  883.     <para>
  884.       &gnum; can save the cell contents in a worksheet to a text file
  885.       which consists either of entire, well formed HTML files of
  886.       version 3.2 or 4.0, or of a file fragment which contains only a
  887.       <table> structure and must be inserted into an HTML
  888.       file. &gnum; can also open files which consist only of simple,
  889.       well formed HTML <table> structures.
  890.     </para>
  891.  
  892.     <informaltable frame='all'>
  893.       <tgroup cols='2' align='left' colsep='1' rowsep='1'>
  894.         <tbody>
  895.       <row>
  896.         <entry>
  897.           <emphasis role="bold">Names:</emphasis>
  898.         </entry>
  899.         <entry>Hypertext Markup Language (HTML)</entry>
  900.       </row>
  901.       <row>
  902.         <entry>
  903.           <emphasis role="bold">Extensions:</emphasis>
  904.         </entry>
  905.         <entry>.html, .htm</entry>
  906.       </row>
  907.       <row>
  908.         <entry>
  909.           <emphasis role="bold">Compatible Programs:</emphasis>
  910.             </entry>
  911.         <entry>Any Web Browser, any text editor</entry>
  912.       </row>
  913.       <row>
  914.         <entry>
  915.           <emphasis role="bold">Open / Save:</emphasis>
  916.         </entry>
  917.         <entry>Save Only, but also can import HTML <table> 
  918.                structures</entry>
  919.       </row>
  920.     </tbody>
  921.       </tgroup>
  922.     </informaltable>
  923.  
  924.     <variablelist>
  925.       <!-- <title></title> -->
  926.       <varlistentry>
  927.         <term>
  928.       <emphasis role="bold">Limitations</emphasis>
  929.     </term>
  930.     <listitem>
  931.       <para>
  932.         Only the cell contents of a worksheet are saved with sheet
  933.             object elements, such as graphical plots, ignored.
  934.       </para>
  935.     </listitem>
  936.       </varlistentry>
  937.  
  938.       <varlistentry>
  939.         <term>
  940.       <emphasis role="bold">Plugin</emphasis>
  941.     </term>
  942.     <listitem>
  943.       <para>
  944.         Supported by the 'HTML & TeX' plugin.
  945.       </para>
  946.     </listitem>
  947.       </varlistentry>
  948.  
  949. <!-- TODO remove or improve HTML examples
  950.       <varlistentry>
  951.         <term>
  952.       <emphasis role="bold">Format Details</emphasis>
  953.     </term>
  954.     <listitem>
  955.       <para>
  956.         The following figures illustrate the output of the
  957.         different HTML file formats.
  958.       </para>
  959.  
  960.           <figure id="fig-file-format-html32-ex1">
  961.             <title>An HTML 3.2 format file</title>
  962.             <screenshot>
  963.           <mediaobject>
  964.                 <imageobject>
  965.                   <imagedata fileref="figures/files-html32-example.png" 
  966.                              format="PNG" />
  967.                 </imageobject>
  968.                 <textobject>
  969.                 <phrase>An image of the rendered output of an HTML 3.2
  970.                         format file generated by Gnumeric.</phrase>
  971.                 </textobject>
  972.               </mediaobject>
  973.             </screenshot>
  974.           </figure>
  975.  
  976.           <figure id="file-format-html40-ex1">
  977.             <title>An HTML 4.0 format file</title>
  978.             <screenshot>
  979.           <mediaobject>
  980.                 <imageobject>
  981.                   <imagedata fileref="figures/files-html40-example.png" 
  982.                              format="PNG" />
  983.                 </imageobject>
  984.                 <textobject>
  985.                 <phrase>An image of the rendered output of an HTML 4.0
  986.                         format file generated by Gnumeric.</phrase> 
  987.                 </textobject>
  988.               </mediaobject>
  989.             </screenshot>
  990.           </figure>
  991.  
  992.           <figure id="fig-file-format-html-fragment">
  993.             <title>An HTML fragment</title>
  994.             <screenshot>
  995.           <mediaobject>
  996.                 <imageobject>
  997.                   <imagedata fileref="figures/files-html-example.png" 
  998.                              format="PNG" />
  999.                 </imageobject>
  1000.                 <textobject>
  1001.                 <phrase>An image of the rendered output of an HTML fragment
  1002.                         format file generated by Gnumeric, after the
  1003.                         incorporation of this fragment into a valid
  1004.                         HTML file.</phrase>  
  1005.                 </textobject>
  1006.               </mediaobject>
  1007.             </screenshot>
  1008.           </figure>
  1009.     </listitem>
  1010.       </varlistentry>
  1011. -->
  1012.  
  1013.       <varlistentry>
  1014.         <term>
  1015.       <emphasis role="bold">Further Processing</emphasis>
  1016.     </term>
  1017.     <listitem>
  1018.       <para>
  1019.         All these files can be opened by any text editor. The HTML
  1020.         3.2 and 4.0 format files can be opened by any web browser
  1021.         such as <application>Mozilla</application>.
  1022.       </para>
  1023.       <para>
  1024.         Files which are generated as HTML fragments must be placed
  1025.         into an HTML file with a valid pre-amble and closing
  1026.         statements. 
  1027.       </para>
  1028.     </listitem>
  1029.       </varlistentry>
  1030.  
  1031.     </variablelist>
  1032.  
  1033.     <para>
  1034.       <emphasis role="italic">See Also:</emphasis>
  1035.       <link linkend="file-format-xhtml">XHTML Format</link>
  1036.     </para>
  1037.  
  1038.  
  1039.   </sect2>
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.   <sect2 id="file-format-latex">
  1051.     <title>LaTeX File Format</title>
  1052.  
  1053.     <para>
  1054.       The LaTeX file format is a text file format with markup in the
  1055.       LaTeX 2ε derivative of the TeX family of languages.
  1056.     </para>
  1057.  
  1058.     <para>
  1059.       &gnum; generates LaTeX files to allow the export of tables of
  1060.       numeric values for use in the LaTeX document processing
  1061.       system. LaTeX is a derived format of the TeX system. The files
  1062.       generated by &gnum; are designed to be used by a LaTeX
  1063.       processor, such as <application>latex</application> or
  1064.       <application>pdflatex</application>, to generate files in
  1065.       viewable formats such as Device Independent (DVI), Postscript
  1066.       (PS) or Portable Document Format (PDF).
  1067.     </para>
  1068.  
  1069.     <para>
  1070.       The generated files can either be processed directly or can be
  1071.       included in other LaTeX files.
  1072.     </para>
  1073.  
  1074.     <informaltable frame='all'>
  1075.       <tgroup cols='2' align='left' colsep='1' rowsep='1'>
  1076.         <tbody>
  1077.       <row>
  1078.         <entry>
  1079.           <emphasis role="bold">Name:</emphasis>
  1080.         </entry>
  1081.         <entry>LaTeX</entry>
  1082.       </row>
  1083.       <row>
  1084.         <entry>
  1085.           <emphasis role="bold">Extensions:</emphasis>
  1086.         </entry>
  1087.         <entry>.tex</entry>
  1088.       </row>
  1089.       <row>
  1090.         <entry>
  1091.           <emphasis role="bold">Compatible Programs:</emphasis>
  1092.             </entry>
  1093.         <entry><application>latex</application>,
  1094.                <application>pdflatex</application></entry>
  1095.       </row>
  1096.       <row>
  1097.         <entry>
  1098.           <emphasis role="bold">Open / Save:</emphasis>
  1099.         </entry>
  1100.         <entry>Save only</entry>
  1101.       </row>
  1102.     </tbody>
  1103.       </tgroup>
  1104.     </informaltable>
  1105.  
  1106.     <variablelist>
  1107.       <!-- <title></title> -->
  1108.       <varlistentry>
  1109.         <term>
  1110.       <emphasis role="bold">Limitations</emphasis>
  1111.     </term>
  1112.     <listitem>
  1113.       <para>
  1114.         &gnum; generates a LaTeX <literal>longtable</literal>
  1115.             structure which contains only the contents of the cells in
  1116.             the worksheet displayed in the view at the time the file
  1117.             was created.
  1118.       </para>
  1119.       <para>
  1120.         Font coloring is supported. Thin cell borders are
  1121.             translated into single lines and thick cell borders are
  1122.             translated into double lines. Cell background colors are
  1123.             ignored.
  1124.       </para>
  1125.     </listitem>
  1126.       </varlistentry>
  1127.  
  1128.       <varlistentry>
  1129.         <term>
  1130.       <emphasis role="bold">Plugin</emphasis>
  1131.     </term>
  1132.     <listitem>
  1133.       <para>
  1134.         Supported by the 'HTML & TeX' plugin.
  1135.       </para>
  1136.     </listitem>
  1137.       </varlistentry>
  1138.  
  1139.       <varlistentry>
  1140.         <term>
  1141.       <emphasis role="bold">Format Details</emphasis>
  1142.     </term>
  1143.     <listitem>
  1144.  
  1145.       <para>
  1146.         The generated file includes extensive documentation in TeX
  1147.         comment fields, to explain how to use and alter the
  1148.         file. Lines in the file which are comments begin and end
  1149.         with double percent symbols (%%). Lines which are designed
  1150.         as user options begin with a single percent symbol (%)
  1151.         which can be deleted to make the LaTeX command on that
  1152.         line take effect.
  1153.       </para>
  1154.  
  1155.     </listitem>
  1156.       </varlistentry>
  1157.  
  1158.       <varlistentry>
  1159.         <term>
  1160.       <emphasis role="bold">Further Processing</emphasis>
  1161.     </term>
  1162.     <listitem>
  1163.  
  1164.       <para>
  1165.         The LaTeX files generated by &gnum; can either be
  1166.         processed directly by a LaTeX processor or can be included
  1167.         as tables in other files. The files can be included by
  1168.         reference as explained below or can be pasted into other
  1169.         files at the appropriate location. The file can also be
  1170.         altered to change certain parameters. These alterations
  1171.         are explained as comments within the file itself and are
  1172.         presented below.
  1173.       </para>
  1174.  
  1175.       <para>
  1176.         The file created by &gnum; can be run directly through a
  1177.         LaTeX processor without any modifications. For example, if
  1178.         the file were saved as <filename>Book1.tex</filename>, the
  1179.         following command 
  1180. <screen>
  1181. pdflatex Book1.tex
  1182. </screen>
  1183.             generates a PDF file named
  1184.         <filename>Book1.pdf</filename>. The file can be generated
  1185.         in landscape format and the headers, footers and column
  1186.         widths of the file can be altered in the manner explained
  1187.         below.
  1188.       </para>
  1189.  
  1190.       <para></para>
  1191. <!-- TODO Ask Shaun: why is this needed to get a par break? -->
  1192.  
  1193.       <para>
  1194.         The file can also be included within another LaTeX file to
  1195.         provide a single table. This requires, first, ensuring
  1196.         that all the packages which will be needed are included, and
  1197.         second, defining a LaTeX variable which is used as a dummy
  1198.         tag to exclude the preamble used to process the file on
  1199.         its own. The LaTeX file generated by &gnum; requires using
  1200.         the following lines in the preamble
  1201. <screen>
  1202. \usepackage{ucs}
  1203. \usepackage{utf8}{inputenc}
  1204. \usepackage{color}
  1205. \usepackage{array}
  1206. \usepackage{longtable}
  1207. \usepackage{calc}
  1208. \usepackage{multirow}
  1209. \usepackage{hhline}
  1210. \usepackage{ifthen}  
  1211. </screen>
  1212.             to include each of these packages. Optionally, to include
  1213.         the table in landscape mode, the preamble also needs the line
  1214. <screen>
  1215. \usepackage{lscape}
  1216. </screen>
  1217.             to include the <literal>lscape</literal> package. Second,
  1218.         the following line
  1219. <screen>
  1220. \def\inputGnumericTable{}
  1221. </screen>
  1222.             must be included to make the LaTeX processor ignore the
  1223.         preamble section of the file generated by &gnum;. The
  1224.         generated file can be included either by adding, at the
  1225.         appropriate location in the other file, the line
  1226. <screen>
  1227. \input{<replaceable>mygnumericfile.tex</replaceable>}  
  1228. </screen>
  1229.             with the text <literal>mygnumericfile</literal> replaced
  1230.         with the appropriate file name or by pasting the entire
  1231.         file generated by &gnum; into the other file. 
  1232.       </para>
  1233.  
  1234.       <para></para>
  1235. <!-- TODO Ask Shaun: why is this needed to get a par break? -->
  1236.  
  1237.  
  1238.           <para>
  1239.         An option is provided in the file allows the table to be
  1240.         presented in landscape mode which allows wider tables to
  1241.         be included. For files which are to be processed
  1242.         independently, the option can be changed in the document
  1243.         class definition
  1244. <screen>
  1245. \documentclass[12pt%
  1246.                %,landscape%
  1247.              ]{report}
  1248. </screen>
  1249.             by removing the percent symbol (%) in front of
  1250.         <literal>,landscape</literal>. For files to be included as
  1251.         tables in other LaTeX files, the preamble must include the
  1252.         <literal>lscape</literal> package, as was explained above,
  1253.         and the two commands
  1254. <screen>
  1255. \def\gnumericTableEnd{\end{landscape}}
  1256. \begin{landscape}
  1257. </screen>
  1258.             must have the leading percent sign removed.
  1259.       </para>
  1260.  
  1261.       <para></para>
  1262. <!-- TODO Ask Shaun: why is this needed to get a par break? -->
  1263.  
  1264.           <para>
  1265.         An option is provided to change the widths of the columns
  1266.         of the file generated by &gnum;. By default, the file
  1267.         attempts to maintain the proportions between the columns
  1268.         in the &gnum; worksheet, yet scale the resulting table for
  1269.         the width of the paper defined in LaTeX. To change the
  1270.         column widths, look for the section in the
  1271.         <application>LaTeX</application> file with lines that look
  1272.         like
  1273. <screen>
  1274. \def\gnumericColA{107pt*\gnumericScale}
  1275. \def\gnumericColB{89pt*\gnumericScale}
  1276. \def\gnumericColC{98pt*\gnumericScale}
  1277. \def\gnumericColD{89pt*\gnumericScale}
  1278. \def\gnumericColE{89pt*\gnumericScale}
  1279. </screen>
  1280.             and that may have as many entries as there were columns in
  1281.         the worksheet. The TeX 'lengths' defined for each column
  1282.         can be changed. For example, change the second column
  1283.         (Column B) to a width of 0.75 inches, we would simply have
  1284.         to modify this code to: 
  1285. <screen>
  1286. \def\gnumericColA{107pt*\gnumericScale}
  1287. \def\gnumericColB{0.75in}
  1288. \def\gnumericColC{98pt*\gnumericScale}
  1289. \def\gnumericColD{89pt*\gnumericScale}
  1290. \def\gnumericColE{89pt*\gnumericScale}
  1291. </screen>
  1292.             and the resulting file would have a second column 0.75
  1293.         inches wide.
  1294.       </para>
  1295.  
  1296.       <para></para>
  1297. <!-- TODO Ask Shaun: why is this needed to get a par break? -->
  1298.  
  1299.       <para>
  1300.         An option to change the headers and footers of the table
  1301.         is provided as well. The file itself contains comments on
  1302.         how to alter these but the choices will require seeing the
  1303.         documentation of the <literal>longtable</literal> LaTeX
  1304.         package. See that documentation and the contents of the
  1305.         file generated by &gnum; for details.
  1306.       </para>  
  1307.  
  1308.     </listitem>
  1309.       </varlistentry>
  1310.  
  1311.     </variablelist>
  1312.  
  1313.  
  1314.   </sect2>
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.   <sect2 id="file-format-mps">
  1326.     <title>Linear and Integer Program Expression (MPS) File Format</title>
  1327.  
  1328.     <para>
  1329.       The Linear and Integer Program Expression  file format is a text
  1330.       file format, encoded as ASCII, which uses fixed columns. The
  1331.       format was developed by International Business Machines
  1332.       Corporation to express linear and integer programs. 
  1333.     </para>
  1334.  
  1335.     <informaltable frame='all'>
  1336.       <tgroup cols='2' align='left' colsep='1' rowsep='1'>
  1337.         <tbody>
  1338.       <row>
  1339.         <entry>
  1340.           <emphasis role="bold">Name:</emphasis>
  1341.         </entry>
  1342.         <entry>Linear and Integer Program Expression (MPS)</entry>
  1343.       </row>
  1344.       <row>
  1345.         <entry>
  1346.           <emphasis role="bold">Extensions:</emphasis>
  1347.         </entry>
  1348.         <entry>none / .mps</entry>
  1349.       </row>
  1350.       <row>
  1351.         <entry>
  1352.           <emphasis role="bold">Compatible Programs:</emphasis>
  1353.             </entry>
  1354.         <entry>Various linear programming applications</entry>
  1355.       </row>
  1356.       <row>
  1357.         <entry>
  1358.           <emphasis role="bold">Open / Save:</emphasis>
  1359.         </entry>
  1360.         <entry>Open only</entry>
  1361.       </row>
  1362.     </tbody>
  1363.       </tgroup>
  1364.     </informaltable>
  1365.  
  1366.     <variablelist>
  1367.       <!-- <title></title> -->
  1368.       <varlistentry>
  1369.         <term>
  1370.       <emphasis role="bold">Limitations</emphasis>
  1371.     </term>
  1372.     <listitem>
  1373.       <para>
  1374.         
  1375.       </para>
  1376.     </listitem>
  1377.       </varlistentry>
  1378.  
  1379.       <varlistentry>
  1380.         <term>
  1381.       <emphasis role="bold">Plugin</emphasis>
  1382.     </term>
  1383.     <listitem>
  1384.       <para>
  1385.         Supported by the 'Linear and integer expression (MPS)
  1386.             format module' plug-in.
  1387.       </para>
  1388.     </listitem>
  1389.       </varlistentry>
  1390.  
  1391.       <varlistentry>
  1392.         <term>
  1393.       <emphasis role="bold">Format Details</emphasis>
  1394.     </term>
  1395.     <listitem>
  1396.       <para>
  1397.         The Argonne National Laboratory of the United States has a
  1398.         simple <ulink type="ftp"
  1399.         url="http://www-unix.mcs.anl.gov/otc/Guide/faq/linear-programming-faq.html#Q5"
  1400.         >introduction</ulink>
  1401.         to the MPS format on their web site.
  1402.       </para>
  1403.  
  1404.       <para>
  1405.         The MIPLIB site has more information including a file
  1406.         named 
  1407.         <ulink type="ftp"
  1408.           url="ftp://softlib.cs.rice.edu/pub/miplib/mps_format"
  1409.           >mps_format</ulink> which is a brief introduction to the
  1410.         format and includes the following section:
  1411. <screen>
  1412. The following template is a guide for the use of MPS format:
  1413.  
  1414. ---------------------------------------------------------------------
  1415. Field:    1           2          3         4         5         6
  1416. Columns:  2-3        5-12      15-22     25-36     40-47     50-61
  1417.  
  1418.           NAME   problem name
  1419.  
  1420.           ROWS
  1421.  
  1422.            type     name
  1423.  
  1424.           COLUMNS
  1425.                    column       row       value     row      value
  1426.                     name        name                name
  1427.           RHS
  1428.                     rhs         row       value     row      value
  1429.                     name        name                name
  1430.           RANGES
  1431.                     range       row       value     row      value
  1432.                     name        name                name
  1433.           BOUNDS
  1434.  
  1435.            type     bound       column     value
  1436.                     name        name
  1437.           ENDATA
  1438. ---------------------------------------------------------------------
  1439. </screen>
  1440.             and provides further explanations to the components. The
  1441.             file also suggests as more complete references:
  1442. <screen>
  1443.   "Advanced Linear Programming," by Bruce A. Murtagh
  1444.   "Computer Solutions of Linear Programs," by J.L. Nazareth
  1445. </screen>
  1446.             which should provide a better explanation.
  1447.       </para>
  1448.     </listitem>
  1449.       </varlistentry>
  1450.  
  1451.  
  1452.     </variablelist>
  1453.  
  1454.  
  1455.   </sect2>
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.   <sect2 id="file-format-lotus">
  1467.     <title>Lotus 1-2-3 File Format</title>
  1468.  
  1469.     <para>
  1470.       The Lotus 1-2-3 file format is the format used by the Lotus
  1471.       <application>1-2-3</application> spreadsheet, which is now part of
  1472.       the office suite called <application>SmartSuite</application>. 
  1473.     </para>
  1474.  
  1475.     <informaltable frame='all'>
  1476.       <tgroup cols='2' align='left' colsep='1' rowsep='1'>
  1477.         <tbody>
  1478.       <row>
  1479.         <entry>
  1480.           <emphasis role="bold">Name:</emphasis>
  1481.         </entry>
  1482.         <entry>Lotus 1-2-3</entry>
  1483.       </row>
  1484.       <row>
  1485.         <entry>
  1486.           <emphasis role="bold">Extensions:</emphasis>
  1487.         </entry>
  1488.         <entry>.wk1,.wks</entry>
  1489.       </row>
  1490.       <row>
  1491.         <entry>
  1492.           <emphasis role="bold">Compatible Programs:</emphasis>
  1493.             </entry>
  1494.         <entry>Lotus <application>SmartSuite</application></entry>
  1495.       </row>
  1496.       <row>
  1497.         <entry>
  1498.           <emphasis role="bold">Open / Save:</emphasis>
  1499.         </entry>
  1500.         <entry>Open only.</entry>
  1501.       </row>
  1502.     </tbody>
  1503.       </tgroup>
  1504.     </informaltable>
  1505.  
  1506.     <variablelist>
  1507.       <!-- <title></title> -->
  1508.       <varlistentry>
  1509.         <term>
  1510.       <emphasis role="bold">Limitations</emphasis>
  1511.     </term>
  1512.     <listitem>
  1513.       <para>
  1514.         
  1515.       </para>
  1516.     </listitem>
  1517.       </varlistentry>
  1518.  
  1519.       <varlistentry>
  1520.         <term>
  1521.       <emphasis role="bold">Plugin</emphasis>
  1522.     </term>
  1523.     <listitem>
  1524.       <para>
  1525.         Supported by the 'Lotus 123' plugin.
  1526.       </para>
  1527.     </listitem>
  1528.       </varlistentry>
  1529.  
  1530.       <varlistentry>
  1531.         <term>
  1532.       <emphasis role="bold">Format Details</emphasis>
  1533.     </term>
  1534.     <listitem>
  1535.       <para>
  1536.         
  1537.       </para>
  1538.     </listitem>
  1539.       </varlistentry>
  1540.  
  1541.       <varlistentry>
  1542.         <term>
  1543.       <emphasis role="bold">Further Processing</emphasis>
  1544.     </term>
  1545.     <listitem>
  1546.       <para>
  1547.         Many spreadsheet programs support this format.
  1548.       </para>
  1549.     </listitem>
  1550.       </varlistentry>
  1551.  
  1552.     </variablelist>
  1553.  
  1554.  
  1555.   </sect2>
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.   <sect2 id="file-format-excel">
  1567.     <title>Microsoft Excel File Format</title>
  1568.  
  1569.     <para>
  1570.       The Microsoft Excel<trademark/> file format is a binary file
  1571.       format used by the <application>Excel</application> program in
  1572.       the <application>Office</application> suite. The format is a
  1573.       common format supported to various extents by most spreadsheets
  1574.       although it is incompletely documented. The &gnum; project has
  1575.       reversed engineered all of the core features of the format.
  1576.     </para>
  1577.  
  1578.     <informaltable frame='all'>
  1579.       <tgroup cols='2' align='left' colsep='1' rowsep='1'>
  1580.         <tbody>
  1581.       <row>
  1582.         <entry>
  1583.           <emphasis role="bold">Name:</emphasis>
  1584.         </entry>
  1585.         <entry>Excel</entry>
  1586.       </row>
  1587.       <row>
  1588.         <entry>
  1589.           <emphasis role="bold">Extensions:</emphasis>
  1590.         </entry>
  1591.         <entry>.xls</entry>
  1592.       </row>
  1593.       <row>
  1594.         <entry>
  1595.           <emphasis role="bold">Compatible Programs:</emphasis>
  1596.             </entry>
  1597.         <entry>Microsoft <application>Excel</application>,
  1598.                Microsoft <application>Office</application>,
  1599.            and many other spreadsheets </entry>
  1600.       </row>
  1601.       <row>
  1602.         <entry>
  1603.           <emphasis role="bold">Open / Save:</emphasis>
  1604.         </entry>
  1605.         <entry>Both</entry>
  1606.       </row>
  1607.     </tbody>
  1608.       </tgroup>
  1609.     </informaltable>
  1610.  
  1611.     <variablelist>
  1612.       <!-- <title></title> -->
  1613.       <varlistentry>
  1614.         <term>
  1615.       <emphasis role="bold">Limitations</emphasis>
  1616.     </term>
  1617.     <listitem>
  1618.       <para>
  1619.         Most core features of the format are supported.
  1620.       </para>
  1621.  
  1622.       <warning>
  1623.         <para>
  1624.           &gnum; does not support the very old file formats used by
  1625.           Excel<trademark/> versions prior to Excel<trademark/> 5.0.
  1626.         </para>
  1627.       </warning>
  1628.  
  1629.           <para>
  1630.             &gnum; can open files from most of the Microsoft
  1631.             Excel<trademark/> file formats and all of the recent file
  1632.             formats. The formats supported are:      
  1633.             <itemizedlist>
  1634.           <listitem>
  1635.             <para> MS Excel<trademark/> 5.0/95.
  1636.         </para>
  1637.           </listitem>
  1638.           <listitem>
  1639.             <para> MS Excel<trademark/> 97/2000/XP.
  1640.         </para>
  1641.           </listitem>
  1642.           <listitem>
  1643.             <para> MS Excel<trademark/> 97/2000/XP & 5.0/95.
  1644.         </para>
  1645.           </listitem>
  1646.         </itemizedlist>
  1647.       </para>
  1648.  
  1649.     </listitem>
  1650.       </varlistentry>
  1651.  
  1652.       <varlistentry>
  1653.         <term>
  1654.       <emphasis role="bold">Plugin</emphasis>
  1655.     </term>
  1656.     <listitem>
  1657.       <para>
  1658.         Supported by the 'MS Excel (tm)' plugin.
  1659.       </para>
  1660.     </listitem>
  1661.       </varlistentry>
  1662.  
  1663.       <varlistentry>
  1664.         <term>
  1665.       <emphasis role="bold">Format Details</emphasis>
  1666.     </term>
  1667.     <listitem>
  1668.       <para>
  1669.         These are binary file formats.
  1670.       </para>
  1671.     </listitem>
  1672.       </varlistentry>
  1673.  
  1674.       <varlistentry>
  1675.         <term>
  1676.       <emphasis role="bold">Further Processing</emphasis>
  1677.     </term>
  1678.     <listitem>
  1679.       <para>
  1680.         A number of other programs are able to process files in
  1681.         the Microsoft Excel file format.
  1682.       </para>
  1683.     </listitem>
  1684.       </varlistentry>
  1685.  
  1686.     </variablelist>
  1687.  
  1688.  
  1689.   </sect2>
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.   <sect2 id="file-format-multiplan">
  1701.     <title>Multiplan SYLK File Format</title>
  1702.  
  1703.     <para>
  1704.       The Microsoft Multiplan Symbolic Link Interchange (SYLK) file
  1705.       format is a column based format.
  1706.     </para>
  1707.  
  1708.     <para>
  1709.       &gnum; can read files in this format.
  1710.     </para>
  1711.  
  1712.     <informaltable frame='all'>
  1713.       <tgroup cols='2' align='left' colsep='1' rowsep='1'>
  1714.         <tbody>
  1715.       <row>
  1716.         <entry>
  1717.           <emphasis role="bold">Name:</emphasis>
  1718.         </entry>
  1719.         <entry>Symbolic Link Interchange (SYLK)</entry>
  1720.       </row>
  1721.       <row>
  1722.         <entry>
  1723.           <emphasis role="bold">Extensions:</emphasis>
  1724.         </entry>
  1725.         <entry>none / .slk</entry>
  1726.       </row>
  1727.       <row>
  1728.         <entry>
  1729.           <emphasis role="bold">Compatible Programs:</emphasis>
  1730.             </entry>
  1731.         <entry><application>Multiplan</application></entry>
  1732.       </row>
  1733.       <row>
  1734.         <entry>
  1735.           <emphasis role="bold">Open / Save:</emphasis>
  1736.         </entry>
  1737.         <entry>Open only</entry>
  1738.       </row>
  1739.     </tbody>
  1740.       </tgroup>
  1741.     </informaltable>
  1742.  
  1743.     <variablelist>
  1744.       <!-- <title></title> -->
  1745.       <varlistentry>
  1746.         <term>
  1747.       <emphasis role="bold">Limitations</emphasis>
  1748.     </term>
  1749.     <listitem>
  1750.       <para>
  1751.         
  1752.       </para>
  1753.     </listitem>
  1754.       </varlistentry>
  1755.  
  1756.       <varlistentry>
  1757.         <term>
  1758.       <emphasis role="bold">Plugin</emphasis>
  1759.     </term>
  1760.     <listitem>
  1761.       <para>
  1762.         Supported by the 'Multiplan (SYLK)' plugin.
  1763.       </para>
  1764.     </listitem>
  1765.       </varlistentry>
  1766.  
  1767.       <varlistentry>
  1768.         <term>
  1769.       <emphasis role="bold">Format Details</emphasis>
  1770.     </term>
  1771.     <listitem>
  1772.       <para>
  1773.         
  1774.       </para>
  1775.     </listitem>
  1776.       </varlistentry>
  1777.  
  1778.  
  1779.     </variablelist>
  1780.  
  1781.  
  1782.   </sect2>
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792. <!-- TODO: split or explain the three OOo formats OASIS/sxc/sxw -->
  1793.   <sect2 id="file-format-ooo">
  1794.     <title>OpenOffice.org XML File Format</title>
  1795.  
  1796.     <para>
  1797.       The OpenOffice.org XML file format is zip archive including
  1798.       several components all of which are text files, most of these with
  1799.       markup in the eXtensible Markup Language (XML). 
  1800.     </para>
  1801.  
  1802.     <para>
  1803.       &gnum; can both open and save files in this format and plans to
  1804.       continue to support this format in the future.
  1805.     </para>
  1806.  
  1807.     <informaltable frame='all'>
  1808.       <tgroup cols='2' align='left' colsep='1' rowsep='1'>
  1809.         <tbody>
  1810.       <row>
  1811.         <entry>
  1812.           <emphasis role="bold">Name:</emphasis>
  1813.         </entry>
  1814.         <entry>OASIS XML, OpenOffice.org XML, StarOffice</entry>
  1815.       </row>
  1816.       <row>
  1817.         <entry>
  1818.           <emphasis role="bold">Extensions:</emphasis>
  1819.         </entry>
  1820.         <entry>.sxc</entry>
  1821.       </row>
  1822.       <row>
  1823.         <entry>
  1824.           <emphasis role="bold">Compatible Programs:</emphasis>
  1825.             </entry>
  1826.         <entry><application>OpenOffice.org Calc</application>,
  1827.                <application>StarCalc</application></entry>
  1828.       </row>
  1829.       <row>
  1830.         <entry>
  1831.           <emphasis role="bold">Open / Save:</emphasis>
  1832.         </entry>
  1833.         <entry>Both</entry>
  1834.       </row>
  1835.     </tbody>
  1836.       </tgroup>
  1837.     </informaltable>
  1838.  
  1839.     <variablelist>
  1840.       <!-- <title></title> -->
  1841.       <varlistentry>
  1842.         <term>
  1843.       <emphasis role="bold">Limitations</emphasis>
  1844.     </term>
  1845.     <listitem>
  1846.       <para>
  1847.         
  1848.       </para>
  1849.     </listitem>
  1850.       </varlistentry>
  1851.  
  1852.       <varlistentry>
  1853.         <term>
  1854.       <emphasis role="bold">Plugin</emphasis>
  1855.     </term>
  1856.     <listitem>
  1857.       <para>
  1858.         Supported by the 'OpenCalc/StarCalc' plugin.
  1859.       </para>
  1860.     </listitem>
  1861.       </varlistentry>
  1862.  
  1863.       <varlistentry>
  1864.         <term>
  1865.       <emphasis role="bold">Format Details</emphasis>
  1866.     </term>
  1867.     <listitem>
  1868.  
  1869.       <para>
  1870.         The file format is a zip archive containing several text
  1871.         and XML elements: a <filename>mimetype</filename> file
  1872.         giving the mime type, a <filename>content.xml</filename>
  1873.         file with the contents of the spreadsheet cells, and
  1874.         several other files with meta data, style definitions or
  1875.         information on the settings. The file contents can be
  1876.         extracted with the <application>unzip</application>
  1877.         command line program or with any of a number of graphical
  1878.         interface programs.
  1879.       </para>
  1880.  
  1881.       <para>
  1882.         The Organization for the Advancement of Structured
  1883.             Information Standards (OASIS) has accepted this file
  1884.             format as the standard "OASIS Open Office XML Format".
  1885.         The published specification for the file format is
  1886.         available from the <ulink type="http"
  1887.         url="http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=office">
  1888.         OASIS Open Office XML Format Technical Committee</ulink>
  1889.         web page. Other information is available from the <ulink
  1890.         type="http"
  1891.         url="http://xml.openoffice.org/">OpenOffice.org XML
  1892.         File Format</ulink> web page, part of the OpenOffice.org
  1893.         project.
  1894.       </para>
  1895.     </listitem>
  1896.       </varlistentry>
  1897.  
  1898.       <varlistentry>
  1899.         <term>
  1900.       <emphasis role="bold">Further Processing</emphasis>
  1901.     </term>
  1902.     <listitem>
  1903.       <para>
  1904.         Files in this format can be imported and modified by the
  1905.         <application>OpenOffice.org Calc</application> spreadsheet
  1906.         or may be modified through XML processing.
  1907.       </para>
  1908.     </listitem>
  1909.       </varlistentry>
  1910.  
  1911.     </variablelist>
  1912.  
  1913.  
  1914.   </sect2>
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.  
  1924.  
  1925.   <sect2 id="file-format-planperfect">
  1926.     <title>Plan Perfect File Format</title>
  1927.  
  1928.     <para>
  1929.       The Plan Perfect file format is a format used by the
  1930.     <application>PlanPerfect</application> spreadsheet.
  1931.     </para>
  1932.  
  1933.     <informaltable frame='all'>
  1934.       <tgroup cols='2' align='left' colsep='1' rowsep='1'>
  1935.         <tbody>
  1936.       <row>
  1937.         <entry>
  1938.           <emphasis role="bold">Name:</emphasis>
  1939.         </entry>
  1940.         <entry>Plan Perfect</entry>
  1941.       </row>
  1942.       <row>
  1943.         <entry>
  1944.           <emphasis role="bold">Extensions:</emphasis>
  1945.         </entry>
  1946.         <entry>Unknown</entry>
  1947.       </row>
  1948.       <row>
  1949.         <entry>
  1950.           <emphasis role="bold">Compatible Programs:</emphasis>
  1951.             </entry>
  1952.         <entry><application>PlanPerfect</application>.</entry>
  1953.       </row>
  1954.       <row>
  1955.         <entry>
  1956.           <emphasis role="bold">Open / Save:</emphasis>
  1957.         </entry>
  1958.         <entry>Open only.</entry>
  1959.       </row>
  1960.     </tbody>
  1961.       </tgroup>
  1962.     </informaltable>
  1963.  
  1964.     <variablelist>
  1965.       <!-- <title></title> -->
  1966.       <varlistentry>
  1967.         <term>
  1968.       <emphasis role="bold">Limitations</emphasis>
  1969.     </term>
  1970.     <listitem>
  1971.       <para>
  1972.         
  1973.       </para>
  1974.     </listitem>
  1975.       </varlistentry>
  1976.  
  1977.       <varlistentry>
  1978.         <term>
  1979.       <emphasis role="bold">Plugin</emphasis>
  1980.     </term>
  1981.     <listitem>
  1982.       <para>
  1983.         Supported by the 'Plan Perfect' plug-in.
  1984.       </para>
  1985.     </listitem>
  1986.       </varlistentry>
  1987.  
  1988.       <varlistentry>
  1989.         <term>
  1990.       <emphasis role="bold">Format Details</emphasis>
  1991.     </term>
  1992.     <listitem>
  1993.       <para>
  1994.         
  1995.       </para>
  1996.     </listitem>
  1997.       </varlistentry>
  1998.  
  1999.       <varlistentry>
  2000.         <term>
  2001.       <emphasis role="bold">Further Processing</emphasis>
  2002.     </term>
  2003.     <listitem>
  2004.       <para>
  2005.         
  2006.       </para>
  2007.     </listitem>
  2008.       </varlistentry>
  2009.  
  2010.     </variablelist>
  2011.  
  2012.  
  2013.   </sect2>
  2014.  
  2015.  
  2016.  
  2017.  
  2018.  
  2019.  
  2020.  
  2021.  
  2022.  
  2023.  
  2024.   <sect2 id="file-format-ps">
  2025.     <title>Postscript File Format</title>
  2026.  
  2027.     <para>
  2028.       The Postscript file format is a text format which contains the
  2029.       program code for a postscript interpreter. Postscript is a page
  2030.       description language designed to enable the creation and
  2031.       transfer of printer-ready output.
  2032.     </para>
  2033.  
  2034.     <note>
  2035.       <para>
  2036.         &gnum; supports the creation of Postscript files through the
  2037.         printing interface, not through the file save mechanism. See
  2038.         <xref linkend="chapter-printing" />, for details on how to
  2039.         generate a Postscript file.
  2040.       </para>
  2041.     </note>
  2042.      
  2043.  
  2044.     <informaltable frame='all'>
  2045.       <tgroup cols='2' align='left' colsep='1' rowsep='1'>
  2046.         <tbody>
  2047.       <row>
  2048.         <entry>
  2049.           <emphasis role="bold">Name:</emphasis>
  2050.         </entry>
  2051.         <entry>Postscript</entry>
  2052.       </row>
  2053.       <row>
  2054.         <entry>
  2055.           <emphasis role="bold">Extensions:</emphasis>
  2056.         </entry>
  2057.         <entry>.ps</entry>
  2058.       </row>
  2059.       <row>
  2060.         <entry>
  2061.           <emphasis role="bold">Compatible Programs:</emphasis>
  2062.             </entry>
  2063.         <entry>Many programs can interpret and display Postscript
  2064.         files including: <application>GGV</application>,
  2065.         <application>ghostview</application>
  2066.         (<application>gv</application>), and
  2067.         <application>ghostscript</application>.  </entry>
  2068.       </row>
  2069.       <row>
  2070.         <entry>
  2071.           <emphasis role="bold">Open / Save:</emphasis>
  2072.         </entry>
  2073.         <entry>Save only.</entry>
  2074.       </row>
  2075.     </tbody>
  2076.       </tgroup>
  2077.     </informaltable>
  2078.  
  2079.     <variablelist>
  2080.       <!-- <title></title> -->
  2081.       <varlistentry>
  2082.         <term>
  2083.       <emphasis role="bold">Limitations</emphasis>
  2084.     </term>
  2085.     <listitem>
  2086.       <para>
  2087.         
  2088.       </para>
  2089.     </listitem>
  2090.       </varlistentry>
  2091.  
  2092.       <varlistentry>
  2093.         <term>
  2094.       <emphasis role="bold">Plugin</emphasis>
  2095.     </term>
  2096.     <listitem>
  2097.       <para>
  2098.         The creation of Postscript files is supported internally
  2099.         by the printing sub-system.
  2100.       </para>
  2101.     </listitem>
  2102.       </varlistentry>
  2103.  
  2104.       <varlistentry>
  2105.         <term>
  2106.       <emphasis role="bold">Format Details</emphasis>
  2107.     </term>
  2108.     <listitem>
  2109.       <para>
  2110.         The Postscript language was created by Adobe, Inc. The
  2111.         Adobe web site has a non-technical <ulink type="http"
  2112.         url="http://www.adobe.com/products/postscript/main.html">introduction</ulink>,
  2113.         as well as a technical <ulink type="http"
  2114.         url="http://www.adobe.com/products/postscript/overview.html">overview</ulink>
  2115.         and the actual <ulink type="http"
  2116.         url="http://partners.adobe.com/asn/tech/ps/specifications.jsp">specifications</ulink>.
  2117.       </para>
  2118.     </listitem>
  2119.       </varlistentry>
  2120.  
  2121.       <varlistentry>
  2122.         <term>
  2123.       <emphasis role="bold">Further Processing</emphasis>
  2124.     </term>
  2125.     <listitem>
  2126.       <para>
  2127.         Postscript files can imported into other documents by
  2128.         several programs. For the very advanced, postscript files
  2129.         can be reprogrammed using a text editor.
  2130.       </para>
  2131.     </listitem>
  2132.       </varlistentry>
  2133.  
  2134.     </variablelist>
  2135.  
  2136.  
  2137.   </sect2>
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.   <sect2 id="file-format-pdf">
  2149.     <title>Portable Document Format (PDF) File Format</title>
  2150.  
  2151.     <para>
  2152.       The Portable Document Format (PDF) file format is a binary
  2153.       format which contains page description primitives and combines a
  2154.       subset of the Postscript language with some more recent
  2155.       features. The Portable Document Format is a page description
  2156.       language designed to enable the creation and transfer of
  2157.       printer-ready output.
  2158.     </para>
  2159.  
  2160.     <note>
  2161.       <para>
  2162.         &gnum; supports the creation of PDF files through the
  2163.         printing interface, not through the file save mechanism. See
  2164.         <xref linkend="chapter-printing" />, for details on how to
  2165.         generate a PDF file.
  2166.       </para>
  2167.     </note>
  2168.      
  2169.  
  2170.     <informaltable frame='all'>
  2171.       <tgroup cols='2' align='left' colsep='1' rowsep='1'>
  2172.         <tbody>
  2173.       <row>
  2174.         <entry>
  2175.           <emphasis role="bold">Name:</emphasis>
  2176.         </entry>
  2177.         <entry>Portable Document Format (PDF)</entry>
  2178.       </row>
  2179.       <row>
  2180.         <entry>
  2181.           <emphasis role="bold">Extensions:</emphasis>
  2182.         </entry>
  2183.         <entry>.pdf</entry>
  2184.       </row>
  2185.       <row>
  2186.         <entry>
  2187.           <emphasis role="bold">Compatible Programs:</emphasis>
  2188.             </entry>
  2189.         <entry>
  2190.           PDF is supported by a wide variety of programs including
  2191.           <application>gPDF</application>, 
  2192.           <application>xPDF</application>, 
  2193.           <application>GGV</application>, 
  2194.           <application>ghostview</application>
  2195.           (<application>gv</application>), and
  2196.           <application>ghostscript</application>, </entry>
  2197.       </row>
  2198.       <row>
  2199.         <entry>
  2200.           <emphasis role="bold">Open / Save:</emphasis>
  2201.         </entry>
  2202.         <entry>Save only</entry>
  2203.       </row>
  2204.     </tbody>
  2205.       </tgroup>
  2206.     </informaltable>
  2207.  
  2208.     <variablelist>
  2209.       <!-- <title></title> -->
  2210.       <varlistentry>
  2211.         <term>
  2212.       <emphasis role="bold">Limitations</emphasis>
  2213.     </term>
  2214.     <listitem>
  2215.       <para>
  2216.         
  2217.       </para>
  2218.     </listitem>
  2219.       </varlistentry>
  2220.  
  2221.       <varlistentry>
  2222.         <term>
  2223.       <emphasis role="bold">Plugin</emphasis>
  2224.     </term>
  2225.     <listitem>
  2226.       <para>
  2227.         The creation of PDF files is supported internally
  2228.         by the printing sub-system.
  2229.       </para>
  2230.     </listitem>
  2231.       </varlistentry>
  2232.  
  2233.       <varlistentry>
  2234.         <term>
  2235.       <emphasis role="bold">Format Details</emphasis>
  2236.     </term>
  2237.     <listitem>
  2238.       <para>
  2239.          The Postscript language was created by Adobe, Inc. The
  2240.         Adobe web site has a non-technical <ulink type="http"
  2241.         url="http://www.adobe.com/products/postscript/main.html">introduction</ulink>,
  2242.         as well as a technical <ulink type="http"
  2243.         url="http://www.adobe.com/products/postscript/overview.html">overview</ulink>
  2244.         and the actual <ulink type="http"
  2245.         url="http://partners.adobe.com/asn/tech/ps/specifications.jsp">specifications</ulink>.
  2246.       </para>
  2247.     </listitem>
  2248.       </varlistentry>
  2249.  
  2250.       <varlistentry>
  2251.         <term>
  2252.       <emphasis role="bold">Further Processing</emphasis>
  2253.     </term>
  2254.     <listitem>
  2255.       <para>
  2256.         PDF files can imported into other documents by
  2257.         several programs.
  2258.       </para>
  2259.     </listitem>
  2260.       </varlistentry>
  2261.  
  2262.     </variablelist>
  2263.  
  2264.  
  2265.   </sect2>
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.   <sect2 id="file-format-qpro">
  2277.     <title>Quattro Pro File Format</title>
  2278.  
  2279.     <para>
  2280.       The Quattro Pro file format is the format used by Corel's
  2281.       <application>QuattroPro</application> spreadsheet.
  2282.     </para>
  2283.  
  2284.     <para>
  2285.       &gnum; supports opening these files to import their data.
  2286.     </para>
  2287.  
  2288.     <informaltable frame='all'>
  2289.       <tgroup cols='2' align='left' colsep='1' rowsep='1'>
  2290.         <tbody>
  2291.       <row>
  2292.         <entry>
  2293.           <emphasis role="bold">Name:</emphasis>
  2294.         </entry>
  2295.         <entry>Quattro Pro</entry>
  2296.       </row>
  2297.       <row>
  2298.         <entry>
  2299.           <emphasis role="bold">Extensions:</emphasis>
  2300.         </entry>
  2301.         <entry>.wb1 / .wb2 / .wb3</entry>
  2302.       </row>
  2303.       <row>
  2304.         <entry>
  2305.           <emphasis role="bold">Compatible Programs:</emphasis>
  2306.             </entry>
  2307.         <entry><application>Quattro Pro</application></entry>
  2308.       </row>
  2309.       <row>
  2310.         <entry>
  2311.           <emphasis role="bold">Open / Save:</emphasis>
  2312.         </entry>
  2313.         <entry>Open only</entry>
  2314.       </row>
  2315.     </tbody>
  2316.       </tgroup>
  2317.     </informaltable>
  2318.  
  2319.     <variablelist>
  2320.       <!-- <title></title> -->
  2321.       <varlistentry>
  2322.         <term>
  2323.       <emphasis role="bold">Limitations</emphasis>
  2324.     </term>
  2325.     <listitem>
  2326.       <para>
  2327.         
  2328.       </para>
  2329.     </listitem>
  2330.       </varlistentry>
  2331.  
  2332.       <varlistentry>
  2333.         <term>
  2334.       <emphasis role="bold">Plugin</emphasis>
  2335.     </term>
  2336.     <listitem>
  2337.       <para>
  2338.         Supported by the Quatro Pro(tm) plugin.
  2339.       </para>
  2340.     </listitem>
  2341.       </varlistentry>
  2342.  
  2343.       <varlistentry>
  2344.         <term>
  2345.       <emphasis role="bold">Format Details</emphasis>
  2346.     </term>
  2347.     <listitem>
  2348.       <para>
  2349.         
  2350.       </para>
  2351.     </listitem>
  2352.       </varlistentry>
  2353.  
  2354.     </variablelist>
  2355.  
  2356.  
  2357.   </sect2>
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.   <sect2 id="file-format-sc">
  2369.     <title>SC/Xspread File Format</title>
  2370.  
  2371.     <para>
  2372.       The SC/Xspread file format is the file format used by the old sc and
  2373.       Xspread spreadsheets. 
  2374.     </para>
  2375.  
  2376.     <informaltable frame='all'>
  2377.       <tgroup cols='2' align='left' colsep='1' rowsep='1'>
  2378.         <tbody>
  2379.       <row>
  2380.         <entry>
  2381.           <emphasis role="bold">Name:</emphasis>
  2382.         </entry>
  2383.         <entry>SC file format</entry>
  2384.       </row>
  2385.       <row>
  2386.         <entry>
  2387.           <emphasis role="bold">Extensions:</emphasis>
  2388.         </entry>
  2389.         <entry>YES</entry>
  2390.       </row>
  2391.       <row>
  2392.         <entry>
  2393.           <emphasis role="bold">Compatible Programs:</emphasis>
  2394.             </entry>
  2395.         <entry><application>SC</application>,
  2396.         <application>Xspread</application>,
  2397.         <application>S</application> spreadsheets.
  2398.         </entry>
  2399.       </row>
  2400.       <row>
  2401.         <entry>
  2402.           <emphasis role="bold">Open / Save:</emphasis>
  2403.         </entry>
  2404.         <entry>Open only.</entry>
  2405.       </row>
  2406.     </tbody>
  2407.       </tgroup>
  2408.     </informaltable>
  2409.  
  2410.     <variablelist>
  2411.       <!-- <title></title> -->
  2412.       <varlistentry>
  2413.         <term>
  2414.       <emphasis role="bold">Limitations</emphasis>
  2415.     </term>
  2416.     <listitem>
  2417.       <para>
  2418.         
  2419.       </para>
  2420.     </listitem>
  2421.       </varlistentry>
  2422.  
  2423.       <varlistentry>
  2424.         <term>
  2425.       <emphasis role="bold">Plugin</emphasis>
  2426.     </term>
  2427.     <listitem>
  2428.       <para>
  2429.         Supported by the 'SC/XSpread' plug-in.
  2430.       </para>
  2431.     </listitem>
  2432.       </varlistentry>
  2433.  
  2434.       <varlistentry>
  2435.         <term>
  2436.       <emphasis role="bold">Format Details</emphasis>
  2437.     </term>
  2438.     <listitem>
  2439.       <para>
  2440.         
  2441.       </para>
  2442.     </listitem>
  2443.       </varlistentry>
  2444.  
  2445.     </variablelist>
  2446.  
  2447.  
  2448.   </sect2>
  2449.  
  2450.  
  2451.  
  2452.  
  2453.  
  2454.  
  2455.  
  2456.  
  2457.  
  2458.  
  2459.   <sect2 id="file-format-tab">
  2460.     <title>Tab Separated Value File Format</title>
  2461.  
  2462.     <para>
  2463.       The Tab Separated Value file format is a common structuring
  2464.       strategy for text format files. In tab separated value flies,
  2465.       each line in the file represents a row of data and, within each
  2466.       line of the file, the different data fields are separated from
  2467.       one another using a tab spacing. &gnum; handles tab separated
  2468.       value files through the text importer and exporter but this
  2469.       format is given its own definition in this document because it
  2470.       is such a common format.
  2471.     </para>
  2472.  
  2473.     <para>
  2474.       &gnum; will automatically open Tab Separated Value format files
  2475.       separating each row into columns based on the presence of tab
  2476.       characters in the file. If the automatic import leads to any
  2477.       errors, these can generally be corrected by using the "Text
  2478.       Import (configurable)" file format instead. Selecting that file
  2479.       format will launch the <interface>Text Import</interface> druid
  2480.       which allows the user to import Tab Separated Value format files
  2481.       while specifying in greater detail the settings of the import
  2482.       configuration parameters. See the section on <link
  2483.       linkend="sect-file-textImport">importing text files</link> or
  2484.       the section on <link linkend="sect-file-textExport">exporting
  2485.       text files</link> for an explanation of how to open or save Tab
  2486.       Separated Value format files through the <interface>Text
  2487.       Import</interface> druid.
  2488.     </para>
  2489.  
  2490.     <informaltable frame='all'>
  2491.       <tgroup cols='2' align='left' colsep='1' rowsep='1'>
  2492.         <tbody>
  2493.       <row>
  2494.         <entry>
  2495.           <emphasis role="bold">Name:</emphasis>
  2496.         </entry>
  2497.         <entry>Tab Separated Value</entry>
  2498.       </row>
  2499.       <row>
  2500.         <entry>
  2501.           <emphasis role="bold">Extensions:</emphasis>
  2502.         </entry>
  2503.         <entry><literal>.tsv</literal> / <literal>.tab</literal></entry>
  2504.       </row>
  2505.       <row>
  2506.         <entry>
  2507.           <emphasis role="bold">Compatible Programs:</emphasis>
  2508.             </entry>
  2509.         <entry>Multiple</entry>
  2510.       </row>
  2511.       <row>
  2512.         <entry>
  2513.           <emphasis role="bold">Open / Save:</emphasis>
  2514.         </entry>
  2515.         <entry>Both</entry>
  2516.       </row>
  2517.     </tbody>
  2518.       </tgroup>
  2519.     </informaltable>
  2520.  
  2521.     <variablelist>
  2522.       <!-- <title></title> -->
  2523.       <varlistentry>
  2524.         <term>
  2525.       <emphasis role="bold">Limitations</emphasis>
  2526.     </term>
  2527.     <listitem>
  2528.       <para>
  2529.         The tab separated value file format is only useful for the
  2530.             exchange of cell data and cannot be used for sheet objects
  2531.             like graphical plots. This file format cannot save the
  2532.             formatting of cell contents, backgrounds or borders.
  2533.       </para>
  2534.     </listitem>
  2535.       </varlistentry>
  2536.  
  2537.       <varlistentry>
  2538.         <term>
  2539.       <emphasis role="bold">Plugin</emphasis>
  2540.     </term>
  2541.     <listitem>
  2542.         <para>
  2543.         Supported by the core &gnum; program.
  2544.       </para>
  2545.     </listitem>
  2546.       </varlistentry>
  2547.  
  2548.       <varlistentry>
  2549.         <term>
  2550.       <emphasis role="bold">Format Details</emphasis>
  2551.     </term>
  2552.     <listitem>
  2553.       <para>
  2554.         Tab separated value files are simple text files where each
  2555.         row of the text file represents one row in the spreadsheet
  2556.         and where the cells within a row are separated from each
  2557.         other by a comma.
  2558.       </para>
  2559.     </listitem>
  2560.       </varlistentry>
  2561.  
  2562.       <varlistentry>
  2563.         <term>
  2564.       <emphasis role="bold">Further Processing</emphasis>
  2565.     </term>
  2566.     <listitem>
  2567.       <para>
  2568.         Tab separated value files can be processed using any tool
  2569.             which operates on text files. The tab separated value
  2570.             format is also common as a format which can be opened by
  2571.             applications.
  2572.       </para>
  2573.     </listitem>
  2574.       </varlistentry>
  2575.  
  2576.     </variablelist>
  2577.  
  2578.     <para>
  2579.       <emphasis role="italic">See the section on </emphasis>
  2580.       <link linkend="file-format-text">Text Formats</link>
  2581.     </para>
  2582.  
  2583.   </sect2>
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.   <sect2 id="file-format-text">
  2595.     <title>Text File Formats</title>
  2596.  
  2597.     <para>
  2598.       Files in the text file format are files in which the bytes
  2599.       represent the text characters of a particular character set
  2600.       using a specific system to relate the binary numbers in the file
  2601.       to the text characters of the set. Such systems are called
  2602.       'encodings' and become an issue when the file includes
  2603.       characters that are not in the standard ASCII set, such as
  2604.       characters in languages other than English. Character encodings
  2605.       are explained in greater detail in <xref
  2606.       linkend="sect-file-textImport-complex-encoding"/>.
  2607.     </para>
  2608.  
  2609.     <para>
  2610.       Choosing the "Text import (configurable)" or "Text export
  2611.       (configurable)" file formats to open or save files will cause
  2612.       &gnum; to start the <interface>Text Import</interface> or
  2613.       <interface>Text Export</interface> druids. These allow the users
  2614.       to configure in detail the parameters with which existing files
  2615.       will be read into a workbook or existing workbooks will be
  2616.       output to a file.
  2617.     </para>
  2618.  
  2619.     <para>
  2620.       The Text file format includes a number of different formatting
  2621.       strategies for text files in which data fields are structured in
  2622.       a regular pattern. Most of these formats represent rows of data
  2623.       on different lines of the file using different strategies to
  2624.       separated data values within each row. 'Fixed-width' formats
  2625.       place each data entry in a separate column and therefore limit
  2626.       the size of the data entries. 'Separated' formats use a special
  2627.       character or character sequence to separate entries. For
  2628.       instance, the comma separated value, the tab separated value
  2629.       formats and the space separated value formats use commas, tabs,
  2630.       and spaces respectively to separate the data fields.
  2631.     </para>
  2632.  
  2633.     <para>
  2634.       &gnum; can open and save files to a wide variety of text file
  2635.       formats when the text importer or the text exporter is
  2636.       configured appropriately. File can be generated with many
  2637.       different encodings. See the section on <link
  2638.       linkend="sect-file-textImport">importing text files</link> or
  2639.       the section on <link linkend="sect-file-textExport">exporting
  2640.       text files</link> for an explanation of how to open or save
  2641.       these formatted text files.
  2642.     </para>
  2643.  
  2644.     <informaltable frame='all'>
  2645.       <tgroup cols='2' align='left' colsep='1' rowsep='1'>
  2646.         <tbody>
  2647.       <row>
  2648.         <entry>
  2649.           <emphasis role="bold">Name:</emphasis>
  2650.         </entry>
  2651.         <entry>Text File Format</entry>
  2652.       </row>
  2653.       <row>
  2654.         <entry>
  2655.           <emphasis role="bold">Extensions:</emphasis>
  2656.         </entry>
  2657.         <entry><literal>.text</literal> / <literal>.txt</literal>
  2658.         / none </entry>
  2659.       </row>
  2660.       <row>
  2661.         <entry>
  2662.           <emphasis role="bold">Compatible Programs:</emphasis>
  2663.             </entry>
  2664.         <entry>Many programs can read and create formatted text files</entry>
  2665.       </row>
  2666.       <row>
  2667.         <entry>
  2668.           <emphasis role="bold">Open / Save:</emphasis>
  2669.         </entry>
  2670.         <entry>Both</entry>
  2671.       </row>
  2672.     </tbody>
  2673.       </tgroup>
  2674.     </informaltable>
  2675.  
  2676.     <variablelist>
  2677.       <!-- <title></title> -->
  2678.       <varlistentry>
  2679.         <term>
  2680.       <emphasis role="bold">Limitations</emphasis>
  2681.     </term>
  2682.     <listitem>
  2683.       <para>
  2684.         The exporter can only create text files using a separator
  2685.             character and cannot create fixed-width structured files.
  2686.       </para>
  2687.     </listitem>
  2688.       </varlistentry>
  2689.  
  2690.       <varlistentry>
  2691.         <term>
  2692.       <emphasis role="bold">Plugin</emphasis>
  2693.     </term>
  2694.     <listitem>
  2695.       <para>
  2696.         Supported by the core &gnum; program.
  2697.       </para>
  2698.     </listitem>
  2699.       </varlistentry>
  2700.  
  2701.       <varlistentry>
  2702.         <term>
  2703.       <emphasis role="bold">Format Details</emphasis>
  2704.     </term>
  2705.     <listitem>
  2706.       <para>
  2707.         Text file format files are simple text files containing
  2708.         the data for each cell of the worksheet organized in a
  2709.         systematic fashion.
  2710.       </para>
  2711.     </listitem>
  2712.       </varlistentry>
  2713.  
  2714.       <varlistentry>
  2715.         <term>
  2716.       <emphasis role="bold">Further Processing</emphasis>
  2717.     </term>
  2718.     <listitem>
  2719.       <para>
  2720.         Text format files can be processed using any tool which
  2721.         operates on text files, and many other applications can
  2722.         read or generate one or more of these formats.
  2723.       </para>
  2724.     </listitem>
  2725.       </varlistentry>
  2726.  
  2727.     </variablelist>
  2728.  
  2729.  
  2730.   </sect2>
  2731.  
  2732.  
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.   <sect2 id="file-format-troff">
  2742.     <title><command>TROFF</command> File Format</title>
  2743.  
  2744.     <para>
  2745.       The <command>TROFF</command> file format is a text file format
  2746.       with markup in <literal>TROFF</literal>.
  2747.     </para>
  2748.  
  2749.     <para>
  2750.       The <command>TROFF</command> system is a documentation
  2751.       preparation system that can generate many different output files
  2752.       from an input file with standard markup. &gnum; produces a file
  2753.       that can be used as input to the <command>TROFF</command> system
  2754.       or its GNU project replacement, <command>GROFF</command>.
  2755.     </para>
  2756.  
  2757.     <para>
  2758.       The support for this format is mostly intended to produce simple
  2759.       tables into a file which can be used in the
  2760.       <command>TROFF</command> system. Since &gnum; supports full
  2761.       output to Postscript and PDF file formats, those formats should
  2762.       be used to generate graphics for plots and drawing elements.
  2763.     </para>
  2764.  
  2765.     <informaltable frame='all'>
  2766.       <tgroup cols='2' align='left' colsep='1' rowsep='1'>
  2767.         <tbody>
  2768.       <row>
  2769.         <entry>
  2770.           <emphasis role="bold">Name:</emphasis>
  2771.         </entry>
  2772.         <entry>TROFF</entry>
  2773.       </row>
  2774.       <row>
  2775.         <entry>
  2776.           <emphasis role="bold">Extensions:</emphasis>
  2777.         </entry>
  2778.         <entry>.me</entry>
  2779.       </row>
  2780.       <row>
  2781.         <entry>
  2782.           <emphasis role="bold">Compatible Programs:</emphasis>
  2783.             </entry>
  2784.         <entry><application>TROFF</application>,
  2785.         <application>GROFF</application></entry> 
  2786.       </row>
  2787.       <row>
  2788.         <entry>
  2789.           <emphasis role="bold">Open / Save:</emphasis>
  2790.         </entry>
  2791.         <entry>Save only</entry>
  2792.       </row>
  2793.     </tbody>
  2794.       </tgroup>
  2795.     </informaltable>
  2796.  
  2797.     <variablelist>
  2798.       <!-- <title></title> -->
  2799.       <varlistentry>
  2800.         <term>
  2801.       <emphasis role="bold">Limitations</emphasis>
  2802.     </term>
  2803.     <listitem>
  2804.       <para>
  2805.         
  2806.       </para>
  2807.     </listitem>
  2808.       </varlistentry>
  2809.  
  2810.       <varlistentry>
  2811.         <term>
  2812.       <emphasis role="bold">Plugin</emphasis>
  2813.     </term>
  2814.     <listitem>
  2815.       <para>
  2816.         Supported by the 'HTML & TeX' plugin.
  2817.       </para>
  2818.     </listitem>
  2819.       </varlistentry>
  2820.  
  2821.       <varlistentry>
  2822.         <term>
  2823.       <emphasis role="bold">Format Details</emphasis>
  2824.     </term>
  2825.     <listitem>
  2826.       <para>
  2827.         
  2828.       </para>
  2829.     </listitem>
  2830.       </varlistentry>
  2831.  
  2832.       <varlistentry>
  2833.         <term>
  2834.       <emphasis role="bold">Further Processing</emphasis>
  2835.     </term>
  2836.     <listitem>
  2837.       <para>
  2838.         
  2839.       </para>
  2840.  
  2841.       <para>
  2842.             Two examples of the <command>TROFF</command> system will
  2843.             illustrate how to use this file format. Both examples
  2844.             start with a simple worksheet which consists of a simple
  2845.             grid of cells with cell contents, which has been used to
  2846.             create a file called "myfile.me" in the
  2847.             <command>TROFF</command> file format.
  2848.       </para>
  2849.  
  2850.       <para>
  2851.         A table in postscript file format can be created starting
  2852.         from the file generated by &gnum;. The command
  2853. <screen>
  2854. groff -me -t -Tps <replaceable>myfile.me</replaceable><replaceable>myfile.ps</replaceable>
  2855. </screen>
  2856.             will create a postscript file of the corresponding
  2857.         table. Note, however, that &gnum; itself can make a
  2858.         Postscript file of the table directly through the printing
  2859.         system.
  2860.           </para>
  2861.  
  2862.       <para>
  2863.         A table in postscript file format can be created starting
  2864.         from the file generated by &gnum;. The command
  2865. <screen>
  2866. groff -me -t -Tascii <replaceable>myfile.me</replaceable><replaceable>myfile.ascii</replaceable>
  2867. </screen>
  2868.             creates an <keycap>ascii</keycap> (straight text)
  2869.         file. This file will look like:
  2870. <screen>
  2871.  
  2872.  
  2873.  
  2874.  
  2875.  
  2876. Sheet 0
  2877.  
  2878.  
  2879. +----------+------------------+-------------+------------+---+
  2880. |          | Operating System |             |            |   |
  2881. +----------+------------------+-------------+------------+---+
  2882. |          |       DOS        |    Linux    |    SCO     |   |
  2883. +----------+------------------+-------------+------------+---+
  2884. |  January | $1000.00         | $900.00     | $500.00    |   |
  2885. +----------+------------------+-------------+------------+---+
  2886. | February | $900.00          | $2500.00    | $300.00    |   |
  2887. +----------+------------------+-------------+------------+---+
  2888. |    March | $800.00          | $4100.00    | $100.00    |   |
  2889. +----------+------------------+-------------+------------+---+
  2890. |    April | $700.00          | $5700.00    | ($100.00)  |   |
  2891. +----------+------------------+-------------+------------+---+
  2892. |      May | $600.00          | $7300.00    | ($300.00)  |   |
  2893. +----------+------------------+-------------+------------+---+
  2894. |     June | $500.00          | $8900.00    | ($500.00)  |   |
  2895. +----------+------------------+-------------+------------+---+
  2896. |     July | $400.00          | $10500.00   | ($700.00)  |   |
  2897. +----------+------------------+-------------+------------+---+
  2898. |   August | $300.00          | $12100.00   | ($900.00)  |   |
  2899. +----------+------------------+-------------+------------+---+
  2900. |September | $200.00          | $13700.00   | ($1100.00) |   |
  2901. +----------+------------------+-------------+------------+---+
  2902. |  October | $100.00          | $15300.00   | ($1300.00) |   |
  2903. +----------+------------------+-------------+------------+---+
  2904. | November | $0.00            | $16900.00   | ($1500.00) |   |
  2905. +----------+------------------+-------------+------------+---+
  2906. | December | ($100.00)        | $18500.00   | ($1700.00) |   |
  2907. +----------+------------------+-------------+------------+---+
  2908. |          |                  |             |            |   |
  2909. +----------+------------------+-------------+------------+---+
  2910. |  Totals: | $5400.00         | $116400.00  | ($7200.00) |   |
  2911. +----------+------------------+-------------+------------+---+
  2912. |          |                  |             |            |   |
  2913. +----------+------------------+-------------+------------+---+
  2914.  
  2915.  
  2916.  
  2917.  
  2918.  
  2919.  
  2920.  
  2921.  
  2922.  
  2923.  
  2924.  
  2925.  
  2926.  
  2927.  
  2928.  
  2929.  
  2930.  
  2931.                               1
  2932.  
  2933.  
  2934.  
  2935. </screen>
  2936.           </para>
  2937.  
  2938.  
  2939.     </listitem>
  2940.       </varlistentry>
  2941.  
  2942.     </variablelist>
  2943.  
  2944.  
  2945.   </sect2>
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.  
  2952.  
  2953.  
  2954.  
  2955.  
  2956.   <sect2 id="file-format-xbase">
  2957.     <title>Xbase File Format</title>
  2958.  
  2959.     <para>
  2960.       The Xbase file format is a file format that includes a series of
  2961.       files of which one is a text file containing the data and the
  2962.       rest are index or other files. The data file consists of a
  2963.       header and then the records themselves.
  2964.     </para>
  2965.  
  2966.     <para>
  2967.       &gnum; only opens the data file.
  2968.     </para>
  2969.  
  2970.     <informaltable frame='all'>
  2971.       <tgroup cols='2' align='left' colsep='1' rowsep='1'>
  2972.         <tbody>
  2973.       <row>
  2974.         <entry>
  2975.           <emphasis role="bold">Name:</emphasis>
  2976.         </entry>
  2977.         <entry>XBase data file format</entry>
  2978.       </row>
  2979.       <row>
  2980.         <entry>
  2981.           <emphasis role="bold">Extensions:</emphasis>
  2982.         </entry>
  2983.         <entry>.dbf</entry>
  2984.       </row>
  2985.       <row>
  2986.         <entry>
  2987.           <emphasis role="bold">Compatible Programs:</emphasis>
  2988.             </entry>
  2989.         <entry>
  2990.           <application>dBase</application>,
  2991.           <application>Clipper</application>,
  2992.           <application>FoxPro</application>,
  2993.           <application>Visual dBase</application>,
  2994.           <application>Visual FoxPro</application>,
  2995.           and numerous other database applications.
  2996.         </entry>
  2997.       </row>
  2998.       <row>
  2999.         <entry>
  3000.           <emphasis role="bold">Open / Save:</emphasis>
  3001.         </entry>
  3002.         <entry>Open only</entry>
  3003.       </row>
  3004.     </tbody>
  3005.       </tgroup>
  3006.     </informaltable>
  3007.  
  3008.     <variablelist>
  3009.       <!-- <title></title> -->
  3010.       <varlistentry>
  3011.         <term>
  3012.       <emphasis role="bold">Limitations</emphasis>
  3013.     </term>
  3014.     <listitem>
  3015.       <para>
  3016.         
  3017.       </para>
  3018.     </listitem>
  3019.       </varlistentry>
  3020.  
  3021.       <varlistentry>
  3022.         <term>
  3023.       <emphasis role="bold">Plugin</emphasis>
  3024.     </term>
  3025.     <listitem>
  3026.       <para>
  3027.         Supported by the 'XBase' plugin.
  3028.       </para>
  3029.     </listitem>
  3030.       </varlistentry>
  3031.  
  3032.       <varlistentry>
  3033.         <term>
  3034.       <emphasis role="bold">Format Details</emphasis>
  3035.     </term>
  3036.     <listitem>
  3037.       <para>
  3038.         The xBase file format is a generic name for database files
  3039.             saved in the format used by Aston-Tate's (then Borland's)
  3040.             <application>dBase</application> database system. The
  3041.             system became widely popular and has been used extensively
  3042.             by other systems.
  3043.       </para>
  3044.  
  3045.       <para>
  3046.         See the <ulink type ="http"
  3047.             url="http://www.pgts.com.au/download/public/xbase.htm">
  3048.             Xbase File Format Description</ulink> by Erik Bachmann for
  3049.             more details on the xBase format.
  3050.       </para>
  3051.     </listitem>
  3052.       </varlistentry>
  3053.  
  3054.     </variablelist>
  3055.  
  3056.  
  3057.   </sect2>
  3058.  
  3059.  
  3060.  
  3061.  
  3062.  
  3063.  
  3064.  
  3065.  
  3066. <!-- TODO: xhtml format edit fragment handling (cut and paste) -->
  3067.  
  3068.  
  3069.   <sect2 id="file-format-xhtml">
  3070.     <title>XHTML File Format</title>
  3071.  
  3072.     <para>
  3073.       The XHTML file format is a text file format with markup in the
  3074.       eXtensible Markup Language (XML) using a definition which mimics
  3075.       the Hypertext Markup Language (HTML). These files are designed
  3076.       to be viewed in a web browser.
  3077.     </para>
  3078.  
  3079.     <para>
  3080. <!-- TODO: Explain import of XHTML tables
  3081.       &gnum; can open well formed xhtml tables placing the data contents of
  3082.       each entry into a cell of a worksheet.
  3083. -->
  3084.       &gnum; can save the cell contents from a worksheet to a text
  3085.       file which consists of an XHTML file fragment containing only a
  3086.       <table> structure, designed to be inserted into another
  3087.       XHTML file.
  3088.     </para>
  3089.  
  3090.     <informaltable frame='all'>
  3091.       <tgroup cols='2' align='left' colsep='1' rowsep='1'>
  3092.         <tbody>
  3093.       <row>
  3094.         <entry>
  3095.           <emphasis role="bold">Name:</emphasis>
  3096.         </entry>
  3097.         <entry>XHTML</entry>
  3098.       </row>
  3099.       <row>
  3100.         <entry>
  3101.           <emphasis role="bold">Extensions:</emphasis>
  3102.         </entry>
  3103.         <entry><literal>.xhtml</literal> / <literal>.html</literal></entry>
  3104.       </row>
  3105.       <row>
  3106.         <entry>
  3107.           <emphasis role="bold">Compatible Programs:</emphasis>
  3108.             </entry>
  3109.         <entry>Most modern web browsers such as
  3110.         <application>Mozilla</application> and
  3111.         <application>Mozilla-Firefox</application ></entry> 
  3112.       </row>
  3113.       <row>
  3114.         <entry>
  3115.           <emphasis role="bold">Open / Save:</emphasis>
  3116.         </entry>
  3117.         <entry>Both</entry>
  3118.       </row>
  3119.     </tbody>
  3120.       </tgroup>
  3121.     </informaltable>
  3122.  
  3123.     <variablelist>
  3124.       <!-- <title></title> -->
  3125.       <varlistentry>
  3126.         <term>
  3127.       <emphasis role="bold">Limitations</emphasis>
  3128.     </term>
  3129.     <listitem>
  3130.       <para>
  3131.         
  3132.       </para>
  3133.     </listitem>
  3134.       </varlistentry>
  3135.  
  3136.       <varlistentry>
  3137.         <term>
  3138.       <emphasis role="bold">Plugin</emphasis>
  3139.     </term>
  3140.     <listitem>
  3141.       <para>
  3142.         Supported by the 'HTML & TeX' plugin.
  3143.       </para>
  3144.     </listitem>
  3145.       </varlistentry>
  3146.  
  3147.       <varlistentry>
  3148.         <term>
  3149.       <emphasis role="bold">Format Details</emphasis>
  3150.     </term>
  3151.     <listitem>
  3152.       <para>
  3153.         The file is generated, encoded in UTF-8, in the World Wide
  3154.         Web consortium (W3C) XHTML 1.0 Transitional file format. 
  3155.       </para>
  3156.     </listitem>
  3157.       </varlistentry>
  3158.  
  3159.       <varlistentry>
  3160.         <term>
  3161.       <emphasis role="bold">Further Processing</emphasis>
  3162.     </term>
  3163.     <listitem>
  3164.       <para>
  3165.         These XHTML files can be opened by any text editor and can
  3166.         be viewed using any web browser such as
  3167.         <application>Mozilla</application>.
  3168.       </para>
  3169.     </listitem>
  3170.       </varlistentry>
  3171.  
  3172.     </variablelist>
  3173.  
  3174.     <para>
  3175.       <emphasis role="italic">See Also:</emphasis>
  3176.       <link linkend="file-format-html">HTML Format</link>
  3177.     </para>
  3178.  
  3179.  
  3180.   </sect2>
  3181.  
  3182.  
  3183.  
  3184.  
  3185. </sect1>
  3186.  
  3187.        
  3188.