|
|
| version 1.46, 2005/12/16 10:14:54 | version 1.48.2.1, 2005/12/28 16:45:36 |
|---|---|
| Line 1 | Line 1 |
| 0.Assuming your perform your builds in $HOME directory | Alexander Petrosian <paf@design.ru> (http://paf.design.ru) |
| and suggested subdirectories. | $Id$ |
| 1.What is the process to compile Parser3? | 1.What is the process to compile Parser3? |
| First, you must have LIBGC installed (conservative garbage collector for C++). | Just start ./buildall-with-xml script and you would get $HOME/parser3install/bin/parser3 binary. |
| libgc >= 6.6 | In case you do not need XML support, use ./buildall-without-xml |
| Installation sequence of this library: | |
| mkdir $HOME/parser3project | |
| mkdir $HOME/parser3project/src | |
| cd $HOME/parser3project/src | |
| wget http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/gc6.6.tar.gz | |
| gunzip -c gc6.6.tar.gz | tar vxf - | |
| cd gc6.6 | |
| ./configure --prefix=$HOME/parser3project/gc --disable-threads --disable-shared --silent | |
| make install | |
| Then you can use these Parser3 configure options to use that statically compiled gc: | |
| --with-static-gc=$HOME/parser3project/gc/lib | |
| In case you already have libgc.so and want to link parser against it, | |
| you can this Parser3 configure option: | |
| --with-shared-gc=/path/to/gc/lib | |
| NOTE: | |
| On some platforms there is special version of libgc patched to support some | |
| local piece of subtlety. | |
| Official libgc does not work there, use special version instead. | |
| (OpenBSD reported to be one of those) | |
| As most UNIX programs Parser3 follows the "standard": | |
| mkdir $HOME/parser3project | |
| cd $HOME/parser3project | |
| gunzip -c parser3-x.x.tar.gz | tar xvf - | |
| mv parser3-x.x parser3 | |
| cd parser3 | |
| ./configure --prefix=$HOME/parser3install --silent | |
| make | |
| That renaming is needed for SQL drivers to be able to find | |
| necessary include-file in Parser3 sources. | |
| NOTE: | NOTE: |
| On some system you should run 'gmake'. | On some platforms there is special version of libgc patched to support some |
| local piece of subtlety. | |
| Official libgc does not work there, use special version instead. | |
| (OpenBSD reported to be one of those) | |
| NOTE: | NOTE: |
| By default your would get 'parser3' binary without support of these features: | On some systems there are no "make" and you should run 'gmake', change buildall script accordingly then. |
| * xml(xdoc and xnode classes) | |
| Read section (3) on getting xml-abled parser. | |
| Read section (4) on configure options. | |
| 2.What is the process to install Parser3? | 2.What is the process to install Parser3? |
| Line 69 | Line 32 |
| windows-1251.cfg -- cyrillic charset [windows-1251 encoding] | windows-1251.cfg -- cyrillic charset [windows-1251 encoding] |
| windows-1257.cfg -- baltic charset [windows-1257 encoding] | windows-1257.cfg -- baltic charset [windows-1257 encoding] |
| 3.What other libraries are needed to compile/install parser? | 3.I have heard about $mail:receive experimental support, how do I use it? |
| You need two more libraries | |
| 3a. In case you wish XML(xdoc and xnode classes) support, you need libraries | |
| libxml2 >= 2.6.22 | |
| libxslt >= 1.1.15 | |
| glib >= 1.2.10 | |
| gdome2 => 0.8.1 | |
| on your system, and specify path to them to Parser3 configure script. | |
| Sources of libgdome library must be patched prior to compile. [library author bug confirmation pending] | |
| Installation sequence of these libraries to $HOME/parser3project/gnome: | |
| libxml2: | |
| cd $HOME/parser3project/src | |
| mkdir $HOME/parser3project | |
| wget --passive-ftp ftp://xmlsoft.org/libxml2-2.6.22.tar.gz | |
| gunzip -c libxml2-2.6.22.tar.gz | tar vxf - | |
| cd libxml2-2.6.22 | |
| #sax1, output, tree, xinclude[in libxslt], html[in libxslt, mode=html?] xptr[xinclude]-- needed! | |
| ./configure --prefix=$HOME/parser3project/gnome \ | |
| --without-iconv --without-threads --without-debug \ | |
| --without-iso8859x --without-legacy \ | |
| --without-pattern --without-push --without-python \ | |
| --without-reader --without-writer --without-readline --without-regexps \ | |
| --without-schemas --without-schematron \ | |
| --without-modules \ | |
| --without-zlib \ | |
| --disable-shared --silent | |
| echo "int main(){return 0;}">testapi.c | |
| echo "int main(){return 0;}">runtest.c | |
| make install | |
| libxslt: | |
| cd $HOME/parser3project/src | |
| wget --passive-ftp ftp://xmlsoft.org/libxslt-1.1.15.tar.gz | |
| gunzip -c libxslt-1.1.15.tar.gz | tar vxf - | |
| cd libxslt-1.1.15 | |
| ./configure --with-libxml-prefix=$HOME/parser3project/gnome --prefix=$HOME/parser3project/gnome --without-debug --without-debugger --without-crypto --without-plugins --disable-shared --silent | |
| make install | |
| glib: | |
| cd $HOME/parser3project/src | |
| #on freebsd5 this is reported to work: | |
| #wget --passive-ftp ftp://ftp.gtk.org/pub/gtk/v1.1/glib-1.1.16.tar.gz | |
| wget --passive-ftp ftp://ftp.gtk.org/pub/gtk/v1.2/glib-1.2.10.tar.gz | |
| gunzip -c glib-1.2.10.tar.gz | tar vxf - | |
| cd glib-1.2.10 | |
| ./configure --prefix=$HOME/parser3project/gnome --disable-debug --disable-shared --silent | |
| make install | |
| gdome2: | |
| cd $HOME/parser3project/src | |
| wget http://gdome2.cs.unibo.it/tarball/gdome2-0.8.1.tar.gz | |
| gunzip -c gdome2-0.8.1.tar.gz | tar vxf - | |
| cd gdome2-0.8.1 | |
| patch -p0 < $HOME/parser3project/parser3/src/lib/patches/gdome2.patch | |
| #copy these additional headers into install includes directory | |
| mkdir -p $HOME/parser3project/gnome/include/libgdome/gdomecore | |
| cp libgdome/gdomecore/gdome-xml-node.h $HOME/parser3project/gnome/include/libgdome/gdomecore | |
| cp libgdome/gdomecore/gdome-xml-document.h $HOME/parser3project/gnome/include/libgdome/gdomecore | |
| set path=($path $HOME/parser3project/gnome/bin) | |
| ./configure --enable-glib-1 --disable-glibtest \ | |
| --prefix=$HOME/parser3project/gnome \ | |
| --disable-shared --silent | |
| make install | |
| Parser3 configure options, choose whether you need static or dynamic linkage with xml libs: | |
| --with-static-xml=$HOME/parser3project/gnome | |
| --with-shared-xml=$HOME/parser3project/gnome | |
| NOTE: | |
| In case your glib as installed into some other prefix, | |
| specify it's configuration file with | |
| --with-glib-config=/path/to/your/glib-config | |
| NOTE: | |
| In case you are using SHARED xml libraries, you may want to link in direct path to them, | |
| use this key to specify which linker key to use do do that: | |
| --with-pathlink=LKEY put dynamic libraries paths to binary | |
| using linker key (-R, -rpath-link) | |
| Sample: | |
| cd $HOME/parser3project/parser3 | |
| ./configure --prefix=$HOME/parser3install \ | |
| --with-static-gc=$HOME/parser3project/gc/lib \ | |
| --with-static-xml=$HOME/parser3project/gnome \ | |
| --with-sendmail="/usr/sbin/sendmail -i -t -f postmaster" \ | |
| --silent | |
| make install | |
| 3b. In case you wish $mail:receive support you need libraries | |
| glib >= 1.2.10 | glib >= 1.2.10 |
| gmime >= 1.0.1 [http://spruce.sourceforge.net/gmime/sources/v1.0/gmime-1.0.8.tar.gz] | gmime >= 1.0.1 [http://spruce.sourceforge.net/gmime/sources/v1.0/gmime-1.0.8.tar.gz] |
| on your system, and specify path to them to Parser3 configure script. | on your system, and specify path to them to Parser3 configure script. |
| You may have already installed glib at 3b step. | |
| glib: | glib: |
| cd $HOME/parser3project/src | cd $HOME/parser3project/src |
| Line 190 | Line 54 |
| ./configure --prefix=$HOME/parser3project/gnome | ./configure --prefix=$HOME/parser3project/gnome |
| make install | make install |
| Parser3 configure options, choose whether you need static or dynamic linkage with xml libs: | You need to change buildall script to add this to parser3 configure line: |
| --with-static-mailreceive=$HOME/parser3project/gnome | --with-static-mailreceive=$HOME/parser3project/gnome |
| --with-shared-mailreceive=$HOME/parser3project/gnome | |
| NOTE: | NOTE: |
| In case your glib as installed into some other prefix, | In case your glib as installed into some other prefix, |
| Line 260 | Line 123 |
| WARNING: if you want to use apache configure option --enable-shared=max, do this: | WARNING: if you want to use apache configure option --enable-shared=max, do this: |
| ./p3runConfigure --enable-shared=max --disable-shared=mod_parser3.c | ./p3runConfigure --enable-shared=max --disable-shared=mod_parser3.c |
| Alexandr Petrosian <paf@design.ru> (http://paf.design.ru) | |
| $Id$ |