Package: sway
Version: 1.9-2
Severity: minor
Dear Maintainer,
One of the command specs for the `gaps` commands is in the
config-file-only section of the man page, but is actually allowed at
runtime with the `swaymsg` command.
Here's how it appears in the man page for sway(5):
COMMANDS
This section only lists general commands. For input and output
commands, refer to sway-input(5)
and sway-output(5).
The following commands may only be used in the configuration file.
...
gaps inner|outer|horizontal|vertical|top|right|bottom|left
all|current set|plus|minus|toggle <amount>
...
The following commands may be used either in the configuration
file or at runtime.
...
gaps inner|outer|horizontal|vertical|top|right|bottom|left <amount>
This is incorrect, for example running `$ swaymsg gaps inner all plus 5`
works as you would expect and increases the gaps of all open windows at
runtime. However one reading the man page would not expect this to work.
This is my first week running sid and my first bug report. I'm also
looking for mentorship on contributing and I think this would be a nice
soft start to get the tools set up. Let me know if you are open to a
patch for this issue. I would appreciate some help on getting oriented
with how to do it.
Thanks,
Jon W
-- System Information:
Debian Release: trixie/sid
APT prefers unstable
APT policy: (500, 'unstable')
Architecture: amd64 (x86_64)
Kernel: Linux 6.10.6-amd64 (SMP w/8 CPU threads; PREEMPT)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled
Versions of packages sway depends on:
ii libc6 2.40-2
ii libcairo2 1.18.0-3+b1
ii libevdev2 1.13.2+dfsg-1
ii libgdk-pixbuf-2.0-0 2.42.12+dfsg-1
ii libgl1-mesa-dri 24.1.6-1
ii libglib2.0-0t64 2.82.0-1
ii libinput10 1.26.0-1
ii libjson-c5 0.17-1+b1
ii libpango-1.0-0 1.54.0+ds-2
ii libpangocairo-1.0-0 1.54.0+ds-2
ii libpcre2-8-0 10.42-4+b1
ii libpixman-1-0 0.42.2-1+b1
ii libsystemd0 256.5-1
ii libudev1 256.5-1
ii libwayland-client0 1.23.0-1
ii libwayland-cursor0 1.23.0-1
ii libwayland-server0 1.23.0-1
ii libwlroots12t64 0.17.4-1+b1
ii libxcb-icccm4 0.4.1-1.1+b1
ii libxcb1 1.17.0-2
ii libxkbcommon0 1.6.0-1+b1
ii polkitd 125-2
ii swaybg 1.2.1-1
Versions of packages sway recommends:
ii foot 1.18.1-1
ii sway-backgrounds 1.9-2
ii wmenu 0.1.9-2
Versions of packages sway suggests:
ii swayidle 1.8.0-1
ii swaylock 1.8.0-1
ii xdg-desktop-portal-gtk 1.15.1-1+b1
ii xdg-desktop-portal-wlr 0.7.1-1+b1
-- no debconf information
