]> www.wagner.pp.ru Git - oss/catdoc.git/blob - INSTALL
Implemented
[oss/catdoc.git] / 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