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