Add open_files_with_merge decorator

Add decorator and tests.
Update documentation to show usage of decorators, especially when
merging.
Improve mock creation in decorator test cases.