Fix issue #8: don't pollute alternate file
updated documentation