Improve internal api regarding directory and tree hash computations

Keep the old api (since i don't measure the impacts on other modules yet).

+ Improve docstring

(Code that actually got lost and rewritten)