catch some edge cases when length is 1
update to README files
minor changes to comments at beginning of files