fixed comment
expanded documentation
removing raising of IOError

this was outdated as the "existing_filepath" option now handles this better.
updated documentation
updated handling of existing output directory
updated documentation