Return to INSTALL CVS log

Up to [parser3project] / parser3

Annotation of parser3/INSTALL, revision 1.57

1.57    ! moko        1: $Id: INSTALL,v 1.56 2009-10-06 13:16:48 misha Exp $
1.1       paf         2: 
1.33      paf         3: 1.What is the process to compile Parser3?
                      4: 
1.57    ! moko        5:   Just start ./buildall script and you would get $HOME/parser3install/bin/parser3 binary.
1.33      paf         6: 
1.57    ! moko        7:   NOTE:
        !             8:   In case you do not need XML support, use ./buildall --without-xml
1.33      paf         9: 
1.49      paf        10:   NOTE:
1.57    ! moko       11:   If case you need apache parser module (DSO), use ./buildall --with-apache
1.1       paf        12: 
1.49      paf        13:   NOTE:
1.57    ! moko       14:   If you have gc, prce, libxml and libxslt installed, you can use ./configure --with-xml
1.3       paf        15: 
1.10      paf        16:   NOTE:
1.57    ! moko       17:   In case you later would experience problems with gcc runtime exception handling 
        !            18:   (most notable when reporting sql-related problems), pass this to buildall script:
        !            19:   --with-sjlj-exceptions (HPUX is reported to have such problems)
1.7       paf        20: 
1.10      paf        21:   NOTE:
1.49      paf        22:   On some systems there are no "make" and you should run 'gmake', change buildall script accordingly then.
1.1       paf        23: 
1.49      paf        24: 2.What is the process to install Parser3?
1.17      paf        25: 
1.49      paf        26:   Copy files from $HOME/parser3install directory into your cgi-bin directory.
1.2       paf        27: 
1.57    ! moko       28:   Then install Parser3 to handle documents, step-by-step instrunctions:
1.49      paf        29:     http://www.parser.ru/en/docs/lang/install4apachecgi.htm" in English
                     30:     http://www.parser.ru/docs/lang/install4apachecgi.htm" in Russian
1.2       paf        31: 
1.49      paf        32:   Directory layout:
                     33:     bin/
1.57    ! moko       34:       parser3               -- CGI and command line Parser3 interpreter
        !            35:       auto.p.dist           -- configuration file sample,
        !            36:                                copy it to auto.p and adjust to your needs
        !            37:     share/
        !            38:       charsets/
        !            39:         parser3.charsets/   -- charset definition files
        !            40:           koi8-r.cfg        -- cyrillic charset [KOI8-R encoding]
        !            41:           windows-1251.cfg  -- cyrillic charset [windows-1251 encoding]
        !            42:           ...
1.2       paf        43: 
1.49      paf        44: 3.I have heard about $mail:receive experimental support, how do I use it?
1.57    ! moko       45: 
        !            46:   Just start ./buildall --with-mailreceive.
        !            47:   If you have glib and gmime installed, you can run ./configure --with-mailreceive.
1.9       paf        48: 
1.49      paf        49: 4.Security issues
1.57    ! moko       50:   You can disable any exec operations by setting --disable-execs option.
1.18      paf        51:   file::exec, file::cgi and mail:send (unix version) methods would be disabled.
                     52: 
1.29      paf        53:   You can enable reading and executing files, not belonging to group+user 
1.57    ! moko       54:   other then effective by setting --disable-safe-mode option.
        !            55: 
1.18      paf        56:   You can disable user-configured sendmail commands by forcing it, setting
1.57    ! moko       57:   "--with=sendmail=COMMAND" option.
        !            58: 
        !            59: 5.Since Parser 3.4.0 the several optimisations were implemented.
        !            60:   If you experience problems you can try to disable them by commenting corresponding 
        !            61:   defines and recompiling parser3.
1.50      misha      62: 
                     63:   src/include/pa_opcode.h
                     64:     #define OPTIMIZE_BYTECODE_GET_CLASS               -- $a:
                     65:     #define OPTIMIZE_BYTECODE_GET_ELEMENT             -- $a ^a
                     66:     #define OPTIMIZE_BYTECODE_GET_OBJECT_ELEMENT      -- $a.b ^a.b
                     67:     #define OPTIMIZE_BYTECODE_GET_OBJECT_VAR_ELEMENT  -- $a.$b ^a.$b
1.52      misha      68:     #define OPTIMIZE_BYTECODE_GET_SELF_ELEMENT        -- $self.a ^self.a
                     69:     #define OPTIMIZE_BYTECODE_CONSTRUCT               -- $a(expr),  $a[value]
                     70:                                                          $.a(expr), $.a[value]
                     71:                                                          $self.a(expr), $self.a[value]
                     72:     #define OPTIMIZE_BYTECODE_CUT_REM_OPERATOR        -- cut rem operator with any number of params during compilation
                     73:     #define OPTIMIZE_BYTECODE_STRING_POOL             -- simplifying string's bytecode into expression
1.50      misha      74: 
                     75:   src/include/pa_string.h
                     76:     #define HASH_CODE_CACHING  -- calculated hash codes are cached and used for sequential hash lookups
                     77: 
                     78:   src/include/pa_memory.h
                     79:     #define USE_DESTRUCTORS    -- destructors are used to decrease memory consumption during code
                     80:                                   processing and make ^memory:compact[] calls non-essential.
                     81: 
                     82:   src/types/pa_method.h
                     83:     #define OPTIMIZE_CALL      -- allows faster operators execution by eliminating method frame
                     84:                                   with local variables creation and extra write context switches.
                     85:     #define OPTIMIZE_RESULT    -- parser methods are marked when the $result variable was used.
                     86:                                   This allows write operations and context switching optimization.
                     87: 
1.52      misha      88:   src/types/pa_wwrapper.h
                     89:     #define OPTIMIZE_SINGLE_STRING_WRITE  -- reuse original VString in single string assignments.
                     90: 
1.51      misha      91:   src/lib/cord/include/cord.h
1.50      misha      92:     #define CORD_CAT_OPTIMIZATION -- CORD library never modifies source concatenations. But in parser
                     93:                                      write operations it is safe to modify them and save some memory.
1.51      misha      94:     #define CORD_CHARS_CACHE      -- language cords with same language and length are cached and reused.
1.50      misha      95: 
1.53      misha      96:   src/include/pa_string.h
                     97:     #define STRING_LENGTH_CACHING -- cache String::Body.length() for char* strings
                     98: 
                     99:   src/include/pa_hash.h
                    100:     #define HASH_ORDER            -- hash keys are iterated in the order of insertion