Reworked sections about MultiFileHierarchicalConfiguration in user guide.

The class is now replaced by MultiFileConfigurationBuilder.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/configuration/trunk@1606581 13f79535-47bb-0310-9956-ffa450edef68
Reworked the multi-file configuration sample in the user's guide.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/configuration/trunk@1606582 13f79535-47bb-0310-9956-ffa450edef68
Reworked section about PatternSubtreeConfigurationWrapper in user's guide.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/configuration/trunk@1606583 13f79535-47bb-0310-9956-ffa450edef68
Added a section about the initialization parameters of multi-file configs.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/configuration/trunk@1606584 13f79535-47bb-0310-9956-ffa450edef68
Renamed howto document about CombinedConfigurationBuilder.

The name howto_configurationbuilder was misleading as this document is about
the specialized CombinedConfigurationBuilder.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/configuration/trunk@1606585 13f79535-47bb-0310-9956-ffa450edef68
Adapted return type of MultiFileConfigurationBuilder.configure().

This makes method chaining easier. The test class was updated correspondingly.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/configuration/trunk@1606586 13f79535-47bb-0310-9956-ffa450edef68
A FileLocator object can now be stored in a map and created from there.

The goal is to simplify the definition of parameters for file-based
configurations in typical IoC frameworks.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/configuration/trunk@1606587 13f79535-47bb-0310-9956-ffa450edef68
FileHandler can now be initialized from a map.

Again, the goal is to simplify the creation of parameters objects for
file-based configurations from within IoC frameworks.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/configuration/trunk@1606588 13f79535-47bb-0310-9956-ffa450edef68
FileBasedBuilderParametersImpl can not be initialized from a map.

This simplifies the creation of instances in IoC frameworks.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/configuration/trunk@1606589 13f79535-47bb-0310-9956-ffa450edef68
FileBasedBuilderParametersImpl now throws IAE for null input.

This is compliant to the rest of the library.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/configuration/trunk@1606590 13f79535-47bb-0310-9956-ffa450edef68