man: rework section about configuration file precedence
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Thu, 16 Jan 2020 13:10:18 +0000 (14:10 +0100)
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Thu, 16 Jan 2020 13:45:37 +0000 (14:45 +0100)
commite76c60bf2a2bfd4193accadb7d29e2ac8f659623
tree278fd9cfbed8532f908727e7b18cade482afb9b6
parent251d3d20c3b8b4ef2b2b12f2e6b48e9b6de8d599
man: rework section about configuration file precedence

This section is loaded in a bunch of places, so this affects many
man pages.

1. point the reader to the synopsis section, which has the exact paths
that are used to load files.
2. put the "reference" part first, and recommendations later, in separate
paragraphs.
3. describe how individual settings and whole files are replaces.

Closes #12791.
man/standard-conf.xml