doc/C/files-ssconvert.xml

   1 <sect1 id="sect-files-ssconvert">
   2   <title>Converting Files</title>
   3
   4   <para>
   5     &gnum; can convert files automatically without needing user
   6     intervention. This allows a large number of files to be converted
   7     using a script. &gnum; is distributed along with a program called
   8     <application>ssconvert</application> which is the program used to
   9     convert files automatically. All of the file formats supported by
  10     &gnum; can be used except for the PostScript and PDF file formats
  11     which operate through the printing system.
  12   </para>
  13
  14   <para>
  15     This application is used, from the command line by specifying, any
  16     desired options, an input file and an output file. For example,
  17 <screen>
  18 ssconvert myfile.xls myfile.gnumeric
  19 </screen>
  20     would convert an <application>Excel</application> format file to a
  21     &gnum; format file.
  22   </para>
  23
  24 <!-- TODO: render hack -->
  25   <para></para>
  26
  27   <para>
  28     The available import and export file formats which ssconvert
  29     can read can be listed using
  30 <screen>
  31 ssconvert --list-importers
  32 </screen>
  33     or
  34 <screen>
  35 ssconvert --list-exporters
  36 </screen>
  37     respectively.
  38   </para>
  39
  40 <!-- TODO: render hack -->
  41   <para></para>
  42
  43   <para>
  44     Like other GNU command line applications,
  45     <application>ssconvert</application>  includes a manual page. This
  46     page can be accessed by typing:
  47 <screen>
  48 man ssconvert
  49 </screen>
  50     which will open the manual page. This page can be navigated by
  51     typing the space bar or using the <keysym>Page Up</keysym> and
  52     <keysym>Page Down</keysym> buttons. The
  53     <application>man</application> program can be dismissed by typing
  54     the <keysym>q</keysym> key.
  55   </para>
  56
  57
  58 </sect1>
  59