Scenario:

• I have a list of resources to be tried in turn for configuration with "first one wins"
• Having built the URL, I call "configureByResource(URL url)"

Problem: I do not know whether this resulted in successful configuration.

-> Case of a resource ending not ending in "xml" or "groovy" ---> Return without error but with any configuration
-> Case of a resource ending in "xml" and successful configuration ---> Return without error and successful configuration (and registered as "safe configuration", too)
-> Case of a resource ending in "xml" and XML errors ---> Return without error and no config change
-> Case of a resource ending in "xml" and I/O exception ---> Return with raised JoranException
-> Case of a resource ending in "groovy" and no Groovy ---> Return without error and no config change
-> Case of a resource ending in "groovy" and Groovy errors ---> Unsure whether GafferUtil.runGafferConfiguratorOn() can throw Runtime Exceptions from Groovy
-> Case of a resource ending in "groovy" and no Groovy errors ---> Return without error and successful configuration

This should be made clearer as far as possible:

--> One "ConfigurationException" if there was a problem, with the "cause" telling what
--> Normal return with "true" --> Configuration successfully changed
--> Normal return with "false" --> Configuration was not changed (i.e. a NOP)