JavaDoc updates

While writing Javadocs for scenarioConfigurationReader, I also
encountered errors (thanks, Netbeans) in other JavaDocs, so I made bug
fixes. I don't mean to step on anybody's toes. Your javadocs are still
your own - I just wanted to get rid of the errors.
Merge branch 'master' of https://github.com/cjeffery/sworsorc