doc/xls2csv.1.in

   1 .TH xls2csv 1  "Version @catdoc_version@" "MS-Word reader"
   2 .SH NAME
   3 xls2csv \- reads MS-Excel file and puts its content as comma-separated data on standard output
   4 .SH SYNOPSIS
   5
   6 .BR "xls2csv " [ -xlV ]
   7 .RB [ -f
   8 .IR " format " ]
   9 .RB [ -b
  10 .IR " string " ]
  11 .RB [ -s
  12 .IR " charset " ]
  13 .RB [ -d
  14 .IR " charset " ]
  15 .RB [-q
  16 .IR " number " ]
  17 .RB [ -c
  18 .IR " char" ]
  19 .I files
  20
  21 .SH DESCRIPTION
  22
  23 .B xls2csv
  24 reads MS-Excel spreadsheet and dumps its content as comma-separated
  25 values to stdout. Numbers are printed without delimiters, strings are
  26 enclosed in the double quotes. Double-quotes inside string are doubled.
  27 .SH "OPTIONS"
  28 .TP 8
  29 .BR -x
  30 print unknown Unicode chars as \exNNNN, rather than as question marks
  31 .TP 8
  32 .BR -l
  33 list known charsets and exit successfully
  34 .TP 8
  35 .BI -c char
  36 cell separator char. By default - comma.
  37 .TP 8
  38 .BI -b string
  39 sheet break string. This string (by default - formfeed) would be output
  40 at the end of each workbook page. This string is printed after page
  41 starting at start of line, but no linefeed would be automatically added
  42 at the end of string. Include newline at the ent of sheet separator if
  43 you want it to appear on separate line by itself
  44 .TP 9
  45 .BI -g number
  46 number of decimal digits in the numbers. By default maximal double
  47 precision (system-dependent macro DBL_DIG) is used.
  48 .TP 8
  49 .BI -q number
  50 set quote mode. In quote mode 0 cell contents is never quoted.
  51 In quote mode 1 only strings which contain spaces, double quotes or
  52 commas are quoted.
  53 In quote mode 2 (default) all cells with type string are quoted.
  54 In quote mode 3 all cells are quoted.
  55
  56 .TP 8
  57 .BI -d charset`
  58 - specifies destination charset name. Charset file has format described in
  59 CHARACTER SETS section of
  60 .BR catdoc (1)
  61 manual page. By default, current locale
  62 charset would be used if langinfo support was enabled at the compile time.
  63
  64 .TP 8
  65 .BI -s charset
  66 - specifies source charset. Typically, Excel files have CODE PAGE
  67 record, which denotes input charset, but for some reason you may wish to
  68 override it.
  69 .TP 8
  70 .BI -f format
  71 - specifies date/time format to use for output of all Excel date and
  72 time  values.  If this option is not specified, format, specified in
  73 the spreadsheet is used. On POSIX system any format, allowed by
  74 .BR strftime (3)
  75 can be used as value of this option. Under MS-DOS
  76 .B xls2csv
  77 implements limited set of
  78 .B strftime
  79 formats, namely
  80 .BR m ", " d ", " y ", " Y ", " b ", " l ", " p ", " H ", " M ", " S .
  81
  82 .TP 8
  83 .B -V
  84 outputs version number
  85
  86 .SH FILES
  87 ${HOME}/.catdocrc, catdoc charset files and substitution map files (see
  88 .BR catdoc (1)
  89 manual page for details,
  90
  91 .SH "SEE ALSO"
  92
  93 .BR cat (1),
  94 .BR catdoc (1),
  95 .BR strings (1),
  96 .BR utf (4),
  97 .BR unicode (4)
  98
  99 .SH AUTHOR
 100
 101 V.B.Wagner <vitus@45.free.net>, based on biffview by David Rysdam