INSTALL

   1 INSTALLING catdoc 0.91.x
   2
   3 Starting with patchlevel alpha 3 catdoc version 0.90 have autoconf
   4 configuration. Thanks for Stephen Farell to convince me.
   5
   6 So typically you should run
   7 ./configure
   8 make
   9 make install
  10
  11 to compile and install catdoc.
  12
  13 NOTE for HPUX users. If you want to compile catdoc with aCC,
  14 use CC="aCC -Ae" ./configure
  15
  16 Configure script for catdoc recognizes following options (apart from
  17 standard --prefix,  --exec-prefix and so on)
  18
  19 --disable-wordview - disables building of Tcl/Tk viewer wordview,
  20           which requires X11. (note, it would be disabled automatically,
  21           if you don't have appropriate version of Tcl/Tk). You may
  22           wish to use this if you don't have X installed.
  23
  24 --with-wish=path - specifies path to wish interpreter. This option have
  25           two uses
  26           1. If executable named wish, found in your PATH is old, and
  27              you have newer wish installed as wish4.2 or wish8.0,
  28              you should specify this in order to build wordview viewer
  29           2. If you are compiling catdoc from telnet connection or
  30              text console, you can specify this option to skip tcl
  31              version check, which would run wish and fail if it couldn't
  32              find X display (which would lead configure to assume, that
  33              you don't have good wish)
  34
  35 --with-input=charset
  36 --with-output=charset
  37           Allows you to specify charset names to expect in 8-bit word
  38           file and to produce as output text file. Do ls ./charsets/*.txt
  39           to find out which charsets are provided in distribution.
  40           Additional charsets can be obtained from
  41           ftp.unicode.org
  42           Note that make would fail if you specify charset, which
  43           doesn't exist in charset directory.
  44
  45 --disable-charset-check
  46           By default, make in charsets directory fails, if it is unable
  47           to find *.txt files corresponding to default input and output
  48           charsets. This option allows you to disable this check. Make
  49           in charsets directory would always succeed, but it is your
  50           responsibility to provide charset files in catdoc library
  51           directory after make install.
  52 --disable-langinfo
  53           By default, catdoc tries to use your current locale charset
  54           as its output charset. It can be, of cource always overriden
  55           by command line switch. But charset from the locale takes
  56           precedence over charset in configuration file, unless
  57           you put use_locale=no into this file.
  58
  59           If your C library is not XPG4-compatible, and configure fails
  60           to detect it, you can completely disable langinfo support
  61           using this switch.
  62
  63 If you experience strange and unexpected behavoir of catdoc, try to
  64 remove optimization flag (-02) from FLAGS in src/Makefile.
  65 If you can write autoconf test to check for this problem, please send it
  66 to me.
  67
  68 It was known problem with version 0.35 on HP/UX 9, and I scarcely changed
  69 my style of writing since.
  70
  71