aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniel Eklöf <daniel@ekloef.se>2024-06-25 06:12:40 +0000
committerDaniel Eklöf <daniel@ekloef.se>2024-06-25 06:12:40 +0000
commit911af53c5c55ca30ba524e32be8deb93769806e6 (patch)
tree7ca0f27f6a26aeddf68abe650d9e94c8c77de5d6
parentshm: discard shm buffers with mis-matching alpha-setting (diff)
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.
-rw-r--r--doc/foot.ini.5.scd13
1 files changed, 12 insertions, 1 deletions
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*