[Pkg-utopia-maintainers] Bug#1071458: wireplumber-doc: "in order of priority" statements are unclear

[Michael Gold]

Package: wireplumber-doc
Version: 0.5.2-3

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


-- System Information:
Debian Release: trixie/sid
  APT prefers unstable-debug
  APT policy: (500, 'unstable-debug'), (500, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 6.8.9-amd64 (SMP w/32 CPU threads; PREEMPT)
Kernel taint flags: TAINT_WARN
Locale: LANG=en_CA.UTF-8, LC_CTYPE=en_CA.UTF-8 (charmap=UTF-8), LANGUAGE=en_CA:en
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

-- debconf-show failed

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: not available
URL: <http://alioth-lists.debian.net/pipermail/pkg-utopia-maintainers/attachments/20240519/ceabe816/attachment.sig>