From 911af53c5c55ca30ba524e32be8deb93769806e6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Daniel=20Ekl=C3=B6f?= Date: Tue, 25 Jun 2024 08:12:40 +0200 Subject: [PATCH] doc: foot.ini: document issues with fractional scaling and initial-window-size-* Since most compositors don't report the correct scaling factor until *after* the window has been mapped, these options often do not work. --- doc/foot.ini.5.scd | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/doc/foot.ini.5.scd b/doc/foot.ini.5.scd index b9e1e70e..be357c7a 100644 --- a/doc/foot.ini.5.scd +++ b/doc/foot.ini.5.scd @@ -277,7 +277,14 @@ empty string to be set, but it must be quoted: *KEY=""*) Initial window width and height in _pixels_ (subject to output scaling), in the form _WIDTHxHEIGHT_. The height _includes_ the titlebar when using CSDs. Mutually exclusive to - *initial-window-size-chars*. Default: _700x500_. + *initial-window-size-chars*. + + Note that this option may not work as expected if fractional + scaling is being used, due to the fact that many compositors do + not report the correct scaling factor until after a window has + been mapped. + + Default: _700x500_. *initial-window-size-chars* Initial window width and height in _characters_, in the form @@ -289,6 +296,10 @@ empty string to be set, but it must be quoted: *KEY=""*) be set correctly. If that is the case, use *initial-window-size-pixels* instead. + And, just like *initial-window-size-pixels*, this option may not + work as expected if fractional scaling is being used (see + *initial-window-size-pixels for details). + Default: _not set_. *initial-window-mode*