#1071458 wireplumber-doc: "in order of priority" statements are unclear

#1071458#5
Date:
2024-05-19 16:01:43 UTC
From:
To:
Dear Maintainer,

The "Locations of WirePlumber’s files" page is unclear about priority
in two places.  The page starts with this statement:
	WirePlumber’s default locations of its configuration files are
	the following, in order of priority:
		1. $XDG_CONFIG_HOME/wireplumber
		2. $XDG_CONFIG_DIRS/wireplumber
		3. $sysconfdir/wireplumber
		4. $XDG_DATA_DIRS/wireplumber
		5. $datadir/wireplumber
	[…]
	At runtime, WirePlumber will seek out the directory with the highest
	priority that contains the required configuration file.

	/usr/share/doc/wireplumber/html/daemon/locations.html

Similar wording is used for "Location of scripts".  "Highest" could mean
numerically largest, closest to the top of the list, or something else.
I recommend changing this to something like "in descending order of
priority"; user files taking priority over system files makes sense, and
seems to be the behaviour.

The "DIR" environment variables, by contrast, are well explained:
	If multiple directories are specified, the first one has the highest
	priority and the last one has the lowest.

- Michael