update documentation to reflect the changes with regard to max_depth and
the maxdepth compat, also adding an explanation of the recurse_fast
option to list_dir()