kitty/docs
Kovid Goyal 8efb82b5b8
Replace sync_to_monitor and repaint_delay with render_interval
The new render_interval option either syncs redraws to the monitor
(the default), optionally with a minimum interval between frames, or
redraws on a schedule with a minimum interval between frames. The
interval is now enforced per OS window, including when output is being
parsed, which the old repaint_delay was not.

On X11, render frames are now provided by the Present extension, with
libxcb-present loaded at runtime. Frames are requested lazily on X11,
since a pending NotifyMSC request delays buffer presentation by the GPU
driver under Xwayland. Xwayland completing requests early and failing to
report vertical blanks for long periods are handled. Without Present,
kitty falls back to blocking buffer swaps as before.

Render frames now only wake up the main loop when something is waiting
for them, so animations such as the eased cursor blink are no longer
sampled at the monitor refresh rate. On Wayland, frame callbacks are
also used when not syncing to the monitor, to stop rendering hidden
windows.

The removed options are converted to render_interval if it is not
specified anywhere, including in other config files and overrides,
otherwise they are ignored with a warning.

Also fix gen config failing on options whose type is a builtin.
2026-11-16 13:43:39 +05:30
..
_static Cleanup previous PR 2026-10-09 20:41:46 +05:30
_templates
kittens Docs: Correct protocol references, examples and generated help 2026-10-28 13:24:43 +08:00
screenshots Add explicit edge resizing for Splits and preserve resize sessions 2026-10-09 19:54:02 +08:00
actions.rst
basic.rst Docs: Correct protocol references, examples and generated help 2026-10-28 13:24:43 +08:00
binary.rst Add nightly version to version string for nightly builds. Fixes #10751 2026-10-27 10:43:51 +05:30
build.rst Read variable font data from WOFF and WOFF2 files in font selection 2026-11-16 13:43:39 +05:30
changelog.rst Fix CI failures from the SIMD UTF-8 decoder changes 2026-11-16 13:43:39 +05:30
clipboard.rst clipboard protocol: Specify handling of invalid base64 data 2026-08-25 10:12:25 +05:30
color-stack.rst Color control protocol: Respond to unknown field names safely using base64 encoding 2026-09-01 21:20:04 +05:30
conf.py ... 2026-09-04 06:35:44 +05:30
conf.rst Docs: Correct protocol references, examples and generated help 2026-10-28 13:24:43 +08:00
custom-shaders.rst Replace sync_to_monitor and repaint_delay with render_interval 2026-11-16 13:43:39 +05:30
deccara.rst
desktop-notifications.rst Handle ConEmu OSC 9;9 cwd reporting and ignore other ConEmu OSC 9 sub-commands 2026-11-13 19:44:02 +05:30
dnd-protocol.rst Add a line to the spec to clarify that MIME types from first move only can be relied upon 2026-10-30 18:20:53 +05:30
extract-rst-targets.py autoformat 2026-08-05 05:32:56 +05:30
faq.rst Switch from sphinx-inline-tabs to sphinx-design 2026-08-09 14:31:33 +05:30
file-transfer-protocol.rst Docs: Correct protocol references, examples and generated help 2026-10-28 13:24:43 +08:00
glossary.rst Docs: Correct protocol references, examples and generated help 2026-10-28 13:24:43 +08:00
graphics-protocol.rst docs: add kmp-terminal and SSH Client for Android to graphics protocol 2026-10-29 20:58:38 +00:00
index.rst Switch from sphinx-inline-tabs to sphinx-design 2026-08-09 14:31:33 +05:30
installer.sh Also use diskutil in a couple more scripts 2026-09-24 09:32:05 +05:30
integrations.rst Add show-your-work to integrations 2026-10-11 14:09:07 +05:00
intro_vid.rst Cleanup previous PR 2026-10-09 20:41:46 +05:30
invocation.rst
keyboard-protocol.rst Add T1K to the list of terminals implementing the keyboard protocol 2026-11-10 09:53:59 +02:00
kittens_intro.rst
launch.rst Fix #10858 2026-11-14 08:16:53 +05:30
layouts.rst Allow resizing docks 2026-11-13 19:44:03 +05:30
Makefile Fix #10577 2026-10-01 17:23:37 +05:30
mapping.rst Docs: Correct protocol references, examples and generated help 2026-10-28 13:24:43 +08:00
marks.rst
misc-protocol.rst Program status protocol: fixes and improvements 2026-10-13 08:50:39 +05:30
multiple-cursors-protocol.rst Docs: Correct protocol references, examples and generated help 2026-10-28 13:24:43 +08:00
notifications.py autoformat 2026-08-05 05:32:56 +05:30
open_actions.rst Docs: Correct protocol references, examples and generated help 2026-10-28 13:24:43 +08:00
overview.rst Allow selecting text drawn in the tab bar outside the tabs 2026-11-15 09:32:37 +05:30
performance.rst Replace sync_to_monitor and repaint_delay with render_interval 2026-11-16 13:43:39 +05:30
pipe.rst
pointer-shapes.rst
press-mentions.rst
protocol-extensions.rst
quake-screenshots.rst
quickstart.rst
rc_protocol.rst Docs: Correct protocol references, examples and generated help 2026-10-28 13:24:43 +08:00
remote-control.rst Further harden remote control password processing 2026-11-03 17:36:01 +05:30
requirements.txt Switch from sphinx-inline-tabs to sphinx-design 2026-08-09 14:31:33 +05:30
sessions.rst Docs: Correct protocol references, examples and generated help 2026-10-28 13:24:43 +08:00
shell-integration.rst Cleanup previous PR 2026-10-18 21:33:34 +05:30
support.html
support.rst
text-sizing-protocol.rst Docs: Correct protocol references, examples and generated help 2026-10-28 13:24:43 +08:00
underlines.rst
unscroll.rst
wide-gamut-colors.rst Docs: Correct protocol references, examples and generated help 2026-10-28 13:24:43 +08:00