update documentation

the default section wasn't documented
update tests

* add third test to ensure default test section loads properly
* use FailWithError instead of old-style error messages
fix an error in ParseFile

If the section changed, that submap wasn't being initialised.