revise doc on different configuration formats and what to recommend

[rgerhards]

This should also check for inconsistent descriptions across several files (I noticed there are at least two descriptions, but I unfortunately do not remember where the second one was).