[BACK]Return to INSTALL CVS log [TXT] [DIR] Up to [parser3project] / parser3

Diff for /parser3/INSTALL between versions 1.27 and 1.48.2.1

version 1.27, 2002/12/19 11:20:37 version 1.48.2.1, 2005/12/28 16:45:36
Line 1 Line 1
 0.Assuming your perform your builds in $D 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?
   
   As most UNIX programs Parser3 follows the "standard":    Just start ./buildall-with-xml script and you would get $HOME/parser3install/bin/parser3 binary.
     In case you do not need XML support, use ./buildall-without-xml
   
   mkdir $D/parser3project  
   cd $D/parser3project  
   gunzip -c parser3-x.x.tar.gz | tar xvf -  
   mv parser3-x.x parser3  
   cd parser3  
   ./configure --prefix=/usr/local  
   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 43 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. You can compile and use parser without any additional libraries.  
     That would be 'basic' version of it.  
   
 3b. In case you wish xml(xdoc and xnode classes) support you need libraries  
       libxml2 >= 2.4.11  
       libxslt >= 1.0.9  
       glib >= 1.2.10        glib >= 1.2.10
       gdome2 >= 0.7.0        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.
   
     Sources of these two libraries must be patched prior to compile:       glib:
       * libxml2  
       * libxslt  
   
     Installation sequence of these libraries to $D/gnome:  
   
     libxml2:  [ftp://ftp.gnome.org/pub/GNOME/stable/sources/libxml/libxml2-2.4.12.tar.gz]  
   
     cd libxml2-x.x.x  
     patch -p0 < $D/parser3project/parser3/src/lib/patches/libxml_error_column_tab.patch  
     patch -p0 < $D/parser3project/parser3/src/lib/patches/libxml_htmloutput_of_xslemptyattr_emptyquotes.patch  
     patch -p0 < $D/parser3project/parser3/src/lib/patches/libxml_transcoder_context1.patch  
     patch -p0 < $D/parser3project/parser3/src/lib/patches/libxml_transcoder_context2.patch  
     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 --without-iconv  
     make install  
   
     libxslt:  [ftp://ftp.gnome.org/pub/GNOME/stable/sources/libxslt/libxslt-1.0.9.tar.gz]  
   
     cd libxslt-x.x.x  
     patch -p0 < $D/parser3project/parser3/src/lib/patches/libxslt_html_output_no_charset_meta.patch  
     ./configure --with-libxml-prefix=$D/gnome --prefix=$D/gnome --without-debug --without-debugger  
     make install  
   
     glib:  [ftp://ftp.gtk.org/pub/gtk/v1.2/glib-1.2.10.tar.gz]  
   
     cd glib-x.x.x      cd $HOME/parser3project/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 --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
   
     gdome2:  [http://phd.cs.unibo.it/gdome2/tarball/gdome2-0.7.0.tar.gz]      gmime:
   
     cd gdome2-x.x.x  
     patch -p0 < $D/parser3project/parser3/src/lib/patches/libgdome_cpp_syntax1.patch  
     patch -p0 < $D/parser3project/parser3/src/lib/patches/libgdome_cpp_syntax2.patch  
     patch -p0 < $D/parser3project/parser3/src/lib/patches/libgdome_morestatic.patch  
     ./configure --with-glib-prefix=$D/gnome --disable-glibtest --with-libxml-prefix=$D/gnome --prefix=$D/gnome  
     make install  
   
     And copy these additional headers into install includes directory  
   
     mkdir $D/gnome/include/libgdome/gdomecore  
     cp libgdome/gdomecore/gdome-xml-node.h $D/gnome/include/libgdome/gdomecore  
     cp libgdome/gdomecore/gdome-xml-document.h $D/gnome/include/libgdome/gdomecore  
       
   
     Parser3 configure options, choose whether you need static or dynamic linkage with xml libs:  
         --with-static-xml=$D/gnome  
         --with-shared-xml=$D/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)  
   
 3c. In case you wish $mail:receive support you need libraries  
       glib >= 1.2.10  
       gmime >= 1.0.1  
     on your system, and specify path to them to Parser3 configure script.  
   
     You may have already installed glib at 3b step.  
   
     glib:  [ftp://ftp.gtk.org/pub/gtk/v1.2/glib-1.2.10.tar.gz]  
   
     cd glib-x.x.x  
     ./configure --prefix=$D/gnome   
     make install  
   
     gmime:  [http://spruce.sourceforge.net/gmime/sources/gmime-1.0.5.tar.gz]  
   
     cd gmime-x.x.x      cd gmime-x.x.x
     ./configure --prefix=$D/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=$D/gnome          --with-static-mailreceive=$HOME/parser3project/gnome
         --with-shared-mailreceive=$D/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 71
   
   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 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 110
   --with-pgsql-client=pgsqlclientlib?params    --with-pgsql-client=pgsqlclientlib?params
   --with-oracle-client=oracleclientlib?params    --with-oracle-client=oracleclientlib?params
       
    5.
 Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)    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
   
 $Id$    ./p3runConfigure <any additional options to apache configure to pass>
     
     example:
     ./p3runConfigure --prefix=$HOME/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
Removed from v.1.27  
changed lines
  Added in v.1.48.2.1

E-mail: