skip to content

detached c8242ea

docs(performance): describe the merged-flips warning

commit: c8242eaeb9e3f2a5deb5755b7e30f10102f48778
author: brice · 9d ago · 2026-10-14 04:34 UTC
parent: 55e2634
signature: GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email

1 file · +2 -1

M docs/performance.md +2 -1


@@ -53,6 +53,7 @@ Every 10 s, each output logs a `stats` entry:
53	53		\| `max_commit_delay_ms` \| Longest wait from "frame due" to commit \|
54	54		\| `late_fences` \| Missed vblanks where the GPU finished too late (needs `--debug=drm-flip`) \|
55	55		\| `redrawn_pixels` \| Pixels drawn \|
56		-	\| `merged_flips` \| Flips merged because wayland was not reading output reports \|
	56	+
	57	+	If outputs report flips faster than the display loop reads them, wayland merges them and logs a warning with `merged` at most every 10 s.
57	58
58	59		Missed vblanks with `late_fences` mean the GPU was late. Without `late_fences` but with a large `max_commit_delay_ms`, the CPU was late.


@@ -53,6 +53,7 @@ Every 10 s, each output logs a `stats` entry:
53		\| `max_commit_delay_ms` \| Longest wait from "frame due" to commit \|	53		\| `max_commit_delay_ms` \| Longest wait from "frame due" to commit \|
54		\| `late_fences` \| Missed vblanks where the GPU finished too late (needs `--debug=drm-flip`) \|	54		\| `late_fences` \| Missed vblanks where the GPU finished too late (needs `--debug=drm-flip`) \|
55		\| `redrawn_pixels` \| Pixels drawn \|	55		\| `redrawn_pixels` \| Pixels drawn \|
56	-	\| `merged_flips` \| Flips merged because wayland was not reading output reports \|	56	+
			57	+	If outputs report flips faster than the display loop reads them, wayland merges them and logs a warning with `merged` at most every 10 s.
57			58
58		Missed vblanks with `late_fences` mean the GPU was late. Without `late_fences` but with a large `max_commit_delay_ms`, the CPU was late.	59		Missed vblanks with `late_fences` mean the GPU was late. Without `late_fences` but with a large `max_commit_delay_ms`, the CPU was late.