added precisions about path completion
a bunch of changes I was too busy to document properly. meh.