fixes and comments for the script, initial text in README