--- parser3/INSTALL	2005/12/29 09:11:11	1.48.2.3
+++ parser3/INSTALL	2009/10/06 13:16:48	1.56
@@ -1,5 +1,5 @@
 Alexander Petrosian <paf@design.ru> (http://paf.design.ru)
-$Id: INSTALL,v 1.48.2.3 2005/12/29 09:11:11 paf Exp $
+$Id: INSTALL,v 1.56 2009/10/06 13:16:48 misha Exp $
 
 1.What is the process to compile Parser3?
 
@@ -126,3 +126,49 @@ $Id: INSTALL,v 1.48.2.3 2005/12/29 09:11
 
   WARNING: if you want to use apache configure option --enable-shared=max, do this:
   ./p3runConfigure --enable-shared=max --disable-shared=mod_parser3.c
+
+  Make build-std" command to compile just httpd binary, support stuff won't build with parser libs.
+
+6.
+  Since Parser 3.4.0 the several optimisations were implemented.
+  If you experience problems you can try to disable them by commenting corresponding defines and recompiling parser3.
+
+  src/include/pa_opcode.h
+    #define OPTIMIZE_BYTECODE_GET_CLASS               -- $a:
+    #define OPTIMIZE_BYTECODE_GET_ELEMENT             -- $a ^a
+    #define OPTIMIZE_BYTECODE_GET_OBJECT_ELEMENT      -- $a.b ^a.b
+    #define OPTIMIZE_BYTECODE_GET_OBJECT_VAR_ELEMENT  -- $a.$b ^a.$b
+    #define OPTIMIZE_BYTECODE_GET_SELF_ELEMENT        -- $self.a ^self.a
+    #define OPTIMIZE_BYTECODE_CONSTRUCT               -- $a(expr),  $a[value]
+                                                         $.a(expr), $.a[value]
+                                                         $self.a(expr), $self.a[value]
+    #define OPTIMIZE_BYTECODE_CUT_REM_OPERATOR        -- cut rem operator with any number of params during compilation
+    #define OPTIMIZE_BYTECODE_STRING_POOL             -- simplifying string's bytecode into expression
+
+  src/include/pa_string.h
+    #define HASH_CODE_CACHING  -- calculated hash codes are cached and used for sequential hash lookups
+
+  src/include/pa_memory.h
+    #define USE_DESTRUCTORS    -- destructors are used to decrease memory consumption during code
+                                  processing and make ^memory:compact[] calls non-essential.
+
+  src/types/pa_method.h
+    #define OPTIMIZE_CALL      -- allows faster operators execution by eliminating method frame
+                                  with local variables creation and extra write context switches.
+    #define OPTIMIZE_RESULT    -- parser methods are marked when the $result variable was used.
+                                  This allows write operations and context switching optimization.
+
+  src/types/pa_wwrapper.h
+    #define OPTIMIZE_SINGLE_STRING_WRITE  -- reuse original VString in single string assignments.
+
+  src/lib/cord/include/cord.h
+    #define CORD_CAT_OPTIMIZATION -- CORD library never modifies source concatenations. But in parser
+                                     write operations it is safe to modify them and save some memory.
+    #define CORD_CHARS_CACHE      -- language cords with same language and length are cached and reused.
+
+  src/include/pa_string.h
+    #define STRING_LENGTH_CACHING -- cache String::Body.length() for char* strings
+
+  src/include/pa_hash.h
+    #define HASH_ORDER            -- hash keys are iterated in the order of insertion
+