Annotation of parser3/INSTALL, revision 1.34

1.33      paf         1: 0.Assuming your perform your builds in $HOME directory 
1.1       paf         2:   and suggested subdirectories.
                      3: 
1.33      paf         4: 1.What is the process to compile Parser3?
                      5: 
                      6:   First, you must have LIBGC installed (conservative garbage collector for C++).
                      7:       libgc >= 6.1 [http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/gc6.1.tar.gz]
                      8:     
                      9:     Installation sequence of this library to $HOME/gc:
                     10: 
                     11:     cd libgc-x.x
                     12:     ./configure --prefix=$HOME/gc --disable-threads --silent
                     13:     make install
                     14: 
                     15:     Then you can use these Parser3 configure options to specify the location and static/dynamic linkage with libgc:
                     16:         --with-static-gc=$HOME/gc/lib
                     17:         --with-shared-gc=$HOME/gc/lib
1.1       paf        18: 
1.3       paf        19:   As most UNIX programs Parser3 follows the "standard":
1.1       paf        20: 
1.33      paf        21:   mkdir $HOME/parser3project
                     22:   cd $HOME/parser3project
1.3       paf        23:   gunzip -c parser3-x.x.tar.gz | tar xvf -
                     24:   mv parser3-x.x parser3
1.2       paf        25:   cd parser3
1.1       paf        26:   ./configure --prefix=/usr/local
1.2       paf        27:   make
                     28:   
1.3       paf        29:   That renaming is needed for SQL drivers to be able to find 
                     30:   necessary include-file in Parser3 sources.
                     31: 
1.10      paf        32:   NOTE:
                     33:   On some system you should run 'gmake'.
1.7       paf        34: 
1.10      paf        35:   NOTE:
1.1       paf        36:   By default your would get 'parser3' binary without support of these features:
                     37:        * xml(xdoc and xnode classes)
1.10      paf        38:   Read section (3) on getting xml-abled parser.
1.1       paf        39: 
1.17      paf        40: 
1.18      paf        41:   Read section (4) on configure options.
1.10      paf        42: 
1.2       paf        43: 2.What is the process to install Parser3?
                     44: 
                     45:   make install
                     46: 
1.1       paf        47:   Installation layout:
                     48:     $prefix/bin/
                     49:       parser3             -- CGI and command line Parser3 interpreter
1.22      paf        50:       auto.p.dist         -- configuration file sample, 
                     51:                              copy it to auto.p and adjust to your needs
1.1       paf        52:     $prefix/etc/
                     53:       parser3.charsets/   -- charset definition files
1.2       paf        54:         koi8-r.cfg        -- cyrillic charset [KOI8-R encoding]
1.33      paf        55:         windows-1250.cfg  -- central europian charset [windows-1250 encoding]
1.5       paf        56:         windows-1251.cfg  -- cyrillic charset [windows-1251 encoding]
                     57:         windows-1257.cfg  -- baltic charset [windows-1257 encoding]
1.2       paf        58: 
1.10      paf        59: 3.What other libraries are needed to compile/install parser? 
1.1       paf        60: 
1.33      paf        61: 3a. In case you wish XML(xdoc and xnode classes) support, you need libraries
                     62:       libxml2 >= 2.5.5 [ftp://xmlsoft.org/libxml2-2.5.5.tar.gz]
1.34    ! paf        63:       libxslt >= 1.1.2 [ftp://xmlsoft.org/libxslt-1.1.2.tar.gz]
1.31      paf        64:       glib >= 1.2.10 [ftp://ftp.gtk.org/pub/gtk/v1.2/glib-1.2.10.tar.gz]
1.33      paf        65:       gdome2 >= 0.7.4 [http://gdome2.cs.unibo.it/tarball/gdome2-0.7.4.tar.gz]
1.1       paf        66:     on your system, and specify path to them to Parser3 configure script.
                     67: 
1.33      paf        68:     Sources of libgdome library must be patched prior to compile. [library author bug confirmation pending]
1.1       paf        69: 
1.33      paf        70:     Installation sequence of these libraries to $HOME/gnome:
1.1       paf        71: 
1.31      paf        72:     libxml2:
1.1       paf        73: 
                     74:     cd libxml2-x.x.x
1.33      paf        75:     ./configure --prefix=$HOME/gnome --without-zlib --without-iconv --silent
1.1       paf        76:     make install
                     77: 
1.31      paf        78:     libxslt:
1.1       paf        79: 
                     80:     cd libxslt-x.x.x
1.33      paf        81:     ./configure --with-libxml-prefix=$HOME/gnome --prefix=$HOME/gnome --without-debug --without-debugger --silent
1.1       paf        82:     make install
                     83: 
1.31      paf        84:     glib:
1.1       paf        85: 
                     86:     cd glib-x.x.x
1.33      paf        87:     ./configure --prefix=$HOME/gnome 
1.1       paf        88:     make install
                     89: 
1.31      paf        90:     gdome2:
1.1       paf        91: 
1.9       paf        92:     cd gdome2-x.x.x
1.33      paf        93:     patch -p0 < $HOME/parser3project/parser3/src/lib/patches/gdome2.patch
                     94:     ./configure --with-glib-prefix=$HOME/gnome --disable-glibtest --with-libxml-prefix=$HOME/gnome --prefix=$HOME/gnome --silent
1.1       paf        95:     make install
                     96: 
1.9       paf        97:     And copy these additional headers into install includes directory
1.1       paf        98: 
1.33      paf        99:     mkdir $HOME/gnome/include/libgdome/gdomecore
                    100:     cp libgdome/gdomecore/gdome-xml-node.h $HOME/gnome/include/libgdome/gdomecore
                    101:     cp libgdome/gdomecore/gdome-xml-document.h $HOME/gnome/include/libgdome/gdomecore
1.1       paf       102:     
                    103: 
1.9       paf       104:     Parser3 configure options, choose whether you need static or dynamic linkage with xml libs:
1.33      paf       105:         --with-static-xml=$HOME/gnome
                    106:         --with-shared-xml=$HOME/gnome
1.1       paf       107: 
1.5       paf       108:     NOTE:
                    109:     In case your glib as installed into some other prefix,
                    110:     specify it's configuration file with
                    111:         --with-glib-config=/path/to/your/glib-config
1.24      paf       112:     NOTE:
                    113:     In case you are using SHARED xml libraries, you may want to link in direct path to them,
                    114:     use this key to specify which linker key to use do do that:
                    115:         --with-pathlink=LKEY    put dynamic libraries paths to binary
                    116:                                 using linker key (-R, -rpath-link)
                    117: 
1.33      paf       118: 3b. In case you wish $mail:receive support you need libraries
1.31      paf       119:       glib >= 1.2.10 [ftp://ftp.gtk.org/pub/gtk/v1.2/glib-1.2.10.tar.gz]
                    120:       gmime >= 1.0.1 [http://spruce.sourceforge.net/gmime/sources/gmime-1.0.5.tar.gz]
1.24      paf       121:     on your system, and specify path to them to Parser3 configure script.
                    122: 
                    123:     You may have already installed glib at 3b step.
                    124: 
1.31      paf       125:     glib:
1.24      paf       126: 
                    127:     cd glib-x.x.x
1.33      paf       128:     ./configure --prefix=$HOME/gnome 
1.24      paf       129:     make install
                    130: 
1.31      paf       131:     gmime:
1.24      paf       132: 
                    133:     cd gmime-x.x.x
1.33      paf       134:     ./configure --prefix=$HOME/gnome
1.24      paf       135:     make install
                    136: 
                    137:     Parser3 configure options, choose whether you need static or dynamic linkage with xml libs:
1.33      paf       138:         --with-static-mailreceive=$HOME/gnome
                    139:         --with-shared-mailreceive=$HOME/gnome
1.24      paf       140: 
                    141:     NOTE:
                    142:     In case your glib as installed into some other prefix,
                    143:     specify it's configuration file with
                    144:         --with-glib-config=/path/to/your/glib-config
                    145:     NOTE:
                    146:     In case you are using SHARED mime library, you may want to link in direct path to it,
1.33      paf       147:     use this key to specify which linker key to use do do that:
1.9       paf       148:         --with-pathlink=LKEY    put dynamic libraries paths to binary
                    149:                                 using linker key (-R, -rpath-link)
                    150: 
1.18      paf       151: 4.
                    152: 
                    153:   In case you're not root on machine you're installing Parser,
                    154:   we recommend you to do:
                    155:   ./configure --prefix=/your/home/parser3install
                    156:   and afterwards copy parser3install/bin/parser3 to your CGI directory
                    157:   or make a symlink [if your web server configured to follow symlinks].
                    158: 
                    159:   You can disable any exec operations by setting
                    160:   --disable-execs
                    161:   option to configure.
                    162:   file::exec, file::cgi and mail:send (unix version) methods would be disabled.
                    163: 
1.29      paf       164:   You can enable reading and executing files, not belonging to group+user 
                    165:   other then effective by setting
                    166:   --disable-safe-mode
1.18      paf       167:   option to configure.
                    168:   
                    169:   You can disable user-configured sendmail commands by forcing it, setting
                    170:   "--with=sendmail=COMMAND"
                    171:   option to configure.
1.26      paf       172: 
                    173:   In case you are experiencing problem with gcc runtime exception handling,
                    174:   try to configure with
                    175:   --with-sjlj-exceptions
                    176:   option.  
1.18      paf       177: 
1.33      paf       178:   By default libstdc++ is linked statically, you can re-enable dynamic libstdc++ linkage by specifying
                    179:   --with-dynamic-stdcpp
                    180:   option to configure.  
                    181: 
                    182: 
1.18      paf       183:   Some root config options can be specified at configure time, and would override autodetects.
                    184: 
                    185:   List of enabled charsets:
                    186:   --with-charsets=CHARSET[,CHARSET,...]  Enables charsets in root config (windows-1251,
                    187:                           windows-1250 windows-1257 koi8-r; Default is windows-1251)
                    188:   SQL clients:
1.21      paf       189:   --with-mysql-client=mysqlclientlib?params
                    190:   --with-pgsql-client=pgsqlclientlib?params
                    191:   --with-oracle-client=oracleclientlib?params
1.18      paf       192:   
1.1       paf       193:  
1.4       paf       194: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
1.1       paf       195: 
1.34    ! paf       196: $Id: INSTALL,v 1.33 2003/07/24 11:31:18 paf Exp $

E-mail: