Diff for /parser3/INSTALL between versions 1.39 and 1.44.2.5

version 1.39, 2005/01/31 08:51:32 version 1.44.2.5, 2005/12/09 10:49:08
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.4.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
     ./configure --prefix=$HOME/gc --disable-threads --silent      mkdir $HOME/parser3project/src
     make install      cd $HOME/parser3project/src
       wget http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/gc6.6.tar.gz
     Then you can use these Parser3 configure options to specify the location and static/dynamic linkage with libgc:      gunzip -c gc6.6.tar.gz | tar vxf -
         --with-static-gc=$HOME/gc/lib      cd gc6.6
         --with-shared-gc=$HOME/gc/lib      CPPFLAGS=USE_LIBC_PRIVATES \
       ./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:      NOTE:
     On some platforms there is special version of libgc patched to support some      On some platforms there is special version of libgc patched to support some
Line 40 Line 48
   
   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 65 Line 73
 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.17.tar.gz]        libxml2 >= 2.6.22
       libxslt >= 1.1.2 [ftp://xmlsoft.org/libxslt-1.1.10-1.src.rpm]        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.8.1.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 --without-threads --silent      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      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 --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      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 --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      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 -p $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 121 Line 159
         --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)
   
       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  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/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.
   
Line 130 Line 177
   
     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 --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 --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 158 Line 209
   
   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 173 Line 224
   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

Removed from v.1.39  
changed lines
  Added in v.1.44.2.5


E-mail: