doc fixes and notes
test against filenames with spaces