Diff for /parser3/INSTALL between versions 1.7 and 1.30

version 1.7, 2002/02/22 13:02:40 version 1.30, 2003/01/09 17:06:45
Line 16 Line 16
   That renaming is needed for SQL drivers to be able to find     That renaming is needed for SQL drivers to be able to find 
   necessary include-file in Parser3 sources.    necessary include-file in Parser3 sources.
   
   NOTE: on some system you sould run 'gmake'.    NOTE:
     On some system you should run 'gmake'.
   
     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.
   
   
   In case you're not root on machine you're installing Parser,    Read section (4) on configure options.
   we recommend you to do:  
   ./configure --prefix=/your/home/parser3install  
   and afterwards copy parser3install/bin/parser3 to your CGI directory  
   or make a symlink [if your web server configured to follow symlinks].  
   
 2.What is the process to install Parser3?  2.What is the process to install Parser3?
   
Line 35 Line 34
   Installation layout:    Installation layout:
     $prefix/bin/      $prefix/bin/
       parser3             -- CGI and command line Parser3 interpreter        parser3             -- CGI and command line Parser3 interpreter
         auto.p.dist         -- configuration file sample, 
                                copy it to auto.p and adjust to your needs
     $prefix/etc/      $prefix/etc/
       parser3.conf        -- main configuration file  
       parser3.charsets/   -- charset definition files        parser3.charsets/   -- charset definition files
         koi8-r.cfg        -- cyrillic charset [KOI8-R encoding]          koi8-r.cfg        -- cyrillic charset [KOI8-R encoding]
         windows-1250.cfg  -- central europian charset [windows-1250 encoding]          windows-1250.cfg  -- central europian charset [windows-1250 encoding]
         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]
   
   NOTE:  3.What other libraries are needed to compile/install parser? 
     For subsequent compilations+installs   
     to prevent configuration files to be overwritten use  
     
     make install-exec  
       
     it will update parser3 binary only.  
   
 2.What other libraries are needed to compile/install libxml ?   
   
   * You can compile and use parser without any additional libraries.  3a. You can compile and use parser without any additional libraries.
     That would be 'basic' version of it.      That would be 'basic' version of it.
   
   3b. In case you wish xml(xdoc and xnode classes) support you need libraries
   * In case you wish xml(xdoc and xnode classes) support you need libraries        libxml2 >= 2.4.11
       libxml2 >= 2.3.6  
       libxslt >= 1.0.9        libxslt >= 1.0.9
       glib >= 1.2.10        glib >= 1.2.10
       gdome2 >= 0.7.0        gdome2 >= 0.7.0
Line 70 Line 61
   
     Installation sequence of these libraries to $D/gnome:      Installation sequence of these libraries to $D/gnome:
   
     libxml2:       libxml2:  [ftp://ftp.gnome.org/pub/GNOME/sources/libxml2/2.4/libxml2-2.4.12.tar.gz]
   
     cd libxml2-x.x.x      cd libxml2-x.x.x
     patch -p0 < $D/parser3project/parser3/src/patches/libxml_error_column_tab.patch      patch -p0 < $D/parser3project/parser3/src/lib/patches/libxml_error_column_tab.patch
     patch -p0 < $D/parser3project/parser3/src/patches/libxml_htmloutput_of_xslemptyattr_emptyquotes.patch      patch -p0 < $D/parser3project/parser3/src/lib/patches/libxml_htmloutput_of_xslemptyattr_emptyquotes.patch
     patch -p0 < $D/parser3project/parser3/src/patches/libxml_transcoder_context1.patch      patch -p0 < $D/parser3project/parser3/src/lib/patches/libxml_transcoder_context1.patch
     patch -p0 < $D/parser3project/parser3/src/patches/libxml_transcoder_context2.patch      patch -p0 < $D/parser3project/parser3/src/lib/patches/libxml_transcoder_context2.patch
     patch -p0 < $D/parser3project/parser3/src/patches/libxml_transcoder_context3.patch      patch -p0 < $D/parser3project/parser3/src/lib/patches/libxml_transcoder_context3.patch
     patch -p0 < $D/parser3project/parser3/src/patches/libxml_transcoder_context4.patch      patch -p0 < $D/parser3project/parser3/src/lib/patches/libxml_transcoder_context4.patch
     ./configure --prefix=$D/gnome      ./configure --prefix=$D/gnome --without-zlib --without-iconv
     make install      make install
   
     libxslt:      libxslt:  [ftp://ftp.gnome.org/pub/GNOME/sources/libxslt/1.0/libxslt-1.0.9.tar.gz]
   
     cd libxslt-x.x.x      cd libxslt-x.x.x
     patch -p0 < $D/parser3project/parser3/src/patches/libxslt_html_output_no_charset_meta.patch      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      ./configure --with-libxml-prefix=$D/gnome --prefix=$D/gnome --without-debug --without-debugger
     make install      make install
   
     glib: [ftp://ftp.gtk.org/pub/gtk/v1.2/glib-1.2.10.tar.gz]      glib:  [ftp://ftp.gtk.org/pub/gtk/v1.2/glib-1.2.10.tar.gz]
   
     cd glib-x.x.x      cd glib-x.x.x
     ./configure --prefix=$D/gnome       ./configure --prefix=$D/gnome 
     make install      make install
   
     gdome2:      gdome2:  [http://gdome2.cs.unibo.it/tarball/gdome2-0.7.0.tar.gz]
   
       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      ./configure --with-glib-prefix=$D/gnome --disable-glibtest --with-libxml-prefix=$D/gnome --prefix=$D/gnome
     make install      make install
   
     And patch+copy these additional headers into install includes directory      And copy these additional headers into install includes directory
   
         patch -p0 < $D/parser3project/parser3/src/patches/libgdome_cpp_syntax1.patch  
         patch -p0 < $D/parser3project/parser3/src/patches/libgdome_cpp_syntax2.patch  
     mkdir $D/gnome/include/libgdome/gdomecore      mkdir $D/gnome/include/libgdome/gdomecore
     cp libgdome/gdomecore/gdome-xml-node.h $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      cp libgdome/gdomecore/gdome-xml-document.h $D/gnome/include/libgdome/gdomecore
           
   
     Parser3 configure option:      Parser3 configure options, choose whether you need static or dynamic linkage with xml libs:
         --with-gnome-xml=$D/gnome          --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
       ./configure --prefix=$D/gnome
       make install
   
       Parser3 configure options, choose whether you need static or dynamic linkage with xml libs:
           --with-static-mailreceive=$D/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,
     specify it's configuration file with      specify it's configuration file with
         --with-glib-config=/path/to/your/glib-config          --with-glib-config=/path/to/your/glib-config
       NOTE:
       In case you are using SHARED mime library, you may want to link in direct path to it,
       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)
   
   4.
   
     In case you're not root on machine you're installing Parser,
     we recommend you to do:
     ./configure --prefix=/your/home/parser3install
     and afterwards copy parser3install/bin/parser3 to your CGI directory
     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
     --disable-execs
     option to configure.
     file::exec, file::cgi and mail:send (unix version) methods would be disabled.
   
     You can enable reading and executing files, not belonging to group+user 
     other then effective by setting
     --disable-safe-mode
     option to configure.
     
     You can disable user-configured sendmail commands by forcing it, setting
     "--with=sendmail=COMMAND"
     option to configure.
   
     In case you are experiencing problem with gcc runtime exception handling,
     try to configure with
     --with-sjlj-exceptions
     option.  
   
     Some root config options can be specified at configure time, and would override autodetects.
   
     List of enabled charsets:
     --with-charsets=CHARSET[,CHARSET,...]  Enables charsets in root config (windows-1251,
                             windows-1250 windows-1257 koi8-r; Default is windows-1251)
     SQL clients:
     --with-mysql-client=mysqlclientlib?params
     --with-pgsql-client=pgsqlclientlib?params
     --with-oracle-client=oracleclientlib?params
     
     
 Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)  Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
   

Removed from v.1.7  
changed lines
  Added in v.1.30


E-mail: