|
|
| version 1.35, 2004/02/10 10:41:52 | version 1.44, 2005/12/01 15:09:59 |
|---|---|
| Line 4 | Line 4 |
| 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++). | First, you must have LIBGC installed (conservative garbage collector for C++). |
| libgc >= 6.1 [http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/gc6.1.tar.gz] | libgc >= 6.6 |
| Installation sequence of this library to $HOME/gc: | Installation sequence of this library: |
| cd libgc-x.x | mkdir $HOME/parser3project/src |
| ./configure --prefix=$HOME/gc --disable-threads --silent | 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 | make install |
| Then you can use these Parser3 configure options to specify the location and static/dynamic linkage with libgc: | Then you can use these Parser3 configure options to use that statically compiled gc: |
| --with-static-gc=$HOME/gc/lib | --with-static-gc=$HOME/parser3project/gc/lib |
| --with-shared-gc=$HOME/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": | As most UNIX programs Parser3 follows the "standard": |
| Line 23 | Line 35 |
| gunzip -c parser3-x.x.tar.gz | tar xvf - | gunzip -c parser3-x.x.tar.gz | tar xvf - |
| mv parser3-x.x parser3 | mv parser3-x.x parser3 |
| cd parser3 | cd parser3 |
| ./configure --prefix=/usr/local | ./configure --prefix=$HOME/parser3install --silent |
| make | make |
| That renaming is needed for SQL drivers to be able to find | That renaming is needed for SQL drivers to be able to find |
| Line 34 | Line 46 |
| NOTE: | NOTE: |
| By default your would get 'parser3' binary without support of these features: | By default your would get 'parser3' binary without support of these features: |
| * xml(xdoc and xnode classes) | * xml(xdoc and xnode classes) |
| Read section (3) on getting xml-abled parser. | Read section (3) on getting xml-abled parser. |
| Line 59 | Line 71 |
| 3.What other libraries are needed to compile/install parser? | 3.What other libraries are needed to compile/install parser? |
| 3a. In case you wish XML(xdoc and xnode classes) support, you need libraries | 3a. In case you wish XML(xdoc and xnode classes) support, you need libraries |
| libxml2 >= 2.6.5 [ftp://xmlsoft.org/libxml2-2.6.5.tar.gz] | libxml2 >= 2.6.22 |
| libxslt >= 1.1.2 [ftp://xmlsoft.org/libxslt-1.1.2.tar.gz] | libxslt >= 1.1.15 |
| glib >= 1.2.10 [ftp://ftp.gtk.org/pub/gtk/v1.2/glib-1.2.10.tar.gz] | glib >= 1.2.10 |
| gdome2 >= 0.7.4 [http://gdome2.cs.unibo.it/tarball/gdome2-0.7.4.tar.gz] | gdome2 => 0.8.1 |
| on your system, and specify path to them to Parser3 configure script. | 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] | Sources of libgdome library must be patched prior to compile. [library author bug confirmation pending] |
| Installation sequence of these libraries to $HOME/gnome: | Installation sequence of these libraries to $HOME/parser3project/gnome: |
| libxml2: | libxml2: |
| cd libxml2-x.x.x | cd $HOME/parser3project/src |
| ./configure --prefix=$HOME/gnome --without-zlib --without-iconv --silent | wget 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], xptr[xinclude]-- needed! | |
| ./configure --prefix=$HOME/parser3project/gnome \ | |
| --with-html --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 | make install |
| libxslt: | libxslt: |
| cd libxslt-x.x.x | cd $HOME/parser3project/src |
| ./configure --with-libxml-prefix=$HOME/gnome --prefix=$HOME/gnome --without-debug --without-debugger --silent | wget 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 | make install |
| glib: | glib: |
| cd glib-x.x.x | cd $HOME/parser3project/src |
| ./configure --prefix=$HOME/gnome | #on freebsd5 this is reported to work: |
| #wget ftp://ftp.gtk.org/pub/gtk/v1.1/glib-1.1.16.tar.gz | |
| wget 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 | make install |
| gdome2: | gdome2: |
| cd gdome2-x.x.x | 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 | patch -p0 < $HOME/parser3project/parser3/src/lib/patches/gdome2.patch |
| ./configure --with-glib-prefix=$HOME/gnome --disable-glibtest --with-libxml-prefix=$HOME/gnome --prefix=$HOME/gnome --silent | |
| make install | |
| And copy these additional headers into install includes directory | #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 | |
| mkdir $HOME/gnome/include/libgdome/gdomecore | |
| cp libgdome/gdomecore/gdome-xml-node.h $HOME/gnome/include/libgdome/gdomecore | |
| cp libgdome/gdomecore/gdome-xml-document.h $HOME/gnome/include/libgdome/gdomecore | |
| Parser3 configure options, choose whether you need static or dynamic linkage with xml libs: | Parser3 configure options, choose whether you need static or dynamic linkage with xml libs: |
| --with-static-xml=$HOME/gnome | --with-static-xml=$HOME/parser3project/gnome |
| --with-shared-xml=$HOME/gnome | --with-shared-xml=$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 116 | Line 157 |
| using linker key (-R, -rpath-link) | using linker key (-R, -rpath-link) |
| 3b. In case you wish $mail:receive support you need libraries | 3b. In case you wish $mail:receive support you need libraries |
| glib >= 1.2.10 [ftp://ftp.gtk.org/pub/gtk/v1.2/glib-1.2.10.tar.gz] | glib >= 1.2.10 |
| gmime >= 1.0.1 [http://spruce.sourceforge.net/gmime/sources/gmime-1.0.5.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. | You may have already installed glib at 3b step. |
| glib: | glib: |
| cd glib-x.x.x | cd $HOME/parser3project/src |
| ./configure --prefix=$HOME/gnome | #on freebsd5 this is reported to work: ftp://ftp.gtk.org/pub/gtk/v1.1/glib-1.1.16.tar.gz |
| wget 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 --silent | |
| make install | make install |
| gmime: | gmime: |
| cd gmime-x.x.x | cd gmime-x.x.x |
| ./configure --prefix=$HOME/gnome | ./configure --prefix=$HOME/parser3project/gnome |
| make install | make install |
| Parser3 configure options, choose whether you need static or dynamic linkage with xml libs: | Parser3 configure options, choose whether you need static or dynamic linkage with xml libs: |
| --with-static-mailreceive=$HOME/gnome | --with-static-mailreceive=$HOME/parser3project/gnome |
| --with-shared-mailreceive=$HOME/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 152 | Line 197 |
| In case you're not root on machine you're installing Parser, | In case you're not root on machine you're installing Parser, |
| we recommend you to do: | we recommend you to do: |
| ./configure --prefix=/your/home/parser3install | ./configure --prefix=$HOME/parser3install |
| and afterwards copy parser3install/bin/parser3 to your CGI directory | and afterwards copy $HOME/parser3install/bin/parser3 to your CGI directory |
| or make a symlink [if your web server configured to follow symlinks]. | or make a symlink [if your web server configured to follow symlinks]. |
| You can disable any exec operations by setting | You can disable any exec operations by setting |
| Line 167 | Line 212 |
| option to configure. | option to configure. |
| You can disable user-configured sendmail commands by forcing it, setting | You can disable user-configured sendmail commands by forcing it, setting |
| "--with=sendmail=COMMAND" | --with=sendmail="COMMAND" |
| option to configure. | option to configure, for example: |
| --with-sendmail="/usr/sbin/sendmail -i -t -f postmaster" | |
| In case you are experiencing problem with gcc runtime exception handling, | In case you are experiencing problem with gcc runtime exception handling, |
| try to configure with | try to configure with |
| Line 190 | Line 236 |
| --with-pgsql-client=pgsqlclientlib?params | --with-pgsql-client=pgsqlclientlib?params |
| --with-oracle-client=oracleclientlib?params | --with-oracle-client=oracleclientlib?params |
| 5. | |
| If you need to build apache 1.3 parser module, get source distribution of apache 1.3, | |
| run configure there, then run parser configure with one more option: | |
| --with-apache13=Apache13 source distribution directory | |
| after 'make' go to that directory and run | |
| ./p3runConfigure <any additional options to apache configure to pass> | |
| example: | |
| ./p3runConfigure --prefix=$D/apache13install --enable-module=rewrite | |
| WARNING: if you want to use apache configure option --enable-shared=max, do this: | |
| ./p3runConfigure --enable-shared=max --disable-shared=mod_parser3.c | |
| Alexandr Petrosian <paf@design.ru> (http://paf.design.ru) | Alexandr Petrosian <paf@design.ru> (http://paf.design.ru) |
| $Id$ | $Id$ |