Improve documentation for configuration files

[wafschneider]

@osma offered a small patch to the documentation to account for the increased flexibility of the configuration and mapping files. The configuration system (such as it is) should be somewhat rationalized and better documented in general.