Further optimisations, changed the prototype of Tree.mli

[SXSI/xpathcomp.git] / HACKING

diff --git a/HACKING b/HACKING
index 92af1c6..bb1dae8 100644 (file)
--- a/HACKING
+++ b/HACKING
@@ -17,6 +17,18 @@ make
 compile xpathcomp/
 make
 
+
+Building xpathcomp requires:
+
+libxml2.6++-dev 
+ocaml-findlib
+ocaml-ulex
+ocaml-nox
+camlp4
+
+and their dependencies
+
+
 you can compile with make DEBUG=true to get more statistics the overall programm is slower
 but you get precise timing for each individual function calls to the XMLTree interface.
 
@@ -26,6 +38,8 @@ Usage :
 
 file.xml is the input file. There are some in the tests subdirectory. At the moment you can mainly test
 with base.xml and tiny.xml. Any file bigger than this will take too much time to load.
+If the file ends with the .srx extensions then it is considered to be a serialized output saved to disk
+with the -s flag (see bellow).
 
 
 output is optional. If specified, it is the name of a file to which the result of the query is serialized.
@@ -33,14 +47,16 @@ If output is not given, the the result of the query is kept as a set of identifi
 the string collection is made.
 
 
-There are a few flags:
 
--f sample factor [default=64]
--i index empty texts [default=false]
--d Disable text collection[default=false]
--help  Display this list of options
---help  Display this list of options
 
+There are a few flags:
+
+./main <input.{xml|srx}> 'query' [output]
 
-for instance:
-./main -f 29 -d tests/tiny.xml '//para'
+  -c counting only (don't materialize the result set)
+  -max-tc set maximum count for which the TextCollection is used
+  -f sample factor [default=64]
+  -s save the intermediate representation into file.srx
+  -b real bottom up run
+  -help  Display this list of options
+  --help  Display this list of options