From 350ba9b9374ce045ead8c85c6c2e055729026c0e Mon Sep 17 00:00:00 2001 From: =?utf8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= Date: Fri, 6 Oct 2017 10:04:49 +0200 Subject: [PATCH] man: explain precedence for options which take a list (#7010) Hopefully finally fixes #6639. --- man/standard-conf.xml | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/man/standard-conf.xml b/man/standard-conf.xml index 4de0cd1a4..fa6a8e474 100644 --- a/man/standard-conf.xml +++ b/man/standard-conf.xml @@ -54,14 +54,15 @@ configuration file is read before any of the configuration directories, and has the lowest precedence; entries in a file in any configuration directory override entries in the single - configuration file. Files in the - *.conf.d/ configuration subdirectories - are sorted by their filename in lexicographic order, regardless of - which of the subdirectories they reside in. If multiple files - specify the same option, the entry in the file with the - lexicographically latest name takes precedence. It is recommended - to prefix all filenames in those subdirectories with a two-digit - number and a dash, to simplify the ordering of the files. + configuration file. Files in the *.conf.d/ + configuration subdirectories are sorted by their filename in lexicographic + order, regardless of which of the subdirectories they reside in. When + multiple files specify the same option, for options which accept just a + single value, the entry in the file with the lexicographically latest name + takes precedence. For options which accept a list of values, entries are + collected as they occur in files sorted lexicographically. It is recommended + to prefix all filenames in those subdirectories with a two-digit number and + a dash, to simplify the ordering of the files. To disable a configuration file supplied by the vendor, the recommended way is to place a symlink to -- 2.30.2