Updated Debugging flags (markdown)

Simon Ser 2024-02-21 20:44:12 +01:00
parent cc1f158b6d
commit 5bb8097ba0

@ -1,11 +1,15 @@
Sway has some debugging options available via the `-D` command-line flag. Sway has some debugging options available via the `-D` command-line flag.
- `-D damage=highlight`: paints regions that haven't been updated in yellow
- `-D damage=rerender`: disables damage tracking by forcing the whole output to be repainted each frame
- `-D noatomic`: disables atomic transactions - `-D noatomic`: disables atomic transactions
- `-D txn-wait`: forces all atomic transactions to time out - `-D txn-wait`: forces all atomic transactions to time out
- `-D txn-timings`: logs addition information about transaction timings - `-D txn-timings`: logs addition information about transaction timings
- `-D txn-timeout=<ms>`: overrides the default atomic transaction timeout - `-D txn-timeout=<ms>`: overrides the default atomic transaction timeout
- `-D noscanout`: disables direct scan-out - `-D legacy-wl-drm`: enables the legacy `wl_drm` protocol extension (Sway 1.10 and later)
Also see `enable_debug_flag()`. Also see `enable_debug_flag()`.
On Sway ≤ 1.9, the following flags are also supported:
- `-D damage=highlight`: paints regions that haven't been updated in yellow (replaced by `WLR_SCENE_DEBUG_DAMAGE=highlight` on Sway 1.10)
- `-D damage=rerender`: disables damage tracking by forcing the whole output to be repainted each frame (replaced by `WLR_SCENE_DEBUG_DAMAGE=rerender` on Sway 1.10)
- `-D noscanout`: disables direct scan-out (replaced by `WLR_SCENE_DISABLE_DIRECT_SCANOUT=1` on Sway 1.10)