Moving docs into README.
Fixing bug in directory cache.
Made directory cache case insensitive.
Adding samples.