From bb2e0d64e1f85ed8a75b9d9c9fa1cfe5a078c006 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Daniel=20Ekl=C3=B6f?= Date: Fri, 7 Jun 2024 16:18:28 +0200 Subject: [PATCH] doc: foot.ini: document pixelsize People are apparently too lazy to read fontconfig's documentation, and don't understand how to configure font sizes in foot. --- doc/foot.ini.5.scd | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/doc/foot.ini.5.scd b/doc/foot.ini.5.scd index 93a3120c..b9e1e70e 100644 --- a/doc/foot.ini.5.scd +++ b/doc/foot.ini.5.scd @@ -50,15 +50,16 @@ empty string to be set, but it must be quoted: *KEY=""*) *font*, *font-bold*, *font-italic*, *font-bold-italic* Comma separated list of fonts to use, in fontconfig format. That is, a font name followed by a list of colon-separated - options. Most noteworthy is *:size=n*, which is used to set the - font size. Note that the font size is also affected by the - *dpi-aware* option. + options. Most noteworthy is *:size=n* (or *:pixelsize=n*), which + is used to set the font size. Note that the font size is also + affected by the *dpi-aware* option. Examples: - Dina:weight=bold:slant=italic - Courier New:size=12 - Fantasque Sans Mono:fontfeatures=ss01 - Meslo LG S:size=12, Noto Color Emoji:size=12 + - Courier New:pixelsize=8 For each option, the first font is the primary font. The remaining fonts are fallback fonts that will be used whenever a glyph cannot @@ -78,6 +79,11 @@ empty string to be set, but it must be quoted: *KEY=""*) To disable bold and/or italic fonts, set e.g. *font-bold* to _exactly_ the same value as *font*. + **size** is in _points_ (as defined by the FontConfig format). To + set a _pixel_ size, use **pixelsize** instead. Note that pixel + sizes are unaffected by DPI aware rendering (see *dpi-aware*), but + are affected by desktop scaling. + Default: _monospace:size=8_ (*font*), _not set_ (*font-bold*, *font-italic*, *font-bold-italic*).