<feed xmlns='http://www.w3.org/2005/Atom'>
<title>mirrors/foot.git/doc/foot.ini.5.scd, branch 1.15.2</title>
<subtitle>A fast, lightweight and minimalistic Wayland terminal emulator</subtitle>
<id>https://git.0x0f.dev/mirrors/foot.git/atom?h=1.15.2</id>
<link rel='self' href='https://git.0x0f.dev/mirrors/foot.git/atom?h=1.15.2'/>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/'/>
<updated>2023-07-28T13:40:07Z</updated>
<entry>
<title>config: add tweak.bold-text-in-bright-amount</title>
<updated>2023-07-28T13:40:07Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2023-07-26T14:12:36Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=f3c5b82c8276feda3c9eec522e549062c1589484'/>
<id>urn:sha1:f3c5b82c8276feda3c9eec522e549062c1589484</id>
<content type='text'>
By how much to increase the luminance when brightening bold
fonts. This was previously hard-coded to a factor of 1.3, which is now
the default value of the new config option.

Closes #1434
</content>
</entry>
<entry>
<title>themes: starlight: update to V4</title>
<updated>2023-07-18T14:20:33Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2023-07-18T14:18:53Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=27b4c2ac2da7dc7b82e014786e9a8e9919888e78'/>
<id>urn:sha1:27b4c2ac2da7dc7b82e014786e9a8e9919888e78</id>
<content type='text'>
This also updates the default theme in foot, as well as the
documentation.

Closes #1409
</content>
</entry>
<entry>
<title>config: add csd.double-click-to-maximize=no|yes option</title>
<updated>2023-07-14T10:03:35Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2023-07-14T10:03:35Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=3f7be59062f00cd99d832eaa5d389b880a3c512e'/>
<id>urn:sha1:3f7be59062f00cd99d832eaa5d389b880a3c512e</id>
<content type='text'>
When enabled, double-clicking the CSD titlebar will (un)maximize the
window.

Defaults to ‘yes’ (since this is the old hard-coded behavior).

Closes #1293
</content>
</entry>
<entry>
<title>config: make ‘starlight’ the default color theme</title>
<updated>2023-07-14T08:11:43Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2023-07-14T08:11:30Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=efc619b0afc856c976ea8e4d255ab9e014089510'/>
<id>urn:sha1:efc619b0afc856c976ea8e4d255ab9e014089510</id>
<content type='text'>
Closes #1321
</content>
</entry>
<entry>
<title>bind control-shift-u to unicode-input, move urls to o</title>
<updated>2023-07-10T10:31:51Z</updated>
<author>
<name>Antoine Beaupré</name>
<email>anarcat@debian.org</email>
</author>
<published>2022-12-15T16:49:51Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=080a11eb7374af3335bde3841789bd2b659237c8'/>
<id>urn:sha1:080a11eb7374af3335bde3841789bd2b659237c8</id>
<content type='text'>
Having a keybinding to invoke arbitrary unicode characters is very
useful. It's often used as a method of last resort to communicate with
people outside of your main language. For example, if you want to type
the last letter of my real name, you can invoke the latin-1 character
0xe9 or unicode 0x00e9.

You can also use this to type special characters, for example, unicode
U+1F4A9 is of course, the infamous PILE OF POO, which is sure to
produce million laughs everywhere you go.

In foot, there's no keybinding by default to invoke the very useful
unicode-input command. There is no "standard" (as in "ISO") keybinding
this either. But there *is* a de-facto standard currently deployed
by *both* GTK and Qt (a rare feat) *and* Chrome OS (an even rarer
feat) and it's control-shift-u.

Alternatives include Control-x 8 (emacs), Control V u (vim),
Alt (Windows, LibreOffice), or Option (Mac). I doubt we want to adopt
any of those.

So let's use control-shift-u for this. Unfortunately, it's currently
assigned to show-urls-launch, which is unfortunate, but
insurmountable. We can reassign this keybinding elsewhere. I have
picked control-shift-o in my configuration, because "o" is a good
mnemonic for "open URLs". Others have suggested "m" instead.

Closes: #1183
</content>
</entry>
<entry>
<title>input: add basic support for touchscreen input</title>
<updated>2023-07-05T14:22:28Z</updated>
<author>
<name>CismonX</name>
<email>admin@cismon.net</email>
</author>
<published>2023-07-04T16:19:21Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=d2fcb5343f57c132abec9a21ad89d1505a32c47c'/>
<id>urn:sha1:d2fcb5343f57c132abec9a21ad89d1505a32c47c</id>
<content type='text'>
Closes #517
</content>
</entry>
<entry>
<title>config: dpi-aware: remove ‘auto’ value, and default to ‘no’</title>
<updated>2023-06-29T13:38:23Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2023-06-26T15:55:04Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=64b6b5d2a7b81bcad3f0a50a6c1556fd7300c171'/>
<id>urn:sha1:64b6b5d2a7b81bcad3f0a50a6c1556fd7300c171</id>
<content type='text'>
We now default to scaling fonts using the scaling factor, not monitor
DPI.

The ‘auto’ value for dpi-aware has been removed.

Documentation (man pages and README) have been updated to reflect the
new default.
</content>
</entry>
<entry>
<title>Fixed a type for the pixel fontsize change</title>
<updated>2023-06-23T18:10:19Z</updated>
<author>
<name>wout</name>
<email>wout@noreply.codeberg.org</email>
</author>
<published>2023-06-23T18:10:19Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=70ffc2632f508d0298ca53160ce69300861aef5b'/>
<id>urn:sha1:70ffc2632f508d0298ca53160ce69300861aef5b</id>
<content type='text'>
xp -&gt; px
</content>
</entry>
<entry>
<title>.desktop: remove StartupWMClass from server, use distinct StartupWMClass for foot and footclient</title>
<updated>2023-05-22T16:57:54Z</updated>
<author>
<name>jdevdevdev</name>
<email>jdevdevdev@noreply.codeberg.org</email>
</author>
<published>2023-05-01T15:53:01Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=134b54dfe0e4d142ac4b6b7fe25e84485ba63387'/>
<id>urn:sha1:134b54dfe0e4d142ac4b6b7fe25e84485ba63387</id>
<content type='text'>
For this to work, the default app-id of footclient has been changed
from ‘foot’ to ‘footclient’.

By using distinct StartupWMClasses, the compositor can connect a
running foot/footclient instance to the correct .desktop-file. This
ensures the correct icon is being used in e.g. docks, and that actions
like “open another window” works correctly.

Note that the user can override the app-id, either by setting app-id
in foot.ini, or with the -a,--app-id command line option.

Closes #1355
</content>
</entry>
<entry>
<title>utmp: rewrite utmp logging</title>
<updated>2023-05-22T16:47:25Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2023-05-17T18:51:40Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=e78319fccd2b8c057deff4b1937b325be1d35140'/>
<id>urn:sha1:e78319fccd2b8c057deff4b1937b325be1d35140</id>
<content type='text'>
This patch generalizes the utmp support, to not only support
libutempter, but also ulog (and in the future, even more interfaces).

* Rename config option main.utempter to main.utmp-helper
* Add meson option -Dutmp-backend=none|libutempter|ulog|auto
* Rename meson option -Ddefault-utempter-path to -Dutmp-default-helper-path
* utmp is no longer detected at compile time, but at runtime instead.

Meson will configure the following pre-processor macros, based on the
selected utmp backend:

* UTMP_ADD - argument to pass to utmp helper when adding a record (starting foot)
* UTMP_DEL - argument to pass to utmp helper when removing a record (exiting foot)
* UTMP_DEL_HAVE_ARGUMENT - if defined, UTMP_DEL expects an extra argument ($WAYLAND_DISPLAY)
* UTMP_DEFAULT_HELPER_PATH - path to the default utmp helper binary

The documentation has been updated to mention which arguments are
passed to the helper binary.

Closes #1314
</content>
</entry>
<entry>
<title>fix typos</title>
<updated>2023-03-28T21:45:18Z</updated>
<author>
<name>Harri Nieminen</name>
<email>moiman@posteo.net</email>
</author>
<published>2023-03-28T21:31:49Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=ae26915916731813edc2aefeb18a5754e8c79cd4'/>
<id>urn:sha1:ae26915916731813edc2aefeb18a5754e8c79cd4</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc: foot.ini: fix spelling mistake in [bell].urgent description</title>
<updated>2023-02-16T09:12:53Z</updated>
<author>
<name>Craig Barnes</name>
<email>craigbarnes@protonmail.com</email>
</author>
<published>2023-02-16T09:09:51Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=f2356adee392edefa54009c9932a37e6c5a45b20'/>
<id>urn:sha1:f2356adee392edefa54009c9932a37e6c5a45b20</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc: fix a typo</title>
<updated>2023-01-07T21:55:01Z</updated>
<author>
<name>Grigory Kirillov</name>
<email>txgk@bk.ru</email>
</author>
<published>2023-01-07T21:55:01Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=a38b8d02227f13ce1da5125905a262e298875a0d'/>
<id>urn:sha1:a38b8d02227f13ce1da5125905a262e298875a0d</id>
<content type='text'>
</content>
</entry>
<entry>
<title>config: change default grapheme-width-method from wcswidth to double-width</title>
<updated>2023-01-01T09:29:27Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-12-16T15:56:43Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=6259d59b4d82b0e8b7705759e04262130a3426c8'/>
<id>urn:sha1:6259d59b4d82b0e8b7705759e04262130a3426c8</id>
<content type='text'>
The old default, wcswidth, simply calls wcswidth() on the grapheme
cluster. This was supposedly the implementation with the highest
application compatibility. Except we never even tried to measure
it. It was just assumed.

A lot of modern applications have better implementations. Let’s try to
push support for better emoji support by changing our default method
from wcswith to double-width.

While far from correct (it’s not based on the Unicode tables), the
‘double-width’ method produces accurate results anyway.

double-width is like wcswidth(), in that it adds together the
individual wcwidths of all codepoints in the grapheme cluster. But, it
limits the maximum width to 2.
</content>
</entry>
<entry>
<title>config: add ‘font-size-adjustment=N[px|%]’ option</title>
<updated>2022-12-17T09:59:17Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-12-15T10:10:32Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=f6ca8c90e11d9b1ecdfe8a5bf69b1b793376a91c'/>
<id>urn:sha1:f6ca8c90e11d9b1ecdfe8a5bf69b1b793376a91c</id>
<content type='text'>
This patch adds a new config option, font-size-adjustment.

It lets you configure how much the font size should be
incremented/decremented when zooming in or out (ctrl-+, ctrl+-).

Values can be specified in points, pixels or percent.

Closes #1188
</content>
</entry>
<entry>
<title>doc: foot.ini: add example, and mention string options can be quoted</title>
<updated>2022-12-06T18:36:07Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-12-02T14:03:07Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=646314469afd96eda346b6a296037d5430e5f121'/>
<id>urn:sha1:646314469afd96eda346b6a296037d5430e5f121</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc: foot.ini: improve documentation of cursor.color</title>
<updated>2022-10-17T18:16:53Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-10-17T18:16:53Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=b0c30c7ed22acbf4033db18949ea43f50edd1382'/>
<id>urn:sha1:b0c30c7ed22acbf4033db18949ea43f50edd1382</id>
<content type='text'>
</content>
</entry>
<entry>
<title>render: delay reflow for ‘resize-delay-ms’ milliseconds</title>
<updated>2022-10-10T15:19:17Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-10-05T15:05:44Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=8179d73daa95dc3b3bdd76eaecc78e456bb4686a'/>
<id>urn:sha1:8179d73daa95dc3b3bdd76eaecc78e456bb4686a</id>
<content type='text'>
Reflowing a large scrollback is *slow*. During an interactive resize,
it can easily take long enough that the compositor fills the Wayland
socket with configure events. Eventually, the socket becomes full and
the compositor terminates the connection, causing foot to exit.

This patch is work-in-progress, and the first step towards alleviating
this.

It delays the reflow by:

* Snapshotting (copying) the original grid when an interactive resize
  is started.
* While resizing, we apply a simple truncation resize of the
  grid (like we handle the alt screen).
* When the resize is done, or paused for ‘resize-delay-ms’, the grid
  is reflowed.

TODO: we *must* not allow any changes to the temporary (truncated)
grid during the resize. Any changes to the grid would be lost when the
final reflow is applied. That is, we must completely pause the ptmx
pipe while a resize is in progress.

Future improvements:

The initial copy can be slow. We should be able to avoid it by
rewriting the reflow algorithm to not free anything. This is
complicated by the fact that some resources (e.g. sixel images) are
currently *moved* to the new grid. They’d instead have to be copied.
</content>
</entry>
<entry>
<title>Add support for creating utmp records</title>
<updated>2022-09-23T21:02:25Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-09-23T18:24:04Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=aa10b1d2da3ecf9672ae915a49073bd30ee0a785'/>
<id>urn:sha1:aa10b1d2da3ecf9672ae915a49073bd30ee0a785</id>
<content type='text'>
This patch adds support for creating utmp records using the ‘utempter’
helper binary from the ‘libutempter’ package.

* New config option ‘main.utempter’
* New meson command line option, -Ddefault-utempter-path. Defaults to
  auto-detecting the path.

The default value of the new ‘main.utempter’ config option depends on
the meson command line option ‘-Ddefault-utempter-path’.

If ‘main.utempter’ is *not* set to ‘none’, foot will try to execute
the utempter helper binary to create utmp records when a new terminal
is instantiated. The record is removed when the terminal instance is
destroyed.
</content>
</entry>
<entry>
<title>config: change default ‘pad’ to 0x0 (i.e. no padding)</title>
<updated>2022-09-03T10:17:46Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-09-03T10:16:41Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=2d1ded183ac1c79b93f2674fed3ec7c0def65075'/>
<id>urn:sha1:2d1ded183ac1c79b93f2674fed3ec7c0def65075</id>
<content type='text'>
</content>
</entry>
</feed>
