IMHO, configuration file consolidation in one single file will make the learning curve much steeper for beginners and newcomers. I found it rather difficult to read and understand one big file with alot of #!ifdef blocks.

Multiple, but simple and very specialized configuration files have the benefit of demonstrating quickly some simple functionalities which is the main goal of an "example configuration".

Autogeneration of make files using some templating language can ease their maintenance and this doesn't remove the need to have one single "most complete and standard-compliant" example configuration file.

—
Reply to this email directly or view it on GitHub.