Annotation of parser3/INSTALL, revision 1.47
1.33 paf 1: 0.Assuming your perform your builds in $HOME directory
1.1 paf 2: and suggested subdirectories.
3:
1.33 paf 4: 1.What is the process to compile Parser3?
5:
6: First, you must have LIBGC installed (conservative garbage collector for C++).
1.41 paf 7: libgc >= 6.6
1.33 paf 8:
1.41 paf 9: Installation sequence of this library:
1.33 paf 10:
1.45 paf 11: mkdir $HOME/parser3project
1.44 paf 12: mkdir $HOME/parser3project/src
13: cd $HOME/parser3project/src
14: wget http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/gc6.6.tar.gz
15: gunzip -c gc6.6.tar.gz | tar vxf -
1.41 paf 16: cd gc6.6
1.44 paf 17: ./configure --prefix=$HOME/parser3project/gc --disable-threads --disable-shared --silent
1.33 paf 18: make install
19:
1.44 paf 20: Then you can use these Parser3 configure options to use that statically compiled gc:
1.43 paf 21: --with-static-gc=$HOME/parser3project/gc/lib
1.44 paf 22: In case you already have libgc.so and want to link parser against it,
23: you can this Parser3 configure option:
24: --with-shared-gc=/path/to/gc/lib
1.1 paf 25:
1.38 paf 26: NOTE:
27: On some platforms there is special version of libgc patched to support some
28: local piece of subtlety.
29: Official libgc does not work there, use special version instead.
30: (OpenBSD reported to be one of those)
31:
1.3 paf 32: As most UNIX programs Parser3 follows the "standard":
1.1 paf 33:
1.43 paf 34: mkdir $HOME/parser3project
35: cd $HOME/parser3project
1.3 paf 36: gunzip -c parser3-x.x.tar.gz | tar xvf -
37: mv parser3-x.x parser3
1.2 paf 38: cd parser3
1.39 paf 39: ./configure --prefix=$HOME/parser3install --silent
1.2 paf 40: make
41:
1.3 paf 42: That renaming is needed for SQL drivers to be able to find
43: necessary include-file in Parser3 sources.
44:
1.10 paf 45: NOTE:
46: On some system you should run 'gmake'.
1.7 paf 47:
1.10 paf 48: NOTE:
1.1 paf 49: By default your would get 'parser3' binary without support of these features:
1.44 paf 50: * xml(xdoc and xnode classes)
1.10 paf 51: Read section (3) on getting xml-abled parser.
1.1 paf 52:
1.17 paf 53:
1.18 paf 54: Read section (4) on configure options.
1.10 paf 55:
1.2 paf 56: 2.What is the process to install Parser3?
57:
58: make install
59:
1.1 paf 60: Installation layout:
61: $prefix/bin/
62: parser3 -- CGI and command line Parser3 interpreter
1.22 paf 63: auto.p.dist -- configuration file sample,
64: copy it to auto.p and adjust to your needs
1.1 paf 65: $prefix/etc/
66: parser3.charsets/ -- charset definition files
1.2 paf 67: koi8-r.cfg -- cyrillic charset [KOI8-R encoding]
1.33 paf 68: windows-1250.cfg -- central europian charset [windows-1250 encoding]
1.5 paf 69: windows-1251.cfg -- cyrillic charset [windows-1251 encoding]
70: windows-1257.cfg -- baltic charset [windows-1257 encoding]
1.2 paf 71:
1.10 paf 72: 3.What other libraries are needed to compile/install parser?
1.1 paf 73:
1.33 paf 74: 3a. In case you wish XML(xdoc and xnode classes) support, you need libraries
1.41 paf 75: libxml2 >= 2.6.22
76: libxslt >= 1.1.15
1.1 paf 77: on your system, and specify path to them to Parser3 configure script.
78:
1.33 paf 79: Sources of libgdome library must be patched prior to compile. [library author bug confirmation pending]
1.1 paf 80:
1.43 paf 81: Installation sequence of these libraries to $HOME/parser3project/gnome:
1.1 paf 82:
1.31 paf 83: libxml2:
1.1 paf 84:
1.44 paf 85: cd $HOME/parser3project/src
1.45 paf 86: mkdir $HOME/parser3project
87: wget --passive-ftp ftp://xmlsoft.org/libxml2-2.6.22.tar.gz
1.44 paf 88: gunzip -c libxml2-2.6.22.tar.gz | tar vxf -
1.41 paf 89: cd libxml2-2.6.22
1.45 paf 90: #sax1, output, tree, xinclude[in libxslt], html[in libxslt, mode=html?] xptr[xinclude]-- needed!
1.44 paf 91: ./configure --prefix=$HOME/parser3project/gnome \
1.45 paf 92: --without-iconv --without-threads --without-debug \
1.44 paf 93: --without-iso8859x --without-legacy \
94: --without-pattern --without-push --without-python \
95: --without-reader --without-writer --without-readline --without-regexps \
96: --without-schemas --without-schematron \
97: --without-modules \
98: --without-zlib \
99: --disable-shared --silent
100: echo "int main(){return 0;}">testapi.c
101: echo "int main(){return 0;}">runtest.c
1.1 paf 102: make install
103:
1.31 paf 104: libxslt:
1.1 paf 105:
1.44 paf 106: cd $HOME/parser3project/src
1.45 paf 107: wget --passive-ftp ftp://xmlsoft.org/libxslt-1.1.15.tar.gz
1.44 paf 108: gunzip -c libxslt-1.1.15.tar.gz | tar vxf -
1.41 paf 109: cd libxslt-1.1.15
1.44 paf 110: ./configure --with-libxml-prefix=$HOME/parser3project/gnome --prefix=$HOME/parser3project/gnome --without-debug --without-debugger --without-crypto --without-plugins --disable-shared --silent
1.1 paf 111: make install
112:
113:
1.9 paf 114: Parser3 configure options, choose whether you need static or dynamic linkage with xml libs:
1.43 paf 115: --with-static-xml=$HOME/parser3project/gnome
116: --with-shared-xml=$HOME/parser3project/gnome
1.1 paf 117:
1.5 paf 118: NOTE:
1.24 paf 119: In case you are using SHARED xml libraries, you may want to link in direct path to them,
120: use this key to specify which linker key to use do do that:
121: --with-pathlink=LKEY put dynamic libraries paths to binary
122: using linker key (-R, -rpath-link)
123:
1.45 paf 124: Sample:
125: cd $HOME/parser3project/parser3
126: ./configure --prefix=$HOME/parser3install \
127: --with-static-gc=$HOME/parser3project/gc/lib \
128: --with-static-xml=$HOME/parser3project/gnome \
129: --with-sendmail="/usr/sbin/sendmail -i -t -f postmaster" \
130: --silent
131: make install
132:
1.33 paf 133: 3b. In case you wish $mail:receive support you need libraries
1.41 paf 134: glib >= 1.2.10
1.39 paf 135: gmime >= 1.0.1 [http://spruce.sourceforge.net/gmime/sources/v1.0/gmime-1.0.8.tar.gz]
1.24 paf 136: on your system, and specify path to them to Parser3 configure script.
137:
1.31 paf 138: glib:
1.24 paf 139:
1.44 paf 140: cd $HOME/parser3project/src
1.41 paf 141: #on freebsd5 this is reported to work: ftp://ftp.gtk.org/pub/gtk/v1.1/glib-1.1.16.tar.gz
1.45 paf 142: wget --passive-ftp ftp://ftp.gtk.org/pub/gtk/v1.2/glib-1.2.10.tar.gz
1.44 paf 143: gunzip -c glib-1.2.10.tar.gz | tar vxf -
1.41 paf 144: cd glib-1.2.10
1.43 paf 145: ./configure --prefix=$HOME/parser3project/gnome --silent
1.24 paf 146: make install
147:
1.31 paf 148: gmime:
1.24 paf 149:
150: cd gmime-x.x.x
1.43 paf 151: ./configure --prefix=$HOME/parser3project/gnome
1.24 paf 152: make install
153:
154: Parser3 configure options, choose whether you need static or dynamic linkage with xml libs:
1.43 paf 155: --with-static-mailreceive=$HOME/parser3project/gnome
156: --with-shared-mailreceive=$HOME/parser3project/gnome
1.24 paf 157:
158: NOTE:
159: In case your glib as installed into some other prefix,
160: specify it's configuration file with
161: --with-glib-config=/path/to/your/glib-config
162: NOTE:
163: In case you are using SHARED mime library, you may want to link in direct path to it,
1.33 paf 164: use this key to specify which linker key to use do do that:
1.9 paf 165: --with-pathlink=LKEY put dynamic libraries paths to binary
166: using linker key (-R, -rpath-link)
167:
1.18 paf 168: 4.
169:
170: In case you're not root on machine you're installing Parser,
171: we recommend you to do:
1.43 paf 172: ./configure --prefix=$HOME/parser3install
173: and afterwards copy $HOME/parser3install/bin/parser3 to your CGI directory
1.18 paf 174: or make a symlink [if your web server configured to follow symlinks].
175:
176: You can disable any exec operations by setting
177: --disable-execs
178: option to configure.
179: file::exec, file::cgi and mail:send (unix version) methods would be disabled.
180:
1.29 paf 181: You can enable reading and executing files, not belonging to group+user
182: other then effective by setting
183: --disable-safe-mode
1.18 paf 184: option to configure.
185:
186: You can disable user-configured sendmail commands by forcing it, setting
1.41 paf 187: --with=sendmail="COMMAND"
188: option to configure, for example:
189: --with-sendmail="/usr/sbin/sendmail -i -t -f postmaster"
1.26 paf 190:
191: In case you are experiencing problem with gcc runtime exception handling,
192: try to configure with
193: --with-sjlj-exceptions
194: option.
1.18 paf 195:
1.33 paf 196: By default libstdc++ is linked statically, you can re-enable dynamic libstdc++ linkage by specifying
197: --with-dynamic-stdcpp
198: option to configure.
199:
200:
1.18 paf 201: Some root config options can be specified at configure time, and would override autodetects.
202:
203: List of enabled charsets:
204: --with-charsets=CHARSET[,CHARSET,...] Enables charsets in root config (windows-1251,
205: windows-1250 windows-1257 koi8-r; Default is windows-1251)
206: SQL clients:
1.21 paf 207: --with-mysql-client=mysqlclientlib?params
208: --with-pgsql-client=pgsqlclientlib?params
209: --with-oracle-client=oracleclientlib?params
1.18 paf 210:
1.37 paf 211: 5.
212: If you need to build apache 1.3 parser module, get source distribution of apache 1.3,
213: run configure there, then run parser configure with one more option:
214: --with-apache13=Apache13 source distribution directory
215: after 'make' go to that directory and run
216:
217: ./p3runConfigure <any additional options to apache configure to pass>
218:
219: example:
1.46 paf 220: ./p3runConfigure --prefix=$HOME/apache13install --enable-module=rewrite
1.37 paf 221:
222: WARNING: if you want to use apache configure option --enable-shared=max, do this:
223: ./p3runConfigure --enable-shared=max --disable-shared=mod_parser3.c
224:
1.4 paf 225: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
1.1 paf 226:
1.47 ! paf 227: $Id: INSTALL,v 1.46 2005/12/16 10:14:54 paf Exp $
E-mail: