search

swaywm / sway

i3-compatible Wayland compositor
https://swaywm.org
MIT License
14.14k stars 1.08k forks source link

Man page false lead? #7928

Open emilyyyylime opened 5 months ago

emilyyyylime commented 5 months ago

This hardly fits the label of a bug but it does regard to the man pages maintained here.

The sway(5) man page mentions, under swaybg_command:^1

Refer to sway-output(5) for more information.

However, as far as I could tell, sway-output(5) bears no mention to swaybg_command or swaybg—this is rather confusing as a user trying to understand whether I can use Sway's built-in mechanisms for controlling my wallpaper with a third-party bg manager.

japhir commented 5 months ago

Note that sway-output(5) does mention some output <name> background|bg xxx options. Maybe that's what it's referring to?

emilyyyylime commented 5 months ago

Certainly doesn't look like anything I expected to find after reading that note. Regardless I feel like the docs on swaybg_command should be improved. I still don't know what it does and what I can use in place of swaybg.