|
|
| version 1.26, 2002/09/04 14:59:54 | version 1.41, 2005/11/30 14:56:58 |
|---|---|
| Line 1 | Line 1 |
| 0.Assuming your perform your builds in $D directory | 0.Assuming your perform your builds in $HOME directory |
| and suggested subdirectories. | and suggested subdirectories. |
| 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++). | |
| libgc >= 6.6 | |
| Installation sequence of this library: | |
| mkdir $HOME/p3p/src | |
| cd $HOME/p3p/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/p3p/gc --disable-threads --silent | |
| make install | |
| Then you can use these Parser3 configure options to specify the location and static/dynamic linkage with libgc: | |
| --with-static-gc=$HOME/p3p/gc/lib | |
| --with-shared-gc=$HOME/p3p/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": |
| mkdir $D/parser3project | mkdir $HOME/p3p |
| cd $D/parser3project | cd $HOME/p3p |
| 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 45 | Line 68 |
| 3.What other libraries are needed to compile/install parser? | 3.What other libraries are needed to compile/install parser? |
| 3a. You can compile and use parser without any additional libraries. | 3a. In case you wish XML(xdoc and xnode classes) support, you need libraries |
| That would be 'basic' version of it. | libxml2 >= 2.6.22 |
| libxslt >= 1.1.15 | |
| 3b. In case you wish xml(xdoc and xnode classes) support you need libraries | glib >= 1.2.10 |
| libxml2 >= 2.4.11 | gdome2 >= 0.8.1 |
| libxslt >= 1.0.9 | |
| glib >= 1.2.10 | |
| gdome2 >= 0.7.0 | |
| 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 these two libraries must be patched prior to compile: | Sources of libgdome library must be patched prior to compile. [library author bug confirmation pending] |
| * libxml2 | |
| * libxslt | |
| Installation sequence of these libraries to $D/gnome: | Installation sequence of these libraries to $HOME/p3p/gnome: |
| libxml2: [ftp://ftp.gnome.org/pub/GNOME/stable/sources/libxml/libxml2-2.4.12.tar.gz] | libxml2: |
| cd libxml2-x.x.x | cd $HOME/p3p/src |
| patch -p0 < $D/parser3project/parser3/src/lib/patches/libxml_error_column_tab.patch | wget ftp://xmlsoft.org/libxml2-2.6.22.tar.gz |
| patch -p0 < $D/parser3project/parser3/src/lib/patches/libxml_htmloutput_of_xslemptyattr_emptyquotes.patch | gunzip -c libxml2-2.6.22.tar.gz | tar vxf - |
| patch -p0 < $D/parser3project/parser3/src/lib/patches/libxml_transcoder_context1.patch | cd libxml2-2.6.22 |
| patch -p0 < $D/parser3project/parser3/src/lib/patches/libxml_transcoder_context2.patch | ./configure --prefix=$HOME/p3p/gnome --without-zlib --without-iconv --without-threads --silent |
| patch -p0 < $D/parser3project/parser3/src/lib/patches/libxml_transcoder_context3.patch | |
| patch -p0 < $D/parser3project/parser3/src/lib/patches/libxml_transcoder_context4.patch | |
| ./configure --prefix=$D/gnome --without-zlib | |
| make install | make install |
| libxslt: [ftp://ftp.gnome.org/pub/GNOME/stable/sources/libxslt/libxslt-1.0.9.tar.gz] | libxslt: |
| cd libxslt-x.x.x | cd $HOME/p3p/src |
| patch -p0 < $D/parser3project/parser3/src/lib/patches/libxslt_html_output_no_charset_meta.patch | wget ftp://xmlsoft.org/libxslt-1.1.15.tar.gz |
| ./configure --with-libxml-prefix=$D/gnome --prefix=$D/gnome --without-debug --without-debugger | gunzip -c libxslt-1.1.15.tar.gz | tar vxf - |
| cd libxslt-1.1.15 | |
| ./configure --with-libxml-prefix=$HOME/p3p/gnome --prefix=$HOME/p3p/gnome --without-debug --without-debugger --silent | |
| make install | make install |
| glib: [ftp://ftp.gtk.org/pub/gtk/v1.2/glib-1.2.10.tar.gz] | glib: |
| cd glib-x.x.x | cd $HOME/p3p/src |
| ./configure --prefix=$D/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/p3p/gnome --silent | |
| make install | make install |
| gdome2: [http://phd.cs.unibo.it/gdome2/tarball/gdome2-0.7.0.tar.gz] | gdome2: |
| cd gdome2-x.x.x | cd $HOME/p3p/src |
| patch -p0 < $D/parser3project/parser3/src/lib/patches/libgdome_cpp_syntax1.patch | wget http://gdome2.cs.unibo.it/tarball/gdome2-0.8.1.tar.gz |
| patch -p0 < $D/parser3project/parser3/src/lib/patches/libgdome_cpp_syntax2.patch | gunzip -c gdome2-0.8.1.tar.gz | tar vxf - |
| patch -p0 < $D/parser3project/parser3/src/lib/patches/libgdome_morestatic.patch | cd gdome2-0.8.1 |
| ./configure --with-glib-prefix=$D/gnome --disable-glibtest --with-libxml-prefix=$D/gnome --prefix=$D/gnome | patch -p0 < $HOME/p3p/parser3/src/lib/patches/gdome2.patch |
| ./configure --with-glib-prefix=$HOME/p3p/gnome --disable-glibtest --with-libxml-prefix=$HOME/p3p/gnome --prefix=$HOME/p3p/gnome --silent | |
| make install | make install |
| And copy these additional headers into install includes directory | And copy these additional headers into install includes directory |
| mkdir $D/gnome/include/libgdome/gdomecore | mkdir -p $HOME/p3p/gnome/include/libgdome/gdomecore |
| cp libgdome/gdomecore/gdome-xml-node.h $D/gnome/include/libgdome/gdomecore | cp libgdome/gdomecore/gdome-xml-node.h $HOME/p3p/gnome/include/libgdome/gdomecore |
| cp libgdome/gdomecore/gdome-xml-document.h $D/gnome/include/libgdome/gdomecore | cp libgdome/gdomecore/gdome-xml-document.h $HOME/p3p/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=$D/gnome | --with-static-xml=$HOME/p3p/gnome |
| --with-shared-xml=$D/gnome | --with-shared-xml=$HOME/p3p/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 138 |
| --with-pathlink=LKEY put dynamic libraries paths to binary | --with-pathlink=LKEY put dynamic libraries paths to binary |
| using linker key (-R, -rpath-link) | using linker key (-R, -rpath-link) |
| 3c. 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 | glib >= 1.2.10 |
| gmime >= 1.0.1 | 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: [ftp://ftp.gtk.org/pub/gtk/v1.2/glib-1.2.10.tar.gz] | glib: |
| cd glib-x.x.x | cd $HOME/p3p/src |
| ./configure --prefix=$D/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/p3p/gnome --silent | |
| make install | make install |
| gmime: [http://spruce.sourceforge.net/gmime/sources/gmime-1.0.5.tar.gz] | gmime: |
| cd gmime-x.x.x | cd gmime-x.x.x |
| ./configure --prefix=$D/gnome | ./configure --prefix=$HOME/p3p/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=$D/gnome | --with-static-mailreceive=$HOME/p3p/gnome |
| --with-shared-mailreceive=$D/gnome | --with-shared-mailreceive=$HOME/p3p/gnome |
| NOTE: | NOTE: |
| In case your glib as installed into some other prefix, | In case your glib as installed into some other prefix, |
| Line 153 | Line 179 |
| 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/p3i |
| and afterwards copy parser3install/bin/parser3 to your CGI directory | and afterwards copy $HOME/p3i/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 libstdc++ linkage by setting | |
| --disable-link-libstdcpp | |
| option to configure. | |
| You can disable any exec operations by setting | You can disable any exec operations by setting |
| --disable-execs | --disable-execs |
| option to configure. | option to configure. |
| file::exec, file::cgi and mail:send (unix version) methods would be disabled. | file::exec, file::cgi and mail:send (unix version) methods would be disabled. |
| You can disable reading and executing files, belonging to group | You can enable reading and executing files, not belonging to group+user |
| other then current by setting | other then effective by setting |
| --disable-foreign-group-files | --disable-safe-mode |
| 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 |
| --with-sjlj-exceptions | --with-sjlj-exceptions |
| option. | option. |
| By default libstdc++ is linked statically, you can re-enable dynamic libstdc++ linkage by specifying | |
| --with-dynamic-stdcpp | |
| option to configure. | |
| Some root config options can be specified at configure time, and would override autodetects. | Some root config options can be specified at configure time, and would override autodetects. |
| List of enabled charsets: | List of enabled charsets: |
| Line 190 | Line 218 |
| --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$ |