Many docs updates

Updated known-issues, remove references to 'hash' as appropriate,
clarify script options.