some traversal speedups
updated documentation
added derived files