Diff for /parser3/INSTALL between versions 1.46 and 1.48.2.1

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$  

Removed from v.1.46  
changed lines
  Added in v.1.48.2.1


E-mail: