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

Attachment: signature.asc
Description: PGP signature

Reply via email to