mirrors/foot
1
0
Fork 0
mirror of https://codeberg.org/dnkl/foot.git synced 2026-02-25 01:40:19 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

doc: foot.ini: document pixelsize

Browse source 
People are apparently too lazy to read fontconfig's documentation, and
don't understand how to configure font sizes in foot.
This commit is contained in:
Daniel Eklöf 2024-06-07 16:18:28 +02:00
parent 0bf5a7e902
commit bb2e0d64e1
No known key found for this signature in database
GPG key ID: 5BBD4992C116573F
1 changed files with 9 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

12
doc/foot.ini.5.scd
View file

@ -50,15 +50,16 @@ empty string to be set, but it must be quoted: *KEY=""*)
*font*, *font-bold*, *font-italic*, *font-bold-italic* *font*, *font-bold*, *font-italic*, *font-bold-italic*
Comma separated list of fonts to use, in fontconfig format. That Comma separated list of fonts to use, in fontconfig format. That
is, a font name followed by a list of colon-separated is, a font name followed by a list of colon-separated
options. Most noteworthy is *:size=n*, which is used to set the options. Most noteworthy is *:size=n* (or *:pixelsize=n*), which
font size. Note that the font size is also affected by the is used to set the font size. Note that the font size is also
*dpi-aware* option. affected by the *dpi-aware* option.
Examples: Examples:
- Dina:weight=bold:slant=italic - Dina:weight=bold:slant=italic
- Courier New:size=12 - Courier New:size=12
- Fantasque Sans Mono:fontfeatures=ss01 - Fantasque Sans Mono:fontfeatures=ss01
- Meslo LG S:size=12, Noto Color Emoji:size=12 - 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 For each option, the first font is the primary font. The remaining
fonts are fallback fonts that will be used whenever a glyph cannot 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 To disable bold and/or italic fonts, set e.g. *font-bold* to
_exactly_ the same value as *font*. _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*, Default: _monospace:size=8_ (*font*), _not set_ (*font-bold*,
*font-italic*, *font-bold-italic*). *font-italic*, *font-bold-italic*).