clarify slight difference in omfile file creation
improve doc
Merge branch 'v7-stable' into v8-stable