Inconsistency in hyprland Multi-GPU docs

[admiral0]

Already reported ? *

• [X] I have searched the existing open and closed issues.

Regression?

No

System Info and Version

irrelevant - not a software bug - documentation bug

Description

On the Multi-GPU page there is a contradiction between first paragraph and second:

First instance:

Do not use the card1 symlink indicated here. It is dynamically assigned at boot and is subject to frequent change, making it unsuitable as a marker for GPU selection.

Second instance:

Here, we tell Hyprland to set priorities. If card0 isn’t available for whatever reason, use card1.

There is an advice to not use card* symlinks, but there is no mention that symlinks are not supported by AQ - possibly a miss during the documentation update.

How to reproduce

• Set symlinks to by-path
• Struggle
• Find https://github.com/hyprwm/Hyprland/issues/6956

Crash reports, logs, images, videos

I would recommend adding a section suggesting a script to generate AQ_DRM_DEVICES env var before the start.

Something like:

#!/bin/bash

G_INTEGRATED="/dev/dri/by-path/pci-0000:00:02.0-card"
G_DISCRETE="/dev/dri/by-path/pci-0000:01:00.0-card"

export AQ_DRM_DEVICES="$(readlink -f $G_INTEGRATED):$(readlink -f $G_DISCRETE)"

exec Hyprland "$@"

[izmyname]

Symlinks should work by now, btw.

https://github.com/hyprwm/aquamarine/pull/34